Generování čárových kódů do obrázku nebo PDF souboru

Generování čárových kódů do obrázku

Webová služba GenerateBarcodeToImage 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ů. Vstupními 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.

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

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

<?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>
    <GenerateBarcodeToImage xmlns="http://software602.com/longtermdocs/">
      <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>
  </soap:Body>
</soap:Envelope>

<Type>
[povinný element]

Vstup Popis

enum

Požadovaný typ čárového kódu ve tvaru Barcode_[typ kódu].

<Flags>
[nepovinný element]

Vstup Popis

String

Dodatečná nastavení. 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í ";" a formátují se ve tvaru "encoding=[hodnota]" a "correction=[hodnota].

<Data>
[povinný element]

Vstup Popis

String

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 anglické abecedy.

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>
    <GenerateBarcodeToImageResponse xmlns="http://software602.com/longtermdocs/">
      <GenerateBarcodeToImageResult>int</GenerateBarcodeToImageResult>
      <OutputImage>base64Binary</OutputImage>
      <ErrorMessage>string</ErrorMessage>
    </GenerateBarcodeToImageResponse>
  </soap:Body>
</soap:Envelope>

<GenerateBarcodeToImageResult>

Návratová hodnota Popis

Int

Číselná reprezentace výsledku metody. 0 = v pořádku.

Jinak viz kapitola Návratové kódy.

<OutputImage>

Návratová hodnota Popis

Base64Binary

Base64Binary Data výstupního obrázku ve formátu PNG.

<ErrorMessage>

Návratová hodnota Popis

String

Když nastane chyba při generování, obsahuje podrobnější údaje o chybě.

Generování čárových kódů do PDF souboru

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

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

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

<?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>
    <GenerateBarcodeToPDF xmlns="http://software602.com/longtermdocs/">
      <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>
  </soap:Body>
</soap:Envelope>

<InputPDF>
[povinný element]

Vstup Popis

Base64Binary

Data vstupního PDF souboru v kódování Base64Binary.

<Placement>
[povinný element]

Vstup Popis

struct

Struktura BarcodePlacement obsahující údaje o umístění čárového kódu:

  • Type – typ čárového kódu.

  • Page – číslo stránky "Page".

  • X – souřadnice "X" (z levého spodního rohu v 72DPI).

  • Y – souřadnice "Y" (z levého spodního rohu v 72DPI).

  • Width – šířka čárového kódu.

  • Height – výška čárového kódu.

  • Data – data čárového kódu.

V rámci jednoho volání je možno definovat více kódů.

<Flags>
[nepovinný element]

Vstup Popis

String

Dodatečná nastavení. 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/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>
    <GenerateBarcodeToPDFResponse xmlns="http://software602.com/longtermdocs/">
      <GenerateBarcodeToPDFResult>int</GenerateBarcodeToPDFResult>
      <OutputPDF>base64Binary</OutputPDF>
      <ErrorMessage>string</ErrorMessage>
    </GenerateBarcodeToPDFResponse>
  </soap:Body>
</soap:Envelope>

<GenerateBarcodeToPDFResult>

Návratová hodnota Popis

Int

Číselná reprezentace výsledku metody GenerateBarcodeToPDF. 0 = v pořádku.

Jinak viz kapitola Návratové kódy.

<OutputPDF>

Návratová hodnota Popis

Base64Binary

Data výstupního PDF souboru v kódování Base64Binary.

<ErrorMessage>

Návratová hodnota Popis

String

Když nastane chyba při generování, obsahuje podrobnější údaje o chybě.