Načtení obsahu čárových kódů v PDF souboru

Webové služby ReadBarcode a ReadBarcodeToString umožňují přečíst obsah čárových kódů typu QR, PDF417, DataMatrix a 1D.

Metoda ReadBarcodeToString 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.

Popis služeb 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=ReadBarcode a http://localhost/ltd/ltd.asmx?op=ReadBarcodeToString.

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

<?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>
    <ReadBarcode xmlns="http://software602.com/longtermdocs/">
      <InputPDF>base64Binary</InputPDF>
      <Pages>
        <int>int</int>
        <int>int</int>
      </Pages>
      <Flags>long</Flags>
      <Additional_Info>string</Additional_Info>
    </ReadBarcode>
  </soap:Body>
</soap:Envelope>

<InputPDF>
[povinný element]

Vstup Popis

Base64Binary

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

<Pages>
[nepovinný element]

Vstup Popis

Int[]

Čísla stránek, na kterých se hledají kódy, indexovány od 1. Pro indexování od konce použijte záporné hodnoty, kde -1 odpovídá poslední stránce. Když není vyplněno, prohledává se celý dokument.

<Flags>
[nepovinný element]

Vstup Popis

Long

Rozšiřující nastavení pro určení hledaného typu čárového kódu.

Možno využít jakékoli kombinace následujících hodnot:

  • 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.

<Additional_Info>
[nepovinný element]

Vstup Popis

String

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

<ReadBarcodeResult>

Návratová hodnota Popis

Int

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

Jinak viz kapitola Návratové kódy.

<BarcodeInfo_result>

<data>

Návratová hodnota Popis

String

Data uložená v čárovém kódu.

<coords>

Návratová hodnota Popis

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.

<user_data>

Návratová hodnota Popis

String

Pomocný logovací text zadaný jako vstup, stejný pro všechny nalezené kódy.

<page>

Návratová hodnota Popis

Int

Číslo stránky, na které byl nalezen čárový kód.

<type>

Návratová hodnota Popis

String

Typ nalezeného čárového kódu.

<checksum>

Návratová hodnota Popis

Boolean

V případě 1D kódu indikuje, zda je kód i s CheckSum součtem.

</BarcodeInfo_result>

<ErrorMessage>

Návratová hodnota Popis

String

Pokud nastane problém, obsahuje popis problému (kde nastal, co nefungovalo).

V odpovědi metody ReadBarcodeToString jsou BarcodeData obsažena v elementu string:

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>
    <ReadBarcodeToStringResponse xmlns="http://software602.com/longtermdocs/">
      <ReadBarcodeToStringResult>int</ReadBarcodeToStringResult>
      <BarcodeData>
        <string>string</string>
        <string>string</string>
      </BarcodeData>
      <ErrorMessage>string</ErrorMessage>
    </ReadBarcodeToStringResponse>
  </soap:Body>

<string>

Návratová hodnota Popis

String

Data uložená v čárovém kódu.