Přidání přílohy k PDF souboru

Webová služba AddAttachment umožňuje přidat ke vstupnímu PDF souboru jakoukoliv přílohu. Musí se specifikovat formát přílohy, její jméno a typ.

Popis služby AddAttachment 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=AddAttachment.

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

<?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>
    <AddAttachment xmlns="http://software602.com/longtermdocs/">
      <InputFileData>base64Binary</InputFileData>
      <AttachmentFileName>string</AttachmentFileName>
      <AttachmentData>base64Binary</AttachmentData>
      <AttachmentType>Attachment or Source or Data or Alternative or Supplement or Unspecified</AttachmentType>
    </AddAttachment>
  </soap:Body>
</soap:Envelope>

<InputFileData>
[povinný element]

Vstup Popis

Base64Binary

Libovolný dokument ve formátu PDF v kódování Base64Binary.

<AttachmentFileName>
[povinný element]

Vstup Popis

String

Název souboru, který chcete přidat jako přílohu.

<AttachmentData>
[povinný element]

Vstup Popis

Base64Binary

Libovolný dokument v kódování Base64Binary, který chcete přidat jako přílohu.

<AttachmentType>
[povinný element]

Vstup Popis

enum

Definuje, jaký typ přílohy přikládáte k výstupnímu souboru. Možné hodnoty:

  • Attachment

  • Source – se použije, pokud je tato specifikace souboru původním zdrojovým materiálem pro související obsah.

  • Data – se použijí, pokud tato specifikace souboru představuje informaci použitou k odvození vizuální prezentace, jako je tabulka nebo graf.

  • Alternative – se použije, pokud je tato specifikace souboru alternativní reprezentací obsahu, například zvuku.

  • Supplement – se použije, pokud tato specifikace souboru představuje doplňkovou reprezentaci původního zdroje nebo dat, která mohou být snadněji zkonzumovatelná (např. verze rovnice MathML). Supplement se má použít pouze v případě, že soubor není zdrojem nebo alternativou.

  • Unspecified – se použije, když vztah není znám nebo jej nelze popsat pomocí jedné z jiných hodnot. Unspecified se má použít pouze tehdy, když žádná jiná hodnota správně neodráží vztah.

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>
    <AddAttachmentResponse xmlns="http://software602.com/longtermdocs/">
      <AddAttachmentResult>boolean</AddAttachmentResult>
      <OutputFileData>base64Binary</OutputFileData>
      <ErrorMessage>string</ErrorMessage>
    </AddAttachmentResponse>
  </soap:Body>
</soap:Envelope>

<AddAttachmentResult>

Návratová hodnota Popis

Boolean

Výsledek metody AddAttachment. Pokud se operace povedla vrací True, jinak False.

<OutputFileData>

Návratová hodnota Popis

Base64Binary

Base64Binary Data výstupního souboru s vloženou přílohou.

<ErrorMessage>

Návratová hodnota Popis

string

Zobrazí chybovou zprávu v případě neúspěchu přidání přílohy.