Šablony tiskových sestav REP
Šablony tiskových sestav můžete spravovat v WebApp – Správa – Asset Management –
Šablony tiskových sestav. Každá šablona obsahuje několik souborů, které definují obsah a vzhled výsledné tiskové sestavy.
Výsledné tiskové sestavy se ze šablon generují takto:
- Poté, co uživatel v aplikaci ve stromu objektů vybere objekty, které chce vytisknout, aplikace vygeneruje pracovní XML soubor obsahující podrobnosti o vybraných objektech
dle nastavení v REP souboru.
- Pracovní XML soubor projde následně transformací podle souboru XSL, jejímž výsledkem je dokument ve formátu HTML. Tento HTML dokument může používat další soubory v šabloně,
jako soubory CSS, PNG, JPG apod.
- Obsah HTML dokumentu se zobrazí uživateli jako náhled na tiskovou sestavu.
- Po odsouhlasení náhledu uživatelem se HTML dokument převede do formátu PDF, ve kterém může být vytisknut a nebo uložen do evidence dokumentů.
Soubor REP
Soubor s příponou REP je textový soubor, který definuje výstupní
tiskovou sestavu.
Soubor obsahuje několik řádků ve formátu:
Proměnná=Hodnota
Např.:
VERSION=XMLReport1
| Proměnná |
Popis |
| VERSION |
Určuje verzi formátu tiskové sestavy. Tato proměnná musí
být uvedena na prvním řádku v souboru REP a musí mít hodnotu
XMLReport1. |
| TYPE |
Hodnota této proměnné určuje speciální postup při
generování XML souboru, který je zdrojem dat pro tiskovou
sestavu.
| Hodnota |
Popis |
| Null |
Při zadání implicitní hodnoty Null bude
XML soubor obsahovat pouze objekt (včetně
podřazených objektů), který je vybrán ve
stromu objektů při vytváření tiskové
sestavy. |
| Transfer Inner |
Tisková sestava typu "předávací protokol
vnitřní". |
| Transfer Inner Summary |
Tisková sestava typu "předávací protokol vnitřní souhrnný". Je možné ji použít pouze na objektu druhu Uživatel. |
| Transfer Outer |
Tisková sestava typu "předávací protokol
vnější". |
|
| SEQUENCE |
Název číselné řady, která bude použita pro generování
čísla dokumentu tiskové sestavy typu "Předávací protokol".
Např.: "Zápůjčky".
Pozn.: Pokud je hodnota prázdná, pro předávací protokoly
vnitřní se použije systémová řada „Předávací protokoly“. Pro
předávací protokoly vnější se nepoužije žádná řada.
|
| HTML |
Název souboru ve formátu HTML, který se použije jako
výchozí soubor pro zobrazení tiskové sestavy. Název souboru
je zadán relativní cestou k souboru REP. Je-li 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
seznam dále uvedených položek oddělených čárkou, např.
"FLAGS=children,ownprop,inheritedprop". Každá položka
seznamu povoluje zápis určité informace do XML souboru.
Seznam položek je uveden v následující tabulce:
| Položka |
Popis |
| notice |
poznámky k objektům (element <noticelist>),
pouze záznamy které nebyly v Deníku
odstraněny (skryty). |
| history |
historie objektů (element <historylist>),
pouze záznamy které nebyly v Deníku
odstraněny (skryty). |
| children |
podřazené objekty (element <nodelist>) |
| responsibility |
Pod objekty druhu Uživatel se vygenerují
nové podstromy. Obsahují objekty, které mají
ve vlastnosti „Za majetek zodpovídá“ hodnotu
daného objektu uživatele. |
| ownprop |
vlastní vlastnosti (element <prop> v <proplist>) |
| inheritedprop |
zděděné vlastnosti (element <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 údajů, atd.) |
|
Příklad obsahu souboru Evidenční karta.rep:
VERSION=XMLReport1
TYPE=Null
HTML=Evidenční karta.htm
FLAGS=children,ownprop,inheritedprop,notice
Soubor XML
V této kapitole je popsána struktura XML souboru, který je použit při
vytváření tiskové sestavy. Do souboru se zapíše obraz objektu (včetně
podřazených objektů), nad kterým se tisková sestava vytváří (tj. objektu,
který je vybrán ve stromu objektů). Které elementy budou v XML souboru
uvedeny, a které ne, záleží 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 elementů:
| Element |
Popis |
| node |
objekt |
| path |
cesta k objektu ve stromu objektů |
| prop |
vlastnost |
| notice |
poznámka k objektu |
| history |
záznam historie |
| nodelist |
seznam podřazených objektů |
Soubor HTML
Soubor REP dále obsahuje název HTML souboru tiskové sestavy, který je, po nahrazení maker, zobrazen v náhledu před tiskem. Tento soubor se používá pouze při tisku z AM Console.
V HTML souboru mohou být použita tato makra:
| Makro |
Popis |
| %HTMLPATH% |
Absolutní cesta k HTML souboru na pevném disku.
Např. je-li soubor stylů style.css uložen ve stejném
adresáři jako HTML soubor, může být pro jeho načtení použita
tato konstrukce:
<link rel="stylesheet" href="%HTMLPATH%\style.css"> |
| %XMLPATH_C% |
Název s cestou k pracovnímu XML souboru ve formátu pro
použití v javascriptu. |
Úprava HTML pro tisk z ALVAO WebApp
Všechny šablony tisknuty z ALVAO WebApp používají jednotné HTML, které je uloženo v databázi. Pro jeho úpravu je potřeba spustit následující SQL skript, který doplníte o požadované HTML:
update tProperty set sPropertyValue='<vlastní HTML>' where sProperty='AssetManagement.PrintTemplateHtml'
V html pro tiskovou sestavu pro web je nutné používat proměnné zapsány jako [$<název>$], které jsou při tisku nahrazeny přiloženými soubory 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 koncovkou (tedy *.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 (tedy logo.png).
Výjimku tvoří proměnná [$PrintTemplateName$], která je nahrazena položkou Název u tiskové sestavy.
Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.