Reports - Output Types and Formatting
Every report adheres to a strict standard to ensure accuracy and consistency in data delivery. Despite variations in content, the integrity of the data remains a top priority. This commitment to excellence guarantees the reliability of the information presented. The standardized formatting acts as a reliable guide through the data, making it easier to navigate. As you explore the reporting pages, you will uncover the distinctive parameters for those reports.
Endpoints
All Reports use the same endpoint to access.
Url | Type |
---|---|
/ActiveReports/GetReport.aspx | CGI |
Output Parameters
In a Direct type of response, the output parameters will only be encoded as HTTP Headers. In other response types the output parameters will be returned in the message and as HTTP Headers.
Name | Description | Example |
---|---|---|
Message | A simple message to describe the result of the request. It can also be an error message. | “Success” |
Method | The Action you are requesting. | “Token”, “ReportList”, “Report” |
Severity | A value between 0 and 9. Zero being a success and 9 being a sever error. | 0 |
Success | A True/False value indicating the success of the call. | True |
Version | The version of the API call. Generally if you request a version, we will honor the version you requested in the response. | 1.4.2.24 |
Token | The security token related to your credentials, expiration, and configuration. This is a Base64 Encoded string. It is variable length and depending on the information included it can be very long. | qXDzhFGifK04IRbBFROx5Rx84 |
Output Types and Format
Report Formats
Binary | String |
---|---|
Word | HTML |
Excel | CSV (With and Without Columns) |
Text (space delimited) | |
| XML |
| JSON |
Return Types
Enumeration | Description |
---|---|
XML | Envelope is XML, internal report data is in a CData section in XML format |
XML_HTML | Envelope is XML, internal report data is in a CData section in HTML format |
XML_CSV | Envelope is XML, internal report data is in a CData section in CSV format |
XML_CSVWithColumns | Envelope is XML, internal report data is in a CData section in CSV format with column headers included |
XML_Text | Envelope is XML, internal report data is in a CData section in space delimited format |
XML_Word | Envelope is in XML, internal report data is in a CData section in Microsoft |
XML_Excel | Envelope is in XML, internal report data is in a CData section in Microsoft |
XML_PDF | Envelope is in XML, internal report data is in a CData section in Microsoft |
JSON | Envelope is JSON, internal report data is in the ReportData value section in |
JSON_HTML | Envelope is JSON, internal report data is in the ReportData value section in |
JSON_CSV | Envelope is JSON, internal report data is in the ReportData value section in |
JSON_CSVWithColumns | Envelope is JSON, internal report data is in the ReportData value section in |
JSON_Text | Envelope is JSON, internal report data is in the ReportData value section in |
JSON_Word | Envelope is JSON, internal report data is in the ReportData value section in |
JSON_Excel | Envelope is JSON, internal report data is in the ReportData value section in |
JSON_PDF | Envelope is JSON, internal report data is in the ReportData value section in |
DirectHTML | No envelope and HTML is returned as a stream |
DirectXML | No envelope and XML is returned as a stream |
DirectJSON | No envelope and JSON is returned as a stream |
DirectText | No envelope and space deliminted text is returned as a stream |
DirectCSV | No envelope and CSV is returned as a stream |
DirectCSV | No envelope and CSV with headers is returned as a stream |
DirectWord | No envelope and Word is returned as a stream |
DirectExcel | No envelope and Excel is returned as a stream |
DirectPDF | No envelope and PDF is returned as a stream |
Examples
Responses
Xml
The outer envelope is XML and the report data element will contain the actual report data and will be in string or
binary format (Base 64 encoded)
<Response Method="Report" Version="1.4.2.24" Severity="0" Success="True"> <Message></Message> <ReportData></ReportData> </Response>
JSON
{ "Method": "Report", "Version": "1.4.2.24", "Severity": "0", "Success": "True", "Message": "Success", "ReportData": "" }