Informacje dodatkowe dotyczące danych wyjściowych w formacie Microsoft Word na potrzeby projektowania szablonów

Przedstawione w tej sekcji informacje dotyczą generowania dokumentów w formacie programu Microsoft Word w produkcie Rational Publishing Engine.

Przeznaczenie

Wygenerowanie z szablonu następujących dokumentów:
Rozszerzenie Format wygenerowanego dokumentu
.doc Microsoft Word 2003
.docx Microsoft Word 2007 bez możliwości uruchamiania makr
.docm Microsoft Word 2007 z możliwością uruchamiania makr

Elementy szablonu

Tabela 1. Elementy szablonu dostępne do użycia dla formatu wyjściowego Microsoft Word
Element Opis Może zawierać inne elementy Może zawierać dane
Ikona Akapit Akapit Służy do grupowania sekcji elementów. Dodaje znak powrotu karetki wokół elementów potomnych tego elementu w dokumencie wyjściowym. Tak Nie
Ikona Kontener Kontener Służy do grupowania sekcji elementów. Nie można wobec tego elementu zastosować stylów i nie wpływa on na formatowanie dokumentu wyjściowego.
Jeśli zostanie użyty wewnątrz innych elementów, może nastąpić ograniczenie dostępności elementów potomnych używanych w tym kontenerze. Na przykład:
  • Wewnątrz wierszy kontener może obsługiwać tylko komórki.
  • Wewnątrz list kontenery mogą obsługiwać tylko elementy szczegółów listy.
Tak Nie
Ikona Tekst Tekst Treść jest wyświetlana z tym samym określonym formatowaniem. Nie Tak
Ikona Tekst formatowany Tekst formatowany Blok tekstu, w którym poszczególne słowa mogą mieć unikalne formatowanie. Na wybranych słowach w obrębie elementu można użyć formatu pogrubienia, kursywy, podkreślenia, przekreślenia lub koloru. Tekst jest statyczny. Nie Tak
Ikona Odsyłacz hipertekstowy Odsyłacz hipertekstowy Służy do tworzenia odsyłacza hipertekstowego w dokumencie wyjściowym. Odsyłacz hipertekstowy może wskazywać położenie wewnątrz dokumentu lub położenie zewnętrzne. Nie Tak
Ikona Obraz Obraz W danych wyjściowych wyświetla obraz .gif, .png, .jpg, .emf lub .wmf. Projektant raportu może określić ścieżkę do obrazu w szablonie lub generator raportu może podać tę ścieżkę w czasie wykonywania. Nie Tak
Ikona Tabela Tabela Służy do tworzenia tabeli w dokumencie wyjściowym. Tabela może zawierać wiersze lub elementy kontenera. Tak Nie
Ikona Wiersz Wiersz Służy do tworzenia wiersza w bieżącej tabeli. Tak Nie
Ikona Komórka Komórka Służy do tworzenia komórki w bieżącym wierszu bieżącej tabeli. Tak Nie
Ikona Lista Lista Służy do tworzenia listy wypunktowanej lub numerowanej w dokumencie wyjściowym. Tak Nie
Ikona Szczegóły listy Szczegóły listy Służy do tworzenia pozycji listy w bieżącej liście w dokumencie wyjściowym. Tak Nie
Ikona Konfiguracja źródła danych Konfiguracja źródła danych Patrz: Dodawanie elementu konfiguracji źródła danych. Nie Nie
Ikona Plik włączany Plik włączany Włącza podany plik do dokumentu wyjściowego jako pole INCLUDETEXT.
  • Pik włączany może mieć rozszerzenie .doc, .docx, .txt lub .rtf.
  • W przypadku danych wyjściowych programu Microsoft Word konieczne jest zaktualizowanie wszystkich pól za pomocą makra, aby wyświetlić plik włączany.
  • W przypadku dokumentu w formacie Wcześniejszy PDF, HTML oraz XSL-FO plik włączany jest odsyłaczem hipertekstowym do dokumentu.
Nie Tak
Ikona Przypis Przypis Służy do tworzenia przypisu na bieżącej stronie dokumentu wyjściowego. Tekst przypisu jest treścią elementu przypisu. Element obsługiwany tylko dla dokumentów wyjściowych Microsoft Word. Nie Tak
Ikona Region Region Regiony to elementy statyczne, które umożliwiają zmianę przepływu danych wyjściowych przez przekierowanie treści innych elementów lub grup elementów. Jeśli element ma określoną właściwość region docelowy z nazwą elementu regionu, jego treść jest wyświetlana w podanym regionie zamiast w jego pozycji w dokumencie. Nie Nie
Ikona Zakładka Zakładka Służy do definiowania zakładki w dokumencie. Nazwą wygenerowanej zakładki jest treść zakładki. Podczas generowania dokumentów produkt Rational Publishing Engine generuje unikalną nazwę dla każdej zakładki. Nazwa ta jest oparta na nazwie podanej w czasie projektowania oraz unikalnym identyfikatorze wygenerowanym w czasie wykonywania. Nie Tak
Ikona Komentarz Komentarz Służy do dodania komentarza do dokumentu wyjściowego. Forma i kształt komentarza wyjściowego są specyficzne dla formatu wyjściowego.

Element obsługiwany dla dokumentów Microsoft Word i PDF.

Nie Tak
Ikona Podział strony Podział strony Służy do dodania podziału strony do dokumentu wyjściowego. Nie Nie
Ikona Podział sekcji Podział sekcji Służy do dodania podziału sekcji do dokumentu wyjściowego. Nie Nie
Ikona Spis treści Spis treści Służy do dodania spisu treści do dokumentu wyjściowego. Nie Nie
Ikona Spis tabel Spis tabel Służy do dodania spisu tabel do dokumentu wyjściowego. Aby wygenerować spis tabel w dokumencie wyjściowym, należy dodać w szablonie dokumentu tytuły tabel.

Element obsługiwany tylko dla dokumentów wyjściowych Microsoft Word.

Należy zaktualizować wszystkie pola w dokumencie Microsoft Word, aby wyświetlić i móc zaktualizować wartość tego pola.

Nie Nie
Ikona Spis tabel Spis tabel Służy do dodania spisu tabel do dokumentu wyjściowego. Aby wygenerować spis tabel w dokumencie wyjściowym, należy dodać w szablonie dokumentu tytuły tabel.

Element obsługiwany tylko dla dokumentów wyjściowych Microsoft Word.

Należy zaktualizować wszystkie pola w dokumencie Microsoft Word, aby wyświetlić i móc zaktualizować wartość tego pola.

Nie Nie
Ikona Pole Pole Służy do dodania ogólnego elementu pola Microsoft Word. We właściwości kodu pola można wpisać dowolny poprawny kod Microsoft Word.

Element obsługiwany tylko dla dokumentów wyjściowych Microsoft Word.

Należy zaktualizować wszystkie pola w dokumencie Microsoft Word, aby wyświetlić i móc zaktualizować wartość tego pola.

Nie Nie
Ikona Numer strony Numer strony Służy do dodania numeru strony do dokumentu wyjściowego. Element obsługiwany tylko w dokumentach wyjściowych Microsoft Word i PDF. Nie Nie
Ikona Łączna liczba stron Łączna liczba stron Służy do dodania łącznej liczby stron do dokumentu wyjściowego. Element obsługiwany tylko dla dokumentów wyjściowych Microsoft Word i PDF. Nie Nie
Ikona Tytuł tabeli Tytuł tabeli Służy do dodania tytułu tabeli. Wprawdzie nie można podać dynamicznej treści w tytule tabeli, jednak każdy kolejny element tekstu jest dołączany do tego tytułu.

Element obsługiwany dla dokumentów wyjściowych Microsoft Word i PDF.

Należy zaktualizować wszystkie pola w dokumencie Microsoft Word, aby wyświetlić i móc zaktualizować wartość tego pola.

Nie Nie
Ikona Tytuł rysunku Tytuł rysunku Służy do dodania tytułu rysunku. Wprawdzie nie można podać dynamicznej treści w tytule rysunku, jednak każdy kolejny element tekstu jest dołączany do tego tytułu.

Element obsługiwany dla dokumentów wyjściowych Microsoft Word i PDF.

Należy zaktualizować wszystkie pola w dokumencie Microsoft Word, aby wyświetlić i móc zaktualizować wartość tego pola.

Nie Nie

Właściwości elementu

Przedstawione w tej sekcji uwagi ułatwiają poznanie zasad określania właściwości elementów w szablonach przeznaczonych do generowania dokumentów w formacie programu Microsoft Word.
Tabela 2. Właściwości komórki
Właściwości komórki Uwagi
Szerokość krawędzi Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi z zakresu od 1 do 30 piksli.
Wyrównanie komórki Ta właściwość określa położenie tekstu w komórce. Wartość wyrównaj nie jest obsługiwana dla tego formatu danych wyjściowych.
Szerokość komórki Należy wprowadzić wartość w punktach lub w pikslach. W przypadku wprowadzenia wartości w pikslach zostanie ona przekształcona do postaci wyrażonej w punktach przy założeniu, że rozdzielczość ekranu wynosi 96 dpi. W przypadku wprowadzenia wartości procentowej zostanie ona zignorowana. W przypadku łączenia tabel konieczne jest ustawienie właściwości szerokość komórki, aby wielkości kolumn były takie same.
Tabela 3. Właściwości podpisu rysunku
Właściwości podpisu rysunku Uwagi
Szerokość krawędzi Nie należy używać dla tego formatu wyjściowego.
Kod pola Cyfry arabskie lub rzymskie wyświetlane sekwencyjnie dla każdego podpisu.
Tabela 4. Właściwości obrazu
Właściwości obrazu Uwagi
Szerokość krawędzi Nie należy używać dla tego formatu wyjściowego.
Tabela 5. Właściwości szczegółów listy
Właściwości szczegółów listy Uwagi
Szerokość krawędzi Nie należy używać dla tego formatu wyjściowego.
Tabela 6. Właściwości numeru strony
Właściwości numeru strony Uwagi
Szerokość krawędzi Nie należy używać dla tego formatu wyjściowego.
Tabela 7. Właściwości akapitu
Właściwości akapitu Uwagi
Szerokość krawędzi Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi z zakresu od 1 do 30 piksli.
Wyrównanie akapitu Tekst na stronie należy rozmieścić przy użyciu określonego wyrównania.

Wartość do lewej, do prawej i wyśrodkowanie powoduje utworzenie nierównych krawędzi akapitu z dopasowaniem w akapicie jak największej możliwej liczby słów. Wartość wyrównaj powoduje utworzenie równych krawędzi akapitu przez wstawienie dodatkowego odstępu między słowami we wszystkich wierszach z wyjątkiem ostatniego. distributed (rozłożone) różni się od wartości justify (wyjustowane) tylko tym, że odstępy są również wstawiane w ostatnim wierszu akapitu.

Kontrola wdów/bękartów W przypadku ustawienia wartości Prawda interlinia jest dopasowywana w celu zapobiegnięcia następującym wynikom formatowania:
  • Pojedyncze słowo kończące akapit w nowym wierszu
  • Pojedynczy wiersz kończący akapit na nowej stronie

W przypadku ustawienia wartości Fałsz odstępy nie są dopasowywane.

Tabela 8. Właściwości wiersza
Właściwości wiersza Uwagi
Podział wiersza między stronami W przypadku ustawienia wartości Prawda treść wiersza znajdującego się na końcu strony jest dzielona (jeśli jest to konieczne). Treść, która nie mieści się na stronie, zostanie przeniesiona na następną stronę jako nowy wiersz.

W przypadku ustawienia wartości Fałsz treść wiersza znajdującego się na końcu strony nie jest dzielona. Cały wiersz zostanie przeniesiony na następną stronę.

Tabela 9. Właściwości tabeli
Właściwości tabeli Uwagi
Autodopasowanie do treści Powoduje zmianę wielkości tabeli w celu dopasowania do zawartości każdej komórki. W przypadku użycia tej właściwości należy również ustawić właściwość Zmień wielkość, aby dopasować do treści na wartość Prawda.
Szerokość krawędzi Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi z zakresu od 1 do 30 piksli.
Stała szerokość komórki w kolumnie Określ wartość w pikslach, aby wszystkie komórki w kolumnie miały tę samą szerokość.
Zmień wielkość, aby dopasować do treści Po ustawieniu wartości true wiersze są dzielone tylko wtedy, gdy zawierają spację. W razie braku spacji wiersze nie są dzielone, a szerokość kolumny jest zwiększana do szerokości tekstu. Jeśli ustawiono właściwość Automatyczne dopasowanie do treści, należy właściwości Zmień wielkość, aby dopasować do treści nadać wartość true.

Użycie wartości false spowoduje, że szerokość komórki będzie stała i wiersze będą dzielone niezależnie od użytych spacji lub długości tekstu. Ponadto właściwość Automatyczne dopasowanie tabeli zostanie zignorowana.

Automatyczne dopasowanie tabeli Jeśli ma wartość true, wielkość tabeli jest zmieniana w celu dopasowania jej do szerokości strony. Gdy właściwość Zmień wielkość, aby dopasować do treści również ma wartość true, szerokości komórek są ignorowane, a wielkość tabeli jest dopasowywana do treści.

Nie można wprowadzić ustawienia Stała szerokość kolumny jako wartości. Zamiast tego należy użyć właściwości Stała szerokość komórki.

Szerokość Należy określić wartość.
Tabela 10. Właściwości tytułu tabeli
Właściwości tytułu tabeli Uwagi
Szerokość krawędzi Nie należy używać dla tego formatu wyjściowego.
Kod pola Cyfry arabskie lub rzymskie wyświetlane sekwencyjnie dla każdego podpisu.
Tabela 11. Właściwości tekstu
Właściwości tekstu Uwagi
Szerokość krawędzi Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi z zakresu od 1 do 30 piksli.
Tabela 12. Właściwości łącznej liczby stron
Właściwości łącznej liczby stron Uwagi
Szerokość krawędzi Nie należy używać dla tego formatu wyjściowego.

Długość tabeli

Podczas projektowania szablonów, które mają być generowane jako dokumenty programu Microsoft Word, warto rozważyć kwestię długości tabeli.

Długie tabele mogą wymagać więcej niż jednej strony. W przypadku wystąpienia tego wymagania należy wybrać element Wiersz w tabeli oraz w widoku właściwości, a następnie ustawić właściwość podział wiersza między stronami na wartość true. Po ustawieniu tej właściwości tabele mogą być kontynuowane na wielu stronach.

Spisy treści, rysunków i tabel w dokumentach Microsoft Word

Aby dodać spis treści do dokumentu wyjściowego, należy zdefiniować spis treści w szablonie lub arkuszu stylów. Jeśli spis treści zostanie zdefiniowany w szablonie, nie będzie wyświetlany w dokumencie Microsoft Word, dopóki nie zostaną zaktualizowane pola dokumentu. Do aktualizacji pól należy użyć funkcji Aktualizacja pól lub Aktualizacja tabeli w programie Microsoft Word lub makr zawartych w arkuszu stylów rpe.dot. Arkusz stylów rpe.dot znajduje się w instalacji produktu Rational Publishing Engine: %RPE_HOME%\utils\word\rpe.dot. Ten sam proces ma zastosowanie do spisów rysunków i spisów tabel.

Tytuły w dokumentach programu Microsoft Word

Tytuły rysunków i tabel nie są aktualizowane automatycznie. Do aktualizacji pól należy użyć funkcji Aktualizacja pól w programie Microsoft Word lub makr zawartych w arkuszu stylów rpe.dot. Arkusz stylów rpe.dot znajduje się w instalacji produktu Rational Publishing Engine: %RPE_HOME%\utils\word\rpe.dot.

Dołączanie elementu pliku

Możliwe jest utworzenie odsyłacza do pliku lub fizyczne osadzenie go w dokumencie wyjściowym. Sposób obsługi elementów pliku włączanego zależy jednak od formatu wyjściowego oraz od miejsca, z którego plik jest pobierany.
W przypadku dokumentów wyjściowych w formacie Microsoft Word jest generowane pole INCLUDETEXT. Oznacza to, że zadanie importowania pliku jest delegowane na program Microsoft Word. Plik włączany nie jest widoczny w dokumencie wyjściowym, dopóki wszystkie pola nie zostaną zaktualizowane. Aby zaktualizować pola, należy skorzystać z opcji aktualizacji pól programu Microsoft Word lub użyć makr zawartych w arkuszu stylów %RPE_HOME%\utils\word\rpe.dot.
Wskazówka: Dokument programu Microsoft Word połączony z innymi plikami nie jest autonomiczny. Przeniesienie dokumentu na inny komputer uniemożliwi wizualizację treści dołączonych dokumentów. Jeśli wymagana jest wizualizacja, w programie Microsoft Word należy użyć opcji Przerwij łącza, która jest wywoływana przez naciśnięcie kombinacji klawiszy Alt+E+K w pakiecie Microsoft Office 2007, aby dołączyć treść połączonego pliku.

Style nagłówków

Aby użyć predefiniowanych stylów nagłówków dla formatów wyjściowych Microsoft Word (Nagłówek 1, Nagłówek 2, ... , Nagłówek 9) i HTML (H1, H2, ... , 9), należy użyć nazwy stylu 1, 2 do 9. Formaty wyjściowe PDF i XSL-FO nie mają stylów nagłówków, jednak produkt Rational Publishing Engine używa wewnętrznie zdefiniowanych stylów nagłówków.

Style produktu Rational Publishing Engine a style zewnętrzne

Jeśli główny dokument wyjściowy jest w formacie Microsoft Word lub HTML, należy zawsze, gdy to możliwe, użyć stylów zewnętrznych zdefiniowanych w arkuszu stylów. Ta metoda umożliwia szybką zmianę wyglądu dokumentu wyjściowego i wymusza jednolity wygląd dokumentów w firmie.

Numeracja nagłówków dla programu Microsoft Word

Aby uzyskać nagłówki numerowane jak lista hierarchiczna, należy użyć arkusza stylów z numerowanymi nagłówkami.

Dane Unicode w dokumencie wyjściowym

Wszystkie dane Unicode zostaną wyświetlone, jeśli użyta czcionka obsługuje kod Unicode.

Obiekty OLE

Istnieje możliwość wyodrębniania osadzonych obiektów, takich jak obiekty OLE (Object Linking and Embedding), ze źródła danych produktu Rational DOORS. Obiekty OLE są w formacie HTML, PDF i dokumentów wyjściowych XSL-FO zawsze wyświetlane jako obrazy, ponieważ te formaty nie obsługują obiektów OLE.
W przypadku danych wyjściowych programu Microsoft Word należy ustawić właściwość Obiekty OLE jako obrazy statyczne w sekcji metadanych specyfikacji dokumentu.
  • Jeśli właściwość Obiekty OLE jako obrazy statyczne jest ustawiona na wartość true, obiekty OLE są zawarte w dokumencie wyjściowym jako obrazy statyczne. Jeśli obiekty OLE są zawarte w dokumencie wyjściowym jako obrazy statyczne, dokument jest samodzielny.
  • Jeśli właściwość Obiekty OLE jako obrazy statyczne jest ustawiona na wartość false, folder ref jest generowany w tym samym miejscu, w którym znajduje się dokument wyjściowy programu Microsoft Word. Jeśli obiekty OLE nie są zawarte w dokumencie wyjściowym jako obrazy statyczne, dokument nie jest samodzielny, ponieważ jest wymagany osobny folder ref.
Folder ref zawiera pliki .rtf obiektów OLE. Dla każdego wyeksportowanego obiektu OLE do danych wyjściowych programu Microsoft Word dołączane jest pole wskazujące plik .rtf. Ponieważ produkt IBM® Rational Publishing Engine nie może aktualizować pól programu Microsoft Word, dołączone pola są niewidoczne, gdy dokument programu Microsoft Word jest otwarty. Aby ustawić te pola jako widoczne, wykonaj jedno z następujących działań:
Tabela 13. Działania
Działanie Wynik
Zaznacz całą treść dokumentu i użyj funkcji Aktualizuj pola w programie Microsoft Word. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument nie jest niezależny.
Użyj makrodefinicji updateFields udostępnionej w produkcie Rational Publishing Engine. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument nie jest niezależny.
Użyj makrodefinicji insertOLEs udostępnionej w produkcie Rational Publishing Engine. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument jest niezależny.
Użyj makrodefinicji rpe lub insertOLEs udostępnionych w produkcie Rational Publishing Engine. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument jest niezależny.
Uwaga: W przypadku przeniesienia dokumentu, który nie jest niezależny, na inny komputer nie można edytować obiektów OLE. Aby uniknąć tego problemu, należy uruchomić makrodefinicje rpe lub insertOLEs.

Opinia