REST API for Oracle Essbase

Update Outline Settings

patch

/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/settings/outline

Updates the outline settings of the specified database. This operation has limited capacity. For more outline update options, refer to the otlUpdate action in Run Batch Outline Edit API.

Request

Supported Media Types

application/json
application/xml

Path Parameters

applicationName(required): string

Application name.
databaseName(required): string

Database name.

Outline settings patch list.

Root Schema : schema

Type: array

Show Source

Array of: object PatchElement

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/PatchElement"
    }
}

Nested Schema : PatchElement

Type: object

Show Source

from: string
op: string

Patch operation. Example: replace.
path: string

Path to setting you want to patch. See examples.
value: object value

New value of setting you want to patch. See examples.

{
    "type":"object",
    "properties":{
        "op":{
            "type":"string",
            "description":"<p>Patch operation. Example: <b>replace</b>.</p>"
        },
        "path":{
            "type":"string",
            "description":"<p>Path to setting you want to patch. See examples.</p>"
        },
        "value":{
            "type":"object",
            "description":"<p>New value of setting you want to patch. See examples.</p>"
        },
        "from":{
            "type":"string"
        }
    }
}

Nested Schema : value

Type: object

New value of setting you want to patch. See examples.

Response

204 Response

Outline settings updated successfully.

400 Response

Bad Request

Failed to update the settings. The application or database name may be incorrect, or the JSON for the settings may be incorrect.

415 Response

Not Acceptable

The media type isn't supported or wasn't specified.

500 Response

Internal Server Error.

Examples

The following example shows how to update outline settings for a cube.

This example uses cURL to access the REST API from a Windows shell script. The calling user's ID and password are variables whose values are set in properties.bat.

Script with cURL Command

call properties.bat
curl -X PATCH https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/databases/Basic/settings/outline -H "accept: application/json" -H "Content-Type: application/json" --data "@./otlgeneraldate.json" -u %User%:%Password%

Sample JSON Payload

The cURL example above delivers the following JSON payload in otlgeneraldate.json, to update the date format in the general outline settings.

[
  {"op":"replace", "path":"/general/dateFormat", "value": "dd/mm/yy"}
]