XML Export

The EZ-Scan XML Export will upload images and data to a remote server using an HTTP Post

 

Before using the XML Export for the first time, you will need to configure it. Go to Tools>Options and click on Export in the tree view on left of the options screen.

 

Select EZ-Scan XML Export from the Export Format drop down box and then click the 'Configure' button. You will see the following configuration dialog box.

Export URL

This is the URL of the page that will process the uploaded image.

 

Username and Password

This  is the username and password that will be sent in the XML data to the processing web page.

Processing Web Page

The page specified in the export URL property will have to process the uploaded image and associated data. The image and data will be sent in the following format:

 

XML Export Format

<?xml version="1.0" encoding="UTF-8"?>

<PostScannedCheck>

<UserName>username</UserName>

<Password>password</Password>

<ImageFrontEncoding>tiff</ImageFrontEncoding>

<ImageFrontData> [Base 64 image data for front image] </ImageFrontData>

<ImageBackEncoding>tiff</ImageBackEncoding>

<ImageBackData> [Base 64 image data for back image] </ImageBackData>

<MICROCR>t063108680t1140 12345678o     a0000005000a</MICROCR>

<ItemNo>1</ItemNo>

<Route>063108680</Route>

<Account>12345678</Account>

<CheckNo>0000000000001140</CheckNo>

<TranCode></TranCode>

<Amount>50</Amount>

<IDCompany>PST</IDCompany>

<DateProcess>5/5/2006</DateProcess>

<IDBatch>Test</IDBatch>

</PostScannedCheck>

XML response

The page processing the data will have to save the data to a database and save the image locally. If the upload is successful it should suppy the following text in its response. The XML export will check the response to verify a successful upload.

 

Successful response = <?xml version="1.0" encoding="UTF-8"?></ProcessScannedCheckSuccess>

 

Any other response will be displayed to the user for error reporting.

The following tags will be checked and displayed  in the case of an error

<Code></Code>

<Description></Description>

 

If neither a successful response nor the error tags are found, then the entire response will be displayed to the user.

 

Contact PST if you need help setting up your upload page.

 

Exporting items

The XML export will export the items currently in the grid. You can export when a batch is complete or do a search to retrieve the items for the export.

You will see a confirmation dialog box before the export begins.

 

Verify the url and click 'OK' to start the export.

 

When complete you will get a message like this:

 

 

Export log file

Click 'Yes' to view the log file. The following information will be logged for each successful upload

 

(20060508 16:52:46) Successful Upload to http://www.ez-scan.com/ezwebview/ezwup.asp

Function: clsExpXML.Process

Date Process: 5/5/2006 IDCompany: PST Batch: Test Item: 1

 

Any errors that occur will also be logged.