This service submits an existing report spec. The report spec is identified by its UID, which is a 64 bit integer. The UID is obtained by right clicking on a project and choosing Advanced | Show report spec UID.
The report spec must belong to the user or the error code CouldNotFindReportSpec will be returned. Public reports are not supported, they must belong to the person running the report.
When the report is submitted, the report output's UID and URL are returned. The UID can be used to determine the status of the report, using the GetReportStatus web service. Once the report successfully completes, the URL can be used to get the report output in one of two ways:
- HTTP GET: In this case the requestor will be asked to log in to Projector (if not already logged in) before given access to the file.
- HTTP POST: In this case the requestor can supply authentication data in the body of the request (they are encrypted by SSL), as shown below.
- <EmailAddress>fred@revcorp.biz</ EmailAddress >
- <Password>someStr0ngP@&&w0zz</Password>
- <AccountName>revcorp</AccountName> (account name is optional if the email address is unique)
Request
The service request contains:
Name |
Data Type |
Required? |
Default Value |
Discussion |
|---|---|---|---|---|
ReportSpecUid |
long |
yes |
|
64 bit integer that uniquely identifies the report spec |
Response
If the report spec exists and belongs to the user, then the following data is returned:
Name |
Data Type |
Discussion |
|---|---|---|
ReportOutputUid |
long |
Uniquely identifies the report output. |
ReportOutputFileUrl |
string(255) |
The URL of the report output file. |