Netgrif – konektor tiskových sestav
Naposledy aktualizováno
CDESK obsahuje několik přednastavených tiskových sestav, které se používají v různých modulech. Díky konektoru NETGRIF se však již nemusíte omezovat na přednastavené formuláře, ale můžete si pro požadavky, plnění, pracovní příkazy či protokoly evidence majetku vytvořit vlastní tiskové sestavy. Díky vysoké modularitě nástroje NETGRIF si navrhnete tiskový formulář, který splní i velmi specifické požadavky, protože může obsahovat pole z požadavků, plnění a konfigurační položky. Díky konektoru NETGRIF se tyto formuláře dostanou do systému CDESK.
Konfigurace vlastního tiskového formuláře začíná na straně NETGRIFu, kde se nastaví vzhled samotného tiskového formuláře. Následně je třeba nakonfigurovat workflow pro daný formulář. Nakonec se přímo v konektoru NETGRIF spárují pole tiskového reportu s poli vybraného modulu CDESK tak, aby se v polích tiskového reportu zobrazovaly požadované informace. Přesné postupy pro jednotlivé kroky jsou popsány v této příručce.
Jedním z nejčastějších použití konektoru NETGRIF jsou servisní protokoly, které technik generuje na základě požadavku ve webovém rozhraní i v mobilní aplikaci. Postup jejich nastavení je popsán v části dokumentace Konfigurace servisních protokolů.
Nastavení podkladu pro tiskový report na straně NETGRIFu
Přístup k šabloně tiskového sestavení
Při vytváření vlastního tiskového sestavení je třeba nejprve navrhnout jeho vzhled v NETGRIFu. Za tímto účelem přejděte na následující odkaz. Po otevření odkazu se zobrazí nástroj NETGRIF pro konfiguraci formuláře.
Na této stránce je možné vytvořit tiskový výpis zcela od začátku nebo vycházet z předem připravených šablon. Pro zjednodušení práce jsme pro vás připravili šablony, které si můžete stáhnout na následujícím odkazu.
Po stažení souborů je nahrajte do nástroje NETGRIF pomocí ikony pro nahrávání souborů XML. Po kliknutí na ikonu se zobrazí průzkumník pro výběr souboru z počítače.
Po nahrání souboru se ve formuláři zobrazí dvě ikony čtverců představující obrazovku formuláře. Pod těmito ikonami se zobrazí formulář, který bude navržen. V prvním kroku nejprve klikněte pravým tlačítkem myši na ikonu s názvem t1 a vyberte možnost + Create new form.
Po kliknutí se zobrazí mapa s mřížkou. Počet sloupců v této mřížce definuje množství polí, která lze umístit vedle sebe. Ve výchozím nastavení je nastavena hodnota 8, takže v takovém případě lze vedle sebe umístit 8 různých polí. Jednotlivá pole však mohou procházet přes více sloupců. Počet sloupců lze změnit pomocí pole Number of Columns. Počet sloupců v mřížce však neurčuje konečnou šířku tiskové sestavy. Ta bude ve výsledku vždy stejná, což je šířka stránky A4. Množství sloupců pouze určuje, kolik polí bude možné v tiskové sestavě umístit vedle sebe.
Přidání polí do tiskového sestavení
Chcete-li přidat libovolný typ pole, klikněte na možnost Create new fields, která se nachází na levé straně. Následně se zobrazí nabídky pro různé typy polí. Chcete-li přidat textové pole, klikněte na možnost Text a následně vyberte Simple, což označuje jednoduché textové pole. Po kliknutí se textové pole automaticky umístí do levého horního rohu mřížky, odkud jej můžete přesunout na libovolné místo v mřížce. Případně je možné pole umístit přímo na požadované místo tak, že jej uchopíte v nabídce na levé straně a pomocí Drag&Drop přesunete na požadované místo.
Rozměry přidaného pole lze měnit tažením za jeho okraje. Rozměry lze měnit jak ve vodorovném, tak ve svislém směru. Maximální šířka pole je dána počtem sloupců v mřížce. Maximální výška pole není omezena. Pole lze po mřížce přesouvat pomocí ikony , která se zobrazuje v pravém horním rohu pole. Pro smazání pole klikněte na ikonu
.
Konfigurace vlastností polí v tiskovém sestavení
Po kliknutí na pole umístěné v mřížce se v pravé části okna zobrazí parametry daného pole. Jedná se o následující nastavení:
- Id – Doporučujeme změnit výchozí hodnotu, abyste mohli pole později identifikovat při párování s poli CDESK a také aby se pole odlišilo od ostatních polí v mřížce. Název doporučujeme zadat malými písmeny.
- Chování – pro potřeby tiskového výstupu CDESK budou důležité tyto možnosti:
- Editable – používá se pro pole, do kterého se bude vyplňovat hodnota z CDESK.
- Visible – do pole nebude předvyplněna žádná hodnota. Toto nastavení se použije, pokud se v daném poli má zobrazovat například logo nebo neměnný text.
- Title – popis pole, které se zobrazí v tiskovém sestavení
- Description – popis pole, které se zobrazuje v mřížce při konfiguraci tiskového sestavení. Popis slouží k identifikaci pole v rámci mřížky.
- Initial value – zadá se text, který se má v daném poli trvale zobrazovat. Používá se, pokud je pole nastaveno jako Editable.
Přidání podformuláře
V případě, že má tiskový report obsahovat více záznamů o modulech navázaných na původní modul, ze kterého se tiskový report vytváří, použije se podformulář. Jedná se například o případy, kdy má tiskový report obsahovat výpis všech položek CI navázaných na požadavek nebo výpis všech plnění k požadavku. Podformulář se konfiguruje stejným způsobem jako hlavní formulář pro tiskový report. Následně je v tomto formuláři nutné přidat Task ref → Simple, na místo, kde se mají zobrazovat pole podformuláře.
Vložení obrázku
Pokud chceme do formuláře vložit vlastní logo/obrázek, postupujeme následovně:
- Do formuláře přidáme pole HTML Editor a nastavíme jej na visible
Dále vyhledáme požadovaný obrázek a zakódujeme jej do formátu base64; k tomuto kroku lze například použít webovou stránku base64-image.de.
Jakmile máme zkopírovaný text v kódování base64 (formát by měl být data:image/png;base64…), vrátíme se zpět do nástroje NetGrif Builder. V poli HTML editoru nastavíme pole Initial value následovně:
- <img src="BASE64">, kde „base64“ představuje zkopírovaná data obrázku, který jsme v předchozím kroku zakódovali
Nastavení zaškrtávacího políčka (Checkbox)
Pro nastavení zaškrtávacího políčka vytvoříme ve formuláři jednoduché textové pole. Následně v CDESK při přiřazování polí formuláře odešleme do jednoduchého textového pole hodnotu uživatelského pole, které je v CDESK ve formě zaškrtávacího políčka.
Pokud chceme, aby se zobrazovaly i prázdné zaškrtávací políčka, musíme v konfiguraci konektoru zaškrtnout políčko „Zobrazit i prázdná zaškrtávací políčka“.
Nastavení související s generováním formuláře
Po nastavení jednotlivých polí v hlavním formuláři i podformuláři přejděte do formuláře pro hlavní tiskový report a klikněte na tlačítko Back. Následně klikněte pravým tlačítkem myši na tlačítko Generate a vyberte možnost Edit action. Následně je nutné upravit následující nastavení:
Dataref button_html
Pod možností Post by se mělo nacházet nastavení:
textField: f.text_html_output,
style: f.text_style;
def transitionId = „t1“;
formToHtmlTable(textField, transitionId, style)
Dataref button_pdf
Pod položkou „Publikovat“ by se mělo nacházet nastavení:
html_text_output: f.text_html_output,
file_pdf_output: f.file_pdf_output;
dynamicHtmlToPdf(html_text_output, "t1", file_pdf_output)
Dataref button_add_subform_1
Pod možností Post by se mělo nacházet nastavení:
taskRef_subform: f.taskRef_subform;
def cnt = findCases({it.processIdentifier.eq(„FULLFILMENT_SUBFORM“)}).size();
def newCase = createCase(„FULLFILMENT_SUBFORM“, „Subform“ + cnt.toString());
def newTask = findTask{(it.caseId.eq( newCase.stringId)).and(it.transitionId.eq(„t1“))};
def taskList = taskRef_subform.value + newTask.stringId;
change taskRef_subform value { taskList }
Po provedení těchto změn exportujte XML soubor formuláře i podformuláře.
Konfigurace pracovního postupu
Na stránkách autoforms.cdesk.io daný soubor nahrajete. Pokud je součástí podformulář, je nutné nahrát i ten.
Následně v sekci Všechny příklady a úkoly přidejte nahraný soubor XML.
Po přidání souboru je třeba k formuláři přiřadit soubory ve formátu PDF a HTML a podformulář.
Po jejich přiřazení je možné zkontrolovat náhled formuláře. Pokud je formulář správně nastaven, lze jej propojit se systémem CDESK.
Změna vizuální části formuláře
Celý vytvořený formulář je sestaven z HTML kódu, který se generuje na základě .xml dokumentu. K úpravě stylu dokumentu a jeho konkrétních prvků proto můžeme použít CSS.
Změna stylu na autoforms.cdesk.io
Jelikož je celý formulář HTML tabulkou, můžeme změnit její styl použitím CSS na její určité prvky. Nejprve doporučujeme vyzkoušet nastavení požadovaného stylu na stránce autoforms.cdesk.io, kde k tomu můžete použít příslušné textové pole (spodní). Po přepsání CSS je nutné ještě jednou stisknout tlačítka HTML a PDF.
Pro inspiraci si můžete prohlédnout další návod: https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Styling_tables
Obrázek níže obsahuje předvyplněný příklad použití CSS na HTML tabulku a její obsah.
Statické změny stylu prvků formuláře
Určité změny stylu konkrétního prvku lze provést přímo při jeho vytvoření v Netgrifu tak, že jeho obsah obalíme do příslušné HTML značky. Například můžeme text obalit značkami <B></B>, což odpovídá tučnému textu. Zároveň zde lze definovat i jeho styl, například <P style="color:red;">Červený text</P> by měl změnit barvu textu na červenou.
Takto aplikované styly konkrétních prvků není nutné opakovaně definovat nikde jinde.
Důležitá poznámka: statické změny stylu se týkají POUZE prvků, jejichž hodnota se nebude měnit, tedy „viditelných“ prvků formuláře. Pokud se předpokládá, že místo prvku bude načtena hodnota z CDESK, bude hodnota tohoto pole přepsána spolu s předdefinovaným stylem!
Uložení stylu CSS pro generované formuláře
Konečnou verzi CSS stylu formuláře je nutné uložit do Generate → Edit form → oblast pro CSS. Pokud sem CSS nevložíte, nebude ani ve výsledném souboru .xml, a proto se neuplatní na formuláře generované v CDESK a autoforms!
Přidání konektoru Netgrif do CDESK
Chcete-li do systému CDESK přidat konektor Netgrif, přejděte do Globální nastavení → Konektory, API a klikněte na tlačítko +Přidat konektor. Po kliknutí se zobrazí okno s výběrem typu konektoru. Vyberte možnost Vlastní sestavy pro NETGRIF. Pro pokračování klikněte na tlačítko Pokračovat.
Následně se zobrazí formulář pro konfiguraci konektoru, který obsahuje níže uvedená pole. Povinná pole je nutné vyplnit, jinak nelze konektor uložit. Některá pole se zobrazují pouze při určitém nastavení jiných polí – tato podmínka je uvedena u každého z nich.
- Typ konektoru – toto pole nelze měnit. Typ se vybírá při vytváření konektoru.
- Název – zadejte název, pod kterým se tento konektor bude zobrazovat v seznamu konektorů. Pokud není vyplněno pole Název tlačítka pro spuštění generování, použije se název konektoru také jako text tlačítka, které se zobrazí v detailu záznamu a slouží k vytvoření tiskového výstupu.
- Zapnuto – konektor je aktivní pouze v případě, že je zapnutý. Tlačítko pro vytvoření tiskového výstupu se zobrazuje pouze u zapnutého konektoru.
- Název tlačítka pro spuštění generování – text tlačítka, kterým se tiskový výpis vytváří ve webovém rozhraní i v mobilní aplikaci, například Generovat protokol. Pokud pole zůstane prázdné, na tlačítku se zobrazí název konektoru. Pokud se pro stejný záznam používá více konektorů, zobrazí se více tlačítek. Z tohoto důvodu je vhodné je pojmenovat tak, aby bylo možné je od sebe odlišit.
- Místo použití – určuje, v kterém modulu se bude zobrazovat tlačítko pro vytvoření tiskové sestavy. CDESK v aktuální verzi nabízí na výběr tyto možnosti.
- Požadavky
- Požadavky vytvořené ze zvolené šablony – pouze požadavky vytvořené ze šablony vybrané v poli Šablona požadavku
- Plnění
- Požadavky a plnění
- Požadavky typu Servis zařízení
- Protokoly evidence majetku
- Šablona požadavku – zobrazuje se pouze v případě použití „Požadavky vytvořené z vybrané šablony“. Určuje šablonu, ze které musí být požadavek vytvořen, aby se v ní zobrazilo tlačítko pro vytvoření tiskového výstupu.
- URL – URL stránky, na které byl nakonfigurován pracovní postup tiskového výstupu. V tomto případě se jedná o autoforms.cdesk.io, což je zároveň výchozí hodnota pole.
- Přihlašovací jméno – přihlašovací jméno používané k přihlášení na autoforms.cdesk.io
- Heslo – heslo používané k přihlášení na autoforms.cdesk.io
- Identifikace formuláře – na stránce builder.netgrif.com klikněte pravým tlačítkem myši mimo políčka t1 a Generate a vyberte možnost Configure Model. V pravém panelu se zobrazí okno, ve kterém se nachází možnost Identifier. Do pole Identifikace formuláře zadejte hodnotu z pole Identifier. Na jednom serveru a pod jedním přihlašovacím jménem může být uloženo více formulářů. Toto pole určuje, který z nich konektor použije.
- Multiplikovat podformulář podle počtu – určuje, podle čeho se podformulář v tiskovém sestavení opakuje. Pokud formulář podformulář neobsahuje, ponechte možnost Bez podformuláře. Další možnosti jsou:
- Plnění – podformulář se opakuje pro každé plnění
- Objektů CI – podformulář se opakuje pro každý objekt CI
- Uživatelem definovaných polí CI objektu – počet opakování se určí podle vybraného uživatelsky definovaného pole CI objektu, které se zvolí v poli Zákaznické pole CI pro vyhodnocení násobení
- Záložky uživatelsky definovaných polí CI objektu – podformulář se opakuje pro každou záložku uživatelsky definovaných polí CI objektu
- Počet položek protokolu – podformulář se opakuje pro každou položku protokolu Evidence majetku
- Uživatelem definovaných polí plnění – počet opakování se určí podle vybraného uživatelsky definovaného pole plnění, které se zvolí v poli „Zákaznické pole plnění“ pro vyhodnocení násobení
- Umístění souboru PDF – místo, kam bude uložen vygenerovaný výsledný tiskový výpis. Je možné vybrat více možností najednou: Příloha požadavku, Příloha plnění, Příloha připojeného objektu CI a Nabídnout ke stažení.
- Vygenerovat pro každou položku CI v požadavku samostatný report – zobrazuje se pouze v případě, že je jako místo použití zvoleno „Požadavky“ nebo „Požadavky vytvořené ze zvolené šablony“ a zároveň je jako místo uložení zvoleno „Příloha požadavku“. Je-li tato možnost zapnutá a požadavek se týká více položek CI, vygeneruje se samostatný výpis pro každou z nich.
- Zahrnout do reportu pouze plnění vázaná na danou CI – zobrazuje se pouze při zapnutém předchozím přepínači. Je-li tato možnost zapnutá, do sestavy konkrétní položky CI se dostanou pouze plnění přímo vázaná na tuto položku CI. Plnění bez vazby na CI nebo s vazbou na jiné CI se v sestavě nezobrazí.
- Použít v reportu hodnoty ze servisního záznamu – určuje, odkud tiskový report čerpá údaje o CI. Pole se zobrazuje vždy.
- Vypnuto – sestava čerpá aktuální hodnoty ze všech CI v požadavku.
- Zapnuto – sestava čerpá hodnoty polí CI ze servisního záznamu, tedy ze stavu zařízení v době vytvoření nebo poslední aktualizace záznamu, a nikoli aktuální hodnoty CI. Při generování ze žádosti zpracovává pouze ty CI, které mají k žádosti aktivní servisní záznam; ostatní CI jsou vynechány. Do sestavy budou zahrnuty pouze plnění zařazená v servisním záznamu a při párování polí se zpřístupní vlastnosti CDESK Servisní záznam → Podpis zákazníka.
Tlačítko Generovat protokol přímo v servisním záznamu se zobrazí pouze v případě, že je toto pole zapnuto; zapnuta jsou také pole Generovat pro každou položku CI v požadavku samostatný report a Do reportu zahrnout pouze plnění vázaná na danou CI, místem použití jsou „Požadavky“ nebo „Požadavky vytvořené z vybrané šablony“ a v poli „Umístění souboru PDF“ je vybrána možnost „Příloha servisního záznamu“.
- Vlastní styly – pokročilé nastavení stylů opakujících se řádků podformuláře a zápatí tiskového výstupu. Zde se zapisuje šablona se speciálními značkami. Doplňuje styl CSS uložený ve formuláři, který je popsán v kapitole Změna vizuální části formuláře. Při běžném použití zůstává pole prázdné.
- Zobrazit i prázdná zaškrtávací políčka – je-li tato možnost zapnutá, nezatržená zaškrtávací políčka se v tiskovém výstupu zobrazí jako prázdná políčka. Postup je popsán v kapitole Nastavení zaškrtávacího políčka (Checkbox).
- Zahrnout do dat interní plnění – zobrazí se pouze v případě, že jsou v nastaveních plnění zapnuta interní plnění. Je-li tato možnost zapnutá, do údajů tiskového výstupu se zahrnou i interní plnění.
- Deduplikace plnění – zobrazuje se na místech použití Požadavky, Požadavky a plnění, Požadavky vytvořené z vybrané šablony a Požadavky typu Servis zařízení. Je-li tato funkce zapnutá, duplicitní plnění se shodným popisem i časovým rozmezím „od–do“ se do sestavy zahrnou pouze jednou. V případě více shodných plnění se použije plnění od řešitele požadavku. Pokud mezi nimi není, použije se plnění s nejnižším ID.
Po nastavení těchto vlastností klikněte na tlačítko „Aktualizovat konfiguraci reportu“, čímž konektor uloží a načte pole formuláře z NETGRIF, aby je bylo možné přiřadit k polím CDESK.
Každý řádek přiřazení odpovídá jednomu poli formuláře a obsahuje tyto sloupce:
- Pole formuláře – název pole tak, jak je pojmenováno ve formuláři v NETGRIF.
- Vlastnosti CDESK – údaj z CDESK, který se do pole zapíše. Nabídka údajů závisí na nastaveném místě použití a zohledňuje také zvolenou šablonu požadavku.
- Sloučení vlastností – pokud se do jednoho pole dostane více hodnot, například z více plnění, zobrazí se pod sebou. Je-li tato možnost vypnutá, v poli zůstane pouze jedna hodnota. U údajů, které nelze sloučit, je přepínač neaktivní.
- Přidat popis vlastnosti k hodnotě – k hodnotě uživatelsky definovaného pole se připojí jeho popis.
- Je-li hodnota prázdná, použít výchozí hodnotu z formuláře – pokud není údaj v CDESK vyplněn, do pole se zapíše hodnota Initial value nastavená ve formuláři v NETGRIF.
Pokud formulář obsahuje podformulář, pod hlavními poli se zobrazí také část „Přiřazení polí podformuláře ke stejným sloupcům“. Dojde-li ke změně formuláře v NETGRIF, je nutné pole znovu načíst kliknutím na tlačítko „Aktualizovat konfiguraci reportu“.
Do tiskového sestavení lze vložit například následující pole CDESK. Nabídka se liší podle nastaveného místa použití:
- Dodavatel – Název a adresa společnosti
- Číslo požadavku
- Číslo zakázky
- Datum vytvoření požadavku
- Typ požadavku
- Oblast služby požadavku
- Popis požadavku
- Společnost
- Adresa společnosti
- Text prvního plnění
- Použitý materiál
- První plnění – Řešitel
- Řešitel plnění
- Poslední plnění – Řešitel
- Datum plnění
- Začátek plnění
- Konec plnění
- První plnění – doprava
- Plnění – doprava
- Poslední plnění – doprava
- Plnění – podpis řešitele
- CI – název hlavní skupiny
- CI – název typu
- CI – provozovna
- CI – místo
- CI – název
- CI – popis
- CI – stav
- CI – vlastník
- Doplňkové vlastnosti nakonfigurované pro požadavky
- Doplňkové vlastnosti nakonfigurované pro plnění
- Doplňkové vlastnosti nakonfigurované pro položky (CI)
- Přihlášený uživatel – jméno a podpis
Po přiřazení všech polí uložte nastavení pomocí tlačítka Uložit. Po uložení bude možné daný tiskový report vyvolat v modulu, který je vybrán v poli Místo použití. Je-li jako místo použití vybráno například Požadavek, pod tlačítkem Akce se zobrazí tlačítko s názvem, který je nastaven v konektoru v poli Název tlačítka pro spuštění generování, případně v poli Název, pokud název tlačítka není vyplněn. V mobilní aplikaci se tlačítko zobrazí v detailu požadavku v části Servisní protokoly.
Byla tato stránka užitečná?
Děkujeme za zpětnou vazbu.