Find the Code for an Offering or Functional Area

Before you automate the process of exporting or importing setup data, you must find the code of an offering or the functional area. Let's assume that you know the name of the offering or functional area, but you don't know their codes.

In this use case, we show how to use a resource to find the offering and functional area codes. Before you begin, keep the name of the offering or functional area ready.

Find the Code for an Offering

Let's look at this example of finding the code for the Order Management offering, using the Features resource.

curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features?fields=FeatureName,FeatureCode,FeatureType&q=FeatureType='OFFERING';FeatureName LIKE 'Order Management'

Sample Response Payload

{
  "items" : [ {
    "FeatureName" : "Order Management",
    "FeatureCode" : "DOO_ORCHESTRATION",
    "FeatureType" : "OFFERING",
    "links" : [ {
      "rel" : "self",
      "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features/DOO_ORCHESTRATION",
      "name" : "features",
      "kind" : "item"
    }, {
      "rel" : "canonical",
      "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features/DOO_ORCHESTRATION",
      "name" : "features",
      "kind" : "item"
    } ]
  } ],
  "count" : 1,
  "hasMore" : false,
  "limit" : 25,
  "offset" : 0,
  "links" : [ {
    "rel" : "self",
    "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features",
    "name" : "features",
    "kind" : "collection"
  } ]
}

The offering code returned by the query is DOO_ORCHESTRATION.

Find Functional Area Code

Let's look at this example of finding the code for the Legal Structures functional area, using the Features resource.

curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features?fields=FeatureName,FeatureCode,FeatureType&q=FeatureType='FUNCTIONAL_AREA';FeatureName LIKE 'Legal Structures'

Sample Response Payload

{
  "items" : [ {
    "FeatureName" : "Legal Structures",
    "FeatureCode" : "ORA_ASK_LEGAL_STRUCTURES",
    "FeatureType" : "FUNCTIONAL_AREA",
    "links" : [ {
      "rel" : "self",
      "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features/ORA_EGP_CUSTOMER",
      "name" : "features",
      "kind" : "item"
    }, {
      "rel" : "canonical",
      "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features/ORA_EGP_CUSTOMER",
      "name" : "features",
      "kind" : "item"
    } ]
  } ],
  "count" : 1,
  "hasMore" : false,
  "limit" : 25,
  "offset" : 0,
  "links" : [ {
    "rel" : "self",
    "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/features",
    "name" : "features",
    "kind" : "collection"
  } ]
}

The functional area code returned by the query is ORA_ASK_LEGAL_STRUCTURES.

Now that you got the code of an offering or the functional area, you can use them to automate the export or import process. For more information about how to automate the export or import process, see topic Automate Export and Import of CSV File Packages.