Create or update an array of customer profile specification

put

https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/customerProfileSpecifications

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: array
Minimum Number of Items: 1
Maximum Number of Items: 50
Show Source
Nested Schema : CustomerProfileSpecificationOracle
Type: object
Title: CustomerProfileSpecificationOracle
The Customer Profile Specification resource represents a set of customer profile characteristics and relationships.
Show Source
Nested Schema : custProfSpecCharacteristic
Type: array
Show Source
  • CustProfSpecCharacteristicOracle
    Title: CustProfSpecCharacteristicOracle
    A list of customer profile spec characteristics (CustomerProfileSpecificationCharacteristic [*]). This class represents the key features of this customer profile specification.
Nested Schema : custProfSpecificationRelationship
Type: array
Show Source
  • CustProfSpecRelationshipOracle
    Title: CustProfSpecRelationshipOracle
    A list of usage spec relationships (CustomerProfileSpecificationRelationship [*]). A list of customer profile specifications related to this specification.
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
Project Reference
Show Source
Nested Schema : relatedParty
Type: array
Show Source
Nested Schema : TimePeriod
Type: object
Title: TimePeriod
The period for which the productOffering is valid
Show Source
Nested Schema : CustProfSpecCharacteristicOracle
Type: object
Title: CustProfSpecCharacteristicOracle
A list of customer profile spec characteristics (CustomerProfileSpecificationCharacteristic [*]). This class represents the key features of this customer profile specification.
Show Source
Nested Schema : custProfSpecCharacteristicValue
Type: array
Show Source
  • CustProfSpecCharacteristicValueOracle
    Title: CustProfSpecCharacteristicValueOracle
    A list of customer profile spec characteristic values A CustomerProfileSpecificationCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a SpecCharacteristic object. The values of the attributes in the SpecCharacteristicValue object describe the values of the attributes that a corresponding SpecCharacteristic object can take on.
Nested Schema : custProfSpecCharRelationship
Type: array
Show Source
  • CustProfSpecCharRelationshipOracle
    Title: CustProfSpecCharRelationshipOracle
    A list of customer profile spec char relationships. An aggregation, migration, substitution, dependency or exclusivity relationship between/among Specification Characteristics.
Nested Schema : TimePeriodOracle
Type: object
Title: TimePeriodOracle
Validity period of the related party
Show Source
Nested Schema : CustProfSpecCharacteristicValueOracle
Type: object
Title: CustProfSpecCharacteristicValueOracle
A list of customer profile spec characteristic values A CustomerProfileSpecificationCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a SpecCharacteristic object. The values of the attributes in the SpecCharacteristicValue object describe the values of the attributes that a corresponding SpecCharacteristic object can take on.
Show Source
  • base class type (immediate parent) of the ServiceSpecCharacteristicValue
  • Hyperlink reference to schema describing this object
  • The class type of the characteristic value
  • A boolean. Indicates if the value is the default value for a characteristic.
  • Allowed Values: [ "OPEN", "CLOSED", "CLOSED_BOTTOM", "CLOSED_TOP" ]
    A string. An indicator that specifies the inclusion or exclusion of the valueFrom and valueTo attributes. If applicable, possible values are 'open', 'closed', 'closedBottom' and 'closedTop'.
  • A string. A regular expression constraint for given value.
  • A string. A length, surface, volume, dry measure, liquid measure, money, weight, time, and the like. In general, a determinate quantity or magnitude of the kind designated, taken as a standard of comparison for others of the same kind, in assigning to them numerical values, as 1 foot, 1 yard, 1 mile, 1 square foot.
  • TimePeriodOracle
    Title: TimePeriodOracle
    Validity period of the related party
  • value
    An object (object). A discrete value that the characteristic can take on, or the actual value of the characteristic.
  • An integer. The low range value that a characteristic can take on.
  • An integer. The upper range value that a characteristic can take on.
  • Allowed Values: [ "STRING", "NUMBER", "OBJECT", "ARRAY", "DECIMAL", "BOOLEAN", "DATE", "DATETIME" ]
    A string. A kind of value that the characteristic can take on, such as numeric, text, and so forth.
Nested Schema : value
An object (object). A discrete value that the characteristic can take on, or the actual value of the characteristic.
Match One Schema
Show Source
Nested Schema : value-oneOf[1]
Type: object
Nested Schema : value-oneOf[4]
Type: array
Nested Schema : CustProfSpecCharRelationshipOracle
Type: object
Title: CustProfSpecCharRelationshipOracle
A list of customer profile spec char relationships. An aggregation, migration, substitution, dependency or exclusivity relationship between/among Specification Characteristics.
Show Source
Nested Schema : CustProfSpecRelationshipOracle
Type: object
Title: CustProfSpecRelationshipOracle
A list of usage spec relationships (CustomerProfileSpecificationRelationship [*]). A list of customer profile specifications related to this specification.
Show Source
Nested Schema : RelatedParty
Type: object
Title: RelatedParty
RelatedParty reference. A related party defines party or party role linked to a specific entity.
Show Source
Back to Top

Response

Supported Media Types

200 Response

Your request is successful and the resources have been created or updated.
Body ()
Root Schema : schema
Type: array
Show Source
Nested Schema : CustomerProfileSpecificationOracle
Type: object
Title: CustomerProfileSpecificationOracle
The Customer Profile Specification resource represents a set of customer profile characteristics and relationships.
Show Source
Nested Schema : custProfSpecCharacteristic
Type: array
Show Source
  • CustProfSpecCharacteristicOracle
    Title: CustProfSpecCharacteristicOracle
    A list of customer profile spec characteristics (CustomerProfileSpecificationCharacteristic [*]). This class represents the key features of this customer profile specification.
Nested Schema : custProfSpecificationRelationship
Type: array
Show Source
  • CustProfSpecRelationshipOracle
    Title: CustProfSpecRelationshipOracle
    A list of usage spec relationships (CustomerProfileSpecificationRelationship [*]). A list of customer profile specifications related to this specification.
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
Project Reference
Show Source
Nested Schema : relatedParty
Type: array
Show Source
Nested Schema : TimePeriod
Type: object
Title: TimePeriod
The period for which the productOffering is valid
Show Source
Nested Schema : CustProfSpecCharacteristicOracle
Type: object
Title: CustProfSpecCharacteristicOracle
A list of customer profile spec characteristics (CustomerProfileSpecificationCharacteristic [*]). This class represents the key features of this customer profile specification.
Show Source
Nested Schema : custProfSpecCharacteristicValue
Type: array
Show Source
  • CustProfSpecCharacteristicValueOracle
    Title: CustProfSpecCharacteristicValueOracle
    A list of customer profile spec characteristic values A CustomerProfileSpecificationCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a SpecCharacteristic object. The values of the attributes in the SpecCharacteristicValue object describe the values of the attributes that a corresponding SpecCharacteristic object can take on.
Nested Schema : custProfSpecCharRelationship
Type: array
Show Source
  • CustProfSpecCharRelationshipOracle
    Title: CustProfSpecCharRelationshipOracle
    A list of customer profile spec char relationships. An aggregation, migration, substitution, dependency or exclusivity relationship between/among Specification Characteristics.
Nested Schema : TimePeriodOracle
Type: object
Title: TimePeriodOracle
Validity period of the related party
Show Source
Nested Schema : CustProfSpecCharacteristicValueOracle
Type: object
Title: CustProfSpecCharacteristicValueOracle
A list of customer profile spec characteristic values A CustomerProfileSpecificationCharacteristicValue object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a SpecCharacteristic object. The values of the attributes in the SpecCharacteristicValue object describe the values of the attributes that a corresponding SpecCharacteristic object can take on.
Show Source
  • base class type (immediate parent) of the ServiceSpecCharacteristicValue
  • Hyperlink reference to schema describing this object
  • The class type of the characteristic value
  • A boolean. Indicates if the value is the default value for a characteristic.
  • Allowed Values: [ "OPEN", "CLOSED", "CLOSED_BOTTOM", "CLOSED_TOP" ]
    A string. An indicator that specifies the inclusion or exclusion of the valueFrom and valueTo attributes. If applicable, possible values are 'open', 'closed', 'closedBottom' and 'closedTop'.
  • A string. A regular expression constraint for given value.
  • A string. A length, surface, volume, dry measure, liquid measure, money, weight, time, and the like. In general, a determinate quantity or magnitude of the kind designated, taken as a standard of comparison for others of the same kind, in assigning to them numerical values, as 1 foot, 1 yard, 1 mile, 1 square foot.
  • TimePeriodOracle
    Title: TimePeriodOracle
    Validity period of the related party
  • value
    An object (object). A discrete value that the characteristic can take on, or the actual value of the characteristic.
  • An integer. The low range value that a characteristic can take on.
  • An integer. The upper range value that a characteristic can take on.
  • Allowed Values: [ "STRING", "NUMBER", "OBJECT", "ARRAY", "DECIMAL", "BOOLEAN", "DATE", "DATETIME" ]
    A string. A kind of value that the characteristic can take on, such as numeric, text, and so forth.
Nested Schema : value
An object (object). A discrete value that the characteristic can take on, or the actual value of the characteristic.
Match One Schema
Show Source
Nested Schema : value-oneOf[1]
Type: object
Nested Schema : value-oneOf[4]
Type: array
Nested Schema : CustProfSpecCharRelationshipOracle
Type: object
Title: CustProfSpecCharRelationshipOracle
A list of customer profile spec char relationships. An aggregation, migration, substitution, dependency or exclusivity relationship between/among Specification Characteristics.
Show Source
Nested Schema : CustProfSpecRelationshipOracle
Type: object
Title: CustProfSpecRelationshipOracle
A list of usage spec relationships (CustomerProfileSpecificationRelationship [*]). A list of customer profile specifications related to this specification.
Show Source
Nested Schema : RelatedParty
Type: object
Title: RelatedParty
RelatedParty reference. A related party defines party or party role linked to a specific entity.
Show Source

400 Response

Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Body ()
Root Schema : schema
Type: array
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

401 Response

Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

404 Response

Your request includes a resource URI that doesn't exist.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

405 Response

HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

500 Response

The server encountered something unexpected that prevented it from completing the request.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source
Back to Top

Examples

The following example shows how to create or update an array of customer profile specification by submitting a put request on the REST resource using cURL.

cURL Command

curl -u username:password -X PUT https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/customerProfileSpecifications -H 'Content-Type: application/json' -D @customprofilespecifications.json | json_pp

Example of Request Body

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

[
    {
        "id": "CustomerProfileSpec_Y2021_001",
        "name": "CustomerProfileSpec_Y2021_001",
        "description": "Description of CustomerProfileSpec_Y2021_001",
        "version": "1.0",
        "lifecycleStatus": "In design",
        "@type": "CustomerProfileSpecificationOracle",
        "@baseType": "CustomerProfileSpecificationOracle",
        "validFor": {
            "startDateTime": "2020-01-18T00:00:00.000Z",
            "endDateTime": "2021-02-20T16:42:23.000Z"
        },
        "project": {
            "id": "BulkDocProject",
            "name": "Bulk Doc Project"
        },
        "custProfSpecCharacteristic": [
            {
                "name": "generalInformation",
                "description": "General Information",
                "valueType": "STRING",
                "extensible": false,
                "configurable": false,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                }
            },
            {
                "name": "availableColor",
                "description": "Available Color",
                "valueType": "STRING",
                "extensible": true,
                "configurable": true,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                },
                "custProfSpecCharacteristicValue": [
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Maple Gold"
                    },
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Crown Silver"
                    },
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": true,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Majestic Black"
                    },
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Royal Gold"
                    }
                ]
            }
        ]
    },
    {
        "id": "CustomerProfileSpec_Y2021_002",
        "name": "CustomerProfileSpec_Y2021_002",
        "description": "description of CustomerProfileSpec_Y2021_002",
        "version": "1.0",
        "lifecycleStatus": "In design",
        "@type": "CustomerProfileSpecificationOracle",
        "@baseType": "CustomerProfileSpecificationOracle",
        "validFor": {
            "startDateTime": "2020-01-18T00:00:00.000Z",
            "endDateTime": "2021-02-20T16:42:23.000Z"
        },
        "project": {
            "id": "BulkDocProject",
            "name": "Bulk Doc Project"
        },
        "custProfSpecCharacteristic": [
            {
                "name": "generalInformation_att",
                "description": "General Information att",
                "valueType": "STRING",
                "extensible": false,
                "configurable": false,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                }
            },
            {
                "name": "availableColor",
                "description": "Available Color",
                "valueType": "STRING",
                "extensible": true,
                "configurable": true,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                },
                "custProfSpecCharacteristicValue": [
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Maple Gold"
                    },
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Crown Silver"
                    },
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": true,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Majestic Black"
                    },
                    {
                        "unitOfMeasure": "GIGABYTE",
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "valueType": "STRING",
                        "value": "Royal Gold"
                    }
                ]
            }
        ]
    }
]

Example of Response Body

The following shows an example of the response body in JSON format.

[
    {
        "id": "CustomerProfileSpec_Y2021_001",
        "name": "CustomerProfileSpec_Y2021_001",
        "description": "Description of CustomerProfileSpec_Y2021_001",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/customerProfileSpecifications/CustomerProfileSpec_Y2021_001",
        "version": "1.0",
        "lifecycleStatus": "In design",
        "@type": "CustomerProfileSpecificationOracle",
        "@baseType": "CustomerProfileSpecificationOracle",
        "validFor": {
            "startDateTime": "2020-01-18T00:00:00.000Z",
            "endDateTime": "2021-02-20T16:42:23.000Z"
        },
        "project": {
            "id": "BulkDocProject",
            "name": "Bulk Doc Project",
            "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/BulkDocProject"
        },
        "custProfSpecCharacteristic": [
            {
                "name": "generalInformation",
                "description": "General Information",
                "valueType": "STRING",
                "extensible": false,
                "configurable": false,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                }
            },
            {
                "name": "availableColor",
                "description": "Available Color",
                "valueType": "STRING",
                "extensible": true,
                "configurable": true,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                },
                "custProfSpecCharacteristicValue": [
                    {
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Maple Gold"
                    },
                    {
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Crown Silver"
                    },
                    {
                        "isDefault": true,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Majestic Black"
                    },
                    {
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Royal Gold"
                    }
                ]
            }
        ]
    },
    {
        "id": "CustomerProfileSpec_Y2021_002",
        "name": "CustomerProfileSpec_Y2021_002",
        "description": "description of CustomerProfileSpec_Y2021_002",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/customerProfileSpecifications/CustomerProfileSpec_Y2021_002",
        "version": "1.0",
        "lifecycleStatus": "In design",
        "@type": "CustomerProfileSpecificationOracle",
        "@baseType": "CustomerProfileSpecificationOracle",
        "validFor": {
            "startDateTime": "2020-01-18T00:00:00.000Z",
            "endDateTime": "2021-02-20T16:42:23.000Z"
        },
        "project": {
            "id": "BulkDocProject",
            "name": "Bulk Doc Project",
            "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/BulkDocProject"
        },
        "custProfSpecCharacteristic": [
            {
                "name": "generalInformation_att",
                "description": "General Information att",
                "valueType": "STRING",
                "extensible": false,
                "configurable": false,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                }
            },
            {
                "name": "availableColor",
                "description": "Available Color",
                "valueType": "STRING",
                "extensible": true,
                "configurable": true,
                "isUnique": true,
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                },
                "custProfSpecCharacteristicValue": [
                    {
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Maple Gold"
                    },
                    {
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Crown Silver"
                    },
                    {
                        "isDefault": true,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Majestic Black"
                    },
                    {
                        "isDefault": false,
                        "validFor": {
                            "startDateTime": "2020-01-18T00:00:00.000Z",
                            "endDateTime": "2021-02-20T16:42:23.000Z"
                        },
                        "unitOfMeasure": "GIGABYTE",
                        "valueType": "STRING",
                        "value": "Royal Gold"
                    }
                ]
            }
        ]
    }
]
Back to Top