Konverze souboru do PDF či PDF/A (Print2PDF)

Webová služba umožňuje provést na serveru konverzi souboru do formátu PDF, či PDF/A podle zvoleného profilu konverze. Je možné nastavit úroveň souladu se specifikací PDF/A, opatření dokumentu elektronickou pečetí, kvalifikovaným časovým razítkem, vodotiskem a další nastavení v rámci každého profilu.

Pro provedení úspěšné konverze 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, popřípadě se musí jednat o nativně podporovaný formát. Více informací o požadavcích na konverzi a možnosti nastavení pro konverzní služby najdete v kapitole Konverzní formáty a jejich konfigurace.

Metoda webové služby ConvertFile je určena hlavně pro zpětnou kompatibilitu s Print2PDF 9. Názvy profilových souborů lze získat metodou GetProfileList.

Popis služby včetně WSDL schématu a příklad požadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je k dispozici na: http://localhost/ltd/ltd.asmx?op=ConvertFile.

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/ConvertFile"

<?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>
    <ConvertFile xmlns="http://software602.com/longtermdocs/">
      <Input>base64Binary</Input>
      <FileName>string</FileName>
      <Profile>string</Profile>
    </ConvertFile>
  </soap:Body>
</soap:Envelope>

<Input>
[povinný element]

Vstup Popis

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>
[povinný element]

Vstup Popis

String

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

<Profile>
[povinný element]

Vstup Popis

String

Celý název konverzního profilu (.ini souboru).

Konverzní profily lze nalézt v instalační složce InstallDir\Profiles. Tvorba a jejich úprava se provádí v serverové aplikaci, případně na žádost.

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>
    <ConvertFileResponse xmlns="http://software602.com/longtermdocs/">
      <ConvertFileResult>int</ConvertFileResult>
      <Output>base64Binary</Output>
      <Report>string</Report>
    </ConvertFileResponse>
  </soap:Body>
</soap:Envelope>

<ConvertFileResult>

Návratová hodnota Popis

Int

Výsledek metody ConvertFile. 0 = v pořádku.

Jinak viz kapitola Návratové kódy.

<Output>

Návratová hodnota Popis

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>

Návratová hodnota Popis

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.