Jump to

• Request
• Response

View a Gateway App Instance Configuration (Deprecated since 24.2)

get

/api/restapi/pims/appInstanceConfigurations/{id}

This endpoint returns Gateway app instance configurations that meet the following requirements:

• The object has an ID that matches the value of the {id} path parameter.

Request

Path Parameters

• id(required): integer(int64)
  ID of application configuration instance.

  Default Value: 0

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : AppInstanceConfig

Type: object

Title: AppInstanceConfig

A list of application instance configurations associated with the application instance.

Show Source

• appConfig(required): object AppConfig
  Title: AppConfig

  The application configuration associated with the application instance configuration.
• appInstance(required): object AppInstance
  Title: AppInstance

  The list of application instances associated with a flow.
• id(required): integer (int64)
  The unique ID of the application instance configuration generated by the system.
• value(required): string
  The value of the application instance configuration entered by the user.

{
    "title":"AppInstanceConfig",
    "required":[
        "appConfig",
        "appInstance",
        "id",
        "value"
    ],
    "type":"object",
    "properties":{
        "value":{
            "type":"string",
            "description":"The value of the application instance configuration entered by the user.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "id":{
            "type":"integer",
            "description":"The unique ID of the application instance configuration generated by the system.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "appConfig":{
            "$ref":"#/components/schemas/AppConfig",
            "exampleSetFlag":false
        },
        "appInstance":{
            "$ref":"#/components/schemas/AppInstance",
            "exampleSetFlag":false
        }
    },
    "description":"A list of application instance configurations associated with the application instance.",
    "xml":{
        "name":"AppInstanceConfig"
    },
    "exampleSetFlag":false
}

Nested Schema : AppConfig

Type: object

Title: AppConfig

The application configuration associated with the application instance configuration.

Show Source

• id(required): integer (int64)
  The unique ID of the application instance configuration generated by the system.
• name(required): string
  The name of the application configuration.
• required: boolean
• type(required): string
  Allowed Values: [ "String", "Integer", "Long", "Date", "Boolean", "Password", "File", "Readonly", "Enum" ]

  The category of application configuration.

{
    "title":"AppConfig",
    "required":[
        "id",
        "name",
        "type"
    ],
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"The name of the application  configuration.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "id":{
            "type":"integer",
            "description":"The unique ID of the application instance configuration generated by the system.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "type":{
            "type":"string",
            "description":"The category of application configuration.",
            "xml":{
                "name":"AppConfigType"
            },
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "String",
                "Integer",
                "Long",
                "Date",
                "Boolean",
                "Password",
                "File",
                "Readonly",
                "Enum"
            ]
        },
        "required":{
            "type":"boolean",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        }
    },
    "description":"The application configuration associated with the application instance configuration.",
    "xml":{
        "name":"AppConfig"
    },
    "exampleSetFlag":false
}

Nested Schema : AppInstance

Type: object

Title: AppInstance

The list of application instances associated with a flow.

Show Source

• app(required): object App
  Title: App

  A reference to the App business object.
• description(required): string
  A description of the application instance.
• id(required): integer (int64)
  The unique ID of the application instance generated by the system.
• name(required): string
  The name of the application instance associated with the application instance ID.

{
    "title":"AppInstance",
    "required":[
        "app",
        "description",
        "id",
        "name"
    ],
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"The name of the application instance associated with the application instance ID.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "id":{
            "type":"integer",
            "description":"The unique ID of the application instance generated by the system.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "description":{
            "type":"string",
            "description":"A description of the application instance.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "app":{
            "$ref":"#/components/schemas/App",
            "exampleSetFlag":false
        }
    },
    "description":"The list of application instances associated with a flow.",
    "xml":{
        "name":"AppInstance"
    },
    "exampleSetFlag":false
}

Nested Schema : App

Type: object

Title: App

A reference to the App business object.

Show Source

• appInstances(required): array appInstances
  Unique Items Required: true

  The list of application instances associated with a flow.
• description(required): string
  A description of the application.
• external: boolean
  The indicator which determines whether the provider is external.
• id(required): integer (int64)
  The unique ID of the application generated by the system.
• name(required): string
  The name of the application associated with the flow.
• providerName(required): string
  The Oracle Primavera Gateway provider associated with an application.
• providerPath(required): string
  The path and the folder location of the provider associated with an application. For example, location of the primeprovider folder associated with the Oracle Primavera Cloud application.
• supportFeedback: boolean
  The indicator which determines whether the feedback step in a business flow is enabled.
• version(required): string
  The application version number.

{
    "title":"App",
    "required":[
        "appInstances",
        "description",
        "id",
        "name",
        "providerName",
        "providerPath",
        "version"
    ],
    "type":"object",
    "properties":{
        "providerName":{
            "type":"string",
            "description":"The Oracle Primavera Gateway provider associated with an application.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "name":{
            "type":"string",
            "description":"The name of the application associated with the flow.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "id":{
            "type":"integer",
            "description":"The unique ID of the application generated by the system.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "version":{
            "type":"string",
            "description":"The application version number.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "description":{
            "type":"string",
            "description":"A description of the application.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "providerPath":{
            "type":"string",
            "description":"The path and the folder location of the provider associated with an application. For example, location of the primeprovider folder associated with the Oracle Primavera Cloud application.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "supportFeedback":{
            "type":"boolean",
            "description":"The indicator which determines whether the feedback step in a business flow is enabled.",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        },
        "external":{
            "type":"boolean",
            "description":"The indicator which determines whether the provider is external.",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        },
        "appInstances":{
            "uniqueItems":true,
            "type":"array",
            "description":"The list of application instances associated with a flow.",
            "exampleSetFlag":false,
            "items":{
                "$ref":"#/components/schemas/AppInstance",
                "exampleSetFlag":false
            },
            "types":[
                "array"
            ]
        }
    },
    "description":"A reference to the App business object.",
    "xml":{
        "name":"App"
    },
    "exampleSetFlag":false
}

Nested Schema : appInstances

Type: array

Unique Items Required: true

The list of application instances associated with a flow.

Show Source

• Array of: object AppInstance
  Title: AppInstance

  The list of application instances associated with a flow.

{
    "uniqueItems":true,
    "type":"array",
    "description":"The list of application instances associated with a flow.",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/AppInstance",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

404 Response

The requested Gateway app instance configuration does not exist, or you do not have access to it.

Back to Top