Šablony tiskových sestav REP
Šablony tiskových sestav můžete spravovat v aplikaci WebApp - Administration - Asset Management - Print report templates. Každá šablona obsahuje několik souborů, které definují obsah a vzhled výsledné tiskové sestavy
Výsledné tiskové sestavy se ze šablon generují následujícím způsobem:
- Poté, co uživatel ve stromu objektů aplikace vybere objekty, které chce vytisknout, aplikace vygeneruje pracovní XML soubor obsahující podrobnosti o vybraných objektech podle nastavení v souboru REP.
- Pracovní soubor XML pak projde transformací XSL, jejímž výsledkem je dokument HTML. Tento dokument HTML může využívat další soubory v šabloně, například soubory CSS, PNG, JPG atd.
- Obsah dokumentu HTML se uživateli zobrazí jako náhled tiskové sestavy.
- Po schválení náhledu uživatelem se dokument HTML převede do formátu PDF, ve kterém jej lze vytisknout nebo uložit do úložiště dokumentů.
Soubor Rep
Soubor REP je textový soubor, který definuje výstupní tiskovou sestavu.
Soubor obsahuje několik řádků ve formátu:
Proměnná=Hodnota
Například:
VERSION=XMLReport1
Proměnná |
Popis |
VERSION |
Určuje verzi formátu tiskové sestavy. Tato proměnná musí být uvedena na prvním řádku souboru REP a musí mít hodnotu XMLReport1. |
TYPE |
Hodnota této proměnné určuje zvláštní postup pro generování souboru XML, který je zdrojem dat pro tiskovou sestavu.
Hodnota |
Popis |
Null |
Je-li zadána výchozí hodnota Null, bude XML soubor obsahovat pouze objekt (včetně podřízených objektů), který je vybrán ve stromu objektů při vytváření tiskové sestavy. |
Transfer Inner |
Tisková sestava typu "přenosová sestava vnitřní". |
Transfer Inner Summary |
Tisková sestava typu "interní souhrn předávacího protokolu". Lze použít pouze na objektu typu Uživatel. |
Transfer Outer |
Tisk sestavy typu "předávací protokol vnější". |
|
SEQUENCE |
Název číselné řady, která bude použita pro generování čísla dokladu tiskové sestavy typu "Přenosová zpráva". Například: "Výpůjčky".
Poznámka: Pokud je hodnota prázdná, bude pro interní předávací protokoly použita systémová řada "předávací protokoly". Pro externí předávací protokoly se nepoužívá žádná řada. |
HTML |
Název souboru HTML, který se použije jako výchozí soubor pro zobrazení tiskové sestavy. Název souboru se zadává relativně k cestě k souboru REP. Pokud je soubor HTML uložen ve stejném adresáři jako soubor REP, stačí zadat pouze název souboru. |
FLAGS |
Hodnotou může být prázdný řetězec (např. "FLAGS=") nebo čárkou oddělený seznam níže uvedených položek, např. "FLAGS=children,ownprop,inheritedprop". Každá položka seznamu umožňuje zapsat některé informace do souboru XML. Seznam položek je uveden v následující tabulce:
Položka |
Popis |
notice |
poznámky k objektům (prvek <noticelist>), pouze záznamy, které nebyly v deníku smazány (skryty). |
history |
historie objektů (element <historylist>), pouze záznamy, které nebyly smazány (skryty) v Journal. |
children |
Podřazené objekty (element <nodelist>) |
responsibility |
Nové podstromy se generují pod objekty typu Uživatel. Obsahují objekty, které mají ve vlastnosti "Odpovědnost za vlastnost" hodnotu objektu uživatel. |
ownprop |
vlastnost (element <prop> v <proplist>) |
inheritedprop |
zděděné vlastnosti (prvek <prop> v <proplist>) |
owninfo |
element <own>1</own> pro vlastní vlastnosti |
inhritedinfo |
element <iherited>1</inherited> pro zděděné vlastnosti |
specialinfo |
element <special>1</special> pro speciální vlastnosti (vlastnosti pro interní použití při vzdáleném sběru dat atd.) |
|
Příklad obsahu souboru Evidence Card.rep:
VERSION=XMLReport1
TYPE=Null
HTML=Evidence Card.ht
FLAGS=children,ownprop,inheritedprop,notice
Soubor XML
Tato kapitola popisuje strukturu souboru XML, který se používá při vytváření tiskové sestavy. Do souboru se zapisuje obraz objektu (včetně podřízených objektů), nad kterým se tisková sestava vytváří (tj. objektu, který je vybrán ve stromu objektů). Které prvky budou do souboru XML zahrnuty a které nikoli, závisí na nastavení položky FLAGS v souboru REP
Formát souboru XML (DTD):
<!ENTITY ONE "1">
<!ELEMENT report (node*)>
<!ELEMENT node (name, icon, proplist?, responsiblefor?, noticelist?, historylist?, nodelist?)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT path (#PCDATA)>
<!ELEMENT icon (#PCDATA)>
<!ELEMENT proplist (prop*)>
<!ELEMENT noticelist (notice*)>
<!ELEMENT historylist (history*)>
<!ELEMENT nodelist (node*)>
<!ELEMENT prop (value, kind, own?, inherited?, special?)>
<!ELEMENT value (#PCDATA)>
<!ELEMENT kind (#PCDATA)>
<!ELEMENT own (&ONE;)>
<!ELEMENT inherited (&ONE;)>
<!ELEMENT special (&ONE;)>
<!ELEMENT notice (date, desc, user)>
<!ELEMENT date (#PCDATA)>
<!ELEMENT desc (#PCDATA)>
<!ELEMENT user (#PCDATA)>
<!ELEMENT history (date, desc, user)>
Význam prvků:
Element |
Popis |
node |
objekt |
path |
cesta k objektu ve stromu objektů |
prop |
vlastnost |
notes |
poznámka k objektu |
history |
záznam historie |
nodelist |
seznam podřízených objektů |
Soubor HTML
Soubor REP obsahuje také název souboru HTML tiskové sestavy, který se po nahrazení maker zobrazí v náhledu před tiskem. Tento soubor se používá pouze při tisku z konzoly AM.
V souboru HTML lze použít následující makra:
Makra |
Popis |
%HTMLPATH% |
Absolutní cesta k souboru HTML na pevném disku.
Pokud je například soubor style.css uložen ve stejném adresáři jako soubor HTML, lze pro jeho načtení použít následující konstrukci:
<link rel="stylesheet" href="%HTMLPATH%\style.css"> |
%XMLPATH_C% |
Název s cestou k pracovnímu souboru XML ve formátu pro použití v javascriptu. |
Úprava HTML pro tisk z webové aplikace ALVAO
Všechny šablony vytištěné z aplikace ALVAO WebApp používají jednotné HTML, které je uloženo v databázi. Chcete-li jej upravit, musíte spustit následující SQL skript, který přidá požadované HTML:
update tProperty set sPropertyValue='<own HTML>' where sProperty='AssetManagement.PrintTemplateHtml'
V html pro tiskovou sestavu pro web je třeba použít proměnné zapsané jako [$<jméno>$], které jsou při tisku nahrazeny soubory připojenými k tiskové sestavě.
Pokud použitá proměnná neobsahuje tečku (např. "CSS" nebo "XSL"), použije se první soubor připojený k šabloně s danou příponou (tj. *.css nebo *.xsl). Pokud použitá proměnná obsahuje tečku (např. "logo.png"), použije se soubor připojený k šabloně s daným názvem (tj. logo.png).
Výjimkou je proměnná [$PrintTemplateName$], která je nahrazena proměnnou Name pro tiskovou sestavu.
Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.