Using the XML Response

In some cases, an XML response is created after running the script. An example of this is when you pass BTXML Script to BarTender using ActiveX Automation. An XML response will provide you with valuable information about the print job, the printer used to complete the job, BarTender's settings during the print job, and complete details about the printed items. This response can be integrated with a custom application. An XML response is returned when BTXML script is run using the following methods:

The default response containing information about the user who sent the BTXML request, the printer used to process the request, the status of the print job and any messages that were created is returned. The following example displays the response returned when no attributes are used or when the ReturnPrintData attribute is set to true and the ReturnSummary and ReturnLabelData attributes are set to false:

<?xml version="1.0" encoding="utf-16"?>

<User>Administrator</User>

<Server>MyServer</Server>

<Description>Finished sending print job to printer.</Description>

</JobStatus>

<Text>BarTender successfully sent the print job to the spooler.

Job Name: MyJobName

BarTender Document: Document1.btw

Printer: Datamax H-4212 7.1.4 </Text>

</Message>

</Print>

</Command>

</Response>

You can set the response to include additional information by setting the attributes associated with the following commands:

The following sections introduce these attributes, and how they affect the response.

Returning Print Data in the Response

The ReturnPrintData attribute displays the summary data and the template information depending upon how the ReturnSummaryData and ReturnLabelData attributes are set. When you set the Print Command's ReturnPrintData attribute to true and do not include any other attribute, the response includes the print job details, a summary of the print job and the individual item information. Setting either the ReturnSummaryData or ReturnLabelData attributes to false will remove their information from the response.

Click Response to view an example of the response returned when the ReturnPrintData attribute is set to true and no other attributes are set or when the ReturnSummary, ReturnLabelData and ReturnChecksum attributes are included and also set to true.

Returning Summary Data in the Response

Setting the ReturnSummary attribute of the <Print> Command to true, or not including the attribute at all, returns a response that includes the ReturnPrintData attribute information and a summary of the entire print job. The summary information includes document and printer information, general page and layout information, and how BarTender was configured when it processed the print job. Refer to the <Summary> tag for a detailed description of the various tags. Setting the ReturnSummary attribute of the <Print> Command to false returns a response that does not include a detailed summary of the print job.

Click ReturnSummary to view an example that displays the response returned when the ReturnSummary attribute is set to true and the ReturnLabelData attribute is set to false.

Returning Template Data in the Response

Setting the ReturnLabelData attribute to true or not including the attribute at all, returns a response that includes the print job information described in the ReturnPrintData attribute and a detailed definition that includes page, template, object and data source information, and can be used to validate and reprint the print job. Refer to the <Pages> tag for a detailed description of the various tags. Setting the ReturnLabelData attribute of the <Print> Command to false returns a response that does not include any template data.

Click ReturnLabelData to view an example that displays the response returned when the ReturnLabelData attribute is set to true, but the ReturnSummary attribute is set to false.

Returning Checksum Data in the Response

To return checksum data in the response you must set the ReturnChecksum attribute to true. When set, the checksum attribute returns checksums that represent various parts of the print job and objects included on the document being printed.

History Explorer and Reprint Console will use these checksum values to verify the content of the documents being reprinted by comparing the checksums of the new document with the old one. If the checksum values match, you can be sure that the document you will print exactly matches the old one. If the checksum values do not match, you will know that the new document has changed in some way. With that knowledge you may choose to print the document with the difference, or you may choose to correct the difference so that the items match again before printing. Refer to the <FormatChecksum> tag for a detailed description of the returned checksum values.

Click ReturnChecksum to view an example that displays the response returned when the ReturnChecksum attribute is set to true.

Returning an Exported Template in a Response

The ReturnImageInReponse attribute of the <ExportPrintPreviewToImage> Command returns a response that contains an image of the exported template as a string in Base 64 format.