Software602 Long-Term Docs (Rozhraní webových služeb a.net assembly) Technická dokumentace. Vytvořeno dne: Aktualizováno: 24.1.

Transkript

1 (Rozhraní webových služeb a.net assembly) Technická dokumentace Vytvořeno dne: Aktualizováno: Software602, a.s.

2 Obsah... 4 Úvod..4 Slovník pojmů... 5 Reference... 6 Technické požadavky... 6 Související požadavky... 7 Autorizace, Evidence a Ověření... 8 Analýza dokumentu... 8 Registrace dokumentu Aktualizace registrovaného dokumentu Zjištění stavu dokumentu Odregistrace dokumentu Dokumenty k občerstvení Přímé podepsání dokumentu Přímé podepsání dokumentu certifikátem na kartě Hardware Security Modulu Přímé opatření dokumentu časovým razítkem Konverzní a ostatní služby Konverze dokumentů do PDF či PDF/A (Print2PDF) Konverze dokumentů do PDF či PDF/A Konverze webové stránky do PDF nebo PDF/A souboru Konverze souboru z URL adresy Konverze PDF do PDF/A Ověření shody s PDF/A Získání konverzních profilů Získání protokolu ověření podpisů v dokumentu Získání časového razítka Export textu z PDF s možností technologie OCR Přečtení obsahu čárových kódů v PDF souboru

3 Generování čárových kódů do obrázku nebo PDF souboru Generování platebních příkazů v QR kódu do obrázku nebo PDF souboru Přidání přílohy k PDF souboru Komprese PDF souboru Zjištění aktuální verze Testovací metody služby Test konverze dokumentu Test Licence produktu Test LTV služby Test OCR Engine Test Ověření formátu PDF/A Test Funkčnosti služby pro práci s časovými razítky Test funkčnosti Webové služby Testování, TRIAL verze

4 Úvod Software602 je serverovým softwarovým řešením pro vytváření a archivaci PDF dokumentů, které odpovídají mezinárodním normám a specifikacím poţadavků pro dlouhodobé uchování elektronických originálů dokumentů. Nabízí rozhraní pro manipulaci s elektronickými podpisy nejen PDF dokumentů, ale také Microsoft Office dokumentů, strukturovaných XML dat a obecných CMS dat. Jeho prostřednictvím lze dokumenty elektronicky podepisovat, opatřovat kvalifikovanými časovými razítky a dlouhodobě uchovávat v souladu s normami CAdES, PAdES a XAdES. Toto technické řešení odpovídá svým pojetím a kvalitou poţadavku na vytvoření sluţby vytvářející důvěru dle nařízení Evropského parlamentu a Rady (EU) č. 910/2014 o elektronické identifikaci a sluţbách vytvářejících důvěru pro elektronické transakce na vnitřním trhu. Zejména pak pro sluţbu ověřování platnosti kvalifikovaných elektronických podpisů a sluţbu uchovávání kvalifikovaných elektronických podpisů. Pro svůj provoz potřebuje aktivní uţivatelský účet na portálu LongTermDocs.eu, pomocí něhoţ vyuţívá sluţby kvalifikovaných časových razítek, ověřovací sluţby po zjištění platnosti elektronických certifikátů a registrační sluţby pro metadata jednotlivých dokumentů a souborů určených k archivaci. Sluţby pro dlouhodobou ověřitelnost LTV a sluţby kvalifikovaných razítek TSA poskytuje Secustamp.eu. Díky těmto sluţbám a moţnostem aplikace Software602 je moţné zajistit vznik či konverzi PDF dokumentu v archivním formátu PDF/A a zároveň zajistit jeho adekvátní zabezpečení elektronickým podpisem ve formátu PAdES pro zajištění jeho dlouhodobé ověřitelnosti autenticity a průkaznosti. SDK umožňuje integraci funkcí a operací nad dokumenty pomocí následujících rozhraní: Metody Webových sluţeb.net knihovny AdES_NET.dll a Software602.Converter.dll.NET knihovny jsou obsaţeny po instalaci SDK v adresáři Engine. Rozhraní.NET metod je opatřeno komentáři ve formě.xml dokumentace. Většina metod.net Assembly má stejné rozhraní jako metody webových sluţeb, které jsou detailně popsány níţe. Díky tomu je snadná integrace do jiných informačních systémů, či webových aplikacích. 4

5 Obrázek 1: Integrace Software602 SDK do aplikací třetích stran Slovník pojmů PAdES elektronicky podepsané PDF dokumenty podle normy ISO nebo standardů rodiny PAdES PAdES Basic, PAdES-BES, PAdES-EPES a PAdES-LTV CMS, PKCS7, CAdES elektronicky podepsaná (interně i externě) obecná data ve formátu CMS/PKCS7/CAdES. Můţe se například jednat o podepsanou ovou komunikaci, audio nebo video záznamy apod. Jedním z příkladů interně podepsaných dat podle CAdES jsou také Datové zprávy ISDS. XAdES elektronicky podepsané XML dokumenty podle standardů rodiny XAdES - ETSI TS Electronic Signatures and Infrastructures (ESI); XML Advanced Electronic Signatures (XAdES) PDF souborový formát pro ukládání dokumentů nezávisle na SW ani HW, na kterém byly pořízeny. Řízen normou ISO :2008. PDF/A oficiální archivační verze souborového formátu PDF. Jedná se o zúţení definice formátu PDF tak, aby bylo moţné soubory uloţené v PDF/A otevřít beze ztráty informace i všemi budoucími verzemi softwarových nástrojů. Definována v standardech ISO 19005:1-2008, ISO :2011 a ISO :2012. Dokument podepsaný PDF dokument nebo jiná podepsaná data ISDOC Information System Document - formát elektronické fakturace v ČR ISDS Informační systém datových schránek OID Object Identifier CRL seznam odvolaných certifikátů vydávaný certifikační autoritou, certifikát se odvolává např. z důvodu ztráty nebo zcizení soukromého klíče 5

6 Grace perioda čas během kterého je podpis v dokumentu příliš čerstvý na to, aby se dal ověřit vůči CRL seznamu certifikační autority. Zpravidla to bývá 24 hodin. Po této době je jiţ moţné platnost elektronického podpisu jednoznačně vyhodnotit. Občerstvení občerstvení dokumentu znamená ověření předcházejících podpisových certifikátů, staţení CRL seznamů a dalších informací nutných pro případně pozdější ověření těchto podpisových certifikátů. Přiloţení těchto informací k dokumentu a opatření dalším kvalifikovaným časovým razítkem. Reference ETSI TS v2.2.1: "Electronic Signatures and Infrastructures (ESI); XAdES Baseline Profile" ETSI TS v2.2.1: "Electronic Signatures and Infrastructures (ESI); CAdES Baseline Profile" ETSI TS v2.2.2: "Electronic Signatures and Infrastructures (ESI); PAdES Baseline Profile" ETSI TS v2.2.1: "Electronic Signatures and Infrastructures (ESI); ASiC Baseline Profile" ETSI TS : "Electronic Signatures and Infrastructures (ESI); PDF Advanced Electronic Signature Profiles;Part 1: PAdES Overview a framework document for PAdES" ETSI TS : "Electronic Signatures and Infrastructures (ESI); PDF Advanced Electronic Signature Profiles;Part 2: PAdES Basic Profile based on ISO " ETSI TS : "Electronic Signatures and Infrastructures (ESI); PDF Advanced Electronic Signature Profiles;Part 3: PAdES Enhanced PAdES-BES and PAdES-EPES Profiles" ETSI TS : "Electronic Signatures and Infrastructures (ESI); PDF Advanced Electronic Signature Profiles;Part 4: PAdES Long Term PAdES LTV Profile" IETF RFC 3852 (2004): "Cryptographic Message Syntax (CMS)" IETF RFC 3161: "Internet X.509 Public Key Infrastructure Time-Stamp Protocol (TSP)" Technické poţadavky 64-bitový operační systém MS Windows Server 2008 R2 SP1 nebo Windows Server 2012 (R2) nebo Windows Server 2016 Dvou nebo vícejádrový procesor Webový Server (IIS) s ASP.NET a.net Framework 3.5 i 4.0 nebo vyšším Vzhledem k zajištění vysoké prostupnosti je vhodné zajistit adekvátní velikost operační paměti a rychlost komunikačních rozhraní. Pro správnou funkčnost SDK je také zapotřebí, aby server (popřípadě firewall, proxy, apod.) nebránil komunikaci s adresami: a Dále je třeba mít povolené adresy pro kontrolu revokace certifikátu serveru. Aktuálně se jedná o certifikáty vydané od thawte SSL CA - G2: tj.symcd.com:80 t1.symcb.com:80 t2.symcb.com:80 6

7 Související poţadavky Aktivní uţivatelský účet na portálu LongTermDocs.eu prostřednictvím kterého uţivatel konzumuje konverzní sluţby a sluţby pro evidenci a dlouhodobou ověřitelnost dokumentu. Obrázek 2: Přehled operací nad dokumentem v procesu dlouhodobé archivace 7

8 Autorizace, Evidence a Ověření Sada metod webové sluţby pro zajištění autorizace, evidence a dlouhodobé ověřitelnosti dokumentu. Zprostředkovává uloţení AdES metadata dokumentu na registračním serveru, díky kterým je moţné rychle ověřit, který dokument je třeba k danému datu občerstvit, či v jakém stavu se nachází konkrétní dokument. Analýza dokumentu Ověření stavu dokumentu a jeho formátu (zahrnuje ověření certifikátů elektronických podpisů, značek a časových razítek, jejich kontrolu vůči CRL listu, kontrolu neporušenosti hashe dokumentu). Ověření formátu elektronického podpisu. Pokud je analyzovaný dokument v pořádku, je moţné jej přijmout k dlouhodobé archivaci a zajistit tak jeho digitální kontinuitu. Nejprve je třeba ověřit, zda jsou v případě daného dokumentu splněny podmínky pro jeho registraci na Server. K tomu slouţí metoda ltvanalyze, jejímţ výstupem pro uţivatele jsou informace o dokumentu a jeho certifikátech. Z jejího výsledku lze učinit závěr, za jakých okolností lze provést operace pro zajištění dlouhodobé průkaznosti dokumentu. Metoda webové služby ltvanalyze sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na Rozhraní SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvanalyze xmlns=" <Input>base64Binary</Input> <ExternalSignature>base64Binary</ExternalSignature> <Filename>string</Filename> <Params>string</Params> <Properties> <ballowunknowncertificateauthority>boolean</ballowunknowncertificateauthority> <revocationchecking>excluderoot or EndCertificateOnly or None</revocationChecking> <breturnvalidationmaterial>boolean</breturnvalidationmaterial> <breturnhtmlreport>boolean</breturnhtmlreport> <bcollapsedhtmlreport>boolean</bcollapsedhtmlreport> <Language>string</Language> </Properties> </ltvanalyze> <Input> 8

9 Base64Binary Base64Binary tvar analyzovaného dokumentu <ExternalSignature> Base64Binary Base64Binary tvar externího podpisu <FileType> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC ASiC_S_CAdES ASiC_S_XAdES ASiC_S_Tst definuje typ registrovaného dokumentu Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument XML data XML data z FO/ZFO formuláře aplikace Software602 Form Filler XML ISDOC data ASiC-S with CAdES ASiC-S with XAdES ASiC-S with Timestamp ASiC_E_CAdES_Tst ASiC-E with CAdES or Timestamp ASiC_E_XAdES MS_WORD MS_EXCEL MS_PWR_PNT ODF ASiC-E with XAdES Dokument aplikace MS Word Dokument aplikace MS Excel Dokument aplikace MS Powerpoint OpenDocumentFormat (OpenOffice) <Properties> <ballowunknowncertificateauthority> boolean Povolí analýzu podpisů od neuznávaných certifikačních autorit <revocationchecking> enum Stupeň kontroly odvolání certifikátů. Hodnoty ExcludeRoot, EndCertificateOnly, None <breturnvalidationmaterial> boolean Nastaví vrácení CRL seznamů v DocInfo 9

10 <breturnhtmlreport> boolean Nastaví vrácení HTML reportu v Error Message <bcollapsedhtmlreport> boolean Nastaví moţnost rozbalení HTML reportu ve stránce <Language> Definuje výstupní jazyk </Properties> Odpověď HTTP/ OK <ltvanalyzeresponse xmlns=" <ltvanalyzeresult> <siginfos> <SigInfo> <id>unsignedint</id> <sid>string</sid> <sigtimestamps xsi:nil="true" /> <sigtype>string</sigtype> <xmlsignedreferences xsi:nil="true" /> <pdfbyterange xsi:nil="true" /> <hasfurtherchanges>boolean</hasfurtherchanges> <Reason>string</Reason> <Location>string</Location> <Contact>string</Contact> </SigInfo> <SigInfo> <id>unsignedint</id> <sid>string</sid> <sigtimestamps xsi:nil="true" /> <sigtype>string</sigtype> <xmlsignedreferences xsi:nil="true" /> <pdfbyterange xsi:nil="true" /> <hasfurtherchanges>boolean</hasfurtherchanges> <Reason>string</Reason> <Location>string</Location> <Contact>string</Contact> </SigInfo> </siginfos> <doctype>string</doctype> <expiration>datetime</expiration> <docdatahash>base64binary</docdatahash> <docdatahashalg>string</docdatahashalg> <currsignhashalg>string</currsignhashalg> <globalstatus>string</globalstatus> </ltvanalyzeresult> <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvanalyzeresponse> 10

11 <ltvanalyzeresult> <siginfos> <SigInfo> <id> unsignedint Pořadové číslo podpisu tak, jak byl přidán do dokumentu. Počítáno od nuly. <sid> Unikátní identifikátor podpisu. <sigtimestamps> XML struktura nepovinný parametr, je závislý na existenci časového razítka u podpisu Informace o časovém razítku přidaném jako atribut k digitálnímu podpisu. Stejná XML struktura informací jako u nadřazeného podpisu. Tedy obsahuje element SigInfo viz výše včetně všech jeho potomků. Informace v potomcích se váţí k certifikátu časového razítka. <sigtype> enum Typ podpisu. Hodnoty UNKNOWN; STANDARD; XML602FORM_TECHNICAL <xmlsignedreferences> nepovinný parametr, je závislý na formátu vstupního souboru (jen pro XML/ZFO) XML struktura <pdfbyterange> XML struktura Data podpisu nepovinný parametr, je závislý na formátu vstupního souboru (jen pro PDF) Bytový rozsah PDF podpisů <hasfurtherchanges> Boolean Údaj, zda byly v dokumentu provedeny změny po podpisu. Hodnoty: 0, 1 <Reason> Důvod podepsání dokumentu. <Location> 11

12 Místo podepsání dokumentu. <Contact> Kontaktní informace k podepsání dokumentu. </SigInfo> </siginfos> <doctype> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC ASiC_S_CAdES ASiC_S_XAdES ASiC_S_Tst ASiC_E_CAdES_Tst ASiC_E_XAdES MS_WORD MS_EXCEL MS_PWR_PNT ODF Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument Podepsaná XML data Podepsaná XML data z FO/ZFO formuláře aplikace Software602 Form Filler Podepsaná XML ISDOC data ASiC-S with CAdES ASiC-S with XAdES ASiC-S with Timestamp ASiC-E with CAdES or Timestamp ASiC-E with XAdES Podepsaný dokument aplikace MS Word Podepsaný dokument aplikace MS Excel Podepsaný dokument aplikace MS Powerpoint OpenDocumentFormat (OpenOffice) <expiration> DateTime Datum a čas vypršení ověřitelnosti celého dokumentu. Po tomto datu nebude moţné ověřit platnost podpisových certifikátů a zajistit další ověřitelnost a platnost dokumentu. <docdatahash> Base64Binary Hash analyzovaného dokumentu v kódování Base64Binary. Algoritmus výpočtu hashe je v následujícícm elementu docdatahashalg. <docdatahashalg> 12

13 Algoritmus výpočtu hashe analyzovaného dokumentu. Ve tvaru například: <currsignhashalg> Algoritmus výpočtu hashe posledního podpisu. Příklad: <globalstatus> Sumarizuje stav dokumentu na základě všech podpisů a časových razítek. Můţe nabývat hodnot: OK = 0 (Všechny podpisy a dokumentová časová razítka jsou platná) WARNING = 1 (Nelze určit platnost některých podpisových certifikátů nebo dokumentových časových razítek) ERROR = 2 (Některé podpisy nebo dokumentová časová razítka jsou neplatná, např. odvolaný certifikát, poškozený hash dokumentu, vizuální změny po podpisu atd.) NO_SIGNATURES = 3 (Dokument neobsahuje ţádné podpisy ani dokumentová časová razítka) </ltvanalyzeresult> <StatusCode> Int Číselná hodnota vyjadřující status ověření <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode 13

14 Registrace dokumentu Registrace dokumentu na Long-TermDocs server, přidělení unikátního ID a AdES metadat dokumentu. Opatření dokumentu novým archivním časovým razítkem. Struktura podpisu dokumentu po registraci vyhovuje specifikaci PAdES, CAdES nebo XAdES. Do registrace - metoda ltvregister - můţe vstoupit dokument, který má alespoň jedno časové razítko nebo jeden podpis a časové razítko a zároveň uplynula tzv. grace perioda, kdy je moţné ověřit, ţe certifikát podpisu nebyl revokován a je vydán důvěryhodnou autoritou a výsledek tohoto ověření je v pořádku. Jsou-li podpisy na dokumentu shledány platnými, připojí k nim proces registrace revokační data získaná při předchozí analýze dokumentu dojde k opatření dokumentu časovým razítkem. Následně se provede registrace metadat dokumentu na server. Při registraci je dokumentu přiděleno unikátní ID a uţivatel má moţnost zvolit zatřiďovací informace. Z výše uvedeného vyplývá, ţe při poţadavku na registraci dokumentu je nejprve provedena kontrola integrity dokumentu a kontrola podpisů metoda ltvanalyze. Pokud je dokument v pořádku, dojde k výpočtu hashe dokumentu a vyţádání časového razítka k tomuto hash. Zároveň je zaznamenán algoritmus výpočtu hashe. Ţádost o časové razítko a odpověď ţádosti je v souladu se specifikací RFC Po obdrţení časového razítka je dokument podepsán, opatřen tímto časovým razítkem dle specifikace PAdES ETSI TS v CAdES ETSI TS v XAdES ETSI TS v Odpovědí je evidenční číslo registrovaného dokumentu DocId. Software602 vytváří dokument v souladu s LTV poţadavky na dlouhodobou ověřitelnost dokumentu. Metoda webové služby ltvregister sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvregister xmlns=" <proposeddocid>string</proposeddocid> <Input>base64Binary</Input> <ExternalSignature>base64Binary</ExternalSignature> <FileType>UNKNOWN or CMSPKCS7 or CMSPKCS7Ext or PDF or XML or XML602FORM or XMLISDOC or ASiC_S_CAdES or ASiC_S_XAdES or ASiC_S_Tst or ASiC_E_CAdES_Tst or ASiC_E_XAdES or MS_WORD or MS_EXCEL or MS_PWR_PNT or ODF</FileType> <sortinfo>string</sortinfo> <bforce>boolean</bforce> </ltvregister> 14

15 <proposeddocid> Navrhované ID dokumentu, které se pouţije pro registraci. Pokud není vyplněno, bude toto číslo dokumentu automaticky přiřazeno při registraci a vráceno v odpovědi. <Input> Base64Binary Base64Binary tvar dokumentu pro registraci <ExternalSignature> Base64Binary Base64Binary tvar externího podpisu pro registraci (jen pro XAdES soubory) <FileType> definuje typ registrovaného dokumentu UNKNOWN Neznámý typ dokumentu CMSPKCS7 Dokument podepsaný interním CMS/PKCS7 podpisem CMSPKCS7Ext Dokument podepsaný externím CMS/PKCS7 podpisem PDF PDF dokument XML XML data XML602Form XML data z FO/ZFO formuláře aplikace Software602 Form Filler XMLISDOC XML ISDOC data ASiC_S_CAdES ASiC-S with CAdES ASiC_S_XAdES ASiC-S with XAdES ASiC_S_Tst ASiC-S with Timestamp ASiC_E_CAdES_Tst ASiC-E with CAdES or Timestamp ASiC_E_XAdES ASiC-E with XAdES MS_WORD Dokument aplikace MS Word MS_EXCEL Dokument aplikace MS Excel MS_PWR_PNT Dokument aplikace MS Powerpoint ODF OpenDocumentFormat (OpenOffice) <sortinfo> Zatřiďovací informace registrovaného dokumentu. Zadává se ve tvaru názvu sloţky, či adresářové struktury sloţek do které mají být uloţeny registrační informace. Tyto informace lze vyuţít i pro vyhledání informací o dokumentech. Příklad zápisu: /FA/2012/06/ 15

16 <bforce> Boolean Logická hodnota, kterou je moţné vynutit registraci dokumentu, který nevyhovuje podmínkám pro registraci tedy neprošel analytickým procesem metody ltvanalyze Odpověď HTTP/ OK <ltvregisterresponse xmlns=" <ltvregisterresult> <docid>string</docid> <sids> <string>string</string> <string>string</string> </sids> <sortinfo>string</sortinfo> <doctype>string</doctype> <expiration>datetime</expiration> <docdatahash>base64binary</docdatahash> <docdatahashalg>string</docdatahashalg> <currsignhashalg>string</currsignhashalg> </ltvregisterresult> <Output>base64Binary</Output> <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvregisterresponse> <ltvregisterresult> <docid> Jednoznačné identifikační číslo registrovaného dokumentu. Pokud nebylo vyplněno v Poţadavku, bylo automaticky vygenerováno při procesu registrace na Serveru. Pod tímto číslem je moţné později klást dotazy Serveru na stav dokumentu a jeho podpisových certifikátů <sids> <string> Seznam identifikátorů podpisů, které k danému dokumentu eviduje registrační Server </sids> <sortinfo> 16

17 Zatřiďovací informace sloţka, nebo struktura vnořených sloţek ve kterých je dokument registrován <doctype> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC ASiC_S_CAdES ASiC_S_XAdES ASiC_S_Tst ASiC_E_CAdES_Tst ASiC_E_XAdES MS_WORD MS_EXCEL MS_PWR_PNT ODF Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument Podepsaná XML data Podepsaná XML data z FO/ZFO formuláře aplikace Software602 Form Filler Podepsaná XML ISDOC data ASiC-S with CAdES ASiC-S with XAdES ASiC-S with Timestamp ASiC-E with CAdES or Timestamp ASiC-E with XAdES Podepsaný dokument aplikace MS Word Podepsaný dokument aplikace MS Excel Podepsaný dokument aplikace MS Powerpoint OpenDocumentFormat (OpenOffice) <expiration> DateTime Datum a čas vypršení ověřitelnosti platnosti celého dokumentu. Po tomto datu nebude moţné ověřit platnost podpisových certifikátů a zajistit další ověřitelnost a platnost dokumentu. <docdatahash> Base64Binary Hash analyzovaného dokumentu v kódování Base4. Algoritmus výpočtu hashe je v následujícícm elementu docdatahashalg. <docdatahashalg> Algoritmus výpočtu hashe analyzovaného dokumentu. Ve tvaru například: <currsignhashalg> 17

18 Algoritmus výpočtu hashe posledního podpisu. Příklad: </ltvregisterresult> <Output> Base64Binary Base64Binary tvar dokumentu pro registraci <StatusCode> Int Číselná hodnota vyjadřující status ověření <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode 18

19 Aktualizace registrovaného dokumentu Aktualizace dříve registrovaného dokumentu před vypršením posledního archivního časového razítka. Opatření dokumentu novým archivním časovým razítkem. Při aktualizaci dokumentu se vţdy provede kontrola podpisových certifikátů dokumentu metodou ltvanalyze pro zajištění oprávněnosti další registrace dokumentu. Metoda webové služby ltvupdate sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvupdate xmlns=" <docid>string</docid> <Input>base64Binary</Input> <ExternalSignature>base64Binary</ExternalSignature> <FileType>UNKNOWN or CMSPKCS7 or CMSPKCS7Ext or PDF or XML or XML602FORM or XMLISDOC or ASiC_S_CAdES or ASiC_S_XAdES or ASiC_S_Tst or ASiC_E_CAdES_Tst or ASiC_E_XAdES or MS_WORD or MS_EXCEL or MS_PWR_PNT or ODF</FileType> <sortinfo>string</sortinfo> <updateallsignatures>boolean</updateallsignatures> </ltvupdate> <docid> Jednoznačné identifikační číslo registrovaného dokumentu. <Input> Base64Binary Base64Binary tvar PDF dokumentu pro aktualizaci <ExternalSignature> Base64Binary Base64Binary tvar externího podpisu pro registraci 19

20 <FileType> definuje typ registrovaného dokumentu UNKNOWN Neznámý typ dokumentu CMSPKCS7 Dokument podepsaný interním CMS/PKCS7 podpisem CMSPKCS7Ext Dokument podepsaný externím CMS/PKCS7 podpisem PDF PDF dokument XML XML data XML602Form XML data z FO/ZFO formuláře aplikace Software602 Form Filler XMLISDOC XML ISDOC data ASiC_S_CAdES ASiC-S with CAdES ASiC_S_XAdES ASiC-S with XAdES ASiC_S_Tst ASiC-S with Timestamp ASiC_E_CAdES_Tst ASiC-E with CAdES or Timestamp ASiC_E_XAdES ASiC-E with XAdES MS_WORD Dokument aplikace MS Word MS_EXCEL Dokument aplikace MS Excel MS_PWR_PNT Dokument aplikace MS Powerpoint ODF OpenDocumentFormat (OpenOffice) <sortinfo> Zatřiďovací informace sloţka, nebo struktura vnořených sloţek do kterých má být dokument registrován po aktualizaci. (Např. /FA/2012/06) <updateallsignatures> Boolean Logická hodnota, určuje zda se mají aktualizovat revokační informace pro všechny podpisy. Zpracování můţe být časově náročnější, ale je tak moţné ke starším podpisům doplnit revokační informace, které při minulých aktualizacích nebyly k dispozici nebo se je nepodařilo přidat. Pokud je nastaveno false, aktualizuje se pouze poslední časové razítko. Odpověď HTTP/ OK <ltvupdateresponse xmlns=" <ltvupdateresult> <docid>string</docid> <sids> 20

21 <string>string</string> <string>string</string> </sids> <sortinfo>string</sortinfo> <doctype>string</doctype> <expiration>datetime</expiration> <docdatahash>base64binary</docdatahash> <docdatahashalg>string</docdatahashalg> <currsignhashalg>string</currsignhashalg> </ltvupdateresult> <Output>base64Binary</Output> <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvupdateresponse> <ltvupdateresult> <docid> Jednoznačné identifikační číslo aktualizovanéhodokumentu.pod tímto číslem je moţné později klást dotazy Serveru na stav dokumentu a jeho podpisových certifikátů <sids> <string> Seznam identifikátorů podpisů, které k danému dokumentu eviduje registrační Server </sids> <sortinfo> Zatřiďovací informace sloţka, nebo struktura vnořených sloţek ve kterých je dokument registrován po aktualizaci. <doctype> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC ASiC_S_CAdES ASiC_S_XAdES Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument Podepsaná XML data Podepsaná XML data z FO/ZFO formuláře aplikace Software602 Form Filler Podepsaná XML ISDOC data ASiC-S with CAdES ASiC-S with XAdES 21

22 ASiC_S_Tst ASiC_E_CAdES_Tst ASiC_E_XAdES MS_WORD MS_EXCEL MS_PWR_PNT ODF ASiC-S with Timestamp ASiC-E with CAdES or Timestamp ASiC-E with XAdES Podepsaný dokument aplikace MS Word Podepsaný dokument aplikace MS Excel Podepsaný dokument aplikace MS Powerpoint OpenDocumentFormat (OpenOffice) <expiration> DateTime Datum a čas vypršení ověřitelnosti platnosti celého dokumentu. Po tomto datu nebude moţné ověřit platnost podpisových certifikátů a zajistit další ověřitelnost a platnost dokumentu. <docdatahash> Base64Binary Hash analyzovaného dokumentu v kódování Base4. Algoritmus výpočtu hashe je v následujícícm elementu docdatahashalg. <docdatahashalg> Algoritmus výpočtu hashe analyzovaného dokumentu. Ve tvaru například: <currsignhashalg> Algoritmus výpočtu hashe posledního podpisu. Příklad: </ltvupdateresult> <Output> Base64Binary Base64Binary tvar aktualizovaného dokumentu <StatusCode> Int Číselná hodnota vyjadřující status ověření <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode 22

23 Zjištění stavu dokumentu Funkce ltvgetinfo vrací informace o zadaném ID dokumentu, či skupině dokumentů, které vyhovují zadanému filtru. Struktura odpovědi definuje obsah výstupu z evidenčního serveru. Dotaz je moţné koncipovat na konkrétní ID, nebo jej vztáhnout na konkrétní datum expirace dokumentu Metoda webové služby ltvgetinfo sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvgetinfo xmlns=" <docid>string</docid> </ltvgetinfo> <docid> Jednoznačné identifikační číslo registrovaného dokumentu. Metoda vrací informace o podpisových certifikátech registrovaného dokumentu. Odpověď HTTP/ OK <ltvgetinforesponse xmlns=" <ltvgetinforesult> <docid>string</docid> <sids> <string>string</string> <string>string</string> </sids> <sortinfo>string</sortinfo> <doctype>string</doctype> <expiration>datetime</expiration> <docdatahash>base64binary</docdatahash> <docdatahashalg>string</docdatahashalg> 23

24 <currsignhashalg>string</currsignhashalg> </ltvgetinforesult> <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvgetinforesponse> <ltvgetinforesult> <docid> Jednoznačné identifikační číslo registrovaného dokumentu, ke kterému se vrací zjištěné informace. V případě dotazu na sloţku nebo rozhodné datum expirace je v odpovědi odpovídající počet informací k dokumentům <sids> <string> Seznam identifikátorů podpisů, které k danému dokumentu eviduje registrační Server </sids> <sortinfo> Zatřiďovací informace sloţka, nebo struktura vnořených sloţek ve kterých je dokument registrován <doctype> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC ASiC_S_CAdES ASiC_S_XAdES ASiC_S_Tst ASiC_E_CAdES_Tst ASiC_E_XAdES MS_WORD Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument Podepsaná XML data Podepsaná XML data z FO/ZFO formuláře aplikace Software602 Form Filler Podepsaná XML ISDOC data ASiC-S with CAdES ASiC-S with XAdES ASiC-S with Timestamp ASiC-E with CAdES or Timestamp ASiC-E with XAdES Podepsaný dokument aplikace MS Word 24

25 MS_EXCEL MS_PWR_PNT ODF Podepsaný dokument aplikace MS Excel Podepsaný dokument aplikace MS Powerpoint OpenDocumentFormat (OpenOffice) <expiration> DateTime Datum a čas vypršení ověřitelnosti platnosti celého dokumentu. Po tomto datu nebude moţné ověřit platnost podpisových certifikátů a zajistit další ověřitelnost a platnost dokumentu. <docdatahash> Base64Binary Hash analyzovaného dokumentu v kódování Base4. Algoritmus výpočtu hashe je v následujícím elementu docdatahashalg. <docdatahashalg> Algoritmus výpočtu hashe analyzovaného dokumentu. Ve tvaru například: <currsignhashalg> Algoritmus výpočtu hashe posledního podpisu. Příklad: </ltvgetinforesult> <StatusCode> Int Číselná hodnota vyjadřující status ověření <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode Struktura <DocEvidence> se opakuje pro každý dokument, který odpovídal specifikacím dotazu. 25

26 Odregistrace dokumentu Kaţdý dokument je moţné z procesu dlouhodobé archivace vyjmout a odstranit tak informace o archiválii metodou ltvunregister. Metoda webové služby ltvunregister sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvunregister xmlns=" <docid>string</docid> </ltvunregister> <docid> Jednoznačné identifikační číslo registrovaného dokumentu.veškeré informace o registrovaném dokumentu budou odstraněny. Odpověď HTTP/ OK <ltvunregisterresponse xmlns=" <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvunregisterresponse> <ltvunregisterresult> Int Výsledek metody ltvunregister. 0 = v pořádku <StatusCode> 26

27 Int Číselná hodnota vyjadřující status ověření <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode 27

28 Dokumenty k občerstvení Slouţí pro zjištění, které dokumenty je nutné občerstvit k zadanému datu. Výsledkem metody ltvgetforupdate je seznam ID dokumentů. Výpis je moţné omezit jen na určitý počet dokumentů, řazeny jsou chronologicky. Zároveň je moţné omezit výběr na vybranou archivační sloţku definovat zatřiďovací informaci pro filtrování selekce. Metoda webové služby ltvgetforupdate sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvgetforupdate xmlns=" <expirationlimit>datetime</expirationlimit> <sortinfomask>string</sortinfomask> <FileType>UNKNOWN or CMSPKCS7 or CMSPKCS7Ext or PDF or XML or XML602FORM or XMLISDOC or ASiC_S_CAdES or ASiC_S_XAdES or ASiC_S_Tst or ASiC_E_CAdES_Tst or ASiC_E_XAdES or MS_WORD or MS_EXCEL or MS_PWR_PNT or ODF</FileType> <ResCount>int</ResCount> </ltvgetforupdate> <expirationlimit> DateTime Datum a čas, ke kterému se vyhledají dokumenty, které je nutné občerstvit <sortinfomask> Vrací informace o dokumentech z dané zatřiďovací sloţky. (Např. /FA/2012/06) <FileType> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML definuje typ registrovaného dokumentu Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument XML data 28

29 XML602Form XMLISDOC XML data z FO/ZFO formuláře aplikace Software602 Form Filler XML ISDOC data ASiC_S_CAdES ASiC-S with CAdES ASiC_S_XAdES ASiC-S with XAdES ASiC_S_Tst ASiC-S with Timestamp ASiC_E_CAdES_Tst ASiC-E with CAdES or Timestamp ASiC_E_XAdES ASiC-E with XAdES MS_WORD Dokument aplikace MS Word MS_EXCEL Dokument aplikace MS Excel MS_PWR_PNT Dokument aplikace MS Powerpoint ODF OpenDocumentFormat (OpenOffice) <ResCount> int Maximální počet souborů v odpovědi Odpověď HTTP/ OK <ltvgetforupdateresponse xmlns=" <ltvgetforupdateresult> <string>string</string> <string>string</string> </ltvgetforupdateresult> <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvgetforupdateresponse> <ltvgetforupdateresult> <string> V jednotlivých elementech typu <>jsou uvedeny DocId identifikační čísla dokumentů, které je nutné k rozhodnému datu občerstvit </ltvgetforupdateresult> <StatusCode> 29

30 Int Číselná hodnota vyjadřující status ověření <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode 30

31 Přímé podepsání dokumentu V případě potřeby podepsání dokumentu elektronickým podpisem bez vazby na archivaci je moţné pomocí funkce ltvsign vytvořit podpis v dokumentu. Cestu k podpisovému certifikátu ve formátu PFX/PEM a přístupové heslo k němu je potřebné nastavit v souboru Web.config umístěném v adresáři WebService. <add key="ltv_signingcertpath" value=""/> a <add key="ltv_signingcertpass" value=" "/> Metoda webové služby ltvsign sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvsign xmlns=" <Input>base64Binary</Input> <FileType>UNKNOWN or CMSPKCS7 or CMSPKCS7Ext or PDF or XML or XML602FORM or XMLISDOC or ASiC_S_CAdES or ASiC_S_XAdES or ASiC_S_Tst or ASiC_E_CAdES_Tst or ASiC_E_XAdES or MS_WORD or MS_EXCEL or MS_PWR_PNT or ODF</FileType> <baddsigntimestamp>boolean</baddsigntimestamp> <SignatureType>DEFAULT or ENVELOPED or DETACHED or ENCAPSULATE</SignatureType> </ltvsign> <Input> Base64Binary Soubor v kódování Base64Binary, který má být podepsán specifikovaným certifikátem <FileType> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC ASiC_S_CAdES ASiC_S_XAdES definuje typ podepisovaného dokumentu Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument XML data XML data z FO/ZFO formuláře aplikace Software602 Form Filler XML ISDOC data ASiC-S with CAdES ASiC-S with XAdES 31

32 ASiC_S_Tst ASiC-S with Timestamp ASiC_E_CAdES_Tst ASiC-E with CAdES or Timestamp ASiC_E_XAdES MS_WORD MS_EXCEL MS_PWR_PNT ODF ASiC-E with XAdES Dokument aplikace MS Word Dokument aplikace MS Excel Dokument aplikace MS Powerpoint OpenDocumentFormat (OpenOffice) <baddsigntimestamp> Boolean Definuje, zda k podpisu bude přidáno podpisové časové razítko <SignatureType> Typ elektronického podpisu. Můţe mít tyto hodnoty: enum DEFAULT - Výchozí hodnota pro kaţdý typ dokumentu ENVELOPED - Speciální formát pro XAdES podpisy DETACHED - Speciální formát pro XAdES podpisy ENCAPSULATE - Speciální formát pro CAdES podpisy Odpověď HTTP/ OK <ltvsignresponse xmlns=" <Output>base64Binary</Output> <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvsignresponse> <Output> Base64Binary Podepsaný dokument v kódování Base64Binary. <StatusCode> Int Číselná hodnota vyjadřující status ověření 32

33 <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode Přímé podepsání dokumentu certifikátem na kartě Hardware Security Modulu Pro podepsání dokumentu certifikátem uloţeným na čipové kartě vloţené v Hardware Security Modulu (HSM) je k dispozici metoda ltvsign2. K identifikaci a pouţití certifikátů z karty jsou oproti předchozí metodě ltvsign nově dostupné parametry CertificateID a PrivateKeyPIN. Před pouţitím metody je nutné upravit cestu k PKCS#11 modulu, kterou zjistíte v dokumentaci příslušného zařízení. Cesty se upravují jak v konfiguračním souboru InstallDir\Engine\AdES\SunPKCS11.cfg, tak také ve spouštěcím souboru InstallDir\Engine\Misc\Configure_PKCS11.bat, který se vyuţívá pro tuto metodu a metody ConvertFile a ConvertFileEx. V obou souborech jsou přednastavené výchozí cesty pro HSM od Thales nshied. Po nastavení odpovídajících cest Vašeho zařízení spusťte dávkový soubor. Metoda webové služby ltvsign2 sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek <ltvsign2 xmlns=" <Input>base64Binary</Input> <FileType>UNKNOWN or CMSPKCS7 or CMSPKCS7Ext or PDF or XML or XML602FORM or XMLISDOC or ASiC_S_CAdES or ASiC_S_XAdES or ASiC_S_Tst or ASiC_E_CAdES_Tst or ASiC_E_XAdES or MS_WORD or MS_EXCEL or MS_PWR_PNT or ODF</FileType> <CertificateID>string</CertificateID> <PrivateKeyPIN>string</PrivateKeyPIN> <baddsigntimestamp>boolean</baddsigntimestamp> <SignatureType>DEFAULT or ENVELOPED or DETACHED or ENCAPSULATE</SignatureType> </ltvsign2> <Input> Base64Binary Soubor v kódování Base64Binary, který má být podepsán specifikovaným certifikátem <FileType> UNKNOWN CMSPKCS7 CMSPKCS7Ext definuje typ podepisovaného dokumentu Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem 33

34 PDF XML PDF dokument XML data XML602Form XML data z FO/ZFO formuláře aplikace Software602 Form Filler XMLISDOC XML ISDOC data ASiC_S_CAdES ASiC-S with CAdES ASiC_S_XAdES ASiC-S with XAdES ASiC_S_Tst ASiC-S with Timestamp ASiC_E_CAdES_Tst ASiC-E with CAdES or Timestamp ASiC_E_XAdES ASiC-E with XAdES MS_WORD Dokument aplikace MS Word MS_EXCEL Dokument aplikace MS Excel MS_PWR_PNT Dokument aplikace MS Powerpoint ODF OpenDocumentFormat (OpenOffice) <CertificateID> Identifikátor podpisového certifikátu z čipové karty (klíčenky). Pouţívá se ve tvaru: "PKCS11:alias:" // Format PKCS11:alias:<alias_certifikátu> <PrivateKeyPIN> Heslo k privátnímu klíči specifikovaného certifikátu <baddsigntimestamp> Boolean Definuje, zda k podpisu bude přidáno podpisové časové razítko <SignatureType> Typ elektronického podpisu. Můţe mít tyto hodnoty: enum DEFAULT - Výchozí hodnota pro kaţdý typ dokumentu ENVELOPED - Speciální formát pro XAdES podpisy DETACHED - Speciální formát pro XAdES podpisy ENCAPSULATE - Speciální formát pro CAdES podpisy 34

35 Přímé opatření dokumentu časovým razítkem V případě potřeby pro opatření dokumentu elektronickým časovým razítkem bez vazby na archivaci. Je moţné opatřit dokument časovým razítkem pomocí funkce ltvtimestamp. Metoda webové služby ltvtimestamp sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ltvtimestamp xmlns=" <Input>base64Binary</Input> <ExternalSignature>base64Binary</ExternalSignature> <FileType>UNKNOWN or CMSPKCS7 or CMSPKCS7Ext or PDF or XML or XML602FORM or XMLISDOC or ASiC_S_CAdES or ASiC_S_XAdES or ASiC_S_Tst or ASiC_E_CAdES_Tst or ASiC_E_XAdES or MS_WORD or MS_EXCEL or MS_PWR_PNT or ODF</FileType> </ltvtimestamp> <Input> Base64Binary Soubor v kódování Base64Binary, který má být opatřen časovým razítkem <ExternalSignature> Base64Binary Base64Binary tvar externího podpisu k dokumentu s časovým razítkem <FileType> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC definuje typ dokumentu Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument XML data XML data z FO/ZFO formuláře aplikace Software602 Form Filler XML ISDOC data 35

36 ASiC_S_CAdES ASiC_S_XAdES ASiC-S with CAdES ASiC-S with XAdES ASiC_S_Tst ASiC-S with Timestamp ASiC_E_CAdES_Tst ASiC-E with CAdES or Timestamp ASiC_E_XAdES ASiC-E with XAdES MS_WORD Dokument aplikace MS Word MS_EXCEL Dokument aplikace MS Excel MS_PWR_PNT Dokument aplikace MS Powerpoint ODF OpenDocumentFormat (OpenOffice) Odpověď HTTP/ OK <ltvtimestampresponse xmlns=" <Output>base64Binary</Output> <StatusCode>int</StatusCode> <StatusMessage>string</StatusMessage> </ltvtimestampresponse> <Output> Base64Binary Dokument opatřený časovým razítkem v kódování Base64Binary. V případě externího podpisu obsahuje data podpisu. <StatusCode> Int Číselná hodnota vyjadřující status ověření <StatusMessage> Textová zpráva odpovídající hodnotě StatusCode 36

37 Konverzní a ostatní služby Sada funkcí pro zajištění formátu dokumentu do standardního formátu PDF dle ISO :2008 a archivního formátu PDF/A dle standardu pro dlouhodobou archivaci ISO :2002, ISO :2011 a ISO :2012. Konverze dokumentů do PDF či PDF/A (Print2PDF) Webová sluţba umoţňuje provést na serveru konverzi libovolného dokumentu do formátu PDF, či PDF/A podle zvoleného profilu konverze. Je moţné nastavit úroveň souladu se specifikací PDF/A, podepsání dokumentu elektronickou značkou, opatření kvalifikovaným časovým razítkem, opatření vodotiskem a další nastavení v rámci kaţdého profilu. Na serveru je nutné mít aplikaci, která umí přečíst formát konvertovaného souboru například pro dokumenty formátu *.docx aplikace Microsoft Word nebo Open Office. Více informací o poţadavcích na aplikaci a nastavení pro konverzní sluţby najdete v dokumentu Příručka Administrátora (kapitola 8). Metoda webové služby ConvertFile Tato metoda je určena hlavně pro zpětnou kompatibilitu s Print2PDF 9. Názvy profilových souborů lze získat metodou GetProfileList. sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na: SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ConvertFile xmlns=" <Input>base64Binary</Input> <FileName>string</FileName> <Profile>string</Profile> </ConvertFile> <Input> Base64Binary libovolný dokument v kódování Base64Binary, určený ke konverzi do formátu PDF, či PDF/A dle zvoleného konverzního profilu <FileName> Jméno vstupního souboru včetně přípony 37

38 <Profile> Název konverzního profilu Konverzní profil je moţné jednoduše vytvořit na serverové straně v aplikaci. Odpověď HTTP/ OK <ConvertFileResponse xmlns=" <ConvertFileResult>int</ConvertFileResult> <Output>base64Binary</Output> <Report>string</Report> </ConvertFileResponse> <ConvertFileResult> Int Výsledek metody ConvertFile. 0 = v pořádku <Output> Base64Binary Base64Binary tvar konvertovaného dokumentu v odpovídajícím formátu PDF či PDF/A ve tvaru dle zvoleného konverzního profilu. <Report> XML report - šablona reportu je v instalačním adresáři v souboru Report.xml. Při převodu se do šablony doplní zvolené údaje, např. jméno dokumentu, čas převodu, výsledek převodu, hash vstupního a výstupního souboru, informace o podpisech převáděného PDF souboru atd. 38

39 Konverze dokumentů do PDF či PDF/A Webová sluţba umoţňuje provést na serveru konverzi libovolného dokumentu do formátu PDF, či PDF/A podle definovaných poţadavků v konfigurační struktuře poţadavku. Je moţné nastavit úroveň souladu se specifikací PDF/A, podepsání dokumentu elektronickou značkou, opatření kvalifikovaným časovým razítkem, opatření vodotiskem a další nastavení. Na serveru je nutné mít aplikaci, která umí přečíst formát konvertovaného souboru například pro dokumenty formátu *.docx aplikace Microsoft Word nebo Open Office. Více informací o poţadavcích na aplikaci a nastavení pro konverzní sluţby najdete v dokumentu Příručka Administrátora (kapitola 8). Metoda webové služby ConvertFileEx sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ConvertFileEx xmlns=" <Input>base64Binary</Input> <FileName>string</FileName> <Options> <RemoveEmptyPages>boolean</RemoveEmptyPages> <ReportLanguage>string</ReportLanguage> <OCRLanguage>string</OCRLanguage> <OCRRecognitionDpi>int</OCRRecognitionDpi> <ForceShell>string</ForceShell> <PdfFormat>PDF or PDF_A_1b or PDF_A_1a or PDF_A_2b or PDF_A_2a or PDF_A_2u or PDF_A_3b or PDF_A_3a or PDF_A_3u or PDF_X_1 or PDF_X_3 or PDF_X_4 or PDF_X_5</PdfFormat> <ForcePDFVersion>string</ForcePDFVersion> <BarcodeInfo> <PosX>double</PosX> <PosY>double</PosY> <Width>double</Width> <Height>double</Height> <Type>Barcode_1D_UPCVersionA or Barcode_1D_UPCVersionE or Barcode_1D_UPCSupplemental2Digit or Barcode_1D_UPCSupplemental5Digit or Barcode_1D_EAN13 or Barcode_1D_EAN8 or Barcode_1D_Interleaved2of5 or Barcode_1D_Standard2of5 or Barcode_1D_Industrial2of5 or Barcode_1D_Code39 or Barcode_1D_Code39Extended or Barcode_1D_Codabar or Barcode_1D_PostNet or Barcode_1D_Bookland or Barcode_1D_ISBN or Barcode_1D_JAN13 or Barcode_1D_MSIMod10 or Barcode_1D_MSI2Mod10 or Barcode_1D_MSIMod11 or Barcode_1D_MSIMod11Mod10 or Barcode_1D_ModifiedPlessey or Barcode_1D_Code11 or Barcode_1D_USD8 or Barcode_1D_UCC12 or Barcode_1D_UCC13 or Barcode_1D_LOGMARS or Barcode_1D_Code128 or Barcode_1D_Code128A or Barcode_1D_Code128B or Barcode_1D_Code128C or Barcode_1D_ITF14 or Barcode_1D_Code93 or Barcode_1D_TelePen or Barcode_PDF417 or Barcode_QR or Barcode_DataMatrix</Type> <Data>string</Data> <Description>string</Description> <Pages>string</Pages> </BarcodeInfo> <ZFO> <AttSettings> <ConversionHandling>IGNORE_ATTACHMENTS or ATTACH_WITHOUT_CONVERSION or CONVERT_FAILURE_END or CONVERT_FAILURE_SKIP or CONVERT_FAILURE_ATTACH_ORIGINAL or CONVERT_ALWAYS_ATTACH_ORIGINAL</ConversionHandling> <AllowedFiletypes>string</AllowedFiletypes> 39

40 </AttSettings> <ConvertDZ>boolean</ConvertDZ> </ZFO> <EML> <AttSettings> <ConversionHandling>IGNORE_ATTACHMENTS or ATTACH_WITHOUT_CONVERSION or CONVERT_FAILURE_END or CONVERT_FAILURE_SKIP or CONVERT_FAILURE_ATTACH_ORIGINAL or CONVERT_ALWAYS_ATTACH_ORIGINAL</ConversionHandling> <AllowedFiletypes>string</AllowedFiletypes> </AttSettings> <CertificatePath>string</CertificatePath> <Decrypt>boolean</Decrypt> <ExportSignature>boolean</ExportSignature> <HeaderLanguage>string</HeaderLanguage> </EML> <HTML> <Header>string</Header> <AvoidTextBreak>boolean</AvoidTextBreak> <AvoidImageBreak>boolean</AvoidImageBreak> <ArchiveHeaderLanguage>string</ArchiveHeaderLanguage> <HeaderHeight>int</HeaderHeight> <Footer>string</Footer> <FooterHeight>int</FooterHeight> <PageEncoding> <EncoderFallback xsi:nil="true" /> <DecoderFallback xsi:nil="true" /> </PageEncoding> <BaseURL>string</BaseURL> <DownloadReferencedFiles>boolean</DownloadReferencedFiles> <DoArchive>boolean</DoArchive> <FitWidth>boolean</FitWidth> <FitHeight>boolean</FitHeight> <AutoSize>boolean</AutoSize> <CustomPageHeight>int</CustomPageHeight> <CustomPageWidth>int</CustomPageWidth> </HTML> <Annotations> <PDF_Annotation> <Format>Points or Relative</Format> <Pos_X>int</Pos_X> <Pos_Y>int</Pos_Y> <Size_X>int</Size_X> <Size_Y>int</Size_Y> <Text>string</Text> <Page>int</Page> </PDF_Annotation> <PDF_Annotation> <Format>Points or Relative</Format> <Pos_X>int</Pos_X> <Pos_Y>int</Pos_Y> <Size_X>int</Size_X> <Size_Y>int</Size_Y> <Text>string</Text> <Page>int</Page> </PDF_Annotation> </Annotations> <AllowAnnotations>boolean</AllowAnnotations> <PageFormat>Custom or A0 or A1 or A10 or A2 or A3 or A4 or A5 or A6 or A7 or A8 or A9 or ArchA or ArchB or ArchC or ArchD or ArchE or B0 or B1 or B2 or B3 or B4 or B5 or Flsa or HalfLetter or Ledger or Legal or Letter or Letter11x17 or Note</PageFormat> <PageOrientation>Portrait or Landscape</PageOrientation> <UsePageCompression>boolean</UsePageCompression> <Metadata> <Title>string</Title> <Subject>string</Subject> <Author>string</Author> <Keywords>string</Keywords> </Metadata> <UseImageCompression>boolean</UseImageCompression> <UsePDFCompression>boolean</UsePDFCompression> <DownsizeResolution>int</DownsizeResolution> <CompressMethod>int</CompressMethod> <JpegQuality>int</JpegQuality> <ConvertToCMYK>boolean</ConvertToCMYK> <RemoveDuplicateImages>boolean</RemoveDuplicateImages> 40

41 <ConversionTimeout>int</ConversionTimeout> <AddWatermark>boolean</AddWatermark> <Watermark> <Mode>FirstPage or AllPages or LastPage or UserDefined</Mode> <Pages>string</Pages> <Angle>int</Angle> <Strength>int</Strength> <FontSize>int</FontSize> <Text>string</Text> <Font>string</Font> <Layer>Top or Bottom</Layer> </Watermark> <AddStamp>boolean</AddStamp> <Stamp> <Mode>FirstPage or AllPages or LastPage or UserDefined</Mode> <Path>string</Path> <Pages>string</Pages> <PosX>int</PosX> <PosY>int</PosY> <Width>float</Width> <Height>float</Height> <AutoPlacement>boolean</AutoPlacement> <AutoPosHorizontal>Left or Center or Right</AutoPosHorizontal> <AutoPosVertical>Top or Center or Bottom</AutoPosVertical> <Layer>Top or Bottom</Layer> <ResampleImage>boolean</ResampleImage> </Stamp> <AddAttachements>boolean</AddAttachements> <AttachementList> <string>string</string> <string>string</string> </AttachementList> <EnableMerge>boolean</EnableMerge> <Merge> <Mode>Overwrite or Begin or End</Mode> <SaveCopyOnMerge>boolean</SaveCopyOnMerge> </Merge> <AddSecurity>boolean</AddSecurity> <Security> <EncryptionAlgorithm>PdfEncryptionNone or PdfEncryption40BitRC4 or PdfEncryption128BitRC4 or PdfEncryption128BitAES or PdfEncryption256BitAES</EncryptionAlgorithm> <UserPasswordCrypted>string</UserPasswordCrypted> <UserPasswordPlaintext>string</UserPasswordPlaintext> <OwnerPasswordCrypted>string</OwnerPasswordCrypted> <OwnerPasswordPlaintext>string</OwnerPasswordPlaintext> <OpenPasswordPlaintext>string</OpenPasswordPlaintext> <Permissions> <CanPrint>boolean</CanPrint> <CanCopy>boolean</CanCopy> <CanModify>boolean</CanModify> <CanAddNotes>boolean</CanAddNotes> <CanFillFields>boolean</CanFillFields> <CanCopyAccess>boolean</CanCopyAccess> <CanAssemble>boolean</CanAssemble> <CanPrintFull>boolean</CanPrintFull> </Permissions> </Security> <AddSignature>boolean</AddSignature> <Signature> <CertificateID>string</CertificateID> <PrivateKeyPIN>string</PrivateKeyPIN> <AddTimeStamp>boolean</AddTimeStamp> <CreateBES>boolean</CreateBES> <ShowValidationStatus>boolean</ShowValidationStatus> <Page>int</Page> <Text>string</Text> <ImagePath>string</ImagePath> <PosX>int</PosX> <PosY>int</PosY> <Width>int</Width> <Height>int</Height> <LocationInfo>string</LocationInfo> <ContactInfo>string</ContactInfo> <Reason>string</Reason> </Signature> 41

42 <AddTimeStamp>boolean</AddTimeStamp> <TimeStamp> <LocationInfo>string</LocationInfo> <ContactInfo>string</ContactInfo> <Reason>string</Reason> </TimeStamp> <PreserveExistingSignatures>boolean</PreserveExistingSignatures> <ConvertSignedPDF>boolean</ConvertSignedPDF> <StrictSignedPDFConversion>boolean</StrictSignedPDFConversion> <ReturnErrorIfNotModified>boolean</ReturnErrorIfNotModified> <XMLReportTemplate>string</XMLReportTemplate> <XMLReportSignaturesTemplate>string</XMLReportSignaturesTemplate> <AddXMLReportToXMP>boolean</AddXMLReportToXMP> <ReturnFullXMPReport>boolean</ReturnFullXMPReport> <MaxInputFileSize>int</MaxInputFileSize> <AllowedFileTypes>string</AllowedFileTypes> <EnableOCR>boolean</EnableOCR> <ForceOCR>boolean</ForceOCR> <AddSourceAsPDFA3AssociatedFile>boolean</AddSourceAsPDFA3AssociatedFile> <ForcePDFAIfErrors>boolean</ForcePDFAIfErrors> <ForceImagePDFAIfErrors>boolean</ForceImagePDFAIfErrors> <ForceImagePDFAResolution>int</ForceImagePDFAResolution> <HttpHeaders>string</HttpHeaders> </Options> <CustomXMLData>string</CustomXMLData> </ConvertFileEx> <Input> Base64Binary Libovolný dokument v kódování Base64Binary určený ke konverzi do formátu PDF, či PDF/A dle zvoleného konverzního profilu <FileName> Jméno vstupního souboru včetně přípony <Options> - Konfigurační struktura konverze <RemoveEmptyPages> boolean Odstraní stránky bez jakéhokoliv textu nebo obrázku. <ReportLanguage> Slouţí pro nastavení jazyka reportu o PDF/A konverzi, výchozím jazykem je angličtina. Moţné hodnoty en = angličtina, cz = čeština <OCRLanguage> string V případě povoleného OCR definuje jazyk rozpoznávaného textu <OCRRecognitionDpi> 42

43 int Minimální rozlišení OCR skenované stránky. Zachovává kvalitu obrázku s vyšším rozlišením <ForceShell> Přípony souborů, které jsou automaticky konvertovány pomocí Shell konverze. Přípony mohou být odděleny pomocí znaků:, ;. nebo mezerou <PdfFormat> Definuje poţadovanou úroveň souladu s normou PDF/A výstupního souboru. Tímto parametrem se definuje zda má být výstupní soubor ve formátu PDF/A. Moţné parametry: PDF generované PDF je v souladu s definicí dle ISO :2008 (PDF Reference 1.7), PDF/A-1b PDF dokument v úrovni souladu 1b dle ISO :2005, PDF/A-1a PDF dokument v úrovni souladu 1a dle ISO :2005, PDF/A-2b PDF dokument v úrovni souladu 2b dle ISO :2011, PDF/A-2a PDF dokument v úrovni souladu 2a dle ISO :2011, enum PDF/A-2u PDF dokument v úrovni souladu 2u dle ISO :2011, PDF/A-3b PDF dokument v úrovni souladu 3b dle ISO :2012, PDF/A-3a PDF dokument v úrovni souladu 3a dle ISO :2012, PDF/A-3u PDF dokument v úrovni souladu 3u dle ISO :2012, PDF/X-1 - PDF dokument v úrovni souladu X-1 dle ISO :2003, PDF/X-3 - PDF dokument v úrovni souladu X-3 dle ISO :2003, PDF/X-4 - PDF dokument v úrovni souladu X-4 dle ISO :2008, PDF/X-5 - PDF dokument v úrovni souladu X-5 dle ISO :2008 <ForcePDFVersion> string Nastaví výstupní verzi PDF souboru <BarCodeInfo> <PosX> double Umístění čárového kódu vrámci PDF, X souřadnice od levého spodního rohu v 72DPi <PosY> double Umístění čárového kódu vrámci PDF, Y souřadnice od levého spodního rohu v 72DPi <Width> double Šířka čárového kódu v 72DPi <Height> 43

44 double Výška čárového kódu v 72DPi <Type> Typ čárového kódu. Můţe mít tyto hodnoty: Barcode_1D_UPCVersionA; Barcode_1D_UPCVersionE; Barcode_1D_UPCSupplemental2Digit; Barcode_1D_UPCSupplemental5Digit; Barcode_1D_EAN13; Barcode_1D_EAN8; Barcode_1D_Interleaved2of5; Barcode_1D_Standard2of5; Barcode_1D_Industrial2of5; Barcode_1D_Code39; Barcode_1D_Code39Extended; Barcode_1D_Codabar; Barcode_1D_PostNet; Barcode_1D_Bookland; Barcode_1D_ISBN; enum Barcode_1D_JAN13; Barcode_1D_MSIMod10; Barcode_1D_MSI2Mod10; Barcode_1D_MSIMod11; Barcode_1D_MSIMod11Mod10; Barcode_1D_ModifiedPlessey; Barcode_1D_Code11; Barcode_1D_USD8; Barcode_1D_UCC12; Barcode_1D_UCC13; Barcode_1D_LOGMARS; Barcode_1D_Code128; Barcode_1D_Code128A; Barcode_1D_Code128B; Barcode_1D_Code128C; Barcode_1D_ITF14; Barcode_1D_Code93; Barcode_1D_TelePen; Barcode_PDF417; Barcode_QR; Barcode_DataMatrix <Data> string Obsah čárového kódu <Description> string Text uvedený pod čárovým kódem <Pages> string Stránky na které se má umístnit čárový kód </BarCodeInfo> <ZFO> <AttSettings> <ConversionHandling> enum Definuje správné zacházení s převedeným statusem přílohy. <AllowedFileTypes> Typy souborů pro konverzi, pro libovolný dokument nastavte * Jednotlivé formáty jsou odděleny středníkem </AttSettings> <ConvertDZ> 44

45 boolean Nastaví, zda převést soubor.zfo, pokud je to datová zpráva. </ZFO> <EML> <AttSettings> <ConversionHandling> enum Definuje správné zacházení s převedeným statusem přílohy. <AllowedFileTypes> Typy souborů pro konverzi, pro libovolný dokument nastavte * Jednotlivé formáty jsou odděleny středníkem </AttSettings> <CertificatePath> string Cesta k certifikátu pro dešifrování šifrovaného u <Decrypt> boolean Definuje jestli se má pouţít certifikát v případě šifrovaného u <ExportSignature> boolean Zapíše informace o podpisu z u do PDF Metadat <HeaderLanguage> string Lokalizace hlavičky u </EML> <HTML> <Header> string Hlavička kaţdé konvertované stránky <AvoidTextBreak> boolean Při převodu HTML zabrání rozdělení textu mezi stránkami ve vytvořeném PDF. 45

46 <AvoidImageBreak> boolean Při převodu HTML zabrání rozdělení obrazu mezi stránkami ve vytvořeném PDF. <ArchiveHeaderLanguage> string V případě stahování zdrojových souborů stránky definuje lokalizaci hlavičky <HeaderHeight> int Velikost hlavičky konvertované stránky <Footer> string Zápatí kaţdé konvertované stránky <FooterHeight> int Velikost zápatí konvertované stránky <PageEncoding> System.Text.Encoding Kódování stahované stránky <BaseURL> string Vychozí adresa pro konverzi souborů leţících mimo úrovně webu <DownloadReferencedFiles> boolean Stahuje i specifické formáty souborů odkazovaných na stahované stránce (office, pdf apod.) <DoArchive> boolean Stahuje i zdrojové soubory stahované stránky <FitWidth> boolean V případě, ţe převedená webová stránka je širší neţ aktuální šířka PageFormat stránky, zmenší webovou stránku tak, aby se vešla. Pokud jsou tato volba a AutoSize nastaveny na false, budou webové stránky ořezané na aktuální PageFormat výšce stránky. 46

47 <FitHeight> boolean V případě, ţe převedená webová stránka je delší neţ aktuální výška PageFormat stránky, zmenší webovou stránku tak, aby se vešla. <AutoSize> boolean Vytvoří vlastní PageFormat, aby se stránka vešla do šíře aktuálně převédené webové stránky. Tento parametr přepíše CustomPageWidth. <CustomPageHeight> int Nastaví výšku převedené PDF stránky. Hodnota musí být v 72dpi formátu. <CustomPageWidth> int </HTML> Nastaví šířku převedené PDF stránky. Hodnota musí být v 72dpi formátu. <Annotations> <PDF_Annotation> <Format> enum Formát anotace v rámci PDF, můţe nabývat hodnot: Points (Pixely) nebo Relative (Procenta) <Pos_X> int Umístění anotace v rámci PDF, X souřadnice od levého spodního rohu <Pos_Y> int Umístění anotace v rámci PDF, Y souřadnice od levého spodního rohu <Size_X> int Velikost anotace v rámci PDF, X souřadnice od levého spodního rohu <Size_Y> int Velikost anotace v rámci PDF, Y souřadnice od levého spodního rohu <Text> 47

48 string Text anotace věty <Page> int Číslo stránky na kterou se má anotace přidat </PDF_Annotation> </Annotations> <AllowAnnotations> boolean Nastavte na true, pokud chcete přidat anotace věty do PDF souboru. Výchozí hodnota je false. Pouţijte pole Anotace pro další nastavení. </AllowAnnotations> <PageFormat> enum Definuje velikost a formát stránky výstupního PDF souboru. Výchozí hodnota je A4 na výšku. Moţné hodnoty: Custom; A0; A1; A10; A2; A3; A4; A5; A6; A7; A8; A9; ArchA; ArchB; ArchC; ArchD; ArchE; B0; B1; B2; B3; B4; B5; Flsa; HalfLetter; Ledger; Legal; Letter; Letter11x17; Note Rozměry stránky pro jednotlivé typy velikosti papírů jsou uvedeny například zde: <PageOrientation> enum Orientace stránky, můţe mít hodnoty: Portrait nebo Landscape <UsePageCompression> boolean Logická hodnota nastavuje zda má být pouţita komprese. Výchozí hodnota je false <Metadata> <Title> Nastavuje hodnotu metadat dokumentu Název dokumentu <Subject> Nastavuje hodnotu metadat dokumentu Předmět <Author> 48

49 Nastavuje hodnotu metadat dokumentu Autor dokumentu <Keywords> Nastavuje hodnotu metadat dokumentu Klíčová slova </Metadata> <UseImageCompression> Boolean Logická hodnota nastavuje, zda je povolena komprese obrázků při konverzi <UsePDFCompression> Boolean Logická hodnota nastavuje, zda je povolena komprese PDF při konverzi <DownsizeResolution> Nastavuje rozlišení obrázků v DPI. Hodnota můţe být nastavena v rozsahu Akceptován Int pouze pokud je nastavena hodnota UseImageCompression na true. Tento parametr není v tuto chvíli dostupný. <CompressMethod> Nastavuje metodu komprese obrázků. Je podporována pouze komprese JPEG obrázků. Moţné Int hodnoty: 0 = ZIP, 1 = JPEG, 2 = JPEG2000. <JpegQuality> Int Nastavuje kvalitu konverze obrázků JPEG v procentech. <ConvertToCMYK> Boolean Logická hodnota nastavuje konverzi z RGB do CMYK. Tento parametr není v tuto chvíli dostupný. <RemoveDuplicateImages> Boolean Logická hodnota nastavuje zda mají být duplicitní obrázky z PDF dokumentu odstraněny. Tento parametr není v tuto chvíli dostupný. <ConversionTimeout> 49

50 Int Timeout pro konverzi, celočíselná hodnota zadává čas v sekundách. <AddWatermark> Boolean Logická hodnota rozhoduje zda bude pouţit vodoznak. <Watermark> <Mode> Určuje na které stránce bude umístěn vodoznak. Povoleny jsou hodnoty FirstPage, AllPages, enum LastPage nebo UserDefined. <Pages> Strany dokumentu, na kterých má být umístěn vodoznak. Oddělovač je, ;. nebo mezera <Angle> Určuje úhel vodoznaku. 0= vodorovně, 1= šikmo dolů zleva do prava, 2= šikmo nahoru zleva do Int prava, 3= svisle seshora dolů <Strength> Určuje viditelnost vodoznaku, pokud je umístěn před textem. Zadává se v procentech Int průhlednosti. <FontSize> Int <Text> Určuje velikost fontu vodoznaku Text vodoznaku <Font> Jméno fontu pouţitého pro vodoznak <Layer> enum Určuje umístění vodoznaku vůči textu, Top = před textem, Bottom = za textem 50

51 </Watermark> <AddStamp> Boolean Logická hodnota povoluje pouţití obrázku razítka <Stamp> <Mode> Určuje na které stránce bude umístěn obrázek razítka. Povoleny jsou hodnoty FirstPage, AllPages, enum LastPage nebo UserDefined. <Path> Cesta k souboru s obrázkem razítka <Pages> Určuje stránku nebo stránky, na které bude umístěno razítko. Tento parametr je nadřazený parametru <Mode> <PosX> Int Parametr pozice obrázku razítka, X pozice od dolního levého rohu v rozlišení 300dpi <PosY> Int Parametr pozice obrázku razítka, Y pozice od dolního levého rohu v rozlišení 300dpi <Width> float Parametr pozice obrázku razítka - šířka, v rozlišení 72dpi <Height> float Parametr pozice obrázku razítka - výška, v rozlišení 72dpi <AutoPlacement> Boolean Logická hodnota určuje zda bude obrázek razítka umístěn ručně, či automaticky, 0= ručně, 1= automaticky <AutoPosHorizontal> 51

52 enum Parametr pozice obrázku razítka, Left= vlevo, Center=uprostřed, Right=vpravo <AutoPosVertical> enum <Layer> enum Parametr pozice obrázku razítka, Top= nahoře, Center=uprostřed, Bottom=dole Určuje umístění obrázku razítka vůči textu, Top = před textem, Bottom = za textem <ResampleImage> boolean Upravení vzoru obrázku na 72DPI </Stamp> <AddAttachements> Boolean Logická hodnota povoluje vloţení přílohy do dokumentu <AttachementList> <> Cesta k souboru přílohy, která má být součástí konvertovaného dokumentu </AttachementList> <EnableMerge> Boolean Logická hodnota povoluje spájení dokumentů <Merge> <Mode> Enum Určuje způsob slučování dokumentů Název Overwrite Begin End Přepíše původní soubor novým Připojí nový soubor na začátek původního Připojí nový soubor na konec původního <SaveCopyOnMerge> 52

53 Boolean Logická hodnota povoluje ukládání kopie původního souboru </Merge> <AddSecurity> Boolean Logická hodnota povoluje šifrování <Security> <EncryptionAlgorithm> Určuje jaký druh šifrování bude pouţit, tento parametr je CaseSensitive. Moţné hodnoty: enum "PdfEncryptionNone", "PdfEncryption40BitRC4", "PDfEncryption128BitRC4", "PDfEncryption128BitAES" a "PDfEncryption256BitAES". <UserPasswordCrypted> Uţivatelské heslo k dokumentu, uloţeno jako kryptovaný text. Parametr pro heslo zadané jako normální text tento parametr přepíše a opačně. <UserPasswordPlainText> Uţivatelské heslo k dokumentu, uloţeno jako normální text. Parametr pro heslo zadané jako normální text přepíše heslo zadané jako kryptovaný text a opačně. <OwnerPasswordCrypted> Heslo vlastníka k dokumentu, uloţeno jako kryptovaný text. Parametr pro heslo zadané jako normální text tento parametr přepíše a opačně. <OwnerPasswordPlainText> Heslo vlastníka k dokumentu, uloţeno jako normální text. Parametr pro heslo zadané jako normální text přepíše heslo zadané jako kryptovaný text a opačně. <OpenPasswordPlainText> Uţivatelské heslo pro otevření PDF dokumentu, uloţeno jako prostý text. Tento parametr se pouţívá k otevření heslem chráněného PDF. Pokud si chcete zachovat zabezpečené PDF, vyuţijte parametrů UserPassword nebo OwnerPassword. <Permissions> <CanPrint> 53

54 Boolean Pokud je dokument šifrován, povoluje práva k dokumentu - tisk <CanCopy> Boolean Pokud je dokument šifrován, povoluje práva k dokumentu kopírování <CanModify> Boolean Pokud je dokument šifrován, povoluje práva k dokumentu - úpravy <CanAddNotes> Boolean Pokud je dokument šifrován, povoluje práva k dokumentu - poznámky <CanFillFields> Boolean Pokud je dokument šifrován, povoluje práva k dokumentu vyplňování polí <CanCoppyAccess> Boolean Pokud je dokument šifrován, povoluje práva k dokumentu <CanAssembly> Boolean Pokud je dokument šifrován, povoluje práva k dokumentu - přiřazení <CanPrintFull> Boolean Pokud je dokument šifrován, povoluje práva k dokumentu plný tisk </Permissions> </Security> <AddSignature> Boolean Logická hodnota určuje, zda má být dokument podepsán <Signature> <CertificateID> Identifikátor podpisového certifikátu. Nabývá jeden z formátů: "urn:sha:" // Format urn:sha:<base64_kodovany_sha1_hash > "urn:hex:" // Format urn:hex:<hexadecimalne_kodovany_sha1_hash> "PEMfile:" // Format PEMfile:<cesta_k_PEM_souboru_bez_hesla> 54

55 "Identity:" // Format Identity:<Base64_kodovany_cert>:<Base64_kodovany_key> "X509:" // Format X509:<Base64_kodovany_cert> "PKCS11:alias:" // Format PKCS11:alias:<alias_certifikatu> <PrivateKeyPIN> Heslo k privátnímu klíči specifikovaného certifikátu <AddTimeStamp> Boolean Logická hodnota určuje, zda bude k podpisu připojeno časové razítko <CreateBES> Boolean Logická hodnota určuje, zda bude elektronický podpis vytvořen ve formátu BES / EPES <ShowValidationStatus> Boolean Logická hodnota určuje, zda bude zobrazena ikona s výsledkem ověření podpisu. Vyţaduje Adobe Reader. <Page> Číslo stránky, na které je vizualizace podpisu. Pokud je zadané číslo větší neţ počet stránek Int dokumentu, bude vizualizace na poslední straně. <Text> Text vizualizace podpisu <ImagePath> Cesta k souboru s obrázkem podpisu. <PosX> Int <PosY> Int <Width> Parametr pozice obrázku podpisu, X pozice od dolního levého rohu v rozlišení 300dpi Parametr pozice obrázku podpisu, Y pozice od dolního levého rohu v rozlišení 300dpi 55

56 Int Parametr pozice obrázku podpisu - šířka, v rozlišení 300dpi <Height> Int Parametr pozice obrázku podpisu - výška, v rozlišení 300dpi <LocationInfo> Určuje polohu, kde byl dokumentu podepsán. <ContactInfo> Určuje osobu, která podepsala dokument <Reason> Zadává důvod podepsání dokumentu </Signature> <AddTimeStamp> Boolean Logická hodnota určuje, zda bude k dokumentu připojeno časové razítko <TimeStamp> <LocationInfo> Určuje polohu, kde byl dokument opatřen časovým razítkem <ContactInfo> Určuje osobu, která opatřila dokument časovým razítkem <Reason> Zadává důvod podepsání dokumentu </TimeStamp> <PreserveExistingSignature> Boolean Logická hodnota určuje, zda bude zachován elektronický podpis. Pokud je nastaven výstupní formát na PDF/A, není moţné zachovat elektronický podpis konvertovaného dokumentu. 56

57 <ConvertSignedPDF> Boolean Při konverzi podepsaného PDF se vytváří PDF/A-3, přikládá se originální soubor jako příloha a do metadat se uloţí info o odstraněných podpisech <StrictSignedPDFConversion> Boolean Konvertuje podepsané PDF jenom v případě, ţe aspoň jeden podpis je platný, jinak vrátí PRN_CR_UNABLE_CONVERT_WITH_INVALID_SIGS <ReturnErrorIfNotModified> Boolean Pokud vstupní soubor nevyţaduje ţádnou změnu na základě nastavení ConvertOptions, je vrácen chybový kód PRN_CR_NOT_MODIFIED. <XMLReportTemplate> Cesta k souboru se strukturou XML reportu <XMLReportSignaturesTemplate> Cesta k souboru se strukturou XML reportu pro odstraněné podpisy <AddXMLReportToXMP> Boolean Definuje, jestli se Report přidává do XMP metadata souboru <ReturnFullXMPReport> Boolean Pouţité jenom v případě zapnutého předešlého argumentu. Vrátí všechna XMP metadata místo XML reportu <MaxInputFileSize> Int Maximální velikost vstupního souboru v bytech <AllowedFileTypes> Typy souborů pro konverzi, pro libovolný dokument nastavte * Jednotlivé formáty jsou odděleny středníkem <EnableOCR> 57

58 Boolean Aktivuje OCR scanování textu v případě celostránkového obrázku v souboru. V případě, ţe stránka obsahuje obrázek který nepokrývá 100% stránky, OCR se neprovádí <ForceOCR> Boolean Aktivuje OCR v případě stránky, která obsahuje aspoň jeden obrázek. POZOR ztráta kvality textu, převede celou stránku do obrázku a hledá text <AddSourceAsPDFA3AssociatedFile> Boolean Zdrojový soubor je součástí výstupního PDF/A-3 dokumentu ve formě asociované přílohy <ForcePDFAIfErrors> Boolean Výstupní soubor se při konverzi do PDF/A označí jako PDF/A i přesto, ţe v něm zůstávají nějaké chyby neopravené <ForceImagePDFAIfErrors> Boolean V případě, ţe se nepovede převést vstupní dokument do PDF/A, převede nejdříve celý dokument do obrázkového PDF a následně jej převede do PDF/A <ForceImagePDFAResolution> Nastaví rozlišení, které se, v případě pouţití parametru ForceImagePDFAIfErrors, pouţije pro Int obrázkové PDF <HttpHeaders> string HTTP Headery v případě konverze webové stránky do PDF </Options> <CustomXMLData> string Vlastní formát reportovacího XML Odpověď HTTP/ OK 58

59 <ConvertFileExResponse xmlns=" <ConvertFileExResult>int</ConvertFileExResult> <Output>base64Binary</Output> <Report>string</Report> <ErrorMessage>string</ErrorMessage> </ConvertFileExResponse> <ConvertFileExResult> Int Výsledek metody ConvertFileEx. 0 = v pořádku <Output> Base64Binary Base64Binary tvar konvertovaného dokumentu v odpovídajícím formátu PDF či PDF/A ve tvaru dle zvoleného konverzního profilu. <Report> string XML report - šablona reportu je v instalačním adresáři v souboru Report.xml. Při převodu se do šablony doplní zvolené údaje, např. jméno dokumentu, čas převodu, výsledek převodu, hash vstupního a výstupního souboru, informace o podpisech převáděného PDF souboru atd. <ErrorMessage> string Obsahuje text chyby v případě neúspěšné konverze Příklad vytvoření PDF/A-2a dokumentu s podpisem a časovým razítkem z Word dokumentu: xmlns:xsd=" xmlns:soap=" <ConvertFileEx xmlns=" <Input>Base64Binary</Input> <FileName>nazev_souboru.docx</FileName> <Options> <PdfFormat>PDF_A_2a</PdfFormat> <AddSignature>true</AddSignature> <Signature> <CertificateID>PEMfile:C:\certs\JohnDoe.pem</CertificateID> <AddTimeStamp>true</AddTimeStamp> 59

60 <CreateBES>true</CreateBES> <LocationInfo>Hornokrčská 15, Praha 4, CZ</LocationInfo> <ContactInfo> <Reason>Podepsáno pomocí pro testovací účel</reason> </Signature> <AddTimeStamp>true</AddTimeStamp> <TimeStamp> <LocationInfo>Praha, Česká republika</locationinfo> <Reason>Testovací účel</reason> </TimeStamp> </Options> </ConvertFileEx> 60

61 Konverze webové stránky do PDF nebo PDF/A souboru Webová služba umožňuje konvertovat jakoukoli webovou stránku do PDF souboru. Pro vytvoření archivního PDF/A dokumentu s odkazovanými soubory (pdf, office, apod.) a zdrojovými soubory stránky (SSL certifikát, obrázky, apod.), je možné využít parametrů DownloadReferencedFiles a DoArchive. Metoda webové služby ConvertWebPage sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ConvertWebPage xmlns=" <URL>string</URL> <Options> <RemoveEmptyPages>boolean</RemoveEmptyPages> <ReportLanguage>string</ReportLanguage> <OCRLanguage>string</OCRLanguage> <OCRRecognitionDpi>int</OCRRecognitionDpi> <ForceShell>string</ForceShell> <PdfFormat>PDF or PDF_A_1b or PDF_A_1a or PDF_A_2b or PDF_A_2a or PDF_A_2u or PDF_A_3b or PDF_A_3a or PDF_A_3u or PDF_X_1 or PDF_X_3 or PDF_X_4 or PDF_X_5</PdfFormat> <ForcePDFVersion>string</ForcePDFVersion> <BarcodeInfo> <PosX>double</PosX> <PosY>double</PosY> <Width>double</Width> <Height>double</Height> <Type>Barcode_1D_UPCVersionA or Barcode_1D_UPCVersionE or Barcode_1D_UPCSupplemental2Digit or Barcode_1D_UPCSupplemental5Digit or Barcode_1D_EAN13 or Barcode_1D_EAN8 or Barcode_1D_Interleaved2of5 or Barcode_1D_Standard2of5 or Barcode_1D_Industrial2of5 or Barcode_1D_Code39 or Barcode_1D_Code39Extended or Barcode_1D_Codabar or Barcode_1D_PostNet or Barcode_1D_Bookland or Barcode_1D_ISBN or Barcode_1D_JAN13 or Barcode_1D_MSIMod10 or Barcode_1D_MSI2Mod10 or Barcode_1D_MSIMod11 or Barcode_1D_MSIMod11Mod10 or Barcode_1D_ModifiedPlessey or Barcode_1D_Code11 or Barcode_1D_USD8 or Barcode_1D_UCC12 or Barcode_1D_UCC13 or Barcode_1D_LOGMARS or Barcode_1D_Code128 or Barcode_1D_Code128A or Barcode_1D_Code128B or Barcode_1D_Code128C or Barcode_1D_ITF14 or Barcode_1D_Code93 or Barcode_1D_TelePen or Barcode_PDF417 or Barcode_QR or Barcode_DataMatrix</Type> <Data>string</Data> <Description>string</Description> <Pages>string</Pages> </BarcodeInfo> <ZFO> <AttSettings> <ConversionHandling>IGNORE_ATTACHMENTS or ATTACH_WITHOUT_CONVERSION or CONVERT_FAILURE_END or CONVERT_FAILURE_SKIP or CONVERT_FAILURE_ATTACH_ORIGINAL or CONVERT_ALWAYS_ATTACH_ORIGINAL</ConversionHandling> <AllowedFiletypes>string</AllowedFiletypes> </AttSettings> <ConvertDZ>boolean</ConvertDZ> </ZFO> <EML> <AttSettings> <ConversionHandling>IGNORE_ATTACHMENTS or ATTACH_WITHOUT_CONVERSION or CONVERT_FAILURE_END or CONVERT_FAILURE_SKIP or CONVERT_FAILURE_ATTACH_ORIGINAL or CONVERT_ALWAYS_ATTACH_ORIGINAL</ConversionHandling> <AllowedFiletypes>string</AllowedFiletypes> 61

62 </AttSettings> <CertificatePath>string</CertificatePath> <Decrypt>boolean</Decrypt> <ExportSignature>boolean</ExportSignature> <HeaderLanguage>string</HeaderLanguage> </EML> <HTML> <Header>string</Header> <AvoidTextBreak>boolean</AvoidTextBreak> <AvoidImageBreak>boolean</AvoidImageBreak> <ArchiveHeaderLanguage>string</ArchiveHeaderLanguage> <HeaderHeight>int</HeaderHeight> <Footer>string</Footer> <FooterHeight>int</FooterHeight> <PageEncoding> <EncoderFallback xsi:nil="true" /> <DecoderFallback xsi:nil="true" /> </PageEncoding> <BaseURL>string</BaseURL> <DownloadReferencedFiles>boolean</DownloadReferencedFiles> <DoArchive>boolean</DoArchive> <FitWidth>boolean</FitWidth> <FitHeight>boolean</FitHeight> <AutoSize>boolean</AutoSize> <CustomPageHeight>int</CustomPageHeight> <CustomPageWidth>int</CustomPageWidth> </HTML> <Annotations> <PDF_Annotation> <Format>Points or Relative</Format> <Pos_X>int</Pos_X> <Pos_Y>int</Pos_Y> <Size_X>int</Size_X> <Size_Y>int</Size_Y> <Text>string</Text> <Page>int</Page> </PDF_Annotation> <PDF_Annotation> <Format>Points or Relative</Format> <Pos_X>int</Pos_X> <Pos_Y>int</Pos_Y> <Size_X>int</Size_X> <Size_Y>int</Size_Y> <Text>string</Text> <Page>int</Page> </PDF_Annotation> </Annotations> <AllowAnnotations>boolean</AllowAnnotations> <PageFormat>Custom or A0 or A1 or A10 or A2 or A3 or A4 or A5 or A6 or A7 or A8 or A9 or ArchA or ArchB or ArchC or ArchD or ArchE or B0 or B1 or B2 or B3 or B4 or B5 or Flsa or HalfLetter or Ledger or Legal or Letter or Letter11x17 or Note</PageFormat> <PageOrientation>Portrait or Landscape</PageOrientation> <UsePageCompression>boolean</UsePageCompression> <Metadata> <Title>string</Title> <Subject>string</Subject> <Author>string</Author> <Keywords>string</Keywords> </Metadata> <UseImageCompression>boolean</UseImageCompression> <UsePDFCompression>boolean</UsePDFCompression> <DownsizeResolution>int</DownsizeResolution> <CompressMethod>int</CompressMethod> <JpegQuality>int</JpegQuality> <ConvertToCMYK>boolean</ConvertToCMYK> <RemoveDuplicateImages>boolean</RemoveDuplicateImages> <ConversionTimeout>int</ConversionTimeout> <AddWatermark>boolean</AddWatermark> <Watermark> <Mode>FirstPage or AllPages or LastPage or UserDefined</Mode> <Pages>string</Pages> <Angle>int</Angle> <Strength>int</Strength> <FontSize>int</FontSize> <Text>string</Text> 62

63 <Font>string</Font> <Layer>Top or Bottom</Layer> </Watermark> <AddStamp>boolean</AddStamp> <Stamp> <Mode>FirstPage or AllPages or LastPage or UserDefined</Mode> <Path>string</Path> <Pages>string</Pages> <PosX>int</PosX> <PosY>int</PosY> <Width>float</Width> <Height>float</Height> <AutoPlacement>boolean</AutoPlacement> <AutoPosHorizontal>Left or Center or Right</AutoPosHorizontal> <AutoPosVertical>Top or Center or Bottom</AutoPosVertical> <Layer>Top or Bottom</Layer> <ResampleImage>boolean</ResampleImage> </Stamp> <AddAttachements>boolean</AddAttachements> <AttachementList> <string>string</string> <string>string</string> </AttachementList> <EnableMerge>boolean</EnableMerge> <Merge> <Mode>Overwrite or Begin or End</Mode> <SaveCopyOnMerge>boolean</SaveCopyOnMerge> </Merge> <AddSecurity>boolean</AddSecurity> <Security> <EncryptionAlgorithm>PdfEncryptionNone or PdfEncryption40BitRC4 or PdfEncryption128BitRC4 or PdfEncryption128BitAES or PdfEncryption256BitAES</EncryptionAlgorithm> <UserPasswordCrypted>string</UserPasswordCrypted> <UserPasswordPlaintext>string</UserPasswordPlaintext> <OwnerPasswordCrypted>string</OwnerPasswordCrypted> <OwnerPasswordPlaintext>string</OwnerPasswordPlaintext> <OpenPasswordPlaintext>string</OpenPasswordPlaintext> <Permissions> <CanPrint>boolean</CanPrint> <CanCopy>boolean</CanCopy> <CanModify>boolean</CanModify> <CanAddNotes>boolean</CanAddNotes> <CanFillFields>boolean</CanFillFields> <CanCopyAccess>boolean</CanCopyAccess> <CanAssemble>boolean</CanAssemble> <CanPrintFull>boolean</CanPrintFull> </Permissions> </Security> <AddSignature>boolean</AddSignature> <Signature> <CertificateID>string</CertificateID> <AddTimeStamp>boolean</AddTimeStamp> <CreateBES>boolean</CreateBES> <ShowValidationStatus>boolean</ShowValidationStatus> <Page>int</Page> <Text>string</Text> <ImagePath>string</ImagePath> <PosX>int</PosX> <PosY>int</PosY> <Width>int</Width> <Height>int</Height> <LocationInfo>string</LocationInfo> <ContactInfo>string</ContactInfo> <Reason>string</Reason> </Signature> <AddTimeStamp>boolean</AddTimeStamp> <TimeStamp> <LocationInfo>string</LocationInfo> <ContactInfo>string</ContactInfo> <Reason>string</Reason> </TimeStamp> <PreserveExistingSignatures>boolean</PreserveExistingSignatures> <ConvertSignedPDF>boolean</ConvertSignedPDF> <StrictSignedPDFConversion>boolean</StrictSignedPDFConversion> <ReturnErrorIfNotModified>boolean</ReturnErrorIfNotModified> 63

64 <XMLReportTemplate>string</XMLReportTemplate> <XMLReportSignaturesTemplate>string</XMLReportSignaturesTemplate> <AddXMLReportToXMP>boolean</AddXMLReportToXMP> <ReturnFullXMPReport>boolean</ReturnFullXMPReport> <MaxInputFileSize>int</MaxInputFileSize> <AllowedFileTypes>string</AllowedFileTypes> <EnableOCR>boolean</EnableOCR> <ForceOCR>boolean</ForceOCR> <AddSourceAsPDFA3AssociatedFile>boolean</AddSourceAsPDFA3AssociatedFile> <ForcePDFAIfErrors>boolean</ForcePDFAIfErrors> <ForceImagePDFAIfErrors>boolean</ForceImagePDFAIfErrors> <ForceImagePDFAResolution>int</ForceImagePDFAResolution> <HttpHeaders>string</HttpHeaders> </Options> </ConvertWebPage> <URL> Webová adresa stránky, kterou chcete zkonvertovat Pozn.: Ostatní parametry jsou stejné jako u metody ConvertFileEx Odpověď HTTP/ OK <ConvertWebPageResponse xmlns=" <ConvertWebPageResult>int</ConvertWebPageResult> <Output>base64Binary</Output> <ErrorMessage>string</ErrorMessage> </ConvertWebPageResponse> <ConvertWebPageResult> Int Výsledek metody ConvertWebPage. 0 = v pořádku <Output> Base64Binary Base64Binary tvar konvertované stránky v PDF dokumentu v odpovídajícím formátu PDF či PDF/A ve tvaru dle zvoleného konverzního profilu. <Report> XML report - šablona reportu je v instalačním adresáři v souboru Report.xml. Při převodu se do šablony doplní zvolené údaje, např. jméno dokumentu, čas převodu, výsledek převodu, hash vstupního a výstupního souboru, informace o podpisech převáděného PDF souboru atd. 64

65 Příklad vytvoření archivního snímku webu v PDF/A-3b s odkazovanými a zdrojovými soubory a časovým razítkem: xmlns:xsd=" xmlns:soap=" <ConvertWebPage xmlns=" <URL> <Options> <ReportLanguage>cz</ReportLanguage> <PdfFormat>PDF_A_3b</PdfFormat> <AddTimeStamp>true</AddTimeStamp> <HTML> <ArchiveHeaderLanguage>cz</ArchiveHeaderLanguage> <DownloadReferencedFiles>true</DownloadReferencedFiles> <DoArchive>true</DoArchive> </HTML> </Options> </ConvertWebPage> 65

66 Konverze souboru z URL adresy Jedná se o interní metodu pro komunikaci se spisovou sluţbou. Webová sluţba umoţňuje provést na serveru konverzi libovolného souboru ze zadané URL adresy do formátu PDF, či PDF/A podle definovaných poţadavků v konfigurační struktuře poţadavku a výsledný soubor nahrát na jiný server. Pro výsledný soubor je moţné nastavit úroveň souladu se specifikací PDF/A, podepsání dokumentu elektronickou značkou, opatření kvalifikovaným časovým razítkem, vodotiskem a další nastavení. Metoda webové služby ConvertFileFromURL sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ConvertFileFromURL xmlns=" <FileName>string</FileName> <SourceFileURL>string</SourceFileURL> <FileUploadURL>string</FileUploadURL> <Options> <RemoveEmptyPages>boolean</RemoveEmptyPages> <ReportLanguage>string</ReportLanguage> <OCRLanguage>string</OCRLanguage> <OCRRecognitionDpi>int</OCRRecognitionDpi> <ForceShell>string</ForceShell> <PdfFormat>PDF or PDF_A_1b or PDF_A_1a or PDF_A_2b or PDF_A_2a or PDF_A_2u or PDF_A_3b or PDF_A_3a or PDF_A_3u or PDF_X_1 or PDF_X_3 or PDF_X_4 or PDF_X_5</PdfFormat> <ForcePDFVersion>string</ForcePDFVersion> <BarcodeInfo> <PosX>double</PosX> <PosY>double</PosY> <Width>double</Width> <Height>double</Height> <Type>Barcode_1D_UPCVersionA or Barcode_1D_UPCVersionE or Barcode_1D_UPCSupplemental2Digit or Barcode_1D_UPCSupplemental5Digit or Barcode_1D_EAN13 or Barcode_1D_EAN8 or Barcode_1D_Interleaved2of5 or Barcode_1D_Standard2of5 or Barcode_1D_Industrial2of5 or Barcode_1D_Code39 or Barcode_1D_Code39Extended or Barcode_1D_Codabar or Barcode_1D_PostNet or Barcode_1D_Bookland or Barcode_1D_ISBN or Barcode_1D_JAN13 or Barcode_1D_MSIMod10 or Barcode_1D_MSI2Mod10 or Barcode_1D_MSIMod11 or Barcode_1D_MSIMod11Mod10 or Barcode_1D_ModifiedPlessey or Barcode_1D_Code11 or Barcode_1D_USD8 or Barcode_1D_UCC12 or Barcode_1D_UCC13 or Barcode_1D_LOGMARS or Barcode_1D_Code128 or Barcode_1D_Code128A or Barcode_1D_Code128B or Barcode_1D_Code128C or Barcode_1D_ITF14 or Barcode_1D_Code93 or Barcode_1D_TelePen or Barcode_PDF417 or Barcode_QR or Barcode_DataMatrix</Type> <Data>string</Data> <Description>string</Description> <Pages>string</Pages> </BarcodeInfo> <ZFO> <AttSettings> <ConversionHandling>IGNORE_ATTACHMENTS or ATTACH_WITHOUT_CONVERSION or CONVERT_FAILURE_END or CONVERT_FAILURE_SKIP or CONVERT_FAILURE_ATTACH_ORIGINAL or CONVERT_ALWAYS_ATTACH_ORIGINAL</ConversionHandling> <AllowedFiletypes>string</AllowedFiletypes> </AttSettings> <ConvertDZ>boolean</ConvertDZ> </ZFO> <EML> 66

67 <AttSettings> <ConversionHandling>IGNORE_ATTACHMENTS or ATTACH_WITHOUT_CONVERSION or CONVERT_FAILURE_END or CONVERT_FAILURE_SKIP or CONVERT_FAILURE_ATTACH_ORIGINAL or CONVERT_ALWAYS_ATTACH_ORIGINAL</ConversionHandling> <AllowedFiletypes>string</AllowedFiletypes> </AttSettings> <CertificatePath>string</CertificatePath> <Decrypt>boolean</Decrypt> <ExportSignature>boolean</ExportSignature> <HeaderLanguage>string</HeaderLanguage> </EML> <HTML> <Header>string</Header> <AvoidTextBreak>boolean</AvoidTextBreak> <AvoidImageBreak>boolean</AvoidImageBreak> <ArchiveHeaderLanguage>string</ArchiveHeaderLanguage> <HeaderHeight>int</HeaderHeight> <Footer>string</Footer> <FooterHeight>int</FooterHeight> <PageEncoding> <EncoderFallback xsi:nil="true" /> <DecoderFallback xsi:nil="true" /> </PageEncoding> <BaseURL>string</BaseURL> <DownloadReferencedFiles>boolean</DownloadReferencedFiles> <DoArchive>boolean</DoArchive> <FitWidth>boolean</FitWidth> <FitHeight>boolean</FitHeight> <AutoSize>boolean</AutoSize> <CustomPageHeight>int</CustomPageHeight> <CustomPageWidth>int</CustomPageWidth> </HTML> <Annotations> <PDF_Annotation> <Format>Points or Relative</Format> <Pos_X>int</Pos_X> <Pos_Y>int</Pos_Y> <Size_X>int</Size_X> <Size_Y>int</Size_Y> <Text>string</Text> <Page>int</Page> </PDF_Annotation> <PDF_Annotation> <Format>Points or Relative</Format> <Pos_X>int</Pos_X> <Pos_Y>int</Pos_Y> <Size_X>int</Size_X> <Size_Y>int</Size_Y> <Text>string</Text> <Page>int</Page> </PDF_Annotation> </Annotations> <AllowAnnotations>boolean</AllowAnnotations> <PageFormat>Custom or A0 or A1 or A10 or A2 or A3 or A4 or A5 or A6 or A7 or A8 or A9 or ArchA or ArchB or ArchC or ArchD or ArchE or B0 or B1 or B2 or B3 or B4 or B5 or Flsa or HalfLetter or Ledger or Legal or Letter or Letter11x17 or Note</PageFormat> <PageOrientation>Portrait or Landscape</PageOrientation> <UsePageCompression>boolean</UsePageCompression> <Metadata> <Title>string</Title> <Subject>string</Subject> <Author>string</Author> <Keywords>string</Keywords> </Metadata> <UseImageCompression>boolean</UseImageCompression> <UsePDFCompression>boolean</UsePDFCompression> <DownsizeResolution>int</DownsizeResolution> <CompressMethod>int</CompressMethod> <JpegQuality>int</JpegQuality> <ConvertToCMYK>boolean</ConvertToCMYK> <RemoveDuplicateImages>boolean</RemoveDuplicateImages> <ConversionTimeout>int</ConversionTimeout> <AddWatermark>boolean</AddWatermark> <Watermark> <Mode>FirstPage or AllPages or LastPage or UserDefined</Mode> 67

68 <Pages>string</Pages> <Angle>int</Angle> <Strength>int</Strength> <FontSize>int</FontSize> <Text>string</Text> <Font>string</Font> <Layer>Top or Bottom</Layer> </Watermark> <AddStamp>boolean</AddStamp> <Stamp> <Mode>FirstPage or AllPages or LastPage or UserDefined</Mode> <Path>string</Path> <Pages>string</Pages> <PosX>int</PosX> <PosY>int</PosY> <Width>float</Width> <Height>float</Height> <AutoPlacement>boolean</AutoPlacement> <AutoPosHorizontal>Left or Center or Right</AutoPosHorizontal> <AutoPosVertical>Top or Center or Bottom</AutoPosVertical> <Layer>Top or Bottom</Layer> <ResampleImage>boolean</ResampleImage> </Stamp> <AddAttachements>boolean</AddAttachements> <AttachementList> <string>string</string> <string>string</string> </AttachementList> <EnableMerge>boolean</EnableMerge> <Merge> <Mode>Overwrite or Begin or End</Mode> <SaveCopyOnMerge>boolean</SaveCopyOnMerge> </Merge> <AddSecurity>boolean</AddSecurity> <Security> <EncryptionAlgorithm>PdfEncryptionNone or PdfEncryption40BitRC4 or PdfEncryption128BitRC4 or PdfEncryption128BitAES or PdfEncryption256BitAES</EncryptionAlgorithm> <UserPasswordCrypted>string</UserPasswordCrypted> <UserPasswordPlaintext>string</UserPasswordPlaintext> <OwnerPasswordCrypted>string</OwnerPasswordCrypted> <OwnerPasswordPlaintext>string</OwnerPasswordPlaintext> <OpenPasswordPlaintext>string</OpenPasswordPlaintext> <Permissions> <CanPrint>boolean</CanPrint> <CanCopy>boolean</CanCopy> <CanModify>boolean</CanModify> <CanAddNotes>boolean</CanAddNotes> <CanFillFields>boolean</CanFillFields> <CanCopyAccess>boolean</CanCopyAccess> <CanAssemble>boolean</CanAssemble> <CanPrintFull>boolean</CanPrintFull> </Permissions> </Security> <AddSignature>boolean</AddSignature> <Signature> <CertificateID>string</CertificateID> <AddTimeStamp>boolean</AddTimeStamp> <CreateBES>boolean</CreateBES> <ShowValidationStatus>boolean</ShowValidationStatus> <Page>int</Page> <Text>string</Text> <ImagePath>string</ImagePath> <PosX>int</PosX> <PosY>int</PosY> <Width>int</Width> <Height>int</Height> <LocationInfo>string</LocationInfo> <ContactInfo>string</ContactInfo> <Reason>string</Reason> </Signature> <AddTimeStamp>boolean</AddTimeStamp> <TimeStamp> <LocationInfo>string</LocationInfo> <ContactInfo>string</ContactInfo> <Reason>string</Reason> 68

69 </TimeStamp> <PreserveExistingSignatures>boolean</PreserveExistingSignatures> <ConvertSignedPDF>boolean</ConvertSignedPDF> <StrictSignedPDFConversion>boolean</StrictSignedPDFConversion> <ReturnErrorIfNotModified>boolean</ReturnErrorIfNotModified> <XMLReportTemplate>string</XMLReportTemplate> <XMLReportSignaturesTemplate>string</XMLReportSignaturesTemplate> <AddXMLReportToXMP>boolean</AddXMLReportToXMP> <ReturnFullXMPReport>boolean</ReturnFullXMPReport> <MaxInputFileSize>int</MaxInputFileSize> <AllowedFileTypes>string</AllowedFileTypes> <EnableOCR>boolean</EnableOCR> <ForceOCR>boolean</ForceOCR> <AddSourceAsPDFA3AssociatedFile>boolean</AddSourceAsPDFA3AssociatedFile> <ForceImagePDFAIfErrors>boolean</ForceImagePDFAIfErrors> <ForceImagePDFAResolution>int</ForceImagePDFAResolution> <ForcePDFAIfErrors>boolean</ForcePDFAIfErrors> <HttpHeaders>string</HttpHeaders> </Options> <CustomXMLData>string</CustomXMLData> </ConvertFileFromURL> Odpověď HTTP/ OK <ConvertFileFromURLResponse xmlns=" <ConvertFileFromURLResult>int</ConvertFileFromURLResult> <UploadedFileURL>string</UploadedFileURL> <Report>string</Report> <ErrorMessage>string</ErrorMessage> </ConvertFileFromURLResponse> Pozn.: Jedná se o interní metodu pro komunikaci se spisovou službou 69

70 Konverze PDF do PDF/A Webová sluţba umoţňuje převést PDF dokumentu do odpovídajícího PDF/A formátu. Formát PDF/A je definován v několika úrovních souladu. Tuto úroveň je moţné nastavit a pokud PDF dokument neobsahuje neopravitelné chyby a neshody oproti zvolené úrovni souladu, bude převeden do formátu PDF/A. Metoda webové služby pdfaconvert a pdfaconvertex sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na a SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <pdfaconvert xmlns=" <Input>base64Binary</Input> <ConformanceLevel>string</ConformanceLevel> <ReportLanguage>string</ReportLanguage> </pdfaconvert> <Input> Base64Binary PDF soubor v kódování Base64Binary, jehoţ formát má být ověřen proti vybrané úrovni PDF/A formátu <ConformanceLevel> Hodnota úrovně souladu se specifikací archivního formátu PDF/A 1b 1a 2b 2a 2u Všechny TrueType fonty jsou přiloţeny v dokumentu, externí http odkazy nejsou povoleny, ani průhlednost, ISO :2008 Stejné poţadavky jako 1b. Dále vyţaduje přesnou vizuální reprodukci doplněnou o povinné mapování textu na standard Unicode a přesnou deklaraci a popis logické struktury dokumentu (Tagged PDF), specifikace jazyka, ISO :2008 Zaloţeno na novější specifikaci PDF dokumentu 1.5, 1.6 a 1.7., nově umoţňuje JPEG2000 kompresi, podpora průhlednosti, připojení OpneType fontů, podpora pdo podpis typu PAdES a moţnost vloţení PDF/A dokumentů do dokumentu PDF/A-2 Vychází ze specifikace 2b navíc s poţadavkem na kódování veškerého textu v dokumentu v Unicode mapování 3a Vychází ze specifikace ISO :2012, 3b umoţňuje vkládání libovolných formátů (např. XML, CSV, CAD, wordprocessing 70

71 3u dokumentů, tabulkových dokumentů a dalších) do formátu PDF / A jako kompletní archivované objekty. Jinak platí specifikace dle PDF/A-2 <ReportLanguage> Jazyk PDF/A reportu ve formátu cz, en, de Pozn.: V požadavku metody pdfaconvertex je namísto atributu ReportLanguage, z metody pdfaconvert, atribut Params: <Params> string Volitelné, obsahuje další parametry. Pouţijte ForcePDFAIfErrors=true, pokud má být soubor označen jako PDF/A i přesto, ţe obsahuje chyby (Bude uvedeno v XML zprávě) Odpověď HTTP/ OK <pdfaconvertresponse xmlns=" <pdfaconvertresult>int</pdfaconvertresult> <Output>base64Binary</Output> <Report> <ErrorCode>int</ErrorCode> <ErrorMessage>string</ErrorMessage> <ConformanceLevel>string</ConformanceLevel> <Result>int</Result> <Issues> <PDFAIssue> <Severity>int</Severity> <Description>string</Description> </PDFAIssue> <PDFAIssue> <Severity>int</Severity> <Description>string</Description> </PDFAIssue> </Issues> </Report> </pdfaconvertresponse> <pdfaconvertresult> int Výsledek metody pdfaconvert. 0 = v pořádku 71

72 <Output> Base64Binary V případě úspěchu konverze Base64Binary tvar konvertovaného dokumentu v odpovídajícím formátu PDF/A ve zvolené úrovni souladu <Report> <ErrorCode> int Chybový kód Výsledek funkce ověření shody. 0 = ověření se podařilo, jinak kód chyby. <ErrorMessage> Textový popis chyby při problému s ověřením shody <ConformanceLevel> Úroveň PDF/A vygenerovaného dokumentu. <Result> int Shoda souboru se zvolenou úrovní specifikace. 0 = formát odpovídá, 1 = vyskytly se nezávaţné neshody, 2 = dokument neodpovídá <Issues> <PDFAIssue> Opakovací sekce, dle počtu nalezených neshod <Severity> int Závaţnost nalezené neshody 1 = informace, 2 = varování, 3 = chyba <Description> nalezené neshody </PDFAIssue> </Issues> </Report> 72

73 Ověření shody s PDF/A Formát PDF/A je definován v několika úrovních souladu. Tuto úroveň je moţné nastavit a vůči ní bude dokument analyzován. Metoda webové služby pdfaverify sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <pdfaverify xmlns=" <Input>base64Binary</Input> <ConformanceLevel>string</ConformanceLevel> <ReportLanguage>string</ReportLanguage> </pdfaverify> <Input> Base64Binary PDF soubor v kódování Base64Binary, jehoţ formát má být ověřen proti vybrané úrovni PDF/A formátu <ConformanceLevel> Není povinné pokud se hodnota nezadá, zjístí se ze vstupního souboru. Hodnota úrovně souladu se specifikací archivního formátu PDF/A. Kaţdá novější verze souladu by měla být zpětně kompatibilní. To znamená všechny platné PDF/A-1 dokumenty by měly být v souladu se specifikací PDF/A-2. Naopak ne všechny PDF/A-2 vyhovující soubory musí být v souladu se specifikací PDF/A-1. Obdobně to platí pro vztah mezi verzí PDF/A-1 a PDF/A-3, PDF/A-2 a PDF/A-3. 1a 1b Vyţaduje přesnou vizuální reprodukci doplněnou o povinné mapování textu na standard Unicode a přesnou deklaraci a popis logické struktury dokumentu (Tagged PDF), ISO :2008 Vyţaduje přesnou vizuální reprodukci, ale ne informace o struktuře nebo sémantické informace, ISO :2008 2a Zaloţeno na novější specifikaci PDF dokumentu 1.5, 1.6 a b 2u Vychází ze specifikace 2b navíc s poţadavkem na kódování veškerého textu v dokumentu v Unicode mapování 3a Vychází ze specifikace ISO :2012, 73

74 3b 3u umoţňuje vkládání libovolných formátů (např. XML, CSV, CAD, wordprocessing dokumentů, tabulkových dokumentů a dalších) do formátu PDF / A jako kompletní archivované objekty. <ReportLanguage> Jazyk PDF/A reportu ve formátu cz, en, de Odpověď HTTP/ OK <pdfaverifyresponse xmlns=" <pdfaverifyresult>int</pdfaverifyresult> <Report> <ErrorCode>int</ErrorCode> <ErrorMessage>string</ErrorMessage> <ConformanceLevel>string</ConformanceLevel> <Result>int</Result> <Issues> <PDFAIssue> <Severity>int</Severity> <Description>string</Description> </PDFAIssue> <PDFAIssue> <Severity>int</Severity> <Description>string</Description> </PDFAIssue> </Issues> </Report> </pdfaverifyresponse> <pdfaverifyresult> int Výsledek metody pdfaverify. 0 = v pořádku. K chybě dojde například pokud není nainstalovaná nebo je nefunkční pdfa podpora <Report> <ErrorCode> int Výsledek funkce ověření shody. 0 = ověření se podařilo, jinak kód chyby. <ErrorMessage> Textový popis chyby při problému s ověřením shody <ConformanceLevel> 74

75 Úroveň, na kterou se prověřovala shoda <Result> Int Shoda souboru se zvolenou úrovní specifikace. 0 = formát odpovídá, 1 = vyskytly se nezávaţné neshody, 2 = dokument neodpovídá <Issues> <PDFAIssue> Opakovací sekce, dle počtu nalezených neshod <Severity> int Závaţnost nalezené neshody 1 = informace, 2 = varování, 3 = chyba <Description> nalezené neshody </PDFAIssue> </Issues> </Report> 75

76 Získání konverzních profilů Webová sluţba umoţňuje pracovat s předpřipravenými konverzními profily, které obsahují nastavení pro konverzi. Tyto profily jsou aktuálně dostupné v instalaci, moţné ověřit pomocí metody GetProfileList. Metoda webové služby GetProfileList sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GetProfileList xmlns=" /> Odpověď HTTP/ OK <GetProfileListResponse xmlns=" <GetProfileListResult>int</GetProfileListResult> <Profiles>string</Profiles> <ErrorMessage>string</ErrorMessage> </GetProfileListResponse> <GetProfileListResult> Int Výsledek metody GetProfileList. 0 = v pořádku <Profiles> Dostupné konverzní profily <ErrorMessage> V případě, ţe nastane chyba obsahuje podrobnější popis chyby 76

77 Získání protokolu ověření podpisů v dokumentu Webová sluţba umoţňuje získat protokol ověření podpisů v dokumentu pomocí volání metody GetSignatureReport. Protokol ověření obsahuje přehled všech podpisů, vystavitelů certifikátů, jejich platnosti, ověřitelnosti a dalších informací ze zdrojového dokumentu. Metoda webové služby GetSignatureReport sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na a SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GetSignatureReport xmlns=" <Input>base64Binary</Input> <ExternalSignature>base64Binary</ExternalSignature> <Filename>string</Filename> <Params>string</Params> <Properties> <ballowunknowncertificateauthority>boolean</ballowunknowncertificateauthority> <revocationchecking>excluderoot or EndCertificateOnly or None</revocationChecking> <breturnvalidationmaterial>boolean</breturnvalidationmaterial> <breturnhtmlreport>boolean</breturnhtmlreport> <bcollapsedhtmlreport>boolean</bcollapsedhtmlreport> <Language>string</Language> </Properties> </GetSignatureReport> <Input> Base64Binary ní dokument pro ověření podpisů zapsaný v Base64Binary <ExternalSignature> Base64Binary Volitelné. Externí podpis, kterým se podepíše výsledný protokol ověření, zapsaný v Base64Binary <FileName> Název vstupního souboru pro ověření <Params> 77

78 Volitelné parametry. Můţe obsahovat jazyk (Lang=) pro výsledný protokol ověření, povolené jsou cz, en. <Properties> <ballowunknowncertificateauthority> boolean Povolí analýzu podpisů od neuznávaných certifikačních autorit <revocationchecking> enum Stupeň kontroly odvolání certifikátů. Hodnoty ExcludeRoot, EndCertificateOnly, None <breturnvalidationmaterial> boolean Nastaví vrácení CRL seznamů v DocInfo <breturnhtmlreport> boolean Nastaví vrácení HTML reportu v Error Message <bcollapsedhtmlreport> boolean Nastaví moţnost rozbalení HTML reportu ve stránce <Language> Definuje výstupní jazyk </Properties> Odpověď HTTP/ OK <GetSignatureReportResponse xmlns=" <GetSignatureReportResult>PRN_CR_SUCCESS or PRN_CR_UNKNOWN or PRN_CR_UNKNOWN_PRINT or PRN_CR_CANCELED or PRN_CR_CANCELED_INIT or PRN_CR_CANCELED_PRINT or PRN_CR_CONVERSION or PRN_CR_CONVERSION_INIT or PRN_CR_CONVERSION_PRINT or PRN_CR_EXEC_MACRO or PRN_CR_FILE_CONVERSION_TIMEOUT or PRN_CR_INITIALIZATION_TIMEOUT or PRN_CR_NO_FILE_ASSOCIATION or PRN_CR_OPEN_APP or PRN_CR_OPEN_DOC or PRN_CR_OUT_OF_MEMORY or PRN_CR_PAGE_CONVERSION_TIMEOUT or PRN_CR_PASSWORD_PROTECTED or PRN_CR_PROCESS_GONE or PRN_CR_PROCESS_GONE_INIT or PRN_CR_PROCESS_GONE_PRINT or PRN_CR_QUQUE_WAIT_TIMEOUT or PRN_CR_SET_APP_SETTING or 78

79 PRN_CR_SET_DOC_SETTING or PRN_CR_SET_PRINTER or PRN_CR_SET_TEMP_DATA or PRN_CR_ADDIN_CONNECT or PRN_CR_ADDIN_EXEC or PRN_CR_ADDIN_NOT_FOUND or PRN_CR_ADDIN_TIMEOUT or PRN_CR_ADDIN_UNKNOWN or PRN_CR_UNSUPPORTED_EXTENSION or PRN_CR_PRIVATE_KEY_INACESSIBLE or PRN_CR_DIGITAL_SIGNING_DISABLED or PRN_CR_UNABLE_TO_SIGN_ENCRYPTED or PRN_CR_NONSIGNING_CERTIFICATE or PRN_CR_DIGITAL_SIGNATURE_ERROR or PRN_CR_VBS_NOT_FOUND or PRN_CR_VBS_ERR_READ or PRN_CR_SHELL_PRINT_ERR or PRN_CR_ERROR_FILE_NOT_FOUND or PRN_CR_ERROR_PATH_NOT_FOUND or PRN_CR_SE_ERR_ACCESSDENIED or PRN_CR_SE_ERR_OOM or PRN_CR_ERROR_BAD_FORMAT or PRN_CR_SE_ERR_SHARE or PRN_CR_SE_ERR_ASSOCINCOMPLETE or PRN_CR_SE_ERR_DDETIMEOUT or PRN_CR_SE_ERR_DDEFAIL or PRN_CR_SE_ERR_DDEBUSY or PRN_CR_SE_ERR_NOASSOC or PRN_CR_SE_ERR_DLLNOTFOUND or PRN_CR_SHELL_PRINT_ERR_MAX or PRN_CR_VBS_TRY_NEXT or PRN_CR_EXTENSION_NOT_ALLOWED or PRN_CR_PROFILE_NOT_FOUND or PRN_CR_UNKNOWN_FILE_TYPE or PRN_CR_STAMP_FILE_NOT_FOUND or PRN_CR_OUTPUT_FAILED or PRN_CR_EML_HAS_NO_ATTACHMENTS or PRN_CR_EML_NO_BODY_FOR_ATT or PRN_CR_EML_PARSING or PRN_CR_INPUT_TOO_LARGE or PRN_CR_ERR_CREATING_REPORT or PRN_CR_VBS_HOST_NOT_FOUND or PRN_CR_TIMESTAMP_ERROR or PRN_CR_NOT_IMPLEMENTED or PRN_CR_TRIAL_EXPIRED or PRN_CR_LICENCE_NOT_FOUND or PRN_CR_POSTPROCESSING or PRN_CR_PDFA_CONVERSION or PRN_CR_PDFA_VERIFICATION or PRN_CR_EXCEPTION or PRN_CR_UNABLE_MODIFY_SIGNED or PRN_CR_APPLICATION_CLOSING or PRN_CR_CODE_RECOGNITION or PRN_CR_PAGE_NOT_EXIST or PRN_CR_BARCODE_GENERATING or PRN_CR_BARCODE_SIZE_TOO_SMALL or PRN_CR_WAITING_AUTHORIZATION or PRN_CR_WP_WRONG_INPUT or PRN_CR_WP_METHOD_FAILED or PRN_CR_WEBSITE_NOT_TRUSTWORTY or PRN_CR_CONVERSION_REJECTED or PRN_CR_FILE_ALLREADY_EXISTS or PRN_CR_UNABLE_CONVERT_WITH_INVALID_SIGS or PRN_CR_NOT_MODIFIED or PRN_CR_UPLOAD_ERROR</GetSignatureReportResult> <Report>base64Binary</Report> <Info> <siginfos> <SigInfo> <id>unsignedint</id> <sid>string</sid> <sigtimestamps xsi:nil="true" /> <sigtype>string</sigtype> <xmlsignedreferences xsi:nil="true" /> <pdfbyterange xsi:nil="true" /> <hasfurtherchanges>boolean</hasfurtherchanges> <Reason>string</Reason> <Location>string</Location> <Contact>string</Contact> </SigInfo> <SigInfo> <id>unsignedint</id> <sid>string</sid> <sigtimestamps xsi:nil="true" /> <sigtype>string</sigtype> <xmlsignedreferences xsi:nil="true" /> <pdfbyterange xsi:nil="true" /> <hasfurtherchanges>boolean</hasfurtherchanges> <Reason>string</Reason> <Location>string</Location> <Contact>string</Contact> </SigInfo> </siginfos> <doctype>string</doctype> <expiration>datetime</expiration> <docdatahash>base64binary</docdatahash> <docdatahashalg>string</docdatahashalg> <currsignhashalg>string</currsignhashalg> <globalstatus>string</globalstatus> </Info> <ErrorMessage>string</ErrorMessage> </GetSignatureReportResponse> <GetSignatureReportResult> Výsledek metody GetSignatureReport. <Report> Base64Binary Výstupní PDF protokol ověření dokumentu v Base64Binary 79

80 <Info> <siginfos> <SigInfo> <id> unsignedint Pořadové číslo podpisu tak, jak byl přidán do dokumentu. Počítáno od nuly. <sid> <sigtimestamps> XML struktura Unikátní identifikátor podpisu. nepovinný parametr, je závislý na existenci časového razítka u podpisu Informace o časovém razítku přidaném jako atribut k digitálnímu podpisu. Stejná XML struktura informací jako u nadřazeného podpisu. Tedy obsahuje element SigInfo viz výše včetně všech jeho potomků. Informace v potomcích se váţí k certifikátu časového razítka. <sigtype> string Typ podpisu. Hodnoty: UNKNOWN; STANDARD; XML602FORM_TECHNICAL <xmlsignedreferences> nepovinný parametr, je závislý na formátu vstupního souboru (jen pro XML/ZFO) XML struktura <pdfbyterange> XML struktura Data podpisu nepovinný parametr, je závislý na formátu vstupního souboru (jen pro PDF) Bytový rozsah PDF podpisů <hasfurtherchanges> Boolean Údaj, zda byly v dokumentu provedeny změny po podpisu. Hodnoty: 0, 1 <Reason> Důvod podepsání dokumentu. 80

81 <Location> Místo podepsání dokumentu. <Contact> Kontaktní informace k podepsání dokumentu. </SigInfo> </siginfos> <doctype> UNKNOWN CMSPKCS7 CMSPKCS7Ext PDF XML XML602Form XMLISDOC ASiC_S_CAdES ASiC_S_XAdES ASiC_S_Tst ASiC_E_CAdES_Tst ASiC_E_XAdES MS_WORD MS_EXCEL MS_PWR_PNT ODF Neznámý typ dokumentu Dokument podepsaný interním CMS/PKCS7 podpisem Dokument podepsaný externím CMS/PKCS7 podpisem PDF dokument Podepsaná XML data Podepsaná XML data z FO/ZFO formuláře aplikace Software602 Form Filler Podepsaná XML ISDOC data ASiC-S with CAdES ASiC-S with XAdES ASiC-S with Timestamp ASiC-E with CAdES or Timestamp ASiC-E with XAdES Podepsaný dokument aplikace MS Word Podepsaný dokument aplikace MS Excel Podepsaný dokument aplikace MS Powerpoint OpenDocumentFormat (OpenOffice) <expiration> DateTime Datum a čas vypršení ověřitelnosti celého dokumentu. Po tomto datu nebude moţné ověřit platnost podpisových certifikátů a zajistit další ověřitelnost a platnost dokumentu. <docdatahash> Base64Binary Hash analyzovaného dokumentu v kódování Base64Binary. Algoritmus výpočtu 81

82 hashe je v následujícícm elementu docdatahashalg. <docdatahashalg> Algoritmus výpočtu hashe analyzovaného dokumentu. Ve tvaru například: <currsignhashalg> Algoritmus výpočtu hashe posledního podpisu. Příklad: <globalstatus> Sumarizuje stav dokumentu na základě všech podpisů a časových razítek. Můţe nabývat hodnot: OK = 0 (Všechny podpisy a dokumentová časová razítka jsou platná) WARNING = 1 (Nelze určit platnost některých podpisových certifikátů nebo dokumentových časových razítek) ERROR = 2 (Některé podpisy nebo dokumentová časová razítka jsou neplatná, např. odvolaný certifikát, poškozený hash dokumentu, vizuální změny po podpisu atd.) NO_SIGNATURES = 3 (Dokument neobsahuje ţádné podpisy ani dokumentová časová razítka) </Info> <ErrorMessage> Chybová zpráva, kdyţ se z nějakého důvodu nepodaří provést poţadavek Pozn.: u metody GetSignatureReport2 se vrací result jako integer 82

83 Získání časového razítka Webová sluţba umoţňuje získat časové razítko ze serveru SecuStamp.eu pomocí volání metody GetTimeStamp. Metoda komunikuje se serverem SecuStamp.eu pomocí přihlasovacího jména nebo certifikátu. Metoda webové služby GetTimeStamp sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GetTimeStamp xmlns=" <Hash>string</Hash> <Flags>long</Flags> </GetTimeStamp> <Hash> Hexadecimálně zapsaný nebo Base64Binary kódovaný SHA1 hash pro časové razítko <Flags> Long Nepouţito, nastavte 0 Odpověď HTTP/ OK <GetTimeStampResponse xmlns=" <GetTimeStampResult>string</GetTimeStampResult> <Error>string</Error> </GetTimeStampResponse> 83

84 <GetTimeStampResult> V případě úspěchu vrací Base64Binary kódované časové razítko podle RFC3166, jinak vrátí prázdný řetězec. <Error> Kdyţ nastane chyba při převodu, obsahuje textový popis chyby 84

85 Export textu z PDF s možností technologie OCR Webová služba umožňuje exportovat text z libovolného dokumentu ve formátu pdf, umožňuje také scanování textu z obrázků pomocí OCR technologie. Metoda webové služby PdfToText sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <PdfToText xmlns=" <InputPDF>base64Binary</InputPDF> <Pages> <int>int</int> <int>int</int> </Pages> <Flags>long</Flags> <Params>string</Params> <Lang>string</Lang> </PdfToText> <Input> Base64Binary Libovolný dokument ve formátu PDF v kódování Base64Binary <Pages> Čísla stránek ze kterých se má vytěţovat text, indexovány od 1. Pro indexování od konce pouţijte Int záporné hodnoty, kde -1 odpovídá poslední stránce. Kdyţ není vyplněný, prohledává se celý dokument. <Flags> Rozširující nastavení OCR Engine. Pokud stránka neobsahuje obrázek, OCR se nepouţívá. Pro nastavení moţno vyuţít jakékoli kombinace nasledujících hodnot: EnableOCR 16 (0x0010); Pouţije OCR Engine při vytěţování textu. Jako výchozí nastavení se vytěţuje jenom text ze stránek, které obsahují jeden celostránkový obrázek (scanované soubory, Long fotografie a pod.) ForceOCR 32 (0x0020); Pouţije OCR Engine na všechny stránky, které obsahují aspoň jeden obrázek. Neodporučuje se pouzívat na stránky, kde je kombinace text a obrázek, protoţe písemný obsah bude před OCR konverzí převeden na obrázek, čím můţe nastat ztráta kvality 85

86 <Params> ExtendedLogging 64 (0x0040); Rozšířené logování, můţe zvětšit velikost logovacího souboru, nemá vliv na rychlost a výsledky funkce, jen na objem logovaných dat. Moţno definovat jen část dokumentu pro OCR ve formátu Coordinates=[x_val],[y_val],[width_val],[height_val], příklad Coordinates=50,50,200,200 <Lang> Jazyk, který se pouţije při konverzi pomocí OCR engine, hodně ovlivní kvalitu vysledného textu. Můţe být ve formátu 'cz' 'en' nebo 'de'. Pro více jazyků kontaktujte podporu. Odpověď HTTP/ OK <PdfToTextResponse xmlns=" <PdfToTextResult>int</PdfToTextResult> <Text>string</Text> <ErrorMessage>string</ErrorMessage> </PdfToTextResponse> <PdfToTextResult> Int Výsledek metody PdfToText. 0 = v pořádku <Text> Vytěţený text z PDF souboru <ErrorMessage> Jestli nastane problém, obsahuje popis problému (kde nastal, co nefungovalo) 86

87 Export textu z PDF s moţností technologie OCR Webová služba umožňuje exportovat text z libovolného dokumentu ve formátu pdf, umožňuje také scanování textu z obrázků pomocí OCR technologie. Tato metoda umožňuje skenovat více sekcí v jednom dokumentu. Metoda webové služby PdfToText2 sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <PdfToText2 xmlns=" <InputPDF>base64Binary</InputPDF> <Flags>long</Flags> <Params>string</Params> <XML_Template>string</XML_Template> <Lang>string</Lang> </PdfToText2> <Input> Base64Binary Libovolný dokument ve formátu PDF v kódování Base64Binary <Flags> Rozširující nastavení OCR Engine. Pokud stránka neobsahuje obrázek, OCR se nepouţívá. Pro nastavení moţno vyuţít jakékoli kombinace nasledujících hodnot: EnableOCR 16 (0x0010); Pouţije OCR Engine při vytěţování textu. Jako výchozí nastavení se vytěţuje jenom text ze stránek, které obsahují jeden celostránkový obrázek (scanované soubory, fotografie a pod.) Long ForceOCR 32 (0x0020); Pouţije OCR Engine na všechny stránky, které obsahují aspoň jeden obrázek. Neodporučuje se pouzívat na stránky, kde je kombinace text a obrázek, protoţe písemný obsah bude před OCR konverzí převeden na obrázek, čím můţe nastat ztráta kvality ExtendedLogging 64 (0x0040); Rozšířené logování, můţe zvětšit velikost logovacího souboru, nemá vliv na rychlost a výsledky funkce, jen na objem logovaných dat. <Params> Moţno definovat jen část dokumentu pro OCR ve formátu Coordinates=[x_val],[y_val],[width_val],[height_val], příklad Coordinates=50,50,200,200 87

88 <XML_Template> string XML struktura obsahující souřadnice skenovaných sekcí. Příklad XML si vyţádejte u podpory. <Lang> Jazyk, který se pouţije při konverzi pomocí OCR engine, hodně ovlivní kvalitu vysledného textu. Můţe být ve formátu 'cz' 'en' nebo 'de'. Pro více jazyků kontaktuje podporu. Odpověď HTTP/ OK <PdfToText2Response xmlns=" <PdfToText2Result>int</PdfToText2Result> <Text>string</Text> <ErrorMessage>string</ErrorMessage> </PdfToText2Response> <PdfToText2Result> Int Výsledek metody PdfToText2. 0 = v pořádku <Text> Vytěţený text z PDF souboru <ErrorMessage> Jestli nastane problém, obsahuje popis problému (kde nastal, co nefungovalo) 88

89 Přečtení obsahu čárových kódů v PDF souboru Webová služba umožňuje přečíst obsah čárových kódů typu QR, PDF417, DataMatrix a 1D. Metoda ReadBarcodeTo vrací jenom položku data z čárového kódu, metoda ReadBarcode vrací také jeho polohu a v případě 1D kódu i podtyp a checksum. Metoda webové služby ReadBarcode a ReadBarcodeTo sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na a SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <ReadBarcode xmlns=" <InputPDF>base64Binary</InputPDF> <Pages> <int>int</int> <int>int</int> </Pages> <Flags>long</Flags> <Additional_Info>string</Additional_Info> </ReadBarcode> <Input> Base64Binary Libovolný dokument ve formátu PDF v kódování Base64Binary <Pages> Int[] Čísla stránek, na kterých se hedají kódy, indexovány od 1. Pro indexování od konce pouţite záporné hodnoty, kde -1 odpovída poslední stránce. Kdyţ není vyplněný, prohledává se celý dokument. <Flags> Rozširující nastavení pro určení hledaného typu čárového kódu. Moţno vyuţít jakékoli kombinace nasledujících hodnot: Long QR 1 (0x0001); PDF417 2 (0x0002); DataMatrix 4 (0x0004); 1D BarCode 8 (0x0008) ExtendedLogging 64 (0x0040); Rozšířené logování, můţe zvětšit velikost logovacího souboru, nemá vliv na rychlost a výsledky funkce, jen na objem logovaných dat. 89

90 <Additional_Info> Doplňující informace, vloţí se ke kaţdému nalezenému kódu do logovacího souboru - určeno jen pro zpřehlednění logu. Odpověď HTTP/ OK <ReadBarcodeResponse xmlns=" <ReadBarcodeResult>int</ReadBarcodeResult> <Barcode_Result> <data> <BarcodeInfo_result> <data>string</data> <coords xsi:nil="true" /> <user_data>string</user_data> <page>int</page> <type>string</type> <checksum>boolean</checksum> </BarcodeInfo_result> <BarcodeInfo_result> <data>string</data> <coords xsi:nil="true" /> <user_data>string</user_data> <page>int</page> <type>string</type> <checksum>boolean</checksum> </BarcodeInfo_result> </data> </Barcode_Result> <ErrorMessage>string</ErrorMessage> </ReadBarcodeResponse> <ReadBarcodeResult> Int Výsledek metody ReadBarcode. 0 = v pořádku <BarcodeInfo_result> <data> Data uloţená v čárovém kódu <coords> Int[] Souřadnice nalezeného čárového kódu. Souřadnice jsou ve tvaru levého spodního a pravého vrchního rohu čtverce, do kterého se má vygenerovat QR kód. 90

91 <user_data> Pomocný logovací text zadaný jako vstup, stejný pro všechny nalezené kódy <page> Int Číslo stránky na které byl nalezen čárový kód <type> Typ nalezeného čárového kódu <checksum> Boolean V případě 1D kódu indikuje zda je kód i s CheckSum součtem </BarcodeInfo_result> <ErrorMessage> Jestli nastane problém, obsahuje popis problému (kde nastal, co nefungovalo) 91

92 Generování čárových kódů do obrázku nebo PDF souboru Webová služba umožňuje generování 1D a 2D čárových kódů do obrázku nebo PDF souboru. Podporovány jsou QR, PDF417, DataMatrix a řada 1D kódů. Jako vstupní parametry jsou typ požadovaného kódu, data, velikost, umístění na stránce a číslo stránky. V případě specifických kódů je možno určit další parametry jako například kódování nebo chybovou korekci. Metoda webové služby GenerateBarcodeToImage sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GenerateBarcodeToImage xmlns=" <Type>Barcode_1D_UPCVersionA or Barcode_1D_UPCVersionE or Barcode_1D_UPCSupplemental2Digit or Barcode_1D_UPCSupplemental5Digit or Barcode_1D_EAN13 or Barcode_1D_EAN8 or Barcode_1D_Interleaved2of5 or Barcode_1D_Standard2of5 or Barcode_1D_Industrial2of5 or Barcode_1D_Code39 or Barcode_1D_Code39Extended or Barcode_1D_Codabar or Barcode_1D_PostNet or Barcode_1D_Bookland or Barcode_1D_ISBN or Barcode_1D_JAN13 or Barcode_1D_MSIMod10 or Barcode_1D_MSI2Mod10 or Barcode_1D_MSIMod11 or Barcode_1D_MSIMod11Mod10 or Barcode_1D_ModifiedPlessey or Barcode_1D_Code11 or Barcode_1D_USD8 or Barcode_1D_UCC12 or Barcode_1D_UCC13 or Barcode_1D_LOGMARS or Barcode_1D_Code128 or Barcode_1D_Code128A or Barcode_1D_Code128B or Barcode_1D_Code128C or Barcode_1D_ITF14 or Barcode_1D_Code93 or Barcode_1D_TelePen or Barcode_PDF417 or Barcode_QR or Barcode_DataMatrix</Type> <Flags>string</Flags> <Data>string</Data> </GenerateBarcodeToImage> <Type> enum Poţadovaný typ čárového kódu ve tvaru Barcode_[typ kódu] <Flags> Dodatečná nastavení, nepovinný parametr. V případě QR kódu moţno nastavit kódování ("numeric","alphanumeric","byte" nebo "binary","kanji") a chybovou korekci ("l","m","q","h"). Parametry se oddělují ";", formátují se ve tvaru "encoding=[hodnota]" a "correction=[hodnota]. <Data> Data pro generování čárového kódu ve stringové podobě. O správnost vstupních dat se stará volající. Podporovány jsou jen znaky anglicke abecedy. 92

93 Odpověď HTTP/ OK <GenerateBarcodeToImageResponse xmlns=" <GenerateBarcodeToImageResult>int</GenerateBarcodeToImageResult> <OutputImage>base64Binary</OutputImage> <ErrorMessage>string</ErrorMessage> </GenerateBarcodeToImageResponse> <GenerateBarcodeToImageResult> Int Číselná reprezentace výsledku metody. 0 = v pořádku <OutputImage> Base64Binary Data výstupního obrázku ve formátu.png v kódování Base64Binary. <ErrorMessage> Kdyţ nastane chyba při generování, obsahuje podrobnější údaje o chybě. 93

94 Metoda webové služby GenerateBarcodeToPDF sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GenerateBarcodeToPDF xmlns=" <InputPDF>base64Binary</InputPDF> <placement> <BarcodePlacement> <type>barcode_1d_upcversiona or Barcode_1D_UPCVersionE or Barcode_1D_UPCSupplemental2Digit or Barcode_1D_UPCSupplemental5Digit or Barcode_1D_EAN13 or Barcode_1D_EAN8 or Barcode_1D_Interleaved2of5 or Barcode_1D_Standard2of5 or Barcode_1D_Industrial2of5 or Barcode_1D_Code39 or Barcode_1D_Code39Extended or Barcode_1D_Codabar or Barcode_1D_PostNet or Barcode_1D_Bookland or Barcode_1D_ISBN or Barcode_1D_JAN13 or Barcode_1D_MSIMod10 or Barcode_1D_MSI2Mod10 or Barcode_1D_MSIMod11 or Barcode_1D_MSIMod11Mod10 or Barcode_1D_ModifiedPlessey or Barcode_1D_Code11 or Barcode_1D_USD8 or Barcode_1D_UCC12 or Barcode_1D_UCC13 or Barcode_1D_LOGMARS or Barcode_1D_Code128 or Barcode_1D_Code128A or Barcode_1D_Code128B or Barcode_1D_Code128C or Barcode_1D_ITF14 or Barcode_1D_Code93 or Barcode_1D_TelePen or Barcode_PDF417 or Barcode_QR or Barcode_DataMatrix</type> <Page>int</Page> <X>float</X> <Y>float</Y> <Width>float</Width> <Height>float</Height> <Data>string</Data> </BarcodePlacement> <BarcodePlacement> <type>barcode_1d_upcversiona or Barcode_1D_UPCVersionE or Barcode_1D_UPCSupplemental2Digit or Barcode_1D_UPCSupplemental5Digit or Barcode_1D_EAN13 or Barcode_1D_EAN8 or Barcode_1D_Interleaved2of5 or Barcode_1D_Standard2of5 or Barcode_1D_Industrial2of5 or Barcode_1D_Code39 or Barcode_1D_Code39Extended or Barcode_1D_Codabar or Barcode_1D_PostNet or Barcode_1D_Bookland or Barcode_1D_ISBN or Barcode_1D_JAN13 or Barcode_1D_MSIMod10 or Barcode_1D_MSI2Mod10 or Barcode_1D_MSIMod11 or Barcode_1D_MSIMod11Mod10 or Barcode_1D_ModifiedPlessey or Barcode_1D_Code11 or Barcode_1D_USD8 or Barcode_1D_UCC12 or Barcode_1D_UCC13 or Barcode_1D_LOGMARS or Barcode_1D_Code128 or Barcode_1D_Code128A or Barcode_1D_Code128B or Barcode_1D_Code128C or Barcode_1D_ITF14 or Barcode_1D_Code93 or Barcode_1D_TelePen or Barcode_PDF417 or Barcode_QR or Barcode_DataMatrix</type> <Page>int</Page> <X>float</X> <Y>float</Y> <Width>float</Width> <Height>float</Height> <Data>string</Data> </BarcodePlacement> </placement> <Flags>string</Flags> </GenerateBarcodeToPDF> <InputPDF> Base64Binary Data vstupního PDF souboru v kódování Base64Binary. 94

95 <Placement> struct Struktura obsahující údaje o umístnění čárového kódu, číslo stránky "Page", souřadnice "X" a "Y" levého spodního rohu v 72Dpi, velikost kódu "Width" a "Height", typ kódu "type" a Data, která chcete zakódovat. Vrámci jednoho volání je moţno zadefinovat více kódů. <Flags> Dodatečná nastavení, nepovinný parametr. V případě QR kódu moţno nastavit kódování ("numeric","alphanumeric","byte" nebo "binary","kanji") a chybovou korekci ("l","m","q","h"). Parametry se oddělují ";", formátují se ve tvaru "encoding=[hodnota]" a "correction=[hodnota]". Dále moţno nastavit parametr "ignoresize", kde se kód generuje vţdy podle poţadavku volajícího, i kdyby měla tato velikost znamenat ztrátu dat a nečitelnost kódu. Odpověď HTTP/ OK <GenerateBarcodeToPDFResponse xmlns=" <GenerateBarcodeToPDFResult>int</GenerateBarcodeToPDFResult> <OutputPDF>base64Binary</OutputPDF> <ErrorMessage>string</ErrorMessage> </GenerateBarcodeToPDFResponse> <GenerateBarcodeToPDFResult> Int Číselná reprezentace výsledku metody GenerateBarcodeToPDF. 0 = v pořádku <OutputPDF> Base64Binary Data výstupního PDF souboru v kódování Base64Binary. <ErrorMessage> Kdyţ nastane chyba při generování, obsahuje podrobnejší údaje o chybě. 95

96 Generování platebních příkazů v QR kódu do obrázku nebo PDF souboru Webová služba umožňuje generování QR čárových kódů obsahujících data pro platební příkaz do obrázku nebo PDF souboru. Tyto QR kódy splňují standard ČBA pro sdílení údajů v rámci tuzemského platebního styku. Jako vstupní data metody jsou použité údaje o platebním příkazu, ze kterého pak webová služba vygeneruje QR kód a postará se o správné formátování. Metoda webové služby GenerateCBA_QR_ToImage sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GenerateCBA_QR_ToImage xmlns=" <Flags>string</Flags> <Data> <account_num>string</account_num> <recipient_msg>string</recipient_msg> <recipient_name>string</recipient_name> <amount>string</amount> <currency>string</currency> <date>string</date> <alternate_account_num>string</alternate_account_num> <reference>string</reference> <sender_name>string</sender_name> <payment_type>string</payment_type> <notification_type>string</notification_type> <notification_data>string</notification_data> <crc_32>string</crc_32> <X_Repeat_Period>string</X_Repeat_Period> <X_Var_Symbol>string</X_Var_Symbol> <X_Specific_Symbol>string</X_Specific_Symbol> <X_Constant_Symbol>string</X_Constant_Symbol> <X_Payment_ID>string</X_Payment_ID> <X_URL>string</X_URL> </Data> </GenerateCBA_QR_ToImage> <Flags> Dodatečná nastavení, nepovinný parametr. V případě QR kódu moţno nastavit kódování ("numeric","alphanumeric","byte" nebo "binary","kanji") a chybovou korekci ("l","m","q","h"). Parametry se oddělují ";", formátují se ve tvaru "encoding=[hodnota]" a "correction=[hodnota]. 96

97 <Data> Struct Struktura reprezentující údaje pro elektronickou platbu přes QR kód. account_num je povinný parametr Název account_num recipient_msg recipient_name amount currency date alternate_account_num reference sender_name payment_type notification_type notification_data crc_32 X_Repeat_Period X_Var_Symbol X_Specific_Symbol X_Constant_Symbol X_Payment_ID X_URL číslo účtu správa pro příjemce jméno příjemce částka na zaplacení měna platby datum splatnosti alternativní číslo účtu referenční číslo jméno plátce typ platby typ notifikace (E= , P=Phone) data notifikace CRC32 součet datum opakování platby variabilní symbol specifický symbol konstantní symbol ID platby URL k platbě Odpověď HTTP/ OK <GenerateCBA_QR_ToImageResponse xmlns=" <GenerateCBA_QR_ToImageResult>int</GenerateCBA_QR_ToImageResult> <OutputImage>base64Binary</OutputImage> <ErrorMessage>string</ErrorMessage> </GenerateCBA_QR_ToImageResponse> 97

98 <GenerateCBA_QR_ToImageResult> Int Číselná reprezentace výsledku metody GenerateCBA_QR_ToImage. 0 = v pořádku <OutputImage> Base64Binary Data výstupního obrázku ve formátu.png v kódování Base64Binary. <ErrorMessage> Kdyţ nastane chyba při generování, obsahuje podrobnější údaje o chybě. 98

99 Metoda webové služby GenerateCBA_QR_ToPDF sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GenerateCBA_QR_ToPDF xmlns=" <InputPDF>base64Binary</InputPDF> <Page>int</Page> <coords> <bottom_left_x>int</bottom_left_x> <top_right_x>int</top_right_x> <bottom_left_y>int</bottom_left_y> <top_right_y>int</top_right_y> </coords> <Flags>string</Flags> <Data> <account_num>string</account_num> <recipient_msg>string</recipient_msg> <recipient_name>string</recipient_name> <amount>string</amount> <currency>string</currency> <date>string</date> <alternate_account_num>string</alternate_account_num> <reference>string</reference> <sender_name>string</sender_name> <payment_type>string</payment_type> <notification_type>string</notification_type> <notification_data>string</notification_data> <crc_32>string</crc_32> <X_Repeat_Period>string</X_Repeat_Period> <X_Var_Symbol>string</X_Var_Symbol> <X_Specific_Symbol>string</X_Specific_Symbol> <X_Constant_Symbol>string</X_Constant_Symbol> <X_Payment_ID>string</X_Payment_ID> <X_URL>string</X_URL> </Data> </GenerateCBA_QR_ToPDF> <InputPDF> Base64Binary Data vstupního PDF souboru v kódování Base64Binary. <Page> Int Číslo stránky na kterou se má vloţit QR kód. 99

100 <Coords> Pole obsahující souřadnice na které se má vykreslit QR kód. Souřadnice jsou ve tvaru levého Int[] spodního a pravého vrchního rohu čtverce, do kterého se má vygenerovat QR kód. <Flags> Dodatečná nastavení, nepovinný parametr. Moţno nastavit ignorování minimální velikosti QR kódu (ignoresize), kódování ("numeric","alphanumeric","byte" nebo "binary","kanji") a chybovou korekci ("l","m","q","h"). Parametry se oddělují ";", formátují se ve tvaru "encoding=[hodnota]" a "correction=[hodnota]. <Data> Struct Struktura reprezentující údaje pro elektronickou platbu přes QR kód. account_num je povinný parametr Název account_num recipient_msg recipient_name amount currency date alternate_account_num reference sender_name payment_type notification_type notification_data crc_32 X_Repeat_Period X_Var_Symbol X_Specific_Symbol X_Constant_Symbol X_Payment_ID X_URL číslo účtu správa pro příjemce jméno příjemce částka na zaplacení měna platby datum splatnosti alternativní číslo účtu referenční číslo jméno plátce typ platby typ notifikace (E= , P=Phone) data notifikace CRC32 součet datum opakování platby variabilní symbol specifický symbol konstantní symbol ID platby URL k platbě 100

101 Odpověď HTTP/ OK <GenerateCBA_QR_ToPDFResponse xmlns=" <GenerateCBA_QR_ToPDFResult>int</GenerateCBA_QR_ToPDFResult> <OutputPDF>base64Binary</OutputPDF> <ErrorMessage>string</ErrorMessage> </GenerateCBA_QR_ToPDFResponse> <GenerateCBA_QR_ToPDFResult> Int Číselná reprezentace výsledku metody GenerateCBA_QR_ToPDF. 0 = v pořádku <OutputPDF> Base64Binary Data výstupního pdf souboru v kódování Base64Binary. <ErrorMessage> Kdyţ nastane chyba při generování, obsahuje podrobnější údaje o chybě. 101

102 Přidání přílohy k PDF souboru Webová služba umožňuje přidat ke vstupnímu PDF souboru jakoukoliv přílohu. Musí se specifikovat formát přílohy, její jméno a typ. Metoda webové služby AddAttachment sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <AddAttachment xmlns=" <InputFileData>base64Binary</InputFileData> <AttachmentFileName>string</AttachmentFileName> <AttachmentData>base64Binary</AttachmentData> <AttachmentType>Attachment or Source or Data or Alternative or Supplement or Unspecified</AttachmentType> </AddAttachment> <InputFileData> Base64Binary Libovolný dokument ve formátu PDF v kódování Base64Binary <AttachmentFileName> Název souboru, který chcete přidat jako přílohu <AttachmentData> Base64Binary Libovolný dokument v kódování Base64Binary, který chcete přidat jako přílohu <AttachmentType> Definuje jaký typ přílohy přikládáte k souboru. Moţné hodnoty: enum Attachment; Source; Data; Alternative; Supplement; Unspecified 102

103 Odpověď HTTP/ OK <AddAttachmentResponse xmlns=" <AddAttachmentResult>boolean</AddAttachmentResult> <OutputFileData>base64Binary</OutputFileData> <ErrorMessage>string</ErrorMessage> </AddAttachmentResponse> <AddAttachmentResult> Boolean Výsledek metody AddAttachment. True pokud se operace povedla, jinak False <OutputFileData> Base64Binary Base64Binary tvar výstupního souboru s přílohou <ErrorMessage> string Zobrazí chybovou zprávu v případě neúspěchu přidání přílohy 103

104 Komprese PDF souboru Metoda pro kompresi PDF souboru. Komprimují se jak data v rámci PDF dokumentu, tak i vložené obrázky a jejich formát a rozlišení. Metoda webové služby CompressPDF sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <CompressPDF xmlns=" <Input>base64Binary</Input> <Level>int</Level> <OpenPassword>string</OpenPassword> <ModifySigned>boolean</ModifySigned> </CompressPDF> <Input> Base64Binary Libovolný dokument ve formátu PDF v kódování Base64Binary <Level> int Úroveň komprese, hodnoty 1-3 (hodně, středně, málo) <OpenPassword> string Heslo pro otevření zaheslovaného dokumentu <ModifySigned> boolean Zda se má komprimovat i PDF, které je podepsané. Tento parametr zruší podpisy v dokumentu. 104

105 Odpověď HTTP/ OK <CompressPDFResponse xmlns=" <CompressPDFResult>int</CompressPDFResult> <Output>base64Binary</Output> <Report>string</Report> <ErrorMessage>string</ErrorMessage> </CompressPDFResponse> <CompressPDFResult> int Číselná reprezentace výsledku metody CompressPDF. 0 = v pořádku <Output> Base64Binary Výstupní PDF soubor v kódování Base64Binary <Report> string XML report - šablona reportu je v instalačním adresáři v souboru Report.xml. Při převodu se do šablony doplní zvolené údaje, např. jméno dokumentu, čas převodu, výsledek převodu, hash vstupního a výstupního souboru, informace o podpisech převáděného PDF souboru atd. <ErrorMessage> string Zobrazí chybovou zprávu v případě neúspěchu komprese PDF souboru 105

106 Zjištění aktuální verze Webová sluţba umoţňuje zjistit verzi aktuálně nainstalované webové sluţby a ověření platnosti licenčního certifikátu. Metoda webové služby GetVersionInfo sluţby včetně WSDL schématu a příklad poţadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na SOAP 1.1 Požadavek POST /ltd/ltd.asmx HTTP/1.1 Host: ws.longtermdocs.eu SOAPAction: " <GetVersionInfo xmlns=" /> Odpověď HTTP/ OK <GetVersionInfoResponse xmlns=" <GetVersionInfoResult>string</GetVersionInfoResult> </GetVersionInfoResponse> <GetVersionInfoResult> Výsledek metody obsahující číslo verze a výsledek kontroly licence 106

107 Testovací metody služby Označeny prefixem test. Slouţí pro administrátora při instalaci a ověřování funkčnosti sluţby. Jejich výhoda spočívá v tom, ţe nemají ţádné vstupní parametry, které by bylo nutné nastavovat a vracejí prostý řetězec. Pokud je sluţba spuštěna v internetovém prohlíţeči na počítači, kde je sluţba nainstalována zpřístupní se tlačítko Vyvolat. Tím je generována odpovídající metoda testovací sluţby a zároveň dojde k zobrazení odpovědi. Vyvolání dotazu z webového prohlíţeče: Odpověď ve webovém prohlíţeči 107