Commit a rollback jsou pomocné operace, které mají usnadnit práci, když se něco nepovede při zpracování dat na straně přijímající aplikace. Není to commit a rollback ve smyslu databáze. Webová služba je stateless. Popis datových typů zpráv je součástí připojeného XML schématu.
Operations
synchronize
Dávková operace požadavku na synchronizaci/provedení změn v evidenci majetku. V případě, že se nepodaří nějaký záznam zapsat nebo aktualizovat v databázi, objeví se v response chyba. Ostatní bezchybně zapsané řádky jsou pak automaticky potvrzeny v databázi a nelze je již odvolat. V případě, že v zásobníku požadovaných změn existuje záznam identifikovaný pomocí elementů 'ejidno', 'invcislo' nebo 'invidno', 'uloha', 'majtyp', 'prvuloha' a 'ejidnop' provede se aktualizace záznamu, v opačném případě se provede insert nového záznamu. Aktualizaci nelze provést v případě, že předchozí požadavek byl promítnut do majetkové evidence, ale elektronické schvalování si nepřevzalo potvrzení o zpracování operací get_processed (stav = U nebo Z). UPOZORNĚNÍ: Pokud se bude v datech nacházet více záznamů se shodným 'invcislo' nebo 'invidno', bude docházet v zásobníku k postupné aktualizaci a hodnoty v záznamu budou odpovídat poslednímu záznamu.
Operace načte data uložená pro schvalování, načtená data uzamkne a vrací proto ID transakce. Povinným argumentem je číslo úlohy, které bude přiděleno příslušné cílové aplikaci. Číslo úlohy je pro danou aplikaci konstanta, kterou vám sdělí BBM a která z pohledu iFIS říká, jaké aplikaci jsou data adresována. Data můžeme připravovat pro více aplikací současně, takže číslo úlohy lze zadat regulárním výrazem.
Operace načte seznam zpracovaných/zamítnutých požadavků z elektronického schvalování, načtená data uzamkne a vrací proto ID transakce. Povinným argumentem je číslo úlohy, které bude přiděleno příslušné cílové aplikaci. Číslo úlohy je pro danou aplikaci konstanta, kterou vám sdělí BBM a která z pohledu iFIS říká, jaké aplikaci jsou data adresována. Data můžeme připravovat pro více aplikací současně, takže číslo úlohy lze zadat regulárním výrazem.
Operace slouží k vymazání zapsaného a ještě nezpracovaného datového záznamu (stav = P), záznam je identifikovaný pomocí elementů 'ejidno', 'invcislo' nebo 'invidno', 'uloha', 'majtyp', 'prvuloha' a 'ejidnop'. Operaci nelze odvolat.
Operace slouží k potvrzení převzetí a zpracování načtených dat operacemi 'get_data' nebo 'get_processed'. Použijete, pokud se v cílové aplikaci podaří zapsat veškerá načtená data do její databáze.
Operace slouží k odemčení záznamů uzamčených operacemi 'get_data' nebo 'get_processed'. Použijete, pokud se v cílové aplikaci nepodaří zapsat veškerá načtená data do její databáze.
<portType name="SyncMAJ"><documentation>Commit a rollback jsou pomocné operace, které mají usnadnit práci, když se něco nepovede při zpracování dat na straně přijímající aplikace. Není to commit a rollback ve smyslu databáze. Webová služba je stateless. Popis datových typů zpráv je součástí připojeného XML schématu.</documentation><operation name="synchronize"><documentation>Dávková operace požadavku na synchronizaci/provedení změn v evidenci majetku. V případě, že se nepodaří nějaký záznam zapsat nebo aktualizovat v databázi, objeví se v response chyba. Ostatní bezchybně zapsané řádky jsou pak automaticky potvrzeny v databázi a nelze je již odvolat. V případě, že v zásobníku požadovaných změn existuje záznam identifikovaný pomocí elementů 'ejidno', 'invcislo' nebo 'invidno', 'uloha', 'majtyp', 'prvuloha' a 'ejidnop' provede se aktualizace záznamu, v opačném případě se provede insert nového záznamu. Aktualizaci nelze provést v případě, že předchozí požadavek byl promítnut do majetkové evidence, ale elektronické schvalování si nepřevzalo potvrzení o zpracování operací get_processed (stav = U nebo Z). UPOZORNĚNÍ: Pokud se bude v datech nacházet více záznamů se shodným 'invcislo' nebo 'invidno', bude docházet v zásobníku k postupné aktualizaci a hodnoty v záznamu budou odpovídat poslednímu záznamu.</documentation><input message="tns:SyncRequestMessage"/><output message="tns:SyncResponseMessage"/></operation><operation name="get_data"><documentation>Operace načte data uložená pro schvalování, načtená data uzamkne a vrací proto ID transakce. Povinným argumentem je číslo úlohy, které bude přiděleno příslušné cílové aplikaci. Číslo úlohy je pro danou aplikaci konstanta, kterou vám sdělí BBM a která z pohledu iFIS říká, jaké aplikaci jsou data adresována. Data můžeme připravovat pro více aplikací současně, takže číslo úlohy lze zadat regulárním výrazem.</documentation><input message="tns:GetDataRequestMessage"/><output message="tns:GetDataResponseMessage"/><fault message="tns:GetDataFaultMessage" name="fault"/></operation><operation name="get_processed"><documentation>Operace načte seznam zpracovaných/zamítnutých požadavků z elektronického schvalování, načtená data uzamkne a vrací proto ID transakce. Povinným argumentem je číslo úlohy, které bude přiděleno příslušné cílové aplikaci. Číslo úlohy je pro danou aplikaci konstanta, kterou vám sdělí BBM a která z pohledu iFIS říká, jaké aplikaci jsou data adresována. Data můžeme připravovat pro více aplikací současně, takže číslo úlohy lze zadat regulárním výrazem.</documentation><input message="tns:GetProcessedRequestMessage"/><output message="tns:GetProcessedResponseMessage"/><fault message="tns:GetDataFaultMessage" name="fault"/></operation><operation name="delete"><documentation>Operace slouží k vymazání zapsaného a ještě nezpracovaného datového záznamu (stav = P), záznam je identifikovaný pomocí elementů 'ejidno', 'invcislo' nebo 'invidno', 'uloha', 'majtyp', 'prvuloha' a 'ejidnop'. Operaci nelze odvolat.</documentation><input message="tns:DeleteDataRequest"/><output message="tns:SyncResponseMessage"/></operation><operation name="commit"><documentation>Operace slouží k potvrzení převzetí a zpracování načtených dat operacemi 'get_data' nebo 'get_processed'. Použijete, pokud se v cílové aplikaci podaří zapsat veškerá načtená data do její databáze.</documentation><input message="tns:commitDataRequestMessage"/></operation><operation name="rollback"><documentation>Operace slouží k odemčení záznamů uzamčených operacemi 'get_data' nebo 'get_processed'. Použijete, pokud se v cílové aplikaci nepodaří zapsat veškerá načtená data do její databáze.</documentation><input message="tns:rollbackDataRequestMessage"/></operation></portType>
Číslo ekonomické jednotky, ke které je požadován přístup.
Source
<xsd:element name="syncRequest" type="mj:syncRadkyType"><xsd:annotation><xsd:documentation>Seznam požadovaných změn k promítnutí do majetkové evidence.</xsd:documentation></xsd:annotation></xsd:element>
Pokud je 'status' true, všechna data byla zapsána v pořádku, v opačném případě je vrácen seznam chyb.
Source
<xsd:element name="syncResponse" type="mj:syncResponseType"><xsd:annotation><xsd:documentation>Informace o výsledku zápisu dat požadavku na synchronizaci/provedení změn v evidenci majetku.</xsd:documentation></xsd:annotation></xsd:element>
Parametry požadavku na informace o požadovaných/provedených změnách v evidenci majetku pro potřeby zahájení workflow elektronického schvalování či promítnutí do jiné evidence majetku. Stejné parametry se používají i v případě operace poskytující informace o zpracování předaných požadavků na promítnutí do majetkové evidence z elektronického schvalování.
Číslo ekonomické jednotky, ke které je požadován přístup.
Source
<xsd:element name="getDataRequest" type="mj:getDataType"><xsd:annotation><xsd:documentation>Parametry požadavku na informace o požadovaných/provedených změnách v evidenci majetku pro potřeby zahájení workflow elektronického schvalování či promítnutí do jiné evidence majetku. Stejné parametry se používají i v případě operace poskytující informace o zpracování předaných požadavků na promítnutí do majetkové evidence z elektronického schvalování.</xsd:documentation></xsd:annotation></xsd:element>
<xsd:element name="getDataResponse" type="mj:getRadkyType"><xsd:annotation><xsd:documentation>Informace o požadovaných/provedených změnách v evidenci majetku (např. pro zahájení schvalovacího workflow).</xsd:documentation></xsd:annotation></xsd:element>
<xsd:element name="getProcessedResponse" type="mj:procRadkyType"><xsd:annotation><xsd:documentation>Informace o provedených změnách v evidenci majetku na základě předaných požadavků na změny (např. z elektronického schvalování majetku).</xsd:documentation></xsd:annotation></xsd:element>
Slouží jako parametry požadavku na vymazání dosud nezpracovaného nebo schvalováním zamítnutého záznamu ze zásobníku. Atribut 'cislo_radku' se nepoužívá, je zde pouze v důsledku odvození od společného komplexního typu!
Číslo ekonomické jednotky, ke které je požadován přístup.
Source
<xsd:element name="deleteDataRequest" type="mj:deleteRequestType"><xsd:annotation><xsd:documentation>Slouží jako parametry požadavku na vymazání dosud nezpracovaného nebo schvalováním zamítnutého záznamu ze zásobníku. Atribut 'cislo_radku' se nepoužívá, je zde pouze v důsledku odvození od společného komplexního typu!</xsd:documentation></xsd:annotation></xsd:element>
Číslo ekonomické jednotky, ke které je požadován přístup.
txid
xsd:string
required
Identifikace transakce v databázi
Source
<xsd:element name="commitDataRequest" type="mj:transRequestType"><xsd:annotation><xsd:documentation>Slouží k potvrzení převzetí a zpracování načtených dat.</xsd:documentation></xsd:annotation></xsd:element>
Pořadové číslo řádku v dávce, na kterém došlo k chybě. Pokud je zde uvedena 0 (nula), nebo atribut není uveden, jedná se o obecnou chybu.
Source
<xsd:element name="operationFault" type="mj:chybaType"><xsd:annotation><xsd:documentation>Chybová zpráva u operací, které vracejí data.</xsd:documentation></xsd:annotation></xsd:element>
Pokud je 'status' true, všechna data byla zapsána v pořádku, v opačném případě je vrácen seznam chyb.
Source
<xsd:complexType name="syncResponseType"><xsd:sequence><xsd:element name="chyba" type="mj:chybaType" minOccurs="0" maxOccurs="unbounded"><xsd:annotation><xsd:documentation>Seznam chyb při pokusu o zápis dat.</xsd:documentation></xsd:annotation></xsd:element></xsd:sequence><xsd:attribute name="status" use="required" type="xsd:boolean"><xsd:annotation><xsd:documentation>Pokud je 'status' true, všechna data byla zapsána v pořádku, v opačném případě je vrácen seznam chyb.</xsd:documentation></xsd:annotation></xsd:attribute></xsd:complexType>
Pořadové číslo řádku v dávce, na kterém došlo k chybě. Pokud je zde uvedena 0 (nula), nebo atribut není uveden, jedná se o obecnou chybu.
Source
<xsd:complexType name="chybaType"><xsd:sequence><xsd:element name="kod" type="xsd:string"><xsd:annotation><xsd:documentation>Kód chyby.</xsd:documentation></xsd:annotation></xsd:element><xsd:element name="zprava" type="xsd:string"><xsd:annotation><xsd:documentation>Text chybove zpravy.</xsd:documentation></xsd:annotation></xsd:element></xsd:sequence><xsd:attribute name="cislo_radku" type="xsd:integer"><xsd:annotation><xsd:documentation>Pořadové číslo řádku v dávce, na kterém došlo k chybě. Pokud je zde uvedena 0 (nula), nebo atribut není uveden, jedná se o obecnou chybu.</xsd:documentation></xsd:annotation></xsd:attribute></xsd:complexType>
Číslo ekonomické jednotky, ke které je požadován přístup.
Source
<xsd:complexType name="getDataType"><xsd:sequence><xsd:element name="uloha" type="xsd:string"><xsd:annotation><xsd:documentation>Čislo cílové úlohy (J_ULO.ULO_ID) nebo cílové aplikace, která přijímá data. Lze použít i regulární výraz pro regexp_like(uloha,:pattern).</xsd:documentation></xsd:annotation></xsd:element><xsd:element name="ejidnop" minOccurs="0"><xsd:annotation><xsd:documentation>Identifikace ekonomické jednotky, která záznam vytvořila - J_EKJ.EKJ_ID. Pokud není element uveden, jeho výchozí hodnota je odvozena od hodnoty atributu 'ej' v rodičovského elementu.</xsd:documentation></xsd:annotation><xsd:simpleType><xsd:restriction base="xsd:integer"><xsd:totalDigits value="10"/></xsd:restriction></xsd:simpleType></xsd:element></xsd:sequence><xsd:attribute name="ej" default="1" type="mj:ekjIdType"><xsd:annotation><xsd:documentation>Číslo ekonomické jednotky, ke které je požadován přístup.</xsd:documentation></xsd:annotation></xsd:attribute></xsd:complexType>
Datový typ řádků s informacemi o provedených změnách v evidenci majetku na základě předaných požadavků na změny (např. z elektronického schvalování majetku).
Číslo ekonomické jednotky, ke které je požadován přístup.
Source
<xsd:complexType name="deleteRequestType"><xsd:complexContent><xsd:extension base="mj:deleteParamsType"><xsd:attribute name="ej" default="1" type="mj:ekjIdType"><xsd:annotation><xsd:documentation>Číslo ekonomické jednotky, ke které je požadován přístup.</xsd:documentation></xsd:annotation></xsd:attribute></xsd:extension></xsd:complexContent></xsd:complexType>
<xsd:complexType name="deleteParamsType"><xsd:complexContent><xsd:restriction base="mj:dataRadekType"><xsd:sequence><xsd:element name="majtyp" minOccurs="1"><xsd:simpleType><xsd:restriction base="xsd:string"><xsd:maxLength value="1"/></xsd:restriction></xsd:simpleType></xsd:element><xsd:element name="uloha" minOccurs="1"><xsd:simpleType><xsd:restriction base="xsd:string"><xsd:maxLength value="3"/></xsd:restriction></xsd:simpleType></xsd:element><xsd:element name="invcislo" minOccurs="0"><xsd:annotation><xsd:documentation>Musí být uvedeno 'invcislo' nebo 'invidno', v případě uvedení obou má přednost 'imvcislo'.</xsd:documentation></xsd:annotation><xsd:simpleType><xsd:restriction base="xsd:string"><xsd:maxLength value="15"/></xsd:restriction></xsd:simpleType></xsd:element><xsd:element name="ejidnop" minOccurs="0"><xsd:annotation><xsd:documentation>Identifikace ekonomické jednotky, která záznam vytvořila - J_EKJ.EKJ_ID. Pokud není element uveden, jeho výchozí hodnota je odvozena od hodnoty atributu 'ej' v rodičovského elementu.</xsd:documentation></xsd:annotation><xsd:simpleType><xsd:restriction base="xsd:integer"><xsd:totalDigits value="10"/></xsd:restriction></xsd:simpleType></xsd:element><xsd:element name="invidno" minOccurs="0"><xsd:annotation><xsd:documentation>Musí být uvedeno 'invcislo' nebo 'invidno', v případě uvedení obou má přednost 'imvcislo'.</xsd:documentation></xsd:annotation><xsd:simpleType><xsd:restriction base="xsd:integer"><xsd:totalDigits value="10"/></xsd:restriction></xsd:simpleType></xsd:element><xsd:element name="prvuloha" minOccurs="1"><xsd:simpleType><xsd:restriction base="xsd:string"><xsd:maxLength value="3"/></xsd:restriction></xsd:simpleType></xsd:element></xsd:sequence></xsd:restriction></xsd:complexContent></xsd:complexType>
Číslo ekonomické jednotky, ke které je požadován přístup.
txid
xsd:string
required
Identifikace transakce v databázi
Source
<xsd:complexType name="transRequestType"><xsd:attribute name="txid" use="required" type="xsd:string"><xsd:annotation><xsd:documentation>Identifikace transakce v databázi</xsd:documentation></xsd:annotation></xsd:attribute><xsd:attribute name="ej" default="1" type="mj:ekjIdType"><xsd:annotation><xsd:documentation>Číslo ekonomické jednotky, ke které je požadován přístup.</xsd:documentation></xsd:annotation></xsd:attribute></xsd:complexType>