Jump to

• Request
• Response
• Examples

Create an integration map

post

/api/boss/data/objects/ora/cxSalesCommon/integration/v1/$en/integrationMaps

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Match All

Show Source

• allOf oraCxSalesCommonIntegration.IntegrationMapping_post-item
• object __busObj_context

{
    "allOf":[
        {
            "$ref":"#/components/schemas/oraCxSalesCommonIntegration.IntegrationMapping_post-item"
        },
        {
            "$ref":"#/components/schemas/__busObj_context"
        }
    ]
}

Nested Schema : oraCxSalesCommonIntegration.IntegrationMapping_post-item

Match All

Show Source

• object Integration Map
  Title: Integration Map

  Integration maps describe the attribute mappings between objects in Sales and objects in other Oracle applications. The integration process uses these mappings to determine the attributes that need to be synchronized from Sales to the other applications.

{
    "allOf":[
        {
            "$ref":"#/components/schemas/oraCxSalesCommonIntegration.IntegrationMapping_item"
        }
    ],
    "required":[
        "name",
        "integrationMapNumber",
        "sourceObject",
        "seededFlag",
        "activeFlag",
        "lockedFlag"
    ]
}

Nested Schema : Integration Map

Type: object

Title: Integration Map

Integration maps describe the attribute mappings between objects in Sales and objects in other Oracle applications. The integration process uses these mappings to determine the attributes that need to be synchronized from Sales to the other applications.

Show Source

• activeFlag: boolean
  Title: Active Flag

  Indicates that the integration map is active.
• createdBy: string
  Title: Created By

  Read Only: true

  The user who created the integration map record.
• description: string
  Title: Map Description

  The description of the integration map.
• integrationMapId: string (big-integer)
  Title: Integration Map Identifier

  The unique identifier of the integration map.
• integrationMapNumber: string
  Title: Integration Map Number

  The public unique identifier of the integration map.
• integrationSpec: string (long-text)
  Title: Map Transform Specification

  The transform specifications for the integration map.
• lockedFlag: boolean
  Title: Locked Flag

  Indicates that the integration map is locked and can't be edited or cloned by a user.
• name: string
  Title: Map Name

  The name of the integration map.
• seededFlag: boolean
  Title: Seeded Flag

  Indicates whether the integration map was seeded by Oracle.
• sourceApplication: string
  Title: Source Application

  Read Only: true

  The source application for the integration.
• sourceObject: string
  Title: Source Object

  The source object of the integration.
• timeCreated: string (date-time)
  Title: Time Created

  Read Only: true

  The date and time when the integration map was created.
• timeUpdated: string (date-time)
  Title: Time Updated

  Read Only: true

  The date and time when the integration map was last updated.
• updatedBy: string
  Title: Updated By

  Read Only: true

  The user who last updated the integration map record.

{
    "type":"object",
    "properties":{
        "integrationMapId":{
            "type":"string",
            "format":"big-integer",
            "x-searchable":true,
            "x-sortable":true,
            "title":"Integration Map Identifier",
            "description":"The unique identifier of the integration map."
        },
        "name":{
            "type":"string",
            "title":"Map Name",
            "description":"The name of the integration map."
        },
        "description":{
            "type":"string",
            "nullable":true,
            "title":"Map Description",
            "description":"The description of the integration map."
        },
        "integrationMapNumber":{
            "type":"string",
            "x-searchable":true,
            "x-sortable":true,
            "title":"Integration Map Number",
            "description":"The public unique identifier of the integration map."
        },
        "sourceApplication":{
            "type":"string",
            "nullable":true,
            "readOnly":true,
            "title":"Source Application",
            "description":"The source application for the integration."
        },
        "sourceObject":{
            "type":"string",
            "x-searchable":true,
            "title":"Source Object",
            "description":"The source object of the integration."
        },
        "seededFlag":{
            "type":"boolean",
            "x-searchable":true,
            "title":"Seeded Flag",
            "description":"Indicates whether the integration map was seeded by Oracle."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "readOnly":true,
            "title":"Time Created",
            "description":"The date and time when the integration map was created."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "title":"Created By",
            "description":"The user who created the integration map record."
        },
        "timeUpdated":{
            "type":"string",
            "format":"date-time",
            "x-sortable":true,
            "readOnly":true,
            "title":"Time Updated",
            "description":"The date and time when the integration map was last updated."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "title":"Updated By",
            "description":"The user who last updated the integration map record."
        },
        "integrationSpec":{
            "type":"string",
            "format":"long-text",
            "nullable":true,
            "title":"Map Transform Specification",
            "description":"The transform specifications for the integration map."
        },
        "activeFlag":{
            "type":"boolean",
            "title":"Active Flag",
            "description":"Indicates that the integration map is active."
        },
        "lockedFlag":{
            "type":"boolean",
            "title":"Locked Flag",
            "description":"Indicates that the integration map is locked and can't be edited or cloned by a user."
        }
    },
    "x-primaryKey":[
        "integrationMapId"
    ],
    "x-alternateKeys":{
        "altKey":[
            "integrationMapNumber"
        ]
    },
    "title":"Integration Map",
    "x-hints":{
        "titlePlural":"Integration Maps"
    },
    "description":"Integration maps describe the attribute mappings between objects in Sales and objects in other Oracle applications. The integration process uses these mappings to determine the attributes that need to be synchronized from Sales to the other applications."
}

Nested Schema : __busObj_context

Type: object

Show Source

• $context: object $context
• $id: string

{
    "type":"object",
    "properties":{
        "$id":{
            "type":"string"
        },
        "$context":{
            "type":"object",
            "properties":{
                "etag":{
                    "type":"string"
                },
                "links":{
                    "type":"object",
                    "properties":{
                        "$self":{
                            "type":"object",
                            "properties":{
                                "href":{
                                    "type":"string"
                                }
                            }
                        }
                    },
                    "readOnly":true
                }
            }
        }
    }
}

Nested Schema : $context

Type: object

Show Source

• etag: string
• links: object links
  Read Only: true

{
    "type":"object",
    "properties":{
        "etag":{
            "type":"string"
        },
        "links":{
            "type":"object",
            "properties":{
                "$self":{
                    "type":"object",
                    "properties":{
                        "href":{
                            "type":"string"
                        }
                    }
                }
            },
            "readOnly":true
        }
    }
}

Nested Schema : links

Type: object

Read Only: true

Show Source

• $self: object $self

{
    "type":"object",
    "properties":{
        "$self":{
            "type":"object",
            "properties":{
                "href":{
                    "type":"string"
                }
            }
        }
    },
    "readOnly":true
}

Nested Schema : $self

Type: object

Show Source

• href: string

{
    "type":"object",
    "properties":{
        "href":{
            "type":"string"
        }
    }
}

Back to Top

Response

Default Response

no content

Back to Top

Examples

The following example shows how to create an integration map by submitting a POST request on the REST resource.

cURL Command

curl -X POST --location 'https://servername.fa.us2.oraclecloud.com/api/boss/data/objects/ora/cxSalesCommon/integration/v1/$en/integrationMaps' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "name": "Integrate Products 299",
    "description": "Synchronize product create or update in Sales with CPQ.",
    "integrationMapNumber": "DATAINTG-299",
    "sourceObject": "Product",
    "seededFlag": true,
    "integrationSpec": "{\"BeforeHandler\":\"com.oracle.osc.aspects.consumer.product.BeforeHandlerImpl\",\"MapTransform\":{\"Transform\":\"{\\n$.Product.ProductTranslation[*].Description:$.upsertParts.partSetups.items[*].translations.items[*].description\\n$.lookup($.Product.ProductTranslation[*].Language,'\''CPQ_LANGUAGES'\''):$.upsertParts.partSetups.items[*].translations.items[*].language.languageCode\\n$.Product.Name:$.upsertParts.partSetups.items[*].partDisplayNumber\\n$.Product.InventoryItemId:$.upsertParts.partSetups.items[*].partnerPartId\\n$.Product.OrganizationId:$.upsertParts.partSetups.items[*].partnerOrganizationId\\n$.Product.DefaultPeriodicityCode:$.upsertParts.partSetups.items[*].pricePeriod\\n$.Product.DefaultPeriods:$.upsertParts.partSetups.items[*].numberOfPricePeriods\\n$.Product.DefaultPriceTypeCode:$.upsertParts.partSetups.items[*].priceType\\n$.Product.ItemNumber:$.upsertParts.partSetups.items[*].partNumber\\n$.Product.DefaultUOMCode:$.upsertParts.partSetups.items[*].defaultUOMCode\\n$.Product.ProductTypeCode:$.upsertParts.partSetups.items[*].salesProductType\\n$.Product.EligibleToSell:$.upsertParts.partSetups.items[*].eligibleToSell\\n$.Product.CSSEnabled:$.upsertParts.partSetups.items[*].enableSelfService\\n$.Product.EligibleForService:$.upsertParts.partSetups.items[*].eligibleForService\\n$.Product.ProcessingDays:$.upsertParts.partSetups.items[*].leadTime\\n$.\\\"1\\\":$.upsertParts.partSetups.items[*].directBuy.lookupCode\\n}\",\"Invoke\":{\"ConnectionReference\":\"ORA_CPQ_APP\",\"EndPointURI\":\"\/rest\/v14\/partSetups\/actions\/upsertParts\",\"EndPointAction\":\"POST\",\"EndPointHeaders\":\"\"}},\"IntegrationStepName\":\"IntegrateProduct\"}"
}'

Example of Request Body

The following example shows the contents of the request body in JSON format.

{
    "name": "Integrate Products 231",
    "description": "Synchronize product create or update in Sales with CPQ.",
    "integrationMapNumber": "DATAINTG-101",
    "sourceObject": "Product",
    "seededFlag": true,
    "integrationSpec": "{\"BeforeHandler\":\"com.oracle.osc.aspects.consumer.product.BeforeHandlerImpl\",\"MapTransform\":{\"Transform\":\"{\\n$.Product.ProductTranslation[*].Description:$.upsertParts.partSetups.items[*].translations.items[*].description\\n$.lookup($.Product.ProductTranslation[*].Language,'CPQ_LANGUAGES'):$.upsertParts.partSetups.items[*].translations.items[*].language.languageCode\\n$.Product.Name:$.upsertParts.partSetups.items[*].partDisplayNumber\\n$.Product.InventoryItemId:$.upsertParts.partSetups.items[*].partnerPartId\\n$.Product.OrganizationId:$.upsertParts.partSetups.items[*].partnerOrganizationId\\n$.Product.DefaultPeriodicityCode:$.upsertParts.partSetups.items[*].pricePeriod\\n$.Product.DefaultPeriods:$.upsertParts.partSetups.items[*].numberOfPricePeriods\\n$.Product.DefaultPriceTypeCode:$.upsertParts.partSetups.items[*].priceType\\n$.Product.ItemNumber:$.upsertParts.partSetups.items[*].partNumber\\n$.Product.DefaultUOMCode:$.upsertParts.partSetups.items[*].defaultUOMCode\\n$.Product.ProductTypeCode:$.upsertParts.partSetups.items[*].salesProductType\\n$.Product.EligibleToSell:$.upsertParts.partSetups.items[*].eligibleToSell\\n$.Product.CSSEnabled:$.upsertParts.partSetups.items[*].enableSelfService\\n$.Product.EligibleForService:$.upsertParts.partSetups.items[*].eligibleForService\\n$.Product.ProcessingDays:$.upsertParts.partSetups.items[*].leadTime\\n$.\\\"1\\\":$.upsertParts.partSetups.items[*].directBuy.lookupCode\\n}\",\"Invoke\":{\"ConnectionReference\":\"ORA_CPQ_APP\",\"EndPointURI\":\"\/rest\/v14\/partSetups\/actions\/upsertParts\",\"EndPointAction\":\"POST\",\"EndPointHeaders\":\"\"}},\"IntegrationStepName\":\"IntegrateProduct\"}"
}

Response: 201 Created

Back to Top