CDESK v sebe obsahuje niekoľko predvolených tlačových zostav, ktoré sa používajú v rôznych moduloch. Vďaka NETGRIF konektoru sa ale už nemusíte obmedzovať na predvolené formuláre, ale pre požiadavky, plnenia a ponuky si môžete vytvoriť vlastné tlačové zostavy. Vďaka vysokej modularite nástroju NETGRIF si navrhnete tlačovú zostavu, ktorá bude spĺňať aj veľmi špecifické požiadavky, pretože môže obsahovať polia z požiadaviek, plnení a konfiguračných položiek. Vďaka NETGRIF konektoru tieto formuláre dostanete do CDESKu.
Konfigurácia vlastnej tlačovej zostavy začína na strane NETGRIFu, kde sa nakonfiguruje výzor samotnej tlačovej zostavy. Následne je potrebné nakonfigurovať workflow pre danú zostavu. Napokon sa priamo v NETGRIF konektore párujú polia tlačovej zostavy s poľami vybraného CDESK modulu, tak aby sa v poliach tlačovej zostavy zobrazovali požadované informácie. Presné postupy k jednotlivým krokom sú popísané v tomto manuály.
Konfigurácia podkladu pre tlačovú zostavu na strane NETGRIFu
Prístup k šablóne tlačovej zostavy
Pri tvorbe vlastnej tlačovej zostavy je potrebné začať na jej navrhnutím v NETGRIFe. Za týmto účelom prejdite na nasledovný odkaz. Po otvorení odkazu sa zobrazí NETGRIF nástroj na konfiguráciu formuláru.
Na tejto stránke je možné vytvoriť tlačovú zostavu úplne od začiatku alebo sa môže vychádzať z predpripravených šablón. Pre zjednodušenie práce sme pre vás pripravili šablóny, ktoré si môžete stiahnuť na nasledujúcom odkaze.
Potom ako si súbory stiahnete, nahrajte ich do NETGRIF nástroju pomocou ikony pre nahratie XML súborov. Po kliknutí na ikonu sa zobrazí prieskumník pre výber súboru z počítača.
Keď sa súbor nahrá, vo formulári sa zobrazia dve ikony štvorčekov reprezentujúce formulárovú obrazovku. Pod danými ikonami sa zobrazuje formulár, ktorý bude navrhnutý. V prvom kroku najprv pravým tlačidlom myši kliknite na ikonu s názvom t1 a vyberte možnosť + Create new form.
Po kliknutí sa zobrazí mapa s mriežkou. Počet stĺpcov v tejto mriežke definuje množstvo polí, ktoré je možné umiestniť vedľa seba. Predvolene je nastavená hodnota 8, čiže v takom prípade je možné vedľa seba umiestniť 8 rôznych polí. Jednotlivé polia ale môžu prechádzať cez viacero stĺpcov. Počet stĺpcov je možné zmeniť pomocou poľa Number of Columns. Počet stĺpcov v mriežke ale neurčuje konečnú šírku tlačovej zostavy. Tá bude vo výsledku vždy rovnaká, čo je šírka strany A4. Množstvo stĺpcov len určuje, koľko polí bude možné v tlačovej zostave umiestniť vedľa seba.
Pridanie polí do tlačovej zostavy
Pre pridanie ľubovoľného typu poľa kliknite na možnosť Create new fields, ktorá sa nachádza na ľavej strane. Následne sa zobrazia ponuky pre rôzne typy polí. Pre pridanie textového poľa kliknite na možnosť Text a následne vyberte Simple, čo označuje jednoduché textové pole. Po kliknutí sa textové pole automaticky umiestni do ľavého horného rohu mriežky, odkiaľ ho môžete presunúť na ľubovoľné miesto v mriežke. Prípadne je možné pole rovno umiestniť na požadované miesto jeho uchopením v ponuke na ľavej strane a pomocou Drag&Drop sa premiestni na požadované miesto.
Rozmer pridaného poľa je možné meniť ťahaním za jeho okraje. Rozmer sa môže meniť v horizontálnom aj vertikálnom smere. Maximálna šírka poľa je určená počtom stĺpcov v mriežke. Maximálna výška poľa nie je obmedzená. Pole je možné po mriežke presúvať pomocou ikony 
Konfigurácia vlastností polí v tlačovej zostave
Po kliknutí na pole, ktoré je umiestnené v mriežke, sa v pravej časti okna zobrazia parametre daného poľa. Ide o nasledovné nastavenia:
- Id – Predvolenú hodnotu odporúčame zmeniť, aby ste pole neskôr vedeli identifikovať pri párovaní s CDESK poľami a taktiež aby pole bolo odlíšené od zvyšných polí v mriežke. Názov odporúčame zadať malými písmenami.
- Behavior – pre potreby CDESK tlačovej zostavy budú dôležité tieto možnosti:
- Editable – používa sa na pole, ktoré sa bude vypĺňať parameter z CDESKu.
- Visible – do poľa sa nebude predvypĺňať žiadna hodnota. Toto nastavenie sa použije, ak sa v danom polí má zobrazovať napríklad logo, alebo nemenný text.
- Title – popis poľa, ktorý sa zobrazí v tlačovej zostave
- Description – popis poľa, ktorý sa zobrazuje v mriežke pri konfigurácii tlačovej zostavy. Popis slúži na identifikáciu poľa v rámci mriežky.
- Initial value – zadá sa text, ktorý sa má zobrazovať v danom poli permanentne. Používa sa ak pole je nastavené ako Editable.
Pridanie subformulára
V prípade, že tlačová zostava má obsahovať viacero záznamov o naviazaných moduloch k pôvodnému modulu, z ktorého sa vytvára tlačová zostava, použije sa subformulár. Ide napríklad o prípady, kedy tlačová zostava má obsahovať výpis všetkých CI položiek naviazaných na požiadavku, alebo výpis všetkých plnení na požiadavke. Subformulár sa nakonfiguruje rovnakým spôsobom ako hlavný formulár pre tlačovú zostavu. Následne v tomto formulári je potrebné pridať Task ref → Simple, na miesto, kde sa majú zobrazovať polia subformulára.
Pridanie obrázku
V prípade že chceme vložiť vlastné logo/obrázok do formuláru postupujeme nasledovne:
- Vo formulári pridáme pole HTML Editor a nastavíme ho na visible
Ďalej si nájdeme požadovaný obrázok a enkódujeme ho do formátu base64, na tento krok je možné použiť napríklad webstránku base64-image.de.
Keď máme skopírovaný base64 text (formát by mal byť data:image/png;base64…) prejdeme naspäť do netgrif builderu. V HTML editor poli nastavíme pole Initial value naslednovne:
- <img src=“BASE64″> kde base64 sú skopírované dáta obrázku, ktorý sme v predošlom kroku enkódovali
Nastavenie zaškrtávacieho políčka (Checkbox)
Pre nastavenie checkboxu, vytvoríme vo formulári jednoduché textové pole. Následne v CDESK pri párovaní polí formuláru, zašleme do jednoduchého textového poľa hodnotu používateľského poľa, ktorá je v CDESK vo forme checkboxu.
Pokiaľ chceme aby sa zobrazovali aj prázdne checkboxy, musíme v konfigurácií konektora zaškrtnúť pole „Zobraziť aj prázdne checkboxy“.
Nastavenia spojené s generovaním formulára
Po nastavení jednotlivých polí v hlavnom formulári ale aj subformulári, prejdite do formulára pre hlavnú tlačovú zostavu a kliknite na tlačidlo Back. Následne pravým tlačidlom myši kliknite na tlačidlo Generate a vyberte možnosť Edit action. Následne je potrebné upraviť nasledujúce nastavenia:
Dataref button_html
Pod možnosťou Post sa má nachádzať nastavenie:
textField: f.text_html_output,
style: f.text_style;
def transitionId = „t1“;
formToHtmlTable(textField, transitionId, style)
Dataref button_pdf
Pod možnosťou Post sa má nachádzať nastavenie:
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žnosťou Post sa má nachádzať nastavenie:
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 vykonaní týchto zmien exportujte XML súbor formulára a rovnako tak aj subformulára.
Konfigurácia workflow
Na stránke autoforms.cdesk.io sa daný súbor nahráte. Ak je zahrnutý subformulár, je potrebné nahrať aj ten.
Následne v časti Všetky prípady a úlohy pridajte nahraný XML súbor.
Po pridaní súboru je potrebné formuláru priradiť pdf, HTML a subformulár.
Po ich priradení je možné skontrolovať náhľad formulára. Ak je formulár správne nastavený, môže sa spárovať so systémom CDESK.
Zmena vizuálnej časti formulára
Celý vytvorený formulár je vytváraný z HTML kódu, ktorý sa generuje na základe .xml dokumentu. Preto pre zmenu štýlu dokumentu a konkrétnych jeho prvkov vieme použiť CSS.
Zmena štýlu v autoforms.cdesk.io
Keďže celý formulár je HTML tabuľkou, zmeniť jej štýl vieme aplikovaním CSS na jej isté prvky. Najprv sa odporúča vyskúšať nastaviť potrebný štýl na stránke autoforms.cdesk.io, kde si viete na to použiť príslušnú textovú oblasť (dolná). Po prepísaní CSS je nutné ešte raz stlačiť HTML a PDF tlačidlá.
Pre inšpiráciu si môžete pozrieť ďalší návod: https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Styling_tables
Obrázok dole obsahuje predvyplnený príklad aplikovania CSS ku HTML tabuľke a jej obsahu.
Statické zmeny štýlu prvkov formulára
Isté zmeny štýlu konkrétneho prvku je možné aplikovať priamo pri jeho vytvorení v Netgrif, zabalením jeho obsahu do potrebného HTML tagu. Napríklad vieme zabaliť text do <b><\b> čo bude zodpovedať tučnému textu. Zároveň tu sa dá zadefinovať aj jeho štýl, napríklad <p style=“color:red;“>Červený text<\p> by mal zmeniť farbu textu na červenú.
Takto aplikované štýly konkrétnych prvkov nie je potrebné opakovane definovať nikde inde.
Dôležitá poznámka: statické zmeny štýlu sa týkajú LEN prvkov ktorých hodnota sa nebude meniť, teda “visible” prvky formulára. Ak je predpokladané že namiesto prvku sa bude doťahovať hodnota z CDESK, tak hodnota tohto poľa sa prepíše spolu s preddefinovaným štýlom!
Uloženie štýlu CSS pre generované formuláre
Finálnu verziu CSS štýlu formulára je nutné uložiť do Generate → Edit form → oblasť pre CSS. Ak CSS nebude vložené sem, tak nebude aj vo výslednom .xml, preto sa neaplikuje na generované v CDESK a autoforms formuláre!
Pridanie Netgrif konektora do CDESK
Pre pridanie Netgrif konektora do systému CDESK, prejdite do Globálne nastavenia → Konektrory, API a kliknite na tlačidlo +Pridať konektor. Po kliknutí sa zobrazí okno s výberom typu konektora. Zvoľte možnosť NETGRIF. Pre pokračovanie kliknite na tlačidlo Pokračovať.
Následne sa zobrazí formulár pre konfiguráciu konektora, ktorý obsahuje tieto polia:
- Typ konektora – pole je read only
- Názov – zadajte názov, pod ktorým sa tento konektor bude zobrazovať v zozname konektorov. Okrem identifikácie v zozname, názov bude použitý aj na pomenovanie tlačidla, ktoré sa zobrazí v detaile Požiadavky alebo Plnenia (závisí od nastavenia konektora) a slúži priamo na vytvorenie konkrétnej tlačovej zostavy.
- Zapnuté – konektor je aktívny, len ak je zapnutý
- Miesto použitia – určuje, v ktorom module sa bude zobrazovať tlačidlo pre vytvorenie tlačovej zostavy. CDESK v aktuálnej verzii ponúka na výber tieto možnosti.
- Požiadavky
- Požiadavky vytvorené zo zvolenej šablóny
- Plnenia
- Požiadavky a plnenia
- URL – URL stránky, kde bolo konfigurované workflow tlačovej zostavy. V tomto prípade ide o autoforms.cdesk.io
- Prihlasovacie meno – prihlasovacie meno používané na prihlásenie do autoforms.cdesk.io
- Heslo – heslo používané na prihlásenie do autoforms.cdesk.io
- Identifikácia siete – v builder.netgrif.com kliknite pravým tlačidlom myši mimo štvorčekov t1 a Generate a vyberte možnosť Configurate Model. Na pravej lište sa zobrazí okno, v ktorom sa nachádza možnosť Identifier. V poli Identifikácia siete zadajte hodnotu z poľa Identifier.
- Miesto uloženia pdf – miesto, kde bude uložená vygenerovaná výsledná tlačová zostava.
Po konfigurácii týchto vlastností kliknite na tlačidlo Znovu načítať polia reportu, aby sa naparovali polia z Ntgrif s CDESK poľami.
Do tlačovej zostavy je možné vložiť nasledujúce CDESK polia:
- Dodávateľ – Názov a adresa spoločnosti
- Číslo požiadavky
- Číslo zákazky
- Dátum vytvorenia požiadavky
- Číslo požiadavky
- Typ požiadavky
- Oblasť služby požiadavky
- Popis požiadavky
- Spoločnosť
- Adresa spoločnosti
- Text prvého plnenia
- Použitý materiál
- Prvé plnenie – Riešiteľ
- Riešiteľ plnenia
- Posledné plnenie – Riešiteľ
- Dátum plnenia
- Začiatok plnenia
- Koniec plnenia
- Prvé plnenie – doprava
- Plnenie – doprava
- Posledné plnenie – doprava
- Plnenie – podpis riešiteľa
- CI – názov maingrupy
- CI – názov typu
- CI – prevádzka
- CI – miesto
- CI – názov
- CI – popis
- CI – stav
- CI – vlastník
- Doplnkové vlastnosti nakonfigurované pre požiadavky
- Doplnkové vlastnosti nakonfigurované pre plnenia
- Doplnkové vlastnosti nakonfigurované pre CI položky
Po naparovaní všetkých polí uložte nastavenia pomocou tlačidla Uložiť. Po uložení bude možné vyvolať danú tlačovú zostavu v moduly, ktoré je vybrané v poli Miesto použitia. Ak je vybrané miesto použitia napríklad Požiadavky, pod tlačidlom Akcia sa zobrazí tlačidlo s názvom, ktorý je nastavený v konektore v poli Názov.
