Przedstawione w tej sekcji informacje dotyczą generowania dokumentów HTML w produkcie
Rational Publishing Engine.
Przeznaczenie
Wygenerowanie z szablonu strony WWW w formacie HTML.
Elementy szablonu
Tabela 1. Elementy szablonu dostępne do użycia dla formatu wyjściowego HTMLElement |
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 |
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 |
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 HTML.
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. |
Wyrównanie komórki |
Ta właściwość określa położenie tekstu w komórce. |
Szerokość komórki |
Szerokość komórki można określić w pikslach, punktach lub
procentach. |
Tabela 3. Właściwości podpisu rysunkuWłaściwości podpisu rysunku |
Uwagi |
Szerokość krawędzi |
Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi. |
Kod pola |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 4. Właściwości obrazuWłaściwości obrazu |
Uwagi |
Szerokość krawędzi |
Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi. |
Tabela 5. Właściwości szczegółów listyWłaściwości szczegółów listy |
Uwagi |
Szerokość krawędzi |
Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi. |
Tabela 6. Właściwości numeru stronyWłaściwości numeru strony |
Uwagi |
Szerokość krawędzi |
Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi. |
Tabela 7. 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. |
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 |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 8. Właściwości wierszaWłaściwości wiersza |
Uwagi |
Podział wiersza między stronami |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 9. 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. |
Szerokość krawędzi |
Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi. |
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 |
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.
|
Tabela 10. Właściwości tytułu tabeliWłaściwości tytułu tabeli |
Uwagi |
Szerokość krawędzi |
Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi. |
Kod pola |
Nie należy używać dla tego formatu wyjściowego. |
Tabela 11. 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. |
Tabela 12. Właściwości łącznej liczby stronWłaściwości łącznej liczby stron |
Uwagi |
Szerokość krawędzi |
Aby utworzyć krawędź w danych wyjściowych, konieczne jest określenie wartości szerokości krawędzi. |
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 Wcześniejszy PDF,
HTML i XSL-FO pliki włączane są zawsze odsyłaczami hipertekstowymi.
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.
Listy w akapitach
Podczas projektowania szablonów, które mają zostać użyte do generowania danych wyjściowych HTML, należy unikać zagnieżdżania
elementów listy w elementach akapitu.
Listy dziedziczą wyznaczony zbiór właściwości formatowania, które wpływają na określone właściwości akapitu. Na przykład właściwości akapitu takie jak kolor tła i krawędzie są zmieniane, jeśli akapit zawiera listę. Aby uniknąć tych problemów, należy umieścić elementy listy po elementach akapitu w szablonie.