Jump to

• Request
• Response
• Examples

Import a dimension from a file

post

/epm/rest/v1/dimensions/{dimensionId}/import/file

Request

Supported Media Types

• application/json

Path Parameters

• dimensionId(required): string(uuid)

Body ()

Specifies the parameters to use for running the import

Root Schema : ImportDimensionFromFileCommandJson

Type: object

Show Source

• fileUri(required): string
  URI of the file to import
• importOption: string
  Allowed Values: [ "ResetDimension", "ReplaceNodes", "Merge" ]

  Option for Reset/Replace/Merge on Import. Default value is Replace.
• resetDimension: boolean
  Set to true to reset the dimension prior to import. If importOption is provided, then resetDimension is ignored. Default value is false.

{
    "type":"object",
    "required":[
        "fileUri"
    ],
    "properties":{
        "fileUri":{
            "type":"string",
            "description":"URI of the file to import"
        },
        "importOption":{
            "type":"string",
            "description":"Option for Reset/Replace/Merge on Import. Default value is Replace.",
            "enum":[
                "ResetDimension",
                "ReplaceNodes",
                "Merge"
            ]
        },
        "resetDimension":{
            "type":"boolean",
            "description":"Set to true to reset the dimension prior to import. If importOption is provided, then resetDimension is ignored. Default value is false."
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

202 Response

Accepted, import processing

400 Response

Error in body

404 Response

Dimension not found

415 Response

Unsupported file media type

Back to Top

Examples

The following example shows how to import a dimension from an uploaded file by submitting a post request on the REST resource using cURL.

cURL Command

curl --user epm_cloud_user -X POST -H 'Content-Type: application/json' -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/epm/rest/v1/dimensions/9ae152c1-9d03-46b8-9206-744680c84c43/import/file

Example of Request Body

The following shows an example of the request body in JSON format.

{
  "fileUri": "https://servername.fa.us2.oraclecloud.com/epm/rest/v1/files/temp/dd8c5576-9db0-44b7-a9e9-e6a24491c950",
  "resetDimension": true,
  "importOption": "ResetDimension"
}

Example of Response Body

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

{
  "links": [
    {
      "rel": "results",
      "href": "https://servername.fa.us2.oraclecloud.com/epm/rest/v1/jobRuns/acdaea6f-1ba6-4efd-bb35-4b51c3e11708"
    }
  ]
}

Back to Top