Working with barcoded forms

Include project files

• Create a Microsoft .NET client assembly that consumes the barcoded forms service WSDL. For information, see Invoking AEM Forms using Base64 encoding.
• Reference the Microsoft .NET client assembly. For information, see “Referencing the .NET client assembly” in Invoking AEM Forms using Base64 encoding.

Create a barcoded forms Client API object

Using the Microsoft .NET client assembly that consumes the barcoded forms service WSDL, create an BarcodedFormsServiceService object by invoking its default constructor.

Get a PDF form that contains barcoded data

• Create a BLOB object by using its constructor. The BLOB object is used to store a PDF document that contains a barcode.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the PDF document and the mode in which to open the file.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method and passing the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its binaryData property with the contents of the byte array.

Decode the data from the PDF form

Decode the form data by invoking the BarcodedFormsServiceService object’s decode method and passing the following values:

• The BLOB object that contains the PDF form.
• A Boolean object that specifies whether to decode a PDF417 barcode.
• A Boolean object that specifies whether to decode a data matrix barcode.
• A Boolean object that specifies whether to decode a QR code barcode.
• A Boolean object that specifies whether to decode a codabar barcode.
• A Boolean object that specifies whether to decode a code 128 barcode.
• A Bolean object that specifies whether to decode a code 39 barcode.
• A Boolean object that specifies whether to decode an EAN-13 barcode.
• A Boolean object that specifies whether to decode an EAN-8 barcode.
• A CharSet enumeration value that specifies the character set encoding value used in the barcode.

The decode method returns a string value that contains decoded form data.

Convert the data to an XML data source

Convert the decoded data into either XDP or XFDF data by invoking the BarcodedFormsServiceService object’s extractToXML method and passing the following values:

• A string value that contains decoded data (ensure that you use the decode method’s return value).
• A Delimiter enumeration value that specifies the line delimiter. It is recommended that you specify Delimiter.Carriage_Return.
• A Delimiter enumeration value that specifies the field delimiter. For example, specify Delimiter.Tab.
• A XMLFormat enumeration value that specifies whether to convert the barcode data into XDP or XFDF XML data. For example, specify XMLFormat.XDP to convert the data to XDP data.

NOTE

Do not specify the same values for the line delimiter and field delimiter parameters.

The extractToXML method returns an Object array where each element is an BLOB instance. There is a separate element for each barcode that is located on the form. That is, if there are four barcodes on the form, then there are four elements in the returned Object array.

Process the decoded data

• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the secured PDF document.
• Create a byte array that stores the data content of the BLOB object that was returned by the encryptPDFUsingPassword method. Populate the byte array by getting the value of the BLOB object’s binaryData data member.
• Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
• Write the contents of the byte array to a PDF file by invoking the System.IO.BinaryWriter object’s Write method and passing the byte array.