Jump to

• Request
• Response
• Examples

Get Collaborative Quote Queue

get

/rest/v19/collabOperationQueues/{bsId}

Use this endpoint to retrieve queued tasks for the specified transaction.

Request

Path Parameters

• bsId(required): integer

Back to Top

Response

Supported Media Types

• application/json

Default Response

A snapshot of the state of the collab operation queue at the time that the request is processed.

Body ()

Root Schema : Collab operation queue state

Type: object

Title: Collab operation queue state

A snapshot of the state of the queue. It represents the state at a single instant, and might not be accurate at any time after that instant.

Show Source

• currentlyExecutingOperation: array Currently executing operation
  Title: Currently executing operation

  Operation which is currently executing. Omitted if the next queued operation has not started executing yet.
• node: string
  Title: node

  Name of the node that is currently responsible for executing all operations for the bsId.
• operationCount: integer
  Title: Operations count

  The total number of incomplete operations, including executing and queued operations.
• queuedOperations: array Queued operations
  Title: Queued operations

  Operations which are queued and have not started execution. The order of the items in the array is the order in which they will execute.

{
    "type":"object",
    "properties":{
        "queuedOperations":{
            "type":"array",
            "description":"Operations which are queued and have not started execution. The order of the items in the array is the order in which they will execute.",
            "title":"Queued operations",
            "items":{
                "$ref":"#/definitions/operation"
            }
        },
        "currentlyExecutingOperation":{
            "type":"array",
            "description":"Operation which is currently executing. Omitted if the next queued operation has not started executing yet.",
            "title":"Currently executing operation",
            "items":{
                "$ref":"#/definitions/operation"
            }
        },
        "node":{
            "type":"string",
            "description":"Name of the node that is currently responsible for executing all operations for the bsId.",
            "title":"node"
        },
        "operationCount":{
            "type":"integer",
            "description":"The total number of incomplete operations, including executing and queued operations.",
            "title":"Operations count"
        }
    },
    "title":"Collab operation queue state",
    "description":"A snapshot of the state of the queue. It represents the state at a single instant, and might not be accurate at any time after that instant."
}

Nested Schema : Currently executing operation

Type: array

Title: Currently executing operation

Operation which is currently executing. Omitted if the next queued operation has not started executing yet.

Show Source

• Array of: object operation

{
    "type":"array",
    "description":"Operation which is currently executing. Omitted if the next queued operation has not started executing yet.",
    "title":"Currently executing operation",
    "items":{
        "$ref":"#/definitions/operation"
    }
}

Nested Schema : Queued operations

Type: array

Title: Queued operations

Operations which are queued and have not started execution. The order of the items in the array is the order in which they will execute.

Show Source

• Array of: object operation

{
    "type":"array",
    "description":"Operations which are queued and have not started execution. The order of the items in the array is the order in which they will execute.",
    "title":"Queued operations",
    "items":{
        "$ref":"#/definitions/operation"
    }
}

Nested Schema : operation

Type: object

Show Source

• id: integer
  Title: Id

  Operation Id
• operationType: object operationType
• operationVariableName: string
  Title: Operation Variable Name

  Operation Variable Name
• operationVariableType: string
  Title: Operation Variable Type

  Operation Variable Type
• resourceVariableName: object Resource Variable Name
  Title: Resource Variable Name

  Resource Variable Name

{
    "properties":{
        "id":{
            "title":"Id",
            "type":"integer",
            "description":"Operation Id"
        },
        "operationType":{
            "properties":{
                "lookupCode":{
                    "title":"lookupCode",
                    "type":"string",
                    "description":"Operation lookupCode"
                }
            }
        },
        "operationVariableType":{
            "title":"Operation Variable Type",
            "type":"string",
            "description":"Operation Variable Type"
        },
        "operationVariableName":{
            "title":"Operation Variable Name",
            "type":"string",
            "description":"Operation Variable Name"
        },
        "resourceVariableName":{
            "title":"Resource Variable Name",
            "type":"object",
            "description":"Resource Variable Name",
            "properties":{
                "variableName":{
                    "title":"Variable Name",
                    "type":"string",
                    "description":"Resource Variable Name"
                }
            }
        }
    }
}

Nested Schema : operationType

Type: object

Show Source

• lookupCode: string
  Title: lookupCode

  Operation lookupCode

{
    "properties":{
        "lookupCode":{
            "title":"lookupCode",
            "type":"string",
            "description":"Operation lookupCode"
        }
    }
}

Nested Schema : Resource Variable Name

Type: object

Title: Resource Variable Name

Resource Variable Name

Show Source

• variableName: string
  Title: Variable Name

  Resource Variable Name

{
    "title":"Resource Variable Name",
    "type":"object",
    "description":"Resource Variable Name",
    "properties":{
        "variableName":{
            "title":"Variable Name",
            "type":"string",
            "description":"Resource Variable Name"
        }
    }
}

Back to Top

Examples

The following example shows how to retrieve queued tasks for the specified transaction by submitting a GET request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X GET -H "Authorization: Bearer <token>" -H "Accept: application/json"
https://sitename.oracle.com/rest/v19/collabOperationQueues/30221276251

Response Body Sample

{
  "queuedOperations": [{
    "uuid": "eaf67e0f-65fc-4ecc-8bfd-09a3dd9c82c0",
    "submitterLoginName": "alex",
    "submitterCompanyName": "mumbai54488",
    "submissionTime": "2024-03-14T09:54:07.649Z",
    "description": "ResourceCmActionOperation[docNum=1,actionVarName=_open_main]"
  }, {
    "uuid": "4bbd4008-aed7-4cc1-b616-6d1ebcd2fbeb",
    "submitterLoginName": "alex",
    "submitterCompanyName": "mumbai54488",
    "submissionTime": "2024-03-14T09:54:09.798Z",
    "description": "ResourceCmActionOperation[docNum=1,actionVarName=_open_main]"
  }],
  "currentlyExecutingOperation": {
    "uuid": "6cc3a88c-4921-4b21-95de-2709d44cf8d5",
    "submitterLoginName": "alex",
    "submitterCompanyName": "mumbai54488",
    "submissionTime": "2024-03-14T09:54:02.593Z",
    "description": "ResourceCmActionOperation[docNum=1,actionVarName=test_c]"
  },
  "operationCount": 3,
  "node": "node1"
}

Error Responses

400 - Collaborative quote editing is not enabled for process

403 - User with restricted access (Sales agent etc)

404 - Invalid bsId provided in the endpoint

Back to Top