Predvyplnenie metadát dokumentu z URL

Pre zrýchlenie a zefektívnenie práce používateľov môže byť dialóg pre vytvorenie nového dokumentu vyvolaný odkazom z externej aplikácie. Odkaz už obsahuje dáta z externého systému, ktoré sa použijú na pred vyplnenie metadát dokumentu. Táto kapitola popisuje zásady, podľa ktorých sa má takýto odkaz zostaviť.

Pred vyplnenie metadát nového dokumentu prebieha na základe dát predávaných v GET parametroch URL odkazu. Odkaz je vytvorený externou aplikáciou. Otvorenie prehliadača s daným URL linkom vykonáva volajúci externej aplikácie.

Odkaz sa skladá z dvoch častí: statickej a dynamickej.

Statická časť odkazu

Tvar odkazu vyzerá približne takto:

https://firemnyserver.sk/create_docu.php

Tento URL link je štandardne autentizovaný. Pokiaľ ho použije neprihlásený používateľ, prebehne pred zobrazením príslušného dialógu prihlásenie.

Dynamická časť odkazu

Dynamická časť sa skladá z prenášaných parametrov. Pred každým parametrom sa uvádza znak „&“, pred folder je znak „?“.

Parameter 1

sid_fldr – tu sa uvádza SID priečinku, do ktorého sa vloží nový dokument. Pokiaľ nie je známy sid_fldr, FormFlow ohlási chybu.

Parameter 2–N

Odovzdané metadáta k pred vyplneniu dialógu. Názov parametra je podľa názvu metadát (NAME_META). Odovzdané metadáta sú viazané na priečinok. Pokiaľ je v odkaze uvedený neznámy názov metadát pre daný priečinok, bude tento parameter ignorovaný. Ak metadáta nie sú v odkaze nastavené a v nastavení je predvolená hodnota, použije sa predvolená hodnota z nastavenia. A obrátene, ak je hodnota nastavená v odkaze aj vo východiskovej konfigurácii, používa sa hodnota z odkazu.

V parametroch môžu byť odovzdané nasledujúce metadáta:

Názov zobrazený v dialógu Názov v URL Hodnota

SID priečinku

SID_FLDR

SID dokumentového priečinku (nemožno použiť diakritiku)

Spravovať LTD:

LTD_ACCEPT_DOCU

TRUE/FALSE

Konfigurácia LTD:

ID_LTD_CONF_DOCU

Hodnota číselníku

Garant:

WARRANTOR_ID_GROU_DOCU

ID_GROU (napr. 4123)

Referent dokumentu:

OFFICER_ID_USER_DOCU

ID_USER (napr. 3951)

Stav:

ID_STAT_DOCU

Kód (nemožno použiť diakritiku)

Názov dokumentu:

NAME_DOCU

Názov (iba bez diakritiky)

Dokumentová trieda:

ID_CLAS_DOCU

Kód triedy (nemožno použiť diakritiku)

Klasifikácia dokumentu:

ID_RANK_DOCU

Kód klasifikácie (nemožno použiť diakritiku)

Znak hodnoty dokumentu:

SHRED_MARK_DOCU

Akýkoľvek znak – pri uložení je strážený formát

Platnosť dokumentu do:

SHRED_TE_VALID_UP_TO_DOCU

Dátum zadaný bez medzier, čas oddelený dvojbodkou (dd.mm.yyyy hh:mm:ss, napr. 1.12.2017 3:55:12)

Počet rokov platnosti dokumentu:

SHRED_TE_VALIDITY_PERIOD_DOCU

Akýkoľvek znak – pri uložení je strážený formát

Rok vyraďovania dokumentu:

SHRED_YEAR_DOCU

Akýkoľvek znak – pri uložení je strážený formát

ID obsluhovaného subjektu:

ID_CERT_DOCU

ID_CERT

IRZ:

JID_DOCU

Akýkoľvek znak bez diakritiky

Registratúrne číslo:

CJ_DOCU

Akýkoľvek znak bez diakritiky

Očakávané tvary jednotlivých dátových typov metadát:

Typ metadát Očakávaný tvar

Číslo

1234

Dátum

d.m.yyyy – 1.12.2017

Dátum a čas

dd.mm.yyyy hh:ii:ss 1.12.2017 3:55:12

Text

Text

Číselník

Hodnota číselníku (nie zobrazovaná hodnota)

Subjekt (používateľ alebo skupina)

ID používateľa alebo skupiny

Trieda/klasifikácia/stav

Kód stavu/triedy/klasifikácie (nie ID)

Všeobecne platí, že sa nevyužívajú ID z databázy (len u požívateľov a skupín), ale inak vždy kódy.

Príklad a očakávaný výstup

https://firemnyserver.sk/create_docu.php?sid_fldr=DOCLI&ESX_DOCLI_DOCTYPE=1100&ESX_DOCLI_BCID=1257

Tento odkaz otvorí dialóg pre nový dokument v priečinku Klientska dokumentácia (SID priečinku je DOCLI). Predvyplnené budú tieto metadáta:

  • Typ dokumentu bude Úverová zmluva (kľúč tejto hodnoty z číselníka typu dokumentov je 1100).

  • Číslo obchodného prípadu bude 1257.