Výměna dkladů v XML Zpracval: Tmáš Urych U Mlýna 2305/22, 141 Praha 4 Záběhlice Dne: 28.6.2008 tel.: +420 585 203 370-2 e-mail: inf@es9.cz Revize: Hruška Pavel www.es9.cz Dne: 30.11.2017
Výměna dkladů v XML Obsah 1. ÚVOD... 3 2. PODMÍNKY PROVOZU... 3 3. POPIS ŘEŠENÍ... 3 3.1 FORMULÁŘE ESO9... 3 3.2 SQL OBJEKTY... 4 3.3 PARAMETRY ESO9... 4 3.4 PROGRAMOVÁ KOMPONENTA... 5 3.5 XML DOKUMENTY... 5 3.6 HROMADNÉ AKCE... 5 3.6.1 Lgvání... 7 3.7 PRŮBĚH EXPORTU... 7 3.8 PRŮBĚH IMPORTU... 8 4. ZMĚNY... 10 Strana 2 z 11
Výměna dkladů v XML 1. Úvd Tent dkument ppisuje způsb kmunikace mezi IS ESO9 a jakýmkli jiným IS na bázi výměny XML 1 dkumentů. Pužití jazyka XML dvluje přenášet data zárveň s jejich ppisem, vše navíc transparentně vzhledem k pužitému peračnímu a infrmačnímu systému. Ppsané řešení lze pužít k výměně jakýchkli typů dkladů pužitých v IS ESO9. Veškeré sftwarvé sučásti jsu naprgramvány v jazycích Visual Basic.NET 2, SQL 3, XML a XSL 4. 2. Pdmínky prvzu Ppisvané řešení je dstupné pr aplikační server (AS) pstavený na technlgii.net d verze 3.5. Základní pdmínky pr prvz XML kmunikace jsu tedy dány pdmínkami pr prvz tét verze AS (pdrbněji viz dkument Metdika instalace AS NET). 3. Ppis řešení Celé řešení je zalžen na mžnsti exprtu a imprtu libvlných dkladů z ESO9 ve frmátu XML a t jak ručně (uživatelsku akcí na tlačítk z frmuláře ESO9), tak autmaticky (např. nčním JOBem). Pr bě akce je v ESO9 dstupná XML šablna tzv. generickéh dkumentu ESO9, který definuje pdbu becnéh dkladu ulženéh v ESO9 (tedy dpvídá paradigmatu hlaviček a slžek). Pr exprt d jinéh XML schématu (neb pr imprt z jinéh XML schématu) se pužívá jazyka XSL, který pmcí XML prcesru prvede převd mezi frmátem generickéh dkumentu ESO9 a frmátem třetí strany. Rzhraní pr aplikační server ESO9 tak pracuje vždy puze se šablnu generickéh dkumentu ESO9, zbytek funkčnsti bstarává XML prcesr. 3.1 Frmuláře ESO9 Obě základní perace XML Exprt/Imprt jsu z ESO9 dstupné prstřednictvím frmulářů ve Start adresáři XMLDcs: XMLExprt.htm realizuje exprt, lze vlat z libvlnéh frmuláře/dkladu ESO9 vazbu Parameters. Pužité parametry: IDHDOK ve vazbě je nutné přenášet ID hlavičky exprtvanéh dkladu. MAP_NAME vlitelný parametr, definuje jmén transfrmační mapy, kteru se bude mdifikvat vyexprtvaný dklad. Pdrbnsti mechanismu transfrmace viz níže. FILENAME_PART vlitelný parametr, pkud je naplněn, bude jeh hdnta pužita k sestavení jména exprtvanéh subru. XMLPATH_EXP pkud je uveden ve stránce, nahrazuje stejnjmenný parametr ESO9. Ukázka vlání frmuláře: <a href="esfrm.asp?tpage=xmldcs/xmlexprt.htm& RelType=Parameters&MAP_NAME=ESO9_2_MyInvice.xsl">Exprt d XML</a> XMLImprt.htm realizuje imprt, lze vlat z libvlnéh frmuláře/dkladu ESO9 vazbu Parameters. Žádný z parametrů uvedených ve frmuláři není pvinný: 1 XML - Extensible Markup Language 2 Visual Basic.NET 3 SQL - Structured Query Language 4 XSL - Extensible Stylesheet Language Strana 3 z 11
Výměna dkladů v XML TYP_DOK - typ imprtvanéh dkladu na straně cílvéh systému. Odpvídá svým významem stejně pjmenvané plžce datvéh mdelu ESO9. IDHDOK_VZOR ID vzru imprtvanéh dkladu na straně cílvéh systému. Odpvídá svým významem stejně pjmenvané plžce datvéh mdelu ESO9. VALREC_BEFORE_HDOK bchdní pravidl vlané nad plžkami hlavičky imprtvanéh XML dkladu ještě před jeh zalžením d cílvéh systému. Obchdní pravidl je realizván jak Stred Prcedura v jazyce SQL. Vstupními parametry jsu všechny dstupné hdnty z plžek hlavičky XML dkladu. VALREC_AFTER_HDOK bch. pravidl vlané nad plžkami hlavičky imprtvanéh XML dkladu p jeh zalžení d cílvéh systému. D tht bch. pravidla již vstupuje ID hlavičky dkladu vznikléh z imprtu. VALREC_BEFORE_SDOK bch. pravidl vlané nad plžkami každé slžky imprtvanéh XML dkladu ještě před jejím zalžením d cílvéh systému. VALREC_AFTER_SDOK bch. pravidl vlané nad plžkami každé slžky imprtvanéh XML dkladu ještě před jejím zalžením d cílvéh systému. D tht bch. pravidla již vstupuje ID slžky dkladu vznikléh z imprtu. ENVELOPE_NAME jmén bálky XML dkumentu. Pkud má imprtvaný XML dkument bálku (nejčastěji bsahuje infrmace pr zpracvání příjemcem, např. kód desílatele v rámci systému XML kmunikace neb datum vytvření), lze jí při imprtu d ESO9 dtrhnut a imprtvat puze vlastní data. Údaje z bálky lze ptm pužít k další funkčnsti. XMLPATH_IMP pkud je uveden ve stránce, nahrazuje stejnjmenný parametr ESO9. Ukázka vlání frmuláře: <a href="esfrm.asp?tpage=xmldcs/xmlimprt.htm& RelType=Parameters&MAP_NAME=MyInvice_2_ESO9.xsl&TYP_DOK=FPU&VALREC_AFTER_HDOK=spSetVLSTAV AfterCreateXMLHDOK&VALREC_AFTER_SDOK=spSetVLSTAVAfterCreateXMLSDOK">Imprt z XML</a> 3.2 SQL bjekty Základními SQL bjekty pužitými v ESO9 pr XML kmunikaci jsu: QHDOK_XML phled definující strukturu exprtvaných plžek z hlavičky dkladu ESO9. QSDOK_XML phled definující strukturu exprtvaných plžek ze slžky dkladu ESO9. spxml_hdok stred prcedura pr imprt hlavičky dkladu d ESO9. spxml_sdok stred prcedura pr imprt slžky dkladu d ESO9. Lze pužít parametr mf_hdok_query jmén phledu pr exprt hlavičky d XML. Můžete takt nahradit standardní phled QHDOK_XML. Phled musí bsahvat alespň IDHDOK. Při exprtu přes Starter parametr vystupuje jak HDOK_QUERY. Není-li uveden, pužívá se standardní QHDOK_XML. Lze pužít parametr mf_sdok_query jmén phledu pr exprt slžek d XML. Můžete takt nahradit standardní phled QSDOK_XML. Phled musí bsahvat alespň IDHDOK. Při exprtu přes Starter parametr vystupuje jak SDOK_QUERY. Není-li uveden, pužívá se standardní QSDOK_XML. 3.3 Parametry ESO9 Všechny parametry aplikace ESO9 pužité pr XML kmunikaci jsu ve skupině parametrů XMLExpImp. Seznam parametrů: Strana 4 z 11
Výměna dkladů v XML XMLPATH_EXP adresář pr exprt dkladů z ESO9. Musí být dstupný (viditelný) z aplikačníh serveru a může bsahvat jak lkální, tak UNC (Universal Naming Cnventin) cestu. Tyt pdmínky platí pr všechny níže uvedené cesty. XMLPATH_XSLMAPS adresář pr ulžení transfrmačních XSL map pr exprt/imprt z/d ESO9. XMLPATH_DOCSPEC adresář pr ulžení specifikací (šabln) pužitých XML dkumentů. Všechny exprtvané a imprtvané dkumenty jsu validvány prti příslušným šablnám, čímž je zaručena jejich validní struktura. XMLPATH_IMP adresář pužitý jak zdrj XML dkumentů pr imprt d ESO9. 3.4 Prgramvá kmpnenta Vlastní práci s XML realizuje prgramvá kmpnenta XMLExpImp.dll. Funkce bsažené v tét kmpnentě lze vlat přes standardní rzhraní pr uživatelské akce z ESO9. Aby jí aplikační server při svém startu zaregistrval, je třeba uvedenu knihvnu nahrát d pdadresáře ESO9Lib instalačníh adresáře ESO9 (např. C:\Prgram Files\Es9\ es9net\es9lib). Takt zaregistrvaná kmpnenta umžňuje exprt p jedntlivých dkladech a hrmadný imprt XML dkumentů přím z ESO9. Pkud je zaptřebí prvádět i hrmadný exprt, ppř. spuštět bě tyt akce autmaticky (např. nčním JOBem), lze pužít prgram ppsaný v kapitle 3.6. 3.5 XML dkumenty Sučástí standardníh Start řešení jsu tyt dkumenty: Šablna generickéh dkumentu ESO9 ulžená v subru ESO9_Dc.xml v adresáři definvaném aplikačním parametrem XMLPATH_DOCSPEC. Základní převdní mapa ulžená v subru ESO9_Dc2Dc.xsl v adresáři definvaném aplikačním parametrem XMLPATH_XSLMAPS. Tat mapa služí puze k frmálnímu převdu XML dkumentu ze zdrjvéh IS ESO9 d cílvéh IS ESO9. 3.6 Hrmadné akce Je-li zaptřebí spuštět imprt neb exprt XML dkumentů hrmadně a autmaticky, lze k tmu využít prgram Starter.exe. Prgram se spuští z příkazvé řádky, parametry spuštění se nastavují v knfiguračním subru Starter.exe.cnfig, který musí ležet ve stejné cestě jak prgram Starter.exe. Parametry mají následující význam: Cinnst činnst, kteru má spuštěcí prgram vyknávat. 1=exprt, 2=imprt. LOG lgvání prváděných akcí d textvéh subru. 1=zapnut, 0=vypnut. Lguje i d databáze, viz ppis dále. CnnStr cnnectin string (definuje parametry připjení) k aplikační databázi. Odpvídá stejnému nastavení aplikace ESO9, s jejímiž dklady (daty) má spuštěč pracvat. XMLExpImpDLLPath cesta k prgramvé kmpnentě ppsané v kapitle 3.4., je třeba uvést plnu cestu. Může t být cesta ke knihvně z instalace aplikačníh serveru, častěji je t však nezávislé umístění tét knihvny. InfAsErrr způsb zpracvání infrmačních hlášení SQL prcedur: 0 = infrmační hlášení není pvažván za chybu, 1 = infrmační hlášení je pvažván za chybu. Parametry jen pr exprt: Strana 5 z 11
Výměna dkladů v XML XMLPATH_EXP pkud je uveden, nahrazuje stejnjmenný parametr ESO9. Význam parametru je ppsán v kapitle 3.13. SQLExprt SQL dtaz pr výběr hlaviček dkladů pr hrmadný exprt. Musí bsahvat alespň hdntu IDHDOK z každéh dkladu. SQL dtaz může bsahvat jeden neb více parametrů ve tvaru %Parametr%. ExprtOptin lze nastavit mžnst exprtvat puze hlavičky. 0 = exprt hlaviček i slzek standardní hdnta, 1 = exprt jen hlaviček, bez slžek. Pkud na imprtné straně neptřebujete slžky, můžete tímt nastravením výrazně urychlit exprt. Exp_SubDirClumn plžka datvéh zdrje, která definuje pdadresář v exprtním adresáři, d kteréh se ukládají XML dkumenty. Zpřehlední se tak struktura vyexprtvaných subrů (zejména pkud jich je velké mnžství). Např. při naplnění hdntu ICO se všechny vyexprtvané XML subry rztřídí d pdadresářů pdle IČO subjektu, který je v dkladu uveden. Exp_FileNamePartClumn plžka datvéh zdrje, která definuje část jména exprtvanéh XML subru. Hdnta plžky nesmí bsahvat znaky nepřípustné ve jméně subru. spafterexprthdok - prcedura vlaná p exprtu každé hlavičky. Předává se jí jen IDHDOK. Můžete v ní napříjklad změnit stav dkladu. ExpReprt - kód přepisu sestavy, kterým se vytvří PDF subr se stejným jménem jak exprtní XML subr. Sestava se vyvří pmci Stimulsft knihven. Pkud je knihvna XMLExpImp.dll umístěna mim aplikační server, je třeba k ní přikpírvat i knihvny Stimulsft.Base.dll a Stimulsft.Reprt.dll, případně nastalvat Stimulsft příslušné verze. Je mžné zadávat pevné jmén sestavy: <add key="expreprt" value="favfrm.idc" /> neb i jmén slupce v datvém zdrji pr exprt se jménem sestavy. Jmén slupce v parametru musí začínat vykřičníkem: <add key="expreprt" value="!reprt" /> v datvém zdrji pak může například být: IIF(HDKUHRADEVAL < 0, 'DbpisFrm.idc', 'FavFrm.idc') as Reprt Parametry jen pr imprt: XMLPATH_IMP pkud je uveden, nahrazuje stejnjmenný parametr ESO9. Význam parametru je ppsán v kapitle 3.13. IDUSER ID uživatele, pd kterým se dklady zakládají v cílvé databázi při imprtu z XML. NazevXSLSablny název transfrmační mapy pr exprt (mapa pr převd z frmátu ESO9 d pžadvanéh frmátu třetí strany) neb imprt (mapa pr převd z frmátu třetí strany d frmátu dkladu ESO9). Je-li parametr NazevXSLSablny uveden i s cestu, pužije se s uvedenu cestu a nekmbinuje se s parametrem ESO9 pr cestu k šablnám XMLPATH_XSLMAPS. ImprtSrtOrder (zatím nezapjen) parametr pr určení přadí imprtu XML subrů. Může mít hdnty: 0 = bez přadí, 1 = pdle názvu subru vzestupně, -1 = pdle názvu subru sestupně, 2 = pdle data a času změny XML subru vzestupně, -2 = pdle data a času změny XML subru sestupně, 3 = pdle data a času zalžení XML subru vzestupně, -3 = pdle data a času zalžení XML subru sestupně. Strana 6 z 11
Výměna dkladů v XML ValrecBefreHDOK význam parametru je ppsán v kapitle 3.1. ValrecAfterHDOK význam parametru je ppsán v kapitle 3.1. ValrecBefreSDOK význam parametru je ppsán v kapitle 3.1. ValrecAfterSDOK význam parametru je ppsán v kapitle 3.1. Imp_IDHDOK_VZOR význam parametru je ppsán v kapitle 3.1. Imp_TYP_DOK význam parametru je ppsán v kapitle 3.1. Imp_DOC_EXT je-li vyplněn, definuje zadáním přípny přílhy pr imprt d dkumentvé databáze (zpravidla PDF). Při imprtu se hledá subr se stejným jménem jak imprtvaný XML subr, avšak se zadanu přílhu. Pkud existuje, zalží se d dkumentvé databáze a prváže s dkladem zalženým imprtem. P úspěšném imprtu se přesune d Zpracván. P neúspěšném se s ním pracuje stejně jak s XML subrem, pdle knfigurace (včetně případnéh zabalení d ZIP). Pkud se pdaří imprt dkladu z XML, ale nepdaří se vlžení přílhy, perace se pvažuje za úspěšnu, transakce se nevrací, vypíše se puze infrmace d LOG subru. Pznámka: Účet, pd kterým se spuští STARTER musí mít práv zápisu d DOC databáze. Imp_DOC_XML má-li parametr hdntu 1, prvede se vlžení imprtvanéh XML d dkumentvé databáze a prváže se s dkladem zalženým imprtem. SQLBefreImprt SQL akce (ulžená prcedura), která se prvede před imprtem dkladu (ů). SQLAfterImprt SQL akce (ulžená prcedura), která se prvede p imprtu dkladu (ů). Krmě parametrů uvedených v knfiguračním subru, které jsu platné pr každé spuštění prgramu, lze ještě jedntlivá spuštění parametrizvat přím z příkazvé řádky. Tent mechanismus lze využít pr parametrizaci SQL dtazu pr exprt (parametr SQLExprt), který může bsahvat parametry, jejichž hdnta se dplní pdle hdnt (y) uvedených v příkazvém řádku. Bez uživatelských zásahů d knfiguračníh subru tak lze pravidelně naplánvanu úlhu autmaticky exprtvat např. puze dklady za aktuální bdbí. Parametry jsu na příkazvém řádku uvedeny ve tvaru /pparametr= Hdnta. 3.6.1 Lgvání Při nastavení parametru LOG=1 se prvádí zápis výsledků d textvéh sbru LOG.TXT. Stejný bsah se zapisuje i d lgvací databáze (její název je dvzen d názvu databáze z CnnStr přidáním _LOG ). Zalží se záznam d tabulky ESO9LOG a naplní se hdnty: ACTION = 9 ACTIVITY = XMLEXP-Starter neb XMLIMP-Starter pdle vyvlané činnsti TIME je datum čas uknčení akce, DURATION její trvání v sekundách SQL infrmace průběhu perace (jaké dklady byly zpracvány, případné chyby) 3.7 Průběh exprtu Exprt dkladu/dkladů z ESO9 prbíhá následujícím způsbem: Exprt jedntlivých dkladů se prvádí frmulářem přím z ESO9 (kapitla 3.1), hrmadný exprt více dkladů ptm prgramvým spuštěčem (kapitla 3.6). Každý exprtvaný dklad je převeden d XML struktury dpvídající šablně generickéh dkumentu ESO9 (ESO9_Dc.xml) Strana 7 z 11
Výměna dkladů v XML Pkud je pr exprt zadána transfrmační XSL mapa, prvede se převd XML dkumentu ESO9 d cílvéh frmátu XSL mapy. Transfrmační mapa umžňuje nejen prsté přemapvání názvů plžek zdrjvéh XML subru na cílvý, ale i funkční perace (pmcí skriptvacích jazyků) nad jedntlivými plžkami (např. slučvání více zdrjvých plžek d jedné cílvé na základě jejich hdnt neb přepčet hdnt zdrjvé plžky na cílvu). Výsledný XML dkument se ulží d subru se jménem sestaveným: Z názvu typu dkladu v ESO9 Z části názvu definvané parametrem FILENAME_PART z kapitly 3.1 pr exprt jedntlivých dkladů přím z ESO9. Neb z části definvané parametrem Exp_FileNamePartClumn z kapitly 3.6 pr hrmadný exprt využitím prgramu Starter.exe. Z vygenervanéh GUID řetězce (unikátní identifikátr). Vyexprtvaný subr je ulžen buď d exprtníh adresáře (zadán v parametrech aplikace ESO9, viz kapitla 3.3), neb v případě hrmadnéh exprtu d pdadresáře definvanéh hdntu parametru v knfiguračním subru (viz kapitla 3.6). 3.8 Průběh imprtu Imprt dkladů d ESO9 prbíhá následujícím způsbem: Imprt dkladů d ESO9 lze jej spuštět buď z frmuláře ESO9 (kapitla 3.1) neb prgramvým spuštěčem (kapitla 3.6). D imprtu vstupují všechny XML subry z imprtníh adresáře (zadán v parametrech aplikace ESO9, viz kapitla 3.3). Pkud je pr imprt zadána transfrmační XSL mapa, prvede se převd vstupníh XML dkumentu d cílvéh frmátu generickéh ESO9 dkladu. Pkud je navíc zadán jmén bálky XML dkumentu, je tat bálka z dkumentu dtržena ještě před vlastním imprtem dat. Pkud transfrmační XSL mapa zadána není, předpkládáme, že vstupní XML dkument již je ve frmátu generickéh ESO9 dkladu a prti jeh šablně se také dkument validuje. Pkud vstupní dkument nedpvídá struktuře generickéh ESO9 dkladu, imprt sknčí chybu. Imprt plžky s hlavičku dkladu a plžek se slžkami dkladu prbíhá v transakci, tzn., nemůže nastat situace, že je v ESO9 např. naimprtvána puze část slžek výslednéh dkladu. Od verze 5.4 dplněna mžnst imprtvat z jednh XML subru více dkladů. V tmt případě není křenvým elementem HDOK ale DOKLADY, které bsahují více pdelementů HDOK. Imprt tyt varianty detekuje sám, není třeba nastavvat parametrem. Viz schéma dále. V případě imprtu více dkladů z jednh subru prbíhá zalžení všech dkladů v jedné transakci, pkud nastane chyba v jednm z nich, nezalží se žádný. Dále ppsaná pravidla se aplikují na každý dklad samstatně. Před imprtem (zalžením) hlavičky dkladu se spuští bchdní pravidl definvané parametrem ValrecBefreHDOK (pkud je tent parametr definván). V tmt bchdním pravidle lze pužít jak vstupní parametry všechny plžky definvané pr HDOK v šablně generickéh dkumentu ESO9 vyjma plžky IDHDOK, která v tut chvíli ještě není známa. Všechny plžky změněné neb přidané tímt bchdním pravidlem musí být vraceny jak výstupní recrdset (tj. stejný mechanismus, jak při spuštění bchdních pravidel v ESO9). Změny neb nvé plžky se zapisují d imprtvanéh XML dkumentu a vstupují d dalších bchdních pravidel. Vlastní zalžení hlavičky dkladu se děje ulženu prceduru spxml_hdok. Vstupem tét prcedury jsu krmě všech plžek imprtvanéh XML dkumentu parametry TYP_DOK a IDHDOK_VZOR, které definují typ a vzr nvéh dkladu v ESO9. Parametr IDHDOK_VZOR lze přetížit jejich případnu Strana 8 z 11
Výměna dkladů v XML mdifikací v bchdním pravidle ValrecBefreHDOK. P imprtu (zalžení) hlavičky dkladu se spuští bchdní pravidl definvané parametrem ValrecAfterHDOK (pkud je tent parametr definván). D tht bchdníh pravidla již vstupuje ID nvě zalžené hlavičky dkladu (tj. lze jej pužít jak vstupní parametr). Před imprtem (zalžením) slžky dkladu se spuští bchdní pravidl definvané parametrem ValrecBefreSDOK (pkud je tent parametr definván). V tmt bchdním pravidle lze pužít jak vstupní parametry všechny plžky definvané pr SDOK v šablně generickéh dkumentu ESO9 vyjma plžky IDSDOK, která v tut chvíli ještě není známa (naprti tmu lze pužít plžku IDHDOK, která již známa je). Přadí zakládané slžky dkladu se generuje autmaticky pdle přadí slžky v XML dkumentu. Vlastní zalžení slžky dkladu se děje ulženu prceduru spxml_sdok. P imprtu (zalžení) slžky dkladu se spuští bchdní pravidl definvané parametrem ValrecAfterSDOK (pkud je tent parametr definván). D tht bchdníh pravidla již vstupuje ID nvě zalžené hlavičky i slžky dkladu (tj. lze jej pužít jak vstupní parametr). Pkud je definvána přípna Imp_DOC_EXT, djde k vyhledání přílhy, zalží se d dkumentvé databáze a prváže s dkladem zalženým imprtem. Schematická struktura imprtníh XML subru, jak generický ESO9 dklad neb p uplatnění transfrmační mapy: Jeden dklad v subru: <?xml versin="1.0" encding="windws-1250"?> <HDOK.> </HDOK> Více dkladů v subru: <?xml versin="1.0" encding="windws-1250"?> <DOKLADY.> <HDOK.> </HDOK> <HDOK.> </HDOK> </DOKLADY> Strana 9 z 11
Výměna dkladů v XML 4. Změny Verze 5.5.1 Dplněna mžnst imprtvat přílhu ukládanu d dkumentvé databáze. Definuje se zadáním přípny přílhy, zpravidla PDF. Při imprtu se hledá subr se stejným jménem jak imprtvaný XML subr, avšak se zadanu přílhu. Pkud existuje, zalží se d dkumentvé databáze a prváže s dkladem zalženým imprtem. V knfigurační subru pr Starter.exe lze zadat přípnu přílhy jak: <!-- Přípna přílhy, která se má imprtvat d dkumentvé databáze --> <add key="imp_doc_ext" value="pdf" /> P úspěšném imprtu se přílha přesune d Zpracván. P neúspěšném se s přílhu pracuje stejně jak s XML subrem - pdle knfigurace (včetně případnéh zabalení d ZIP). Pznámka: Účet, pd kterým se spuští STARTER musí mít práv zápisu d DOC databáze. Dplněna mžnst vlžit imprtvaný XML subr d dkumentvé databáze. V knfigurační subru pr Starter.exe lze zadat přípnu přílhy jak: <!-- Vlžit imprtvaný XML subr d dkumentvé databáze. Hdnta 1 - An, jiná - Ne --> <add key="imp_doc_xml" value="1" /> má-li parametr hdntu 1, prvede se vlžení imprtvanéh XML d dkumentvé databáze a prváže se s dkladem zalženým imprtem. Při exprtu dplněna mžnst definvat jmén sestavy dynamicky - v datvém zdrji. V již dříve existujícím parametru je mžné zadávat pevné jmén sestavy: <add key="expreprt" value="favfrm.idc" /> neb nvě i jmén slupce v datvém zdrji pr exprt se jménem sestavy. Jmén slupce v parametru musí začínat vykřičníkem: <add key="expreprt" value="!reprt" /> v datvém zdrji pak může například být: IIF(HDKUHRADEVAL < 0, 'DbpisFrm.idc', 'FavFrm.idc') as Reprt Verze 5.4 Dplněna mžnst imprtvat z jednh XML subru více dkladů. V tmt případě není křenvým elementem HDOK ale DOKLADY, které bsahují více pdelementů HDOK. Imprt tyt varianty detekuje sám, není třeba nastavvat parametrem. Verze 4.6.3 Je-li parametr NazevXSLSablny uveden i s cestu, pužije se s uvedenu cestu a nekmbinuje se s parametrem ESO9 pr cestu k šablnám XMLPATH_XSLMAPS. Exprt Dplněn parametr mf_hdok_query jmén phledu pr exprt hlavičky d XML. Můžete takt nahradit standardní phled QHDOK_XML. Phled musí bsahvat alespň IDHDOK. Při exprtu přes Starter parametr vystupuje jak HDOK_QUERY. Není-li uveden, pužívá se standardní QHDOK_XML. Dplněn parametr mf_sdok_query jmén phledu pr exprt slžek d XML. Můžete takt nahradit standardní phled QSDOK_XML. Phled musí bsahvat alespň IDHDOK. Při exprtu přes Starter parametr vystupuje jak SDOK_QUERY. Není-li uveden, pužívá se standardní QSDOK_XML. Strana 10 z 11
Výměna dkladů v XML Dplněn parametr mf_expreprt - kód přepisu sestavy, kterým se vytvří PDF subr se stejným jménem jak exprtní XML subr. Sestava se vyvří pmci Stimulsft knihven. Při exprtu přes Starter parametr vystupuje jak ExpReprt. Pkud je knihvna XMLExpImp.dll umístěna mim aplikační server, je třeba k ní přikpírvat i knihvny Stimulsft.Base.dll a Stimulsft.Reprt.dll. Imprt Dplněn parametr KdExpImpDef, cž je kód definice imprtu v tabulce ExpImpDef (činnst 9.6.18). Zatím jde puze frmální definici. Pkud je tent parametr uveden, zapisují se výsledky imprtu z XML d průběhu imprtu svázanéh s tut definicí. Služí tedy jak histrie imprtů, která je lépe přístupná z aplikace ESO9 než textvé subry výsledků imprtů neb zápisy v LOG databázi. V knfigurační subru pr Starter.exe lze zadat jak: <add key="kdexpimpdef" value="" /> Verze 4.4.3 Dplněn "mf_infaserrr" způsb zpracvání infrmačních hlášení SQL prcedur: 0 = infrmační hlášení není pvažván za chybu, 1 = infrmační hlášení je pvažván za chybu. V knfigurační subru pr Starter.exe lze zadat jak: <add key="infaserrr" value="0" /> Verze 4.4.2 Převd d VS2010 a.net Framewrk verze 4.0. Verze 4.4.0.2 Pkud SQL prcedura vrací infrmační hlášení, imprt není uknčen, nevyhdntí se jak chyba. Verze 4.1 Starter dplněn zápis lgu i d lgvací databáze. Verze 4.0.2 Dplněn parametr ImprtSrtOrder pr určení přadí imprtu XML subrů. Verze 3.9.0.6 Parametr IDUSER z knfigurace se naplňuje d imprtních SQL prcedur d parametru IDUZIVATEL. Pkud se IDUZIVATEL předá z XML subru neb z výstupu prcedury, má přednst před paramtrem. Verze 3.9.0.5 Pkud je v XML subru, tedy na výstupu z prcedury plžka IDHDOK_VZOR, nenaplňuje se z parametru. Lze tedy v BEFORE prceduře menit ID VZORU. Verze 3.9.0.4 Dplněn "mf_exprtoptin" - mžnst exprtvat puze hlavičky. Verze 3.9.0.2 Dplněn parametr "mf_spafterexprthdok", prcedura vlaná p exprtu každé hlavičky. Předává se jí jen IDHDOK. Verze 3.7.3 Rzšířen pužití parametrů XMLPATH_IMP, XMLPATH_EXP tak, že při uvedení ve frmuláři neb v knfiguraci prgramu Starter nahradí stejnjmenný parametr ESO9. Umžní se tak exprt d více výstupních adresářů či imprt z více adresářů (například v různých činnstech). Strana 11 z 11