Zmienne wewnętrzne

Zmienne wewnętrzne produktu Rational Publishing Engine mogą być używane do wyświetlania generowanych automatycznie informacji dotyczących szablonu lub specyfikacji dokumentu w dokumencie wyjściowym.
Tabela 1. Zmienne wewnętrzne produktu Rational Publishing Engine
Zmienna Opis
_cell_number Numer komórki w bieżącym wierszu. Jeśli element nie jest komórką, wartość wynosi 0. Istnieje możliwość użycia zmiennej _cell_number z karty Wyrażenie danych lub Wyrażenie skryptu.
_element_id Numer elementu w szablonie. Zmienna przechowywana wewnętrznie w szablonie i używana do debugowania. Istnieje możliwość użycia zmiennej _element_id z karty Wyrażenie danych lub Wyrażenie skryptu.
_element_level Rekurencyjny poziom elementu. Jeśli dla elementu właściwości poziomu rekurencji na karcie Dane nie ustawiono wartości, wartość tej zmiennej wynosi 1. Istnieje możliwość użycia zmiennej _element_level z karty Wyrażenie danych lub Wyrażenie skryptu.
_row_number Numer wiersza w bieżącej tabeli. Jeśli element nie jest zawarty w elemencie wiersza, wartość tej zmiennej wynosi 0. Istnieje możliwość użycia zmiennej _row_number z karty Wyrażenie danych lub Wyrażenie skryptu.
_sessionInfo Informacje na temat właściwości środowiska wykonawczego pochodzące z szablonu lub specyfikacji dokumentu. Na karcie Wyrażenie skryptu należy wybrać zmienną _sessionInfo i wprowadzić skrypt. Aby wygenerować wartość domyślną dla właściwości w danych wyjściowych, należy użyć cudzysłowów bez żadnej wartości między nimi. Przykłady skryptów:

_sessionInfo.getDocspecProperty("właściwość", "");
_sessionInfo.getTemplateProperty("właściwość", "");
_sessionInfo.getDatasourceProperty("nazwa_źródła_danych","właściwość", "");
_sessionInfo.getOutputProperty("typ_danych_wyjściowych","właściwość", "");
_sessionInfo.docspecVersion
_sessionInfo.templateVersion
_sessionInfo.engineVersion
_sessionInfo.buildNumber

Dla skryptu getDocspecProperty można użyć właściwości specyfikacji istniejącego dokumentu lub właściwości tworzenia niestandardowych metadanych.

_sessionLogger Na potrzeby debugowania informacje niestandardowe, komunikaty dotyczące błędów, ostrzeżeń lub debugowania można wyświetlać w pliku %TEMP%\rpe\rpe.log, widoku Konsola lub widoku Problemy. Komunikaty są wyświetlane w miejscu zdefiniowanym w pliku log4j.properties.

Ustawienie domyślne to wyświetlanie komunikatów informacyjnych w widoku Konsola, a nie w pliku rpe.log.

Na karcie Wyrażenie skryptu należy wybrać zmienną _sessionLogger i wprowadzić skrypt. Pozycje dziennika można generować za pomocą jednej z następujących metod:
  1. _sessionLogger.debug(komunikat)
  2. _sessionLogger.info(komunikat)
  3. _sessionLogger.error(komunikat)
  4. _sessionLogger.warn(komunikat)

Podczas decydowania, jaki tekst należy wprowadzić jako komunikat w skrypcie, w celu utworzenia zrozumiałego komunikatu należy rozważyć użycie elementów wizualnego wywołania, takich jak inicjały lub imię użytkownika oraz zmiennych z szablonu.

_sessionUtils Na karcie Wyrażenie skryptu można użyć tej zmiennej w celu uruchomienia funkcji w skrypcie o nazwie tidyXHTML. Ta zmienna jest przydatna w przypadku występowania w dokumencie wyjściowym bloków białych znaków, które powstają w wyniku niewłaściwego kodowania XHTML. Za pomocą zmiennej _sessionUtils argument łańcucha jest przetwarzany, a kod XHTML jest czyszczony, dzięki czemu dodatkowe białe znaki nie będą wyświetlane w danych wyjściowych.

Przykład: _sessionUtils.tidyXHTML(tekst);

Używając zmiennej _sessionUtils, należy również wybrać opcję Dane wejściowe XHTML i Dane wyjściowe XHTML na karcie Wyrażenie skryptu.
Uwaga: Istnieje możliwość ładowania szablonów zawierających tę zmienną do wcześniejszych wersji produktu Rational Publishing Engine, ale nie ma możliwości poprawnego wartościowania skryptów.

Opinia