1. REST API for Oracle Analytics Publisher in Oracle Analytics Server
  2. Tasks
  3. Manage Reports

Update report definition

put

/services/rest/v1/reports/{reportPath}

Updates the attributes of the report definition file (.xdo), and writes the file back to the catalog.

Request

Supported Media Types
Path Parameters
  • URL encoded report path. For example, if your report path is "/Sample Lite/Published Reporting/Reports/Balance Letter" then your encoded report path will be "%2FSample%20Lite%2FPublished%20Reporting%2FReports%2FBalance%20Letter". Use double encoded forward slash when you send a REST request to BI Publisher through a load balancer that isn't configured to pass encoded slashes. For example, if your report path is "/Sample Lite/Published Reporting/Reports/Balance Letter" then your encoded report path will be Sample%20Lite%252FPublished%20Reporting%252FReports%252FBalance%20Letter
Body ()
Report definition
Root Schema : ReportDefinition
Type: object
Show Source
Nested Schema : listOfTemplateFormatsLabelValues
Type: array
Show Source
Nested Schema : reportParameterNameValues
Type: array
Show Source
Nested Schema : templateIds
Type: array
Passes the layout names of the report templates.
Show Source
Nested Schema : TemplateFormatsLabelValues
Type: object
Show Source
Nested Schema : listOfTemplateFormatLabelValue
Type: array
Contains the TemplateFormatLabelValue label-value pairs .
Show Source
Nested Schema : templateAvailableLocales
Type: array
The available locale options defined for a template
Show Source
Nested Schema : TemplateFormatLabelValue
Type: object
Show Source
Nested Schema : ParamNameValues
Type: object
Show Source
Nested Schema : listOfParamNameValues
Type: array
An array of ParamNameValue
Show Source
Nested Schema : ParamNameValue
Type: object
Show Source
  • Valid values include: Boolean Date Float Integer String
  • If UIType is "Date", this specifies the Date Format String. The date format string must be a Java date format (for example, MM-DD-YYYY).
  • If UIType is "Date", this specifies the begin value of the date.
  • If UIType is "Date", this specifies the end value of the date.
  • Specifies the default value of the parameter.
  • For parameter types "Text" and "Date", specifies the text field size for the parameter.
  • For all parameter types except "Hidden", specifies the display label for the parameter.
  • lovLabels
    If the parameter type is "Menu", specifies the values displayed in the list of values to the user.
  • True indicates that a parameter may contain multiple values.
  • The parameter name.
  • For parameter types "Text" and "Menu", a value of true for this parameter indicates that other defined parameters should be refreshed when a selection is made for this parameter.
  • For parameter type "Menu", a value of true indicates that all values can be selected for the LOV.
  • A value of true indicates the parameter is defined in the RTF template.
  • The type of parameter as defined in the Oracle BI Publisher data model user interface. Valid values include: Date Hidden Menu Search Text
  • For parameter type "Menu", a value of true indicates that a null will be passed if all values are selected for the parameter.
  • values
    Parameter values.
Nested Schema : lovLabels
Type: array
If the parameter type is "Menu", specifies the values displayed in the list of values to the user.
Show Source
Nested Schema : values
Type: array
Parameter values.
Show Source
Back to Top

Response

200 Response

Report definition update is successful.

400 Response

An error occurred while updating the report definition.
Body ()
Root Schema : schema
Type: string
Back to Top

Examples

The following example shows how to update a report definition by submitting a POST request on the REST resource using cURL.

curl -i \
     --header 'Authorization: Bearer <token>' \
     --header 'Content-Type: application/json' \
     --request PUT \
     -d '{"ReportDefinition":{"defaultOutputFormat":"pdf", "diagnostics":true, "autoRun":"true"}}' \
     'https://hostname/xmlpserver/services/rest/v1/reports/BalanceLetter'

Example of the Response Body

The following example shows the contents of the response body in JSON format.

* Connection #0 to host hostname left intact
Back to Top