1. REST API for Oracle Fusion Cloud SCMREST API for Oracle Fusion Cloud SCM
  2. Use Cases
  3. Product Management
  4. Manage Workflow Participants for Any Change Status Using Product Change Orders V2

Manage Workflow Participants for Any Change Status Using Product Change Orders V2

You can use the Product Change Orders V2 REST API resource to add participants to any change status for product management change objects.

Let's discuss these scenarios where, say, James is a product data steward who's preparing the production system for going live and uses the Product Change Orders V2 REST API resource to add participants to a change order:

  1. Add a user as an approver.

  2. Add reviewer to completed status.

  3. Get one of the participant type reviewers.

Add a User as an Approver

Let's take a change order, CO9898, that's in open status. Using Product Change Order V2, add a user with role as approver.

Add a User

Example URL

Use this resource URL format.

POST

curl -u username:password -X POST -H 'Content-Type:application/vnd.oracle.adf.resourceitem+json' -d 'request payload' 
'https://servername/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants'
Example Request
Here's an example of the request body in JSON format.
{
    "AssigneeName": "John.Dove",
    "AssigneeTypeCode": "EGO_PERSON",
    "StatusCode": 8,
    "ActivityTypeValue": "Approval"
}

Example Response

Here's an example of the response body in JSON format.
{
    "ResponseRequiredFrom": "EGO_ONE",
    "AssigneeName": "John.Dove",
    "AssigneeTypeCode": "EGO_PERSON",
    "StatusCode": 8,
    "StatusCodeValue": "Approval",
    "ActivityTypeCode": "APPROVAL",
    "ActivityTypeValue": "Approval",
    "ResponseRequiredFromValue": "One",
    "AssigneeTypeValue": "Person",
    "ReassignedTo": null,
    "ReassignedTime": null,
    "ResponseCode": null,
    "ResponseValue": null,
    "Comments": null,
    "links": [
        {
            "rel": "self",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559999750",
            "name": "changeOrderParticipants",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559999750",
            "name": "changeOrderParticipants",
            "kind": "item"
        },
        {
            "rel": "parent",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733",
            "name": "productChangeOrdersV2",
            "kind": "item"
        }
    ]
}

Add Approver Role to User

Example URL

Use this resource URL format.

POST

curl -u username:password -X POST -H 'Content-Type:application/vnd.oracle.adf.resourceitem+json' -d 'request payload' 
'https://servername/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants'
Example Request
Here's an example of the request body in JSON format.
{
    "AssigneeName": "ORA_EGP_PRODUCT_MANAGER_JOB",
    "AssigneeTypeCode": "EGO_ROLE",
    "StatusCode": 8,
    "ActivityTypeValue": "Approval"
}

Example Response

Here's an example of the response body in JSON format.
{
    "ResponseRequiredFrom": "EGO_ONE",
    "AssigneeName": "ORA_EGP_PRODUCT_MANAGER_JOB",
    "AssigneeTypeCode": "EGO_ROLE",
    "StatusCode": 8,
    "StatusCodeValue": "Approval",
    "ActivityTypeCode": "APPROVAL",
    "ActivityTypeValue": "Approval",
    "ResponseRequiredFromValue": "One",
    "AssigneeTypeValue": "Role",
    "ReassignedTo": null,
    "ReassignedTime": null,
    "ResponseCode": null,
    "ResponseValue": null,
    "Comments": null,
    "links": [
        {
            "rel": "self",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559999752",
            "name": "changeOrderParticipants",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559999752",
            "name": "changeOrderParticipants",
            "kind": "item"
        },
        {
            "rel": "parent",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733",
            "name": "productChangeOrdersV2",
            "kind": "item"
        }
    ]
}

Add Reviewer to Completed Status

Let's take a change order, CO9898, that's in open status. Using Product Change Order V2, add a participant method to add a user and role as approvers.

Example URL

Use this resource URL format.

POST

curl -u username:password -X POST -H 'Content-Type:application/vnd.oracle.adf.resourceitem+json' -d 'request payload' 
'https://servername/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants'

Example Request

Here's an example of the request body in JSON format.
{
    "AssigneeName": "John.Dove",
    "AssigneeTypeCode": "EGO_PERSON",
    "StatusCode": 6,
    "ActivityTypeValue": "Review"
}

Example Response

Here's an example of the response body in JSON format.
{
    "ResponseRequiredFrom": "EGO_ONE",
    "AssigneeName": "John.Dove",
    "AssigneeTypeCode": "EGO_PERSON",
    "StatusCode": 6,
    "StatusCodeValue": "Completed",
    "ActivityTypeCode": "REVIEW",
    "ActivityTypeValue": "Review",
    "ResponseRequiredFromValue": "One",
    "AssigneeTypeValue": "Person",
    "ReassignedTo": null,
    "ReassignedTime": null,
    "ResponseCode": null,
    "ResponseValue": null,
    "Comments": null,
    "links": [
        {
            "rel": "self",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559999754",
            "name": "changeOrderParticipants",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559999754",
            "name": "changeOrderParticipants",
            "kind": "item"
        },
        {
            "rel": "parent",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733",
            "name": "productChangeOrdersV2",
            "kind": "item"
        }
    ]
}

Get One Participant Type Reviewer

Now that the participant is added, James can use the GET action to query for reviewers added to the approval status.

Example URL

Use this resource URL format.

GET
curl -u username:password -X GET -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d "https://servername/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants?q=StatusCode=8 AND ActivityTypeCode='REVIEW'"

Note:

Ensure that the REST-framework-version = 2 header parameter is set before executing this request.
Example Response
Here's an example of the response body in JSON format.
{
    "items": [
        {
            "ResponseRequiredFrom": "EGO_ALL",
            "AssigneeName": "PLM_AUTO",
            "AssigneeTypeCode": "EGO_PERSON",
            "StatusCode": 8,
            "StatusCodeValue": "Approval",
            "ActivityTypeCode": "REVIEW",
            "ActivityTypeValue": "Review",
            "ResponseRequiredFromValue": "All",
            "AssigneeTypeValue": "Person",
            "ReassignedTo": null,
            "ReassignedTime": null,
            "ResponseCode": null,
            "ResponseValue": null,
            "Comments": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559997754",
                    "name": "changeOrderParticipants",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants/300100559997754",
                    "name": "changeOrderParticipants",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733",
                    "name": "productChangeOrdersV2",
                    "kind": "item"
                }
            ]
        }
    ],
    "count": 1,
    "hasMore": false,
    "limit": 25,
    "offset": 0,
    "links": [
        {
            "rel": "self",
            "href": "https://server/fscmRestApi/resources/version/productChangeOrdersV2/300100559997733/child/changeOrderParticipants",
            "name": "changeOrderParticipants",
            "kind": "collection"
        }
    ]
}