Możliwe jest zaimportowanie całego szablonu lub jego sekcji przez fizyczne osadzenie elementów w innym szablonie. Istnieje również możliwość zaimportowania szablonu do
innego szablonu podczas generowania dokumentu przez dynamiczne połączenie z szablonem zamiast jego fizycznego osadzania.
O tym zadaniu
Szablony można importować ze źródłami danych, stronami wzorcowymi,
stylami i zmiennymi. Jeśli importowana
treść jest zgodna z treścią szablonu, użytkownik otrzyma powiadomienie o konflikcie. Aby
rozwiązać konflikt, należy zmienić treść lub ją zastąpić.
Procedura
- W aplikacji Document Studio wybierz jedną z następujących opcji:
- Aby wstawić szablon do istniejącego elementu lub na końcu szablonu, kliknij opcję .
- Jeśli w szablonie wybrano istniejący element, który może zawierać importy, opcja Importuj szablon jest włączona, aby umożliwić wstawienie zaimportowanej treści do wybranego elementu.
- Jeśli w szablonie wybrano istniejący element, który nie może zawierać importów, opcja Importuj szablon jest wyłączona.
- Jeśli nie wybrano żadnych istniejących elementów, opcja Importuj szablon jest włączona, aby umożliwić wstawienie zaimportowanej treści na końcu szablonu.
- Aby dodać szablon przed elementem wybranym w edytorze treści szablonu lub po tym elemencie, kliknij opcję
, a następnie wybierz opcję Przed wybranym elementem lub opcję Po wybranym elemencie.
W kreatorze importu szablonu należy kliknąć przycisk Dalej.
- W oknie Wybór szablonu wybierz szablon.
- Wybierz typ importu:
- Osadzanie fizyczne: powoduje wstawienie
elementów szablonu do bieżącego szablonu.
- Przywoływanie dynamiczne: elementy szablonu są dowiązywane i ładowane podczas generowania dokumentu do danych wyjściowych.
Ważne: Osadzanie fizyczne powinno być
używane zamiast przywoływania dynamicznego, gdy:
- Szablon lub fragment kodu zaprojektowano do wyodrębniania informacji ze
źródła danych.
- Szablon lub fragment kodu zawiera odwołanie dynamiczne.
- Jeśli informacje dla stron wzorcowych, stylów i zmiennych pozostają w
konflikcie, przed taką treścią zostanie wyświetlona ikona
Konflikt treści. Zmodyfikuj elementy treści pozostające w konflikcie: - Aby użyć informacji z istniejącego szablonu, kliknij opcję Użyj istniejącego elementu dla konfliktów, jeśli są dozwolone.
- Aby zmodyfikować treść pozostającą w konflikcie z nową treścią, kliknij opcję Edytuj,
zmodyfikuj wartość i kliknij przycisk OK.
Uwaga: Jeśli najpierw zaimportowano szablon przez jego dynamiczne przywołanie, a następnie zaimportowano inny
szablon przez jego fizyczne osadzenie, żaden z tych konfliktów nie może zostać rozwiązany przez ponowne wykorzystanie wartości dla dynamicznie przywoływanego szablonu. Konieczna jest edycja każdego konfliktu w celu jego rozwiązania.
Kliknij przycisk
Dalej.
- Przejrzyj podsumowanie i kliknij przycisk Zakończ. Jeśli w importowanym szablonie podano referencje uwierzytelniania i są one wyświetlane w podsumowaniu, są one również przechowywane w szablonie hosta. Po zaimportowaniu
szablonu można zmodyfikować te referencje.
- Opcjonalne: W razie potrzeby zmień kolejność elementów w szablonie. Jeśli zaimportowano kilka szablonów lub elementów po kolei, każdy dodany element zostanie wyświetlony powyżej ostatniego elementu. Najnowszy import zostanie wyświetlony jako pierwszy. W
edytorze treści szablonu można przeciągnąć zaimportowane szablony w konkretne miejsce, aby zmienić kolejność w szablonie.
Uwaga: W widoku schematu można przeciągać elementy w konkretne miejsce, aby zmieniać kolejność w szablonie, ale nie można zmieniać tej kolejności, przeciągając zaimportowane
szablony.
Wyniki
Treść szablonu lub odsyłacz do niego są wstawiane do szablonu hosta.
Jeśli jako typ importu wybrano opcję Przywoływanie dynamiczne, style, strony
wzorcowe, źródła danych i zmienne z zaimportowanego szablonu zostaną wyświetlone w widoku Schemat z informacją (przywoływane) po ich nazwach. Te odwołania można przeciągać i upuszczać w elementach szablonu oraz używać ich w wyrażeniach w edytorze skryptów. Nie można przypisać wartości do tych zmiennych ani ich edytować. Gdy produkt Rational Publishing Engine ładuje szablon hosta, sprawdza, czy istnieją wszystkie odwołania do zmiennych, stylów i stron wzorcowych. Usuwanie przywoływanych szablonów zawierających zmienne, style lub strony wzorcowe używane w szablonie hosta jest niedozwolone. W produkcie Rational Publishing Engine 1.3.0 i późniejszych wersjach w skryptach w szablonie hosta można używać zmiennych zewnętrznych z dynamicznie importowanych szablonów.
Co dalej
- Jeśli wybrano opcję dynamicznego odwoływania się do pliku, może zostać wyświetlone zapytanie
dotyczące zmiany ścieżki do pliku, tak aby była względna w odniesieniu do szablonu hosta.
Jeśli zostanie wyświetlone zapytanie dotyczące użycia ścieżek względnych:
- Należy pamiętać, że określona ścieżka względna jest względna w odniesieniu do szablonu hosta, a nie specyfikacji dokumentu.
- W przypadku przeniesienia jednego z szablonów z jego pierwotnego położenia i zmiany ścieżki względnej konieczne jest usunięcie przywoływanego szablonu z szablonu hosta i ponowne zaimportowanie szablonu.
Jeśli nie zostanie wyświetlone zapytanie dotyczące użycia ścieżek względnych, należy sprawdzić, czy:
- Szablon hosta jest zapisany.
- Szablony hosta i zaimportowane szablony to szablony w wersji 2.
- W razie potrzeby należy zmodyfikować referencje uwierzytelniania z zaimportowanego szablonu, które są przechowywane w szablonie hosta.