Jump to

• Request
• Response
• Examples

Update one rule

patch

/fscmRestApi/resources/11.13.18.05/spendClassificationRules/{RuleId}

Request

Path Parameters

• RuleId(required): integer(int64)
  Value that uniquely identifies the rule.

Header Parameters

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• ActionOnAttributeCode: string
  Maximum Length: 100

  Abbreviation that indicates the attribute on which the action is taken.
• ActionType: string
  Maximum Length: 30

  Type of action taken on the rule.
• ApplicableDatasets: string
  Maximum Length: 1000

  List of data sets to which a rule is applicable.
• ApplicableKnowledgebases: string
  Maximum Length: 1000

  List of knowledge bases to which a rule is applicable.
• AssignmentTypeCode: string
  Maximum Length: 100

  Abbreviation that indicates the type of assignment.
• AssignToAttributeCode: string
  Maximum Length: 100

  Abbreviation that indicates the attribute whose value is assigned to another attribute.
• AssignToConstant: string
  Maximum Length: 100

  Value that indicates that a constant value is assigned to another attribute.
• DatasetsScope: string
  Maximum Length: 30

  Value that indicates if a rule is applicable to all or specific data sets.
• Description: string
  Maximum Length: 2000

  Description of the rule.
• EndDate: string (date)
  Date when the rule becomes inactive.
• EntityId: integer (int32)
  Default Value: 1

  Value that detemines if the rules are created for spend classification or another product.
• KnowledgebaseScope: string
  Maximum Length: 30

  Value that indicates if a rule is applicable to all or specific knowledge bases.
• LastUsedDate: string (date-time)
  Date when the rule was most recently applied to the classification process.
• ruleConditions: array Rule Conditions
  Title: Rule Conditions

  The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.
• RuleConditionType: string
  Maximum Length: 30

  Type of the rule condition.
• RuleName: string
  Maximum Length: 200

  Name of the rule.
• RuleSequence: integer (int64)
  Number that indicates the sequence in which rules are applied to the classification process.
• RuleType: string
  Maximum Length: 30

  Type of the rule.
• StartDate: string (date)
  Date when the rule becomes active.
• StopRule: string
  Maximum Length: 3

  Value that determines if all applicable rules should be processed or if the classification process should stop after the first rule is applied.

{
    "type":"object",
    "properties":{
        "KnowledgebaseScope":{
            "maxLength":"30",
            "type":"string",
            "description":"Value that indicates if a rule is applicable to all or specific knowledge bases.",
            "nullable":true
        },
        "Description":{
            "maxLength":"2000",
            "type":"string",
            "description":"Description of the rule.",
            "nullable":true
        },
        "ActionType":{
            "maxLength":"30",
            "type":"string",
            "description":"Type of action taken on the rule.",
            "nullable":true
        },
        "ApplicableKnowledgebases":{
            "maxLength":"1000",
            "type":"string",
            "description":"List of knowledge bases to which a rule is applicable.",
            "nullable":true
        },
        "RuleType":{
            "maxLength":"30",
            "type":"string",
            "description":"Type of the rule.",
            "nullable":false
        },
        "RuleConditionType":{
            "maxLength":"30",
            "type":"string",
            "description":"Type of the rule condition.",
            "nullable":true
        },
        "EndDate":{
            "type":"string",
            "description":"Date when the rule becomes inactive.",
            "format":"date",
            "nullable":true
        },
        "AssignmentTypeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the type of assignment.",
            "nullable":true
        },
        "DatasetsScope":{
            "maxLength":"30",
            "type":"string",
            "description":"Value that indicates if a rule is applicable to all or specific data sets.",
            "nullable":true
        },
        "RuleSequence":{
            "type":"integer",
            "description":"Number that indicates the sequence in which rules are applied to the classification process.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            }
        },
        "AssignToAttributeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the attribute whose value is assigned to another attribute.",
            "nullable":true
        },
        "StartDate":{
            "type":"string",
            "description":"Date when the rule becomes active.",
            "format":"date",
            "nullable":true
        },
        "EntityId":{
            "type":"integer",
            "description":"Value that detemines if the rules are created for spend classification or another product.",
            "format":"int32",
            "nullable":true,
            "default":"1",
            "x-hints":{
                "precision":"9"
            }
        },
        "LastUsedDate":{
            "type":"string",
            "description":"Date when the rule was most recently applied to the classification process.",
            "format":"date-time",
            "nullable":true
        },
        "ActionOnAttributeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the attribute on which the action is taken.",
            "nullable":true
        },
        "AssignToConstant":{
            "maxLength":"100",
            "type":"string",
            "description":"Value that indicates that a constant value is assigned to another attribute.",
            "nullable":true
        },
        "StopRule":{
            "maxLength":"3",
            "type":"string",
            "description":"Value that determines if all applicable rules should be processed or if the classification process should stop after the first rule is applied.",
            "nullable":true
        },
        "ApplicableDatasets":{
            "maxLength":"1000",
            "type":"string",
            "description":"List of data sets to which a rule is applicable.",
            "nullable":true
        },
        "ruleConditions":{
            "title":"Rule Conditions",
            "type":"array",
            "description":"The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.",
            "items":{
                "$ref":"#/components/schemas/spendClassificationRules-ruleConditions-item-patch-request"
            }
        },
        "RuleName":{
            "maxLength":"200",
            "type":"string",
            "description":"Name of the rule.",
            "nullable":false
        }
    }
}

Nested Schema : Rule Conditions

Type: array

Title: Rule Conditions

The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.

Show Source

• Array of: object spendClassificationRules-ruleConditions-item-patch-request

{
    "title":"Rule Conditions",
    "type":"array",
    "description":"The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.",
    "items":{
        "$ref":"#/components/schemas/spendClassificationRules-ruleConditions-item-patch-request"
    }
}

Nested Schema : spendClassificationRules-ruleConditions-item-patch-request

Type: object

Show Source

• AttributeCode: string
  Maximum Length: 100

  Abbreviation that indicates the attribute used to define a condition.
• OperatorCode: string
  Maximum Length: 30

  Abbreviation that indicates the operator used to define a condition.
• Value: string
  Maximum Length: 2000

  Value that indicates the string used to define the condition.

{
    "type":"object",
    "properties":{
        "Value":{
            "maxLength":"2000",
            "type":"string",
            "description":"Value that indicates the string used to define the condition.",
            "nullable":true
        },
        "AttributeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the attribute used to define a condition.",
            "nullable":true
        },
        "OperatorCode":{
            "maxLength":"30",
            "type":"string",
            "description":"Abbreviation that indicates the operator used to define a condition.",
            "nullable":true
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The following table describes the default response for this task.

Headers

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Body ()

Root Schema : spendClassificationRules-item-response

Type: object

Show Source

• ActionOnAttribute: string
  Read Only: true

  Maximum Length: 80

  Value that indicates the attribute on which the action is taken.
• ActionOnAttributeCode: string
  Maximum Length: 100

  Abbreviation that indicates the attribute on which the action is taken.
• ActionType: string
  Maximum Length: 30

  Type of action taken on the rule.
• ActivityClassification: string
  Read Only: true

  Maximum Length: 2000

  Category name that is used for invoice classification to calculate carbon emissions.
• ApplicableDatasets: string
  Maximum Length: 1000

  List of data sets to which a rule is applicable.
• ApplicableKnowledgebases: string
  Maximum Length: 1000

  List of knowledge bases to which a rule is applicable.
• AssignmentType: string
  Read Only: true

  Maximum Length: 80

  Type of the assignment.
• AssignmentTypeCode: string
  Maximum Length: 100

  Abbreviation that indicates the type of assignment.
• AssignToAttribute: string
  Read Only: true

  Maximum Length: 80

  Value that indicates the attribute whose value is assigned to another attribute.
• AssignToAttributeCode: string
  Maximum Length: 100

  Abbreviation that indicates the attribute whose value is assigned to another attribute.
• AssignToConstant: string
  Maximum Length: 100

  Value that indicates that a constant value is assigned to another attribute.
• DatasetsScope: string
  Maximum Length: 30

  Value that indicates if a rule is applicable to all or specific data sets.
• Description: string
  Maximum Length: 2000

  Description of the rule.
• EndDate: string (date)
  Date when the rule becomes inactive.
• EntityId: integer (int32)
  Default Value: 1

  Value that detemines if the rules are created for spend classification or another product.
• KnowledgebaseScope: string
  Maximum Length: 30

  Value that indicates if a rule is applicable to all or specific knowledge bases.
• LastUsedDate: string (date-time)
  Date when the rule was most recently applied to the classification process.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• ruleConditions: array Rule Conditions
  Title: Rule Conditions

  The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.
• RuleConditionType: string
  Maximum Length: 30

  Type of the rule condition.
• RuleId: integer (int64)
  Value that uniquely identifies the rule.
• RuleName: string
  Maximum Length: 200

  Name of the rule.
• RuleSequence: integer (int64)
  Number that indicates the sequence in which rules are applied to the classification process.
• RuleType: string
  Maximum Length: 30

  Type of the rule.
• StartDate: string (date)
  Date when the rule becomes active.
• Status: string
  Read Only: true

  Maximum Length: 1

  Status of the rule.
• StopRule: string
  Maximum Length: 3

  Value that determines if all applicable rules should be processed or if the classification process should stop after the first rule is applied.

{
    "type":"object",
    "properties":{
        "KnowledgebaseScope":{
            "maxLength":"30",
            "type":"string",
            "description":"Value that indicates if a rule is applicable to all or specific knowledge bases.",
            "nullable":true,
            "x-queryable":true
        },
        "Description":{
            "maxLength":"2000",
            "type":"string",
            "description":"Description of the rule.",
            "nullable":true,
            "x-queryable":true
        },
        "ActionType":{
            "maxLength":"30",
            "type":"string",
            "description":"Type of action taken on the rule.",
            "nullable":true,
            "x-queryable":true
        },
        "RuleId":{
            "type":"integer",
            "description":"Value that uniquely identifies the rule.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "ApplicableKnowledgebases":{
            "maxLength":"1000",
            "type":"string",
            "description":"List of knowledge bases to which a rule is applicable.",
            "nullable":true,
            "x-queryable":true
        },
        "AssignToAttribute":{
            "maxLength":"80",
            "type":"string",
            "description":"Value that indicates the attribute whose value is assigned to another attribute.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "AssignmentTypeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the type of assignment.",
            "nullable":true,
            "x-queryable":true
        },
        "DatasetsScope":{
            "maxLength":"30",
            "type":"string",
            "description":"Value that indicates if a rule is applicable to all or specific data sets.",
            "nullable":true,
            "x-queryable":true
        },
        "RuleSequence":{
            "type":"integer",
            "description":"Number that indicates the sequence in which rules are applied to the classification process.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "AssignToAttributeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the attribute whose value is assigned to another attribute.",
            "nullable":true,
            "x-queryable":true
        },
        "StartDate":{
            "type":"string",
            "description":"Date when the rule becomes active.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "ActionOnAttributeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the attribute on which the action is taken.",
            "nullable":true,
            "x-queryable":true
        },
        "AssignToConstant":{
            "maxLength":"100",
            "type":"string",
            "description":"Value that indicates that a constant value is assigned to another attribute.",
            "nullable":true,
            "x-queryable":true
        },
        "ApplicableDatasets":{
            "maxLength":"1000",
            "type":"string",
            "description":"List of data sets to which a rule is applicable.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "RuleName":{
            "maxLength":"200",
            "type":"string",
            "description":"Name of the rule.",
            "nullable":false,
            "x-queryable":true
        },
        "Status":{
            "maxLength":"1",
            "type":"string",
            "description":"Status of the rule.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "ActionOnAttribute":{
            "maxLength":"80",
            "type":"string",
            "description":"Value that indicates the attribute on which the action is taken.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "RuleType":{
            "maxLength":"30",
            "type":"string",
            "description":"Type of the rule.",
            "nullable":false,
            "x-queryable":true
        },
        "RuleConditionType":{
            "maxLength":"30",
            "type":"string",
            "description":"Type of the rule condition.",
            "nullable":true,
            "x-queryable":true
        },
        "EndDate":{
            "type":"string",
            "description":"Date when the rule becomes inactive.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "ActivityClassification":{
            "maxLength":"2000",
            "type":"string",
            "description":"Category name that is used for invoice classification to calculate carbon emissions.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "EntityId":{
            "type":"integer",
            "description":"Value that detemines if the rules are created for spend classification or another product.",
            "format":"int32",
            "nullable":true,
            "default":"1",
            "x-hints":{
                "precision":"9"
            },
            "x-queryable":true
        },
        "LastUsedDate":{
            "type":"string",
            "description":"Date when the rule was most recently applied to the classification process.",
            "format":"date-time",
            "nullable":true,
            "x-queryable":true
        },
        "StopRule":{
            "maxLength":"3",
            "type":"string",
            "description":"Value that determines if all applicable rules should be processed or if the classification process should stop after the first rule is applied.",
            "nullable":true,
            "x-queryable":true
        },
        "AssignmentType":{
            "maxLength":"80",
            "type":"string",
            "description":"Type of the assignment.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "ruleConditions":{
            "title":"Rule Conditions",
            "type":"array",
            "description":"The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.",
            "items":{
                "$ref":"#/components/schemas/spendClassificationRules-ruleConditions-item-response"
            }
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : Rule Conditions

Type: array

Title: Rule Conditions

The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.

Show Source

• Array of: object spendClassificationRules-ruleConditions-item-response

{
    "title":"Rule Conditions",
    "type":"array",
    "description":"The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.",
    "items":{
        "$ref":"#/components/schemas/spendClassificationRules-ruleConditions-item-response"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string
  Title: hyperlink reference

  The URI to the related resource.
• kind: string
  Title: kind

  Allowed Values: [ "collection", "item", "describe", "other" ]

  The kind of the related resource.
• name: string
  Title: name

  The name of the link to the related resource.
• properties: object properties
• rel: string
  Title: relation

  Allowed Values: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

  The name of the relation to the resource instance. Example: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Nested Schema : spendClassificationRules-ruleConditions-item-response

Type: object

Show Source

• AttributeCode: string
  Maximum Length: 100

  Abbreviation that indicates the attribute used to define a condition.
• AttributeValue: string
  Read Only: true

  Maximum Length: 80

  Value that indicates the attribute used to define a condition.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• OperatorCode: string
  Maximum Length: 30

  Abbreviation that indicates the operator used to define a condition.
• OperatorValue: string
  Read Only: true

  Maximum Length: 80

  Value that indicates the operator used to define a condition.
• RuleConditionId: integer
  Value that uniquely identifies the rule condition.
• Value: string
  Maximum Length: 2000

  Value that indicates the string used to define the condition.

{
    "type":"object",
    "properties":{
        "AttributeCode":{
            "maxLength":"100",
            "type":"string",
            "description":"Abbreviation that indicates the attribute used to define a condition.",
            "nullable":true,
            "x-queryable":true
        },
        "AttributeValue":{
            "maxLength":"80",
            "type":"string",
            "description":"Value that indicates the attribute used to define a condition.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "RuleConditionId":{
            "type":"integer",
            "description":"Value that uniquely identifies the rule condition.",
            "nullable":false,
            "x-queryable":true
        },
        "Value":{
            "maxLength":"2000",
            "type":"string",
            "description":"Value that indicates the string used to define the condition.",
            "nullable":true,
            "x-queryable":true
        },
        "OperatorCode":{
            "maxLength":"30",
            "type":"string",
            "description":"Abbreviation that indicates the operator used to define a condition.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "OperatorValue":{
            "maxLength":"80",
            "type":"string",
            "description":"Value that indicates the operator used to define a condition.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Links

ruleConditions

Operation: /fscmRestApi/resources/11.13.18.05/spendClassificationRules/{RuleId}/child/ruleConditions

Parameters:

• RuleId: $request.path.RuleId

The Rule Conditions resource manages the conditions for rules in Oracle Fusion Spend Classification Cloud.

Back to Top

Examples

This example describes how to update rule properties.

Example cURL Command

Use the following cURL command to submit a request on the REST resource.

curl -u user:password -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -X PATCH -d 'request payload' https://servername/fscmRestApi/resources/11.13.18.05/spendClassificationRules/{RuleId}

Example Request Body

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

"{
    ""StartDate"": ""2021-03-01"",
    ""EndDate"": ""2021-04-01"",
}"

Example Response Body

The following example includes the contents of the response body in JSON format:

"{
    ""RuleId"": 4006,
    ""RuleName"": ""RuleTATA1053"",
    ""Description"": ""RuleTATA10445"",
    ""RuleType"": ""POST"",
    ""Status"": null,
    ""StartDate"": ""2021-02-01"",
    ""EndDate"": ""2021-03-01"",
    ""LastUsedDate"": null,
    ""ActionType"": ""EXCLUDE"",
    ""ActionOnAttributeCode"": ""ORA_POI_ITEM_CODE"",
    ""ActionOnAttribute"": null,
    ""AssignmentTypeCode"": ""CONSTANT"",
    ""AssignmentType"": null,
    ""AssignToAttributeCode"": null,
    ""AssignToAttribute"": null,
    ""AssignToConstant"": ""AS18940"",
    ""DatasetsScope"": ""LIST"",
    ""ApplicableDatasets"": ""TATAPOSET1"",
    ""KnowledgebaseScope"": ""LIST"",
    ""ApplicableKnowledgebases"": ""TATAKWP01"",
    ""RuleSequence"": 278,
    ""RuleConditionType"": ""ALL"",
 ""links"" : [ {
  ...
 } ]
}"

Back to Top