Netgrif konektor tlačových zostáv
Naposledy aktualizované
CDESK v sebe obsahuje niekoľko predvolených tlačových zostáv, ktoré sa používajú v rôznych moduloch. Vďaka NETGRIF konektoru sa ale už nemusíte obmedzovať na predvolené formuláre, ale požiadavky, plnenia, pracovné príkazy či protokoly evidencie majetku si môžete vytvoriť vlastné tlačové zostavy. Vďaka vysokej modularite nástroja 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 CDESK.
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áli.
Jedným z najčastejších použití NETGRIF konektora sú servisné protokoly, ktoré technik generuje z požiadavky vo webovom rozhraní aj v mobilnej aplikácii. Postup ich nastavenia je opísaný v časti dokumentácie Konfigurácia servisných protokolov.
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ť 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ástroja 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 , ktorá sa zobrazuje v pravom hornom rohu poľa. Pre vymazanie poľa kliknite na ikonu
.
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 pre pole, do ktorého sa bude vypĺňať hodnota z CDESK.
- Visible – do poľa sa nebude predvypĺňať žiadna hodnota. Toto nastavenie sa použije, ak sa v danom poli 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 nasledovne:
- <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ácii 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 → Konektory, API a kliknite na tlačidlo +Pridať konektor. Po kliknutí sa zobrazí okno s výberom typu konektora. Zvoľte možnosť Vlastné zostavy pre NETGRIF. Pre pokračovanie kliknite na tlačidlo Pokračovať.
Následne sa zobrazí formulár pre konfiguráciu konektora, ktorý obsahuje nižšie uvedené polia. Povinné polia je potrebné vyplniť, inak konektor nie je možné uložiť. Niektoré polia sa zobrazujú len pri určitom nastavení iných polí – táto podmienka je uvedená pri každom z nich.
- Typ konektora – pole nie je možné meniť. Typ sa vyberá pri vytváraní konektora.
- Názov – zadajte názov, pod ktorým sa tento konektor bude zobrazovať v zozname konektorov. Ak nie je vyplnené pole Názov tlačidla pre spustenie generovania, názov konektora sa použije aj ako text tlačidla, ktoré sa zobrazí v detaile záznamu a slúži na vytvorenie tlačovej zostavy.
- Zapnuté – konektor je aktívny, len ak je zapnutý. Tlačidlo na vytvorenie tlačovej zostavy sa zobrazuje len pri zapnutom konektore.
- Názov tlačidla pre spustenie generovania – text tlačidla, ktorým sa tlačová zostava vytvára vo webovom rozhraní aj v mobilnej aplikácii, napríklad Generuj protokol. Ak pole zostane prázdne, na tlačidle sa zobrazí názov konektora. Ak sa pre ten istý záznam používa viacero konektorov, zobrazí sa viacero tlačidiel. Z tohto dôvodu je vhodné pomenovať ich tak, aby ich bolo možné odlíšiť.
- 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 – – len požiadavky vytvorené zo šablóny vybranej v poli Šablóna požiadavky
- Plnenia
- Požiadavky a Plnenia
- Požiadavky typu Servis zariadení
- Protokoly evidencie majetku
- Šablóna požiadavky – zobrazuje sa len pri mieste použitia Požiadavky vytvorené zo zvolenej šablóny. Určuje šablónu, z ktorej musí byť požiadavka vytvorená, aby sa v nej tlačidlo na vytvorenie tlačovej zostavy zobrazilo.
- URL – URL stránky, kde bolo konfigurované workflow tlačovej zostavy. V tomto prípade ide o autoforms.cdesk.io, , ktorá je zároveň predvolenou hodnotou poľa.
- 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 formuláru – 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 formuláru zadajte hodnotu z poľa Identifier. Na jednom serveri a pod jedným prihlasovacím menom môže byť uložených viacero formulárov. Toto pole určuje, ktorý z nich konektor použije.
- Multiplikovať subformulár podľa počtu – určuje, podľa čoho sa v tlačovej zostave opakuje subformulár. Ak formulár subformulár neobsahuje, ponechajte možnosť Bez subformularu. Ostatné možnosti sú:
- Plnení – subformulár sa opakuje pre každé plnenie
- CI objektov – subformulár sa opakuje pre každý CI objekt
- Používateľom definovaných polí CI Objektu – počet opakovaní sa určí podľa vybraného používateľom definovaného poľa CI objektu, ktoré sa zvolí v poli Zákaznícke pole CI pre vyhodnotenie multiplikácie
- Tabov používateľom definovaných polí CI Objektu – subformulár sa opakuje pre každú záložku používateľom definovaných polí CI objektu
- Položiek protokolu – subformulár sa opakuje pre každú položku protokolu evidencie majetku
- Používateľom definovaných polí plnenia – počet opakovaní sa určí podľa vybraného používateľom definovaného poľa plnenia, ktoré sa zvolí v poli Zákaznícke pole plnenia pre vyhodnotenie multiplikácie
- Miesto uloženia pdf – miesto, kde bude uložená vygenerovaná výsledná tlačová zostava. Je možné zvoliť viacero možností naraz: Príloha Požiadavky, Príloha Plnenia, Príloha pripojeného CI objektu a Ponúknuť na stiahnutie.
- Vygenerovať pre každú CI položku na požiadavke zvlášť report – zobrazuje sa len pri mieste použitia Požiadavky alebo Požiadavky vytvorené zo zvolenej šablóny a zároveň pri mieste uloženia Príloha Požiadavky. Ak je zapnuté a požiadavka sa týka viacerých CI položiek, vygeneruje sa samostatná tlačová zostava pre každú z nich.
- Do reportu zahrnúť len plnenia viazané na dané CI – zobrazuje sa len pri zapnutom predchádzajúcom prepínači. Ak je zapnuté, do zostavy konkrétnej CI položky sa dostanú iba plnenia priamo viazané na túto CI položku. Plnenia bez väzby na CI alebo s väzbou na iné CI sa v zostave nezobrazia.
- Do reportu použiť hodnoty zo servisného záznamu – určuje, odkiaľ tlačová zostava čerpá údaje o CI. Pole sa zobrazuje vždy.
- Vypnuté – zostava čerpá aktuálne hodnoty zo všetkých CI na požiadavke.
- Zapnuté – zostava čerpá hodnoty polí CI zo servisného záznamu, teda zo stavu zariadenia v čase vytvorenia alebo poslednej aktualizácie záznamu, a nie aktuálne hodnoty CI. Pri generovaní z požiadavky spracuje len tie CI, ktoré majú k požiadavke aktívny servisný záznam; ostatné CI sa vynechajú. Do zostavy sa zahrnú len plnenia zaradené v servisnom zázname a pri párovaní polí sa sprístupnia CDESK vlastnosti Servisný záznam → Podpis zákazníka.
Tlačidlo Generovať protokol priamo v servisnom zázname sa zobrazí, len ak je toto pole zapnuté, zapnuté sú aj polia Vygenerovať pre každú CI položku na požiadavke zvlášť report a Do reportu zahrnúť len plnenia viazané na dané CI, miesto použitia je Požiadavky alebo Požiadavky vytvorené zo zvolenej šablóny a v poli Miesto uloženia pdf je zvolená možnosť Príloha Servisného záznamu.
- Vlastné štýly – pokročilé nastavenie štýlov opakujúcich sa riadkov subformulára a päty tlačovej zostavy. Zapisuje sa v ňom šablóna so špeciálnymi značkami. Dopĺňa CSS štýl uložený vo formulári, ktorý je opísaný v kapitole Zmena vizuálnej časti formulára. Pri bežnom použití pole zostáva prázdne.
- Zobraziť aj prázdne checkboxy – ak je zapnuté, nezaškrtnuté zaškrtávacie políčka sa v tlačovej zostave zobrazia ako prázdne políčko. Postup je opísaný v kapitole Nastavenie zaškrtávacieho políčka (Checkbox).
- Zahrnúť do dát interné plnenia – zobrazuje sa len v prípade, že sú v nastaveniach plnení zapnuté interné plnenia. Ak je zapnuté, do údajov tlačovej zostavy sa zahrnú aj interné plnenia.
- Deduplikácia plnení – zobrazuje sa pri mieste použitia Požiadavky, Požiadavky a Plnenia, Požiadavky vytvorené zo zvolenej šablóny a Požiadavky typu Servis zariadení. Ak je zapnutá, duplicitné plnenia so zhodným popisom aj časom od-do sa do zostavy zahrnú iba raz. Pri viacerých zhodných plneniach sa použije plnenie od riešiteľa požiadavky. Ak medzi nimi nie je, použije sa plnenie s najnižším ID.
Po konfigurácii týchto vlastností kliknite na tlačidlo Aktualizovať konfiguráciu reportu, ktoré konektor uloží a načíta polia formulára z NETGRIF, aby ich bolo možné spárovať s poľami CDESK.
Každý riadok párovania zodpovedá jednému poľu formulára a obsahuje tieto stĺpce:
- Polia formuláru – názov poľa tak, ako je pomenované vo formulári v NETGRIF.
- CDESK vlastnosti – údaj z CDESK, ktorý sa do poľa vpíše. Ponuka údajov závisí od nastaveného miesta použitia a zohľadňuje aj zvolenú šablónu požiadavky.
- Zlučovanie vlastnosti – ak sa do jedného poľa dostane viacero hodnôt, napríklad z viacerých plnení, zobrazia sa pod sebou. Ak je vypnuté, v poli zostane len jedna hodnota. Pri údajoch, ktoré zlučovať nie je možné, je prepínač neaktívny.
- Pridať popis vlastnosti k hodnote – k hodnote používateľom definovaného poľa sa pripojí jeho popis.
- Ak je hodnota prázdna, použiť implicitnú hodnotu z formuláru – ak údaj v CDESK nie je vyplnený, do poľa sa vpíše hodnota Initial value nastavená vo formulári v NETGRIF.
Ak formulár obsahuje subformulár, pod hlavnými poliami sa zobrazí aj časť Párovanie polí sub-formuláru s rovnakými stĺpcami. Ak sa formulár v NETGRIF zmení, je potrebné polia načítať znova kliknutím na tlačidlo Aktualizovať konfiguráciu reportu.
Do tlačovej zostavy je možné vložiť napríklad nasledujúce CDESK polia. Ponuka sa líši podľa nastaveného miesta použitia:
- Dodávateľ – Názov a adresa spoločnosti
- Číslo požiadavky
- Číslo zákazky
- Dátum vytvorenia 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
- Prihlásený používateľ – Meno a Podpis
Po napárovaní všetkých polí uložte nastavenia pomocou tlačidla Uložiť. Po uložení bude možné vyvolať danú tlačovú zostavu v module, 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 tlačidla pre spustenie generovania, prípadne v poli Názov, ak názov tlačidla nie je vyplnený. V mobilnej aplikácii sa tlačidlo zobrazí v detaile požiadavky v časti Servisné protokoly.
Bola táto stránka užitočná?
Ďakujeme za spätnú väzbu.