Report instance helps you to get the current page settings of a report, update all the page setting properties, and update a specific page setting property in a report. You can create a client application to send an HTTP request to the service application for using the report services.
To get the current page settings in the report instance with the specified instance id, you need to use GET method. Report full path and instance id of executing report is specified in the request URL, as follows:
GET: http://<host>[:port]/api/report/{folder path}/{report name}$instances/{instance id}/pagesettings
Request URL: https://developer.mescius.com/componentone/demos/aspnet/5/c1webapi/latest/api/report/ReportsRoot/FlexCommonTasks/FlexCommonTasks.flxr/MultiValue DataBound Parameters$instances/9e20a2d1-e371-44c2-87f2-bc65700172eb/pagesettings
Parameters
| Parameter | Description |
|---|---|
| Report Full Path | Specify the full path of the executing report. For example: FlexCommonTasks.flxr/MultiValue DataBound Parameters |
| Instance Id | Specify the instance id of the executing report. |
Response Messages
| HTTP Status Code | Reason |
|---|---|
| 200 | JSON string contains IPageSettings type object. |
| 404 | The report path or instance id does not exist. |
To update all the page settings properties in the report instance with the specified instance id, you need to use PUT method. Report full path and instance id of executing report is specified in the request URL, as follows:
PUT: http://<host>[:port]/api/report/{folder path}/{report name}$instances/{instance id}/pagesettings
Parameters
| Parameter | Description |
|---|---|
| Report Full Path | Specify the full path of the executing report. For example: FlexCommonTasks.flxr/MultiValue DataBound Parameters |
| Instance Id | Specify the instance id of the executing report. |
| Report Page Settings | Set the page settings. Example: paperSize=custom&height=10in&width=20.5cm |
Response Messages
| HTTP Status Code | Reason |
|---|---|
| 200 | JSON string contains IPageSettings type object, which is the new page settings. Use the default value if one property is not set. |
| 404 | The report path or instance id does not exist. |
To update a specific page setting property in the report instance with the specified instance id, you need to use PATCH method. Report full path and instance id of executing report is specified in the request URL, as follows:
PUT: http://<host>[:port]/api/report/{folder path}/{report name}$instances/{instance id}/pagesettings
Parameters
| Parameter | Description |
|---|---|
| Report Full Path | Specify the full path of the executing report. For example: FlexCommonTasks.flxr/MultiValue DataBound Parameters |
| Instance Id | Specify the instance id of the executing report. |
| Report Page Settings | Set the page settings. Example: paperSize=custom&height=10in&width=20.5cm |
Response Messages
| HTTP Status Code | Reason |
|---|---|
| 200 | JSON string contains IPageSettings type object, which is the new page settings. |
| 404 | The report path or instance id does not exist. |
For more information about Report Instances. see WebApiExplorer Demo.
