1. REST API for Oracle Fusion Cloud SCMREST API for Oracle Fusion Cloud SCM
  2. Use Cases
  3. Maintenance
  4. Create and Update Qualification Profiles

Create and Update Qualification Profiles

You can define the qualifications required for a maintenance operation using an equipment qualification profile for an asset in Oracle Fusion Cloud Maintenance. You must associate the resource instance to an asset number to perform the equipment qualification check for the resource instance.

Integrated inline checks for equipment qualification reduces the likelihood of noncompliance, defects, or failures in maintenance operations.

The Qualification Profile Solution includes these REST API:
  • Qualification Profiles
  • Qualification Requirements

Qualification Profiles

The Qualification Profiles REST API supports these methods:

  • POST: to create a new qualification profile.
  • PATCH: to update attributes in the header and child.
  • GET: to get one or all qualification profiles.

This use case discusses the following scenarios for qualification profiles:

  • Create a qualification profile.
  • Create a qualification profile with a qualification requirement ID.
  • Create a qualification profile with qualification requirement code.

Note:

Before you create a qualification profile:
  • Items used to create Enterprise Assets must be set up in Oracle Product Information Management.
  • Qualification requirements much be created.

Create a Qualification Profile

In this scenario, you create a qualification profile without a qualification requirement.

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/assetQualificationProfiles"

Example Request

Here's an example of the request body in JSON format.

{
    "ProfileName": "ALMQualProfileName",
    "ProfileCode": "ALMQualProfileCode",
    "ProfileDescription": "ALMQualProfileDescription"
}

Example Response

Here's an example of the response body in JSON format.

{
    "ProfileId": 300100584871827,
    "ProfileName": "ALMQualProfileName01",
    "ProfileCode": "ALMQualProfileCode01",
    "ProfileDescription": "ALMQualProfile01Description",
    "ProfileCategoryCode": null,
    "ProfileCategoryName": null,
    "ProfileEndDate": null,
    "CreatedBy": "MNT_QA",
    "CreationDate": "2023-05-05T13:44:33+00:00",
    "LastUpdatedBy": "MNT_QA",
    "LastUpdateDate": "2023-05-05T13:44:33.142+00:00",
    "LastUpdateLogin": "FACC879A24601F8CE0537AA8F00AA5D9",
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871827",
            "name": "assetQualificationProfiles",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871827",
            "name": "assetQualificationProfiles",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871827/child/qualificationRequirements",
            "name": "qualificationRequirements",
            "kind": "collection"
        }
    ]
}

Create a Qualification Profile with a Qualification Requirement ID

In this scenario, you create a qualification profile with a qualification requirement ID.

Example Request

Here's an example of the request body in JSON format.

{
    "ProfileName": "ALMQualProfileWithQulReqId",
    "ProfileCode": " ALMQualProfileWithQulReqIdCode",
    "ProfileDescription": " ALMQualProfileWithQulReqId Description",
    "qualificationRequirements": [
        {
            "RequirementId": 300100584871823
        }
    ]
}

Example Response

Here's an example of the response body in JSON format.

{
    "ProfileId": 300100584871824,
    "ProfileName": "ALMQualProfile2",
    "ProfileCode": "ALMQualProfileCode",
    "ProfileDescription": "ALMQualProfile2Description",
    "ProfileCategoryCode": null,
    "ProfileCategoryName": null,
    "ProfileEndDate": null,
    "CreatedBy": "MNT_QA",
    "CreationDate": "2023-05-05T13:25:35+00:00",
    "LastUpdatedBy": "MNT_QA",
    "LastUpdateDate": "2023-05-05T13:25:35.069+00:00",
    "LastUpdateLogin": "FACC9299451C1F90E0537AA8F00A19AC",
    "qualificationRequirements": [
        {
            "ProfileRequirementId": 300100584871825,
            "RequirementId": 300100584871823,
            "RequirementName": "ALMQualReq2",
            "RequirementCode": "ALMQualReqCode",
            "RequirementDescription": "ALMQualReq2 desc",
            "RequirementEndDate": null,
            "CreatedBy": "MNT_QA",
            "CreationDate": "2023-05-05T13:25:35.014+00:00",
            "LastUpdatedBy": "MNT_QA",
            "LastUpdateDate": "2023-05-05T13:25:35.069+00:00",
            "LastUpdateLogin": "FACC9299451C1F90E0537AA8F00A19AC",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871824/child/qualificationRequirements/300100584871825",
                    "name": "qualificationRequirements",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871824/child/qualificationRequirements/300100584871825",
                    "name": "qualificationRequirements",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871824",
                    "name": "assetQualificationProfiles",
                    "kind": "item"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871824",
            "name": "assetQualificationProfiles",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871824",
            "name": "assetQualificationProfiles",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871824/child/qualificationRequirements",
            "name": "qualificationRequirements",
            "kind": "collection"
        }
    ]
}

Create a Qualification Profile with Qualification Requirement Code

In this scenario, you create a qualification profile with qualification requirement code.

Example Request

Here's an example of the request body in JSON format.

{
    "ProfileName": "ALMQualProfileQualReqCodeName",
    "ProfileCode": "ALMQualProfileQualReq",
    "ProfileDescription": "ALMQualProfileQualReq Description",
    "qualificationRequirements": [
        {
            "RequirementCode": "ALMQualReq"
        }
    ]
}

Example Response

Here's an example of the response body in JSON format.

{
    "ProfileId": 300100584871821,
    "ProfileName": "ALMQualProfileName",
    "ProfileCode": "ALMQualProfile",
    "ProfileDescription": "ALMQualProfileDescription",
    "ProfileCategoryCode": null,
    "ProfileCategoryName": null,
    "ProfileEndDate": null,
    "CreatedBy": "MNT_QA",
    "CreationDate": "2023-05-05T13:16:33+00:00",
    "LastUpdatedBy": "MNT_QA",
    "LastUpdateDate": "2023-05-05T13:16:33.301+00:00",
    "LastUpdateLogin": "FACC86B79CD71F88E0537AA8F00AE88D",
    "qualificationRequirements": [
        {
            "ProfileRequirementId": 300100584871822,
            "RequirementId": 300100584871818,
            "RequirementName": "ALMQualReq1",
            "RequirementCode": "ALMQualReq",
            "RequirementDescription": "ALMQualReq1 desc",
            "RequirementEndDate": null,
            "CreatedBy": "MNT_QA",
            "CreationDate": "2023-05-05T13:16:33.266+00:00",
            "LastUpdatedBy": "MNT_QA",
            "LastUpdateDate": "2023-05-05T13:16:33.302+00:00",
            "LastUpdateLogin": "FACC86B79CD71F88E0537AA8F00AE88D",
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871821/child/qualificationRequirements/300100584871822",
                    "name": "qualificationRequirements",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871821/child/qualificationRequirements/300100584871822",
                    "name": "qualificationRequirements",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871821",
                    "name": "assetQualificationProfiles",
                    "kind": "item"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871821",
            "name": "assetQualificationProfiles",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871821",
            "name": "assetQualificationProfiles",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871821/child/qualificationRequirements",
            "name": "qualificationRequirements",
            "kind": "collection"
        }
    ]
}

Qualification Requirements

The qualification requirements REST API supports these methods:

  • POST: to create a new qualification.
  • PATCH: to update attributes in the header and child.
  • GET: to get single or all qualification requirements.

This use case discusses the following scenario for a qualification requirement:

  • Associate a qualification requirement with a qualification profile.

Note:

Before you associate a qualification requirement with a qualification profile, the qualification requirements must be created.

Associate an Inspection Plan with a Qualification Requirement

In this scenario, you associate an inspection plan with a qualification requirement.

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/assetQualificationProfiles/ProfileId/child/qualificationRequirements"

Example Requests

Here are examples of the request body in JSON format.

"RequirementCode"
{
"RequirementCode": "ALMQualReqCode"
}
{
            "RequirementId": 300100584871823
}

Example Response

Here's an example of the response body in JSON format.

{
    "ProfileRequirementId": 300100584871830,
    "RequirementId": 300100584871823,
    "RequirementName": "ALMQualReq2",
    "RequirementCode": "ALMQualReqCode",
    "RequirementDescription": "ALMQualReq2 desc",
    "RequirementEndDate": null,
    "CreatedBy": "ALM_QA",
    "CreationDate": "2023-05-05T16:11:54+00:00",
    "LastUpdatedBy": "ALM_QA",
    "LastUpdateDate": "2023-05-05T16:11:54.075+00:00",
    "LastUpdateLogin": "FACC889D04B61F79E0537AA8F00A60F1",
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871829/child/qualificationRequirements/300100584871830",
            "name": "qualificationRequirements",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871829/child/qualificationRequirements/300100584871830",
            "name": "qualificationRequirements",
            "kind": "item"
        },
        {
            "rel": "parent",
            "href": "https://servername/fscmRestApi/resources/version/assetQualificationProfiles/300100584871829",
            "name": "assetQualificationProfiles",
            "kind": "item"
        }
    ]
}