Understanding the Web Services › The Report Data Web Service › Data Returned by the Report Data Web Service › Returning AFP or Binary Reports

Returning AFP or Binary Reports

If the report is AFP, or binary, it can be returned in the following formats:

• If the returnas value is "Attachment" a file with the entire AFP, or binary report is returned to the client application. The client application must be coded to accept an attachment.
• If the returnas value is "Vector" there is an entry in the vector for each binary line of the report. (These lines have no correspondence to the printed or viewable report.) Each vector entry contains a single entry string array. The single entry holds a displayable representation of the binary data. The client program converts the data to its binary format and then written to a file. For example, a data line of "5a0008d3a8cd000001" is a character string representing the hex string 0x5a0008d3a8cd000001. The Data lines that are returned are of varying length.
• If the returnas value is "StringArray", a string array entry for each binary line of the report is returned. These lines have no correspondence to the printed or viewable report. Each string array entry contains a single entry string array. This second string array entry contains a displayable representation of the binary data. The client program converts the data back to its binary format and then written to a file. For example, a data line of "5a0008d3a8cd000001" is a character string representing the hex string 0x5a0008d3a8cd000001. Returned data lines vary in length.
• If the returnas value is "XMLString", then an XML-formatted string is returned. A <binaryline> tag represents each binary line of the report. Within the <binaryline></binaryline> tag is the <reportdataline> tag.

  The <reportdataline> tag is a displayable representation of the binary data line. The client program converts the data back to its binary format and then written to a file. For example, a data line of "5a0008d3a8cd000001" is a character string representing the hex string 0x5a0008d3a8cd000001. Returned data lines vary in length.

• If the returnas value is "XMLAttachment", it contains a file with the same data as returned by "XMLString".