Przejrzenie tych informacji pozwala dowiedzieć się więcej na temat generowania dokumentów PDF przy użyciu sterownika formatu PDF produktu Rational Publishing Engine.
Przeznaczenie
Wyprowadzenie szablonu do dokumentu .pdf.
Wybór sterownika PDF
Domyślny sterownik PDF generuje pliki PDF
w wersji 1.5. W dalszym ciągu możliwe jest użycie wcześniejszego sterownika
PDF, który generuje pliki PDF w wersji 1.4.
Jeśli
użytkownik utworzy specyfikację dokumentu w produkcie
Rational Publishing Engine
w wersji 1.1.2.1 lub wcześniejszej i otworzy go za pomocą produktu
Rational Publishing Engine
w wersji 1.1.2.2 lub nowszej, ustawienia PDF zostaną zmigrowane do ustawień
nowszej wersji sterownika PDF i wcześniejszego sterownika PDF. Jeśli użytkownik utworzy specyfikację dokumentu w produkcie
Rational Publishing Engine w wersji 1.1.2.2 lub nowszej i otworzy ją za pomocą produktu
Rational Publishing Engine w wersji 1.1.2.1 lub wcześniejszej, domyślnie używany jest wcześniejszy
sterownik PDF. Jeśli oba sterowniki PDF - aktualny i wcześniejszy - zostały skonfigurowane w specyfikacji dokumentu w wersji 1.1.2.2 lub nowszej, tworzone są dwie takie same
instancje sterownika PDF. Jeśli ta duplikacja będzie miała
miejsce, możliwe jest usunięcie zduplikowanego sterownika ze specyfikacji
dokumentu.
Elementy szablonu
Tabela 1. Elementy szablonu dostępne do użycia dla formatu danych wyjściowych PDFElement |
Opis |
Może zawierać inne elementy |
Może zawierać dane |
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 |
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 |
Tekst |
Treść jest wyświetlana z tym samym określonym
formatowaniem. |
Nie |
Tak |
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 |
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 |
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 |
Tabela |
Służy do tworzenia tabeli w dokumencie
wyjściowym. Tabela może zawierać wiersze lub elementy kontenera. |
Tak |
Nie |
Wiersz |
Służy do tworzenia wiersza w bieżącej
tabeli. |
Tak |
Nie |
Komórka |
Służy do tworzenia komórki w bieżącym
wierszu bieżącej tabeli. |
Tak |
Nie |
Lista |
Służy do tworzenia listy wypunktowanej lub
numerowanej w dokumencie wyjściowym. |
Tak |
Nie |
Szczegóły listy |
Służy do tworzenia pozycji listy w bieżącej
liście w dokumencie wyjściowym. |
Tak |
Nie |
Konfiguracja źródła danych |
Patrz:
Dodawanie elementu konfiguracji źródła danych. |
Nie |
Nie |
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 |
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 |
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 |
Podział strony |
Służy do dodania podziału strony do dokumentu
wyjściowego. |
Nie |
Nie |
Podział sekcji |
Służy do dodania podziału sekcji do dokumentu
wyjściowego. |
Nie |
Nie |
Spis treści |
Służy do dodania spisu treści do dokumentu
wyjściowego. |
Nie |
Nie |
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 |
Łą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 |
Jeśli generowanie pliku PDF jest długotrwałe,
należy dodać elementy
Podział sekcji do szablonu w celu
zwiększenia wydajności.
Właściwości elementu
Należy przejrzeć te uwagi, aby uzyskać więcej informacji na temat określania właściwości elementu w szablonach, które są przeznaczone do generowania dokumentów PDF.
Tabela 2. Właściwości komórkiWł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. |
Zakres kolumny |
Wszystkie wiersze i kolumny muszą zawierać tę samą liczbę komórek. Krawędzie między komórkami są usuwane, a tylko treść lub właściwości określone dla pierwszej komórki są stosowane do danych wyjściowych. Należy unikać nakładających się zakresów. |
Zakres wiersza |
Wszystkie wiersze i kolumny muszą zawierać tę samą liczbę komórek. Krawędzie między komórkami są usuwane, a tylko treść lub właściwości określone dla pierwszej komórki są stosowane do danych wyjściowych. Należy unikać nakładających się zakresów. |
Tabela 3. Właściwości podpisu rysunkuWł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 obrazuWłaściwości obrazu |
Uwagi |
Szerokość krawędzi |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 5. Właściwości listyWłaściwości listy |
Uwagi |
Styl numeracji |
Możliwe jest użycie następujących stylów:- Znacznik podpunktu: listy nieuporządkowane
- Arabskie: listy numerowane
- Cyfry rzymskie pisane wielkimi literami: cyfry rzymskie pisane wielkimi literami
- Cyfry rzymskie pisane małymi literami: cyfry rzymskie pisane małymi literami
- Alfabet pisany wielkimi literami: wielkie litery
- Alfabet pisany małymi literami: małe litery
|
Odstępy między znakami numeracji |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 6. Właściwości szczegółów listyWłaściwości szczegółów listy |
Uwagi |
Szerokość krawędzi |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 7. Właściwości numeru stronyWłaściwości numeru strony |
Uwagi |
Szerokość krawędzi |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 8. Właściwości akapituWł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. Wyrównanie 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.
Nie należy używać wartości rozproszone dla tego formatu danych wyjściowych.
|
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 9. Właściwości wierszaWł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 10. Właściwości tabeliWł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. |
Autodopasowanie do okna |
Powoduje zmianę wielkości tabeli w celu dopasowania do szerokości strony. Należy usunąć zaznaczenie tej właściwości, gdy wartość właściwości Zmień wielkość, aby dopasować do treści to Fałsz. |
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. |
Odstępy między komórkami |
Nie należy używać dla tego formatu wyjściowego. |
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 |
Jeśli ustawiono wartość Prawda, a zaznaczenie właściwości Szerokość i Autodopasowanie do okna zostaną usunięte, szerokość kolumny zostanie dopasowana w celu dopasowania do treści. 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. Jeśli ustawiono wartość Fałsz, dla tabeli należy usunąć zaznaczenie właściwości Szerokość i Autodopasowanie do okna. Tabela jest generowana przy użyciu domyślnej wielkości kolumny wynoszącej jeden cal.
|
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ść |
Konieczne jest określenie wartości, chyba że właściwość Zmień wielkość, aby dopasować do treści ustawiono na wartość Fałsz. |
Tabela 11. Właściwości tytułu tabeliWł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 12. Właściwości tekstuWł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 13. Właściwości łącznej liczby stronWłaściwości łącznej liczby stron |
Uwagi |
Szerokość krawędzi |
Nie należy używać dla tego formatu wyjściowego. |
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 PDF plik
włączany jest importowany i wyświetlana jest pełna treść dokumentu.
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.
Dane Unicode w dokumencie wyjściowym
Wszystkie dane Unicode zostaną wyświetlone, jeśli użyta czcionka obsługuje kod
Unicode.
- Dla dokumentu wyjściowego PDF konieczna jest konfiguracja dodatkowa. Szczegółowe informacje zawiera sekcja
Ustawienia
dokumentu wyjściowego PDF. Jeśli użyto czcionki w kodowaniu innym niż
Unicode, należy ponownie wygenerować dokument z użyciem czcionek Unicode typu
True Type i ustawić odpowiednie właściwości dokumentu wyjściowego.
- W przypadku dokumentu wyjściowego
Microsoft Word, jeśli użyto czcionki
w kodowaniu innym niż Unicode, należy po wygenerowaniu dokumentu zmienić
czcionkę w dokumencie wyjściowym.
- W przypadku dokumentu wyjściowego HTML, jeśli użyto czcionki w kodowaniu
innym niż Unicode, należy po wygenerowaniu dokumentu zmienić rodzinę czcionek w
arkuszu stylów.