Zaručený převod datového formátu a konverze dle §69a

Webová služba ConvertWithClause umožňuje každému tzv. určenému původci (veřejná správa, komerce s přenesenou působností, školská zařízení, …) provést převod dokumentu z analogové podoby do elektronické a naopak (Zaručená konverze), a provést převod dokumentu z elektronické podoby opět do elektronické podoby, například když DOCX převádíme do PDF/A (Zaručený převod datového formátu):

Zaručená konverze dle § 69a zákona č. 499/2004 Sb. o archivnictví a spisové službě:

Výstup má právní účinky ověřené kopie a ověřovací doložku připojuje aplikace provádějící zaručenou konverzi (typicky spisová služba). Analogový vstup musí organizace uchovávat po celou dobu životnosti dokumentu.

Zaručený převod datového formátu dle § 69a zákona č. 499/2004 Sb. o archivnictví a spisové službě

Výstup má právní účinky ověřené kopie a ověřovací doložku připojuje aplikace provádějící zaručenou konverzi (typicky spisová služba). Původní elektronický dokument (vstup) musí organizace uchovávat po celou dobu životnosti dokumentu.

V rámci této metody je tedy umožněna:

  • Zaručená konverze L→E.

  • Zaručená konverze E→L.

  • Zaručený převod datového formátu E→E.

Popis služby ConvertWithClause 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 http://localhost/ltd/ltd.asmx?op=ConvertWithClause.

Parametr "localhost" je název používaný pro lokální počítač; namísto něj zapište jméno/IP adresu LTD serveru (dle nastavení v IIS).

Požadavek

POST /ltd/ltd.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://software602.com/longtermdocs/ConvertWithClause"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertWithClause xmlns="http://software602.com/longtermdocs/">
      <Input>base64Binary</Input>
      <FileName>string</FileName>
      <Options>
        <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>
        <ConversionType>int</ConversionType>
        <Language>string</Language>
        <OrganizationName>string</OrganizationName>
        <PersonalName>string</PersonalName>
        <CreationDate>string</CreationDate>
        <NonConvertableItems>string</NonConvertableItems>
        <CustomInfo>
          <Property>
            <Name>string</Name>
            <Value>string</Value>
          </Property>
          <Property>
            <Name>string</Name>
            <Value>string</Value>
          </Property>
        </CustomInfo>
        <DontConvertOutputFormats>string</DontConvertOutputFormats>
        <ValidationService>int</ValidationService>
        <CustomValidationResult>
          <ServiceName>string</ServiceName>
          <ValidationStatus>string</ValidationStatus>
          <ValidationDetail>string</ValidationDetail>
        </CustomValidationResult>
        <AddSignature>boolean</AddSignature>
        <Signature>
          <CertificateID>string</CertificateID>
          <PrivateKeyPIN>string</PrivateKeyPIN>
          <AddTimeStamp>boolean</AddTimeStamp>
          <CreateEmpty>boolean</CreateEmpty>
          <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>
      </Options>
    </ConvertWithClause>
  </soap:Body>
</soap:Envelope>

<Input>
[povinný element]

Vstup Popis

Base64Binary

Libovolný dokument (v podporovaném formátu) v kódování Base64Binary, určený ke konverzi do zvoleného PdfFormat.

Podporované formáty: PDF, FO, ZFO, DOC, DOCX, RTF, XLS, XLSX, PPT, PPTX, EML, MSG, HTML.

<FileName>
[povinný element]

Vstup Popis

String

Jméno vstupního souboru včetně přípony.

<Options> – Konfigurační struktura konverze
[povinný element]

<PdfFormat>
[nepovinný element]

Vstup Popis

enum

Definuje požadovanou úroveň souladu výstupního souboru s PDF či PDF/A normou. Hodnoty:

  • PDF – generované PDF je v souladu s definicí dle ISO 32000-1:2008 (PDF Reference 1.7),

  • PDF/A-1b – PDF dokument v úrovni souladu 1b dle ISO 19005-1:2005,

  • PDF/A-1a – PDF dokument v úrovni souladu 1a dle ISO 19005-1:2005,

  • PDF/A-2b – PDF dokument v úrovni souladu 2b dle ISO 19005-2:2011,

  • PDF/A-2a – PDF dokument v úrovni souladu 2a dle ISO 19005-2:2011,

  • PDF/A-2u – PDF dokument v úrovni souladu 2u dle ISO 19005-2:2011,

  • PDF/A-3b – PDF dokument v úrovni souladu 3b dle ISO 19005-3:2012,

  • PDF/A-3a – PDF dokument v úrovni souladu 3a dle ISO 19005-3:2012,

  • PDF/A-3u – PDF dokument v úrovni souladu 3u dle ISO 19005-3:2012,

  • PDF/X-1 - PDF dokument v úrovni souladu X-1 dle ISO 15930-4:2003,

  • PDF/X-3 - PDF dokument v úrovni souladu X-3 dle ISO 15930-6:2003,

  • PDF/X-4 - PDF dokument v úrovni souladu X-4 dle ISO 15930-7:2008,

  • PDF/X-5 - PDF dokument v úrovni souladu X-5 dle ISO 15930-8:2008.

<ConversionType>
[nepovinný element]

Vstup Popis

int

Typ prováděné konverze. Možné hodnoty:

  • 0 – z listinné do elektronické.

  • 1 – z elektronické do listinné.

  • 2 – z elektronické do elektronické (změna datového formátu).

Výchozí hodnota: 0

<Language>
[nepovinný element]

Vstup Popis

string

Jazyk konverzní doložky.

Výchozí hodnota: cs-CZ.

<OrganizationName>
[nepovinný element]

Vstup Popis

string

Jméno organizace podepisujícího uvedené v doložce.

<PersonalName>
[nepovinný element]

Vstup Popis

string

Jméno podepisujícího uvedené v doložce a u pole pro podpis.

<CreationDate>
[nepovinný element]

Vstup Popis

String

Zobrazí se nad datem konverze v poli "Datum sepsání listinného dokumentu:". Platí pouze pro L-E konverzi. Pokud není uvedeno, řádek v tabulce není.

<NonConvertableItems>
[nepovinný element]

Vstup Popis

String

Libovolný popis viditelných znaků. Pokud je prázdné, uvede se „Bez viditelných znaků“

<CustomInfo> – pole s vlastními informacemi pro vložení do ověřovací doložky

<Property>

<Name>
[nepovinný element]

Vstup Popis

string

Název vlastnosti. Pokud nebude definováno, vypadá doložka standardně, jinak přibudou řádky s dodanými popisy a hodnotami.

<Value>
[nepovinný element]

Vstup Popis

string

Hodnota vlastnosti. Pokud nebude definováno, vypadá doložka standardně, jinak přibudou řádky s dodanými popisy a hodnotami.

</CustomInfo>

<DontConvertOutputFormats>
[nepovinný element]

Vstup Popis

string

Lze definovat vlastní seznam formátů (přípon nebo PUID) ve string formě, které se nemají konvertovat. Pokud není nastaveno, použije se pro konverzi výchozí nastavení EEOutputFormats z InstallDir\Engine\Engine.config.

<ValidationService>
[nepovinný element]

Vstup Popis

int

Ověřovací služba pro získání doložky. Hodnoty:

  • 0 – SecuSign.

  • 1 – Custom (volající si ověřil podpisy sám, hodnoty do doložky nastaví v CustomValidationResult).

Výchozí hodnota: 0.

<CustomValidationResult>
[nepovinný element]

Struktura s názvem validační služby a výsledky ověření, které se doplní do doložky.

<ServiceName>
[nepovinný element]

Vstup Popis

string

Název použité vlastní (Custom) ověřovací služby.

<ValidationStatus>
[nepovinný element]

Vstup Popis

string

Výsledek ověření z vlastní (Custom) ověřovací služby.

Může být HTML fragment (vnitřek HTML BODY, styly musí být definovány inline, pomocí atributu STYLE), který se konvertuje do PDF.

<ValidationDetail>
[nepovinný element]

Vstup Popis

string

Podrobnosti ověření z vlastní (Custom) ověřovací služby.

<AddSignature>
[nepovinný element]

Vstup Popis

Boolean

Logická hodnota určuje, zda má být dokument podepsán. Certifikát podpisu se specifikuje v elementu Signature. Výchozí hodnota: false.

<Signature>
[nepovinný element]

Identifikace podpisového/pečetícího certifikátu a vlastností podpisu/pečeti. Struktura je stejná jako u ConvertFileEx Options.

</Options>

Odpověď

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertWithClauseResponse xmlns="http://software602.com/longtermdocs/">
      <ConvertWithClauseResult>int</ConvertWithClauseResult>
      <Output>base64Binary</Output>
      <ErrorMessage>string</ErrorMessage>
    </ConvertWithClauseResponse>
  </soap:Body>
</soap:Envelope>

<ConvertWithClauseResult>

Návratová hodnota Popis

Int

Výsledek metody ConvertWithClauseResult. 0 = v pořádku. Jinak viz kapitola Návratové kódy.

<Output>

Návratová hodnota Popis

Base64Binary

V případě úspěchu konverze Base64Binary tvar konvertovaného dokumentu v odpovídajícím formátu PDF/A a zvolené úrovni souladu.

<ErrorMessage>

Návratová hodnota Popis

String

Textový popis chyby při problému s konverzí do zvoleného PDF/A formátu.