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

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.

Obsługiwane przeglądarki danych

Aby uzyskać listę produktów obsługujących wyświetlanie tego typu danych wyjściowych:
  1. Otwórz widok Wymagania systemowe dotyczące produktu Rational Publishing Engine .
  2. W sekcji Według typu kliknij opcję Oprogramowanie.
  3. Przewiń do sekcji Przeglądarki treści. Zostaną wyświetlone nazwy i wersje produktów obsługujących wyświetlanie danych wyjściowych produktu Rational Publishing Engine.

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 PDF
Element Opis Może zawierać inne elementy Może zawierać wartości treści i wyrażenia

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 pozycji 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

Więcej informacji na ten temat zawiera sekcja 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 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 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 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

Jeśli generowanie pliku PDF jest długotrwałe, należy dodać elementy Ikona elementu Podział sekcji 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ó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.
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 komentarza
Właściwości komentarza Uwagi
Zawartość W przypadku dołączenia odsyłaczy hipertekstowych do właściwości Zawartość elementów komentarza można korzystać z odsyłaczy hipertekstowych w dokumencie wyjściowym PDF.
Tabela 4. 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 5. Właściwości przypisu
Właściwości przypisu Uwagi
Nazwa stylu W przypadku zastosowania stylu do elementów wstawianych, takich jak przypisy, tekst, tekst formatowany lub tabele styl jest stosowany do wszystkich elementów wstawianych do momentu wystąpienia następnego elementu blokowego, np. akapitu. Jeśli np. zostanie dodany styl do elementu przypisu, przed którym znajduje się tekst formatowany, styl zostanie zastosowany także do elementu tekstu formatowanego.
Tabela 6. Właściwości obrazu
Właściwości obrazu Uwagi
Szerokość krawędzi Nie należy używać dla tego formatu wyjściowego.
Zawartość Obsługiwane formaty obrazów: .bmp, .emf, .gif, .jpg, .png, .wmf

Obrazy w formacie .svg są obsługiwane przez produkt Rational Publishing Engine, ale nie są obsługiwane przez program Microsoft Word. Sterownik PDF używa funkcji z programu Microsoft Word. W celu umożliwienia poprawnego generowania dokumentu w dokumencie wyjściowym PDF obrazy w formacie .svg są przekształcane w obrazy w formacie .png. Proces konwersji może zniekształcić wyświetlanie obrazu w dokumencie wyjściowym.

Tabela 7. Właściwości listy
Wł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 8. 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 9. 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 10. 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.

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 11. 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 12. Właściwości tekstu formatowanego
Właściwości tekstu formatowanego Uwagi
Nazwa stylu W przypadku zastosowania stylu do elementów wstawianych, takich jak przypisy, tekst, tekst formatowany lub tabele styl jest stosowany do wszystkich elementów wstawianych do momentu wystąpienia następnego elementu blokowego, np. akapitu. Jeśli np. zostanie dodany styl do elementu przypisu, przed którym znajduje się tekst formatowany, styl zostanie zastosowany także do elementu tekstu formatowanego.
Tabela 13. 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.
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.
Styl ramki Należy użyć wartości single (pojedyncza) zamiast thick (gruba), hairline (włosowa), inset (wklęsła) lub outset (wypukła). Takie samo formatowanie jest zastosowane do wszystkich tych wartości i wiernie oddaje efekt uzyskiwany przy pomocy wartości single (pojedyncza).
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.

Nazwa stylu W przypadku zastosowania stylu do elementów wstawianych, takich jak przypisy, tekst, tekst formatowany lub tabele styl jest stosowany do wszystkich elementów wstawianych do momentu wystąpienia następnego elementu blokowego, np. akapitu. Jeśli np. zostanie dodany styl do elementu przypisu, przed którym znajduje się tekst formatowany, styl zostanie zastosowany także do elementu tekstu formatowanego.
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 14. 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 15. 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.
Nazwa stylu W przypadku zastosowania stylu do elementów wstawianych, takich jak przypisy, tekst, tekst formatowany lub tabele styl jest stosowany do wszystkich elementów wstawianych do momentu wystąpienia następnego elementu blokowego, np. akapitu. Jeśli np. zostanie dodany styl do elementu przypisu, przed którym znajduje się tekst formatowany, styl zostanie zastosowany także do elementu tekstu formatowanego.
Tabela 16. 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.

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

Formaty wyjściowe PDF 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.

Obiekty OLE

Istnieje możliwość wyodrębniania osadzonych obiektów, takich jak obiekty OLE (Object Linking and Embedding) z atrybutów w źródle danych. Obiekty OLE są jednak zawsze wyświetlane jako obrazy w dokumencie wyjściowym PDF, ponieważ ten format nie obsługuje obiektów OLE.

Opinia