Rule Sets

Create a rule set

Creates a new rule set.

post/ruleSets

Request

  • Base URL: https://example.com/businessRules
  • URL: https://example.com/businessRules/ruleSets
  • Auth: none declared

Query parameters

parentFolderUristring /folders/folders/{parentFolderId}

A folder in which the new rule set is placed.

fromRevisionUristring /businessRules/ruleSets/{rulesetId}/revisions/{revisionId}

This value specifies the URI of the rule set revision from which the new rule set is created. This property enables you to trace the lineage of a rule set. The valid format for this parameter is '/businessRules/ruleSets/${rulesetId}/revisions/${revisionId}'

Request body

idstring

The system-assigned unique ID for this object.

namestring required

The name of the rule set.

ruleSetType'assignment' | 'filtering' enumeration

The type of rule set. Assignment rule sets enable users to specify variable assignment actions within business rules. Filtering rule sets contain business rules that are only conditions that must be matched for the data to be retained within the resulting output. Assignment is the default if not specified.

descriptionstring

The rule set description

createdBystring

The user who created the rule set.

creationTimeStampstring date-time

The date and time that the rule set was created.

modifiedBystring

The user ID of the authenticated user who last updated the rule set.

modifiedTimeStampstring date-time

The date and time that the rule set was last modified.

majorRevisioninteger

Major version number of the revision being viewed of the rule set. This value is assigned by the service, the user only has control on whether the major number or minor number is incremented when creating a new revision. This is a derived field that is generated on PUT/POST.

minorRevisioninteger

Minor version number of the current revision of the rule set. This value is assigned by the service. The user only has control on whether the major number or minor number is incremented when creating a new revision. This is a derived field that is generated on PUT/POST.

checkoutboolean

Flag that indicates that the rule set is a user's working copy of another rule set.

lockedboolean

Flag that indicates if the content of the revision being viewed is locked or editable.

folderTypestring

Indicates the type of folder where the rule set is housed.

sourceRevisionUristring

The URI of the rule set revision this rule set is being created from.

copyTimeStampstring date-time

The time stamp when the ruleset revision was copied.

testCustomContextUristring

The URI of a Custom Context DS2 code file that provides a custom context to this rule set. The ruleset's custom context is usually provided by the decision that uses it. For syntax validation of rule expressions and for testing purposes, you can specify a testing-only custom context.

versioninteger

This media type's schema version number. This representation is version 10.

Example request

{
  "name": "Loan Score Approval",
  "signature": [
    {
      "name": "customerName",
      "dataType": "string",
      "direction": "input"
    },
    {
      "name": "creditScore",
      "dataType": "decimal",
      "direction": "input"
    },
    {
      "name": "approved",
      "dataType": "boolean",
      "direction": "output"
    }
  ]
}

Response

A folder was created.

idstring

The system-assigned unique ID for this object.

namestring required

The name of the rule set.

ruleSetType'assignment' | 'filtering' enumeration

The type of rule set. Assignment rule sets enable users to specify variable assignment actions within business rules. Filtering rule sets contain business rules that are only conditions that must be matched for the data to be retained within the resulting output. Assignment is the default if not specified.

descriptionstring

The rule set description

createdBystring

The user who created the rule set.

creationTimeStampstring date-time

The date and time that the rule set was created.

modifiedBystring

The user ID of the authenticated user who last updated the rule set.

modifiedTimeStampstring date-time

The date and time that the rule set was last modified.

majorRevisioninteger

Major version number of the revision being viewed of the rule set. This value is assigned by the service, the user only has control on whether the major number or minor number is incremented when creating a new revision. This is a derived field that is generated on PUT/POST.

minorRevisioninteger

Minor version number of the current revision of the rule set. This value is assigned by the service. The user only has control on whether the major number or minor number is incremented when creating a new revision. This is a derived field that is generated on PUT/POST.

checkoutboolean

Flag that indicates that the rule set is a user's working copy of another rule set.

lockedboolean

Flag that indicates if the content of the revision being viewed is locked or editable.

folderTypestring

Indicates the type of folder where the rule set is housed.

sourceRevisionUristring

The URI of the rule set revision this rule set is being created from.

copyTimeStampstring date-time

The time stamp when the ruleset revision was copied.

testCustomContextUristring

The URI of a Custom Context DS2 code file that provides a custom context to this rule set. The ruleset's custom context is usually provided by the decision that uses it. For syntax validation of rule expressions and for testing purposes, you can specify a testing-only custom context.

versioninteger

This media type's schema version number. This representation is version 10.

Example response

{
  "name": "Loan Score Approval",
  "signature": [
    {
      "name": "customerName",
      "dataType": "string",
      "direction": "input"
    },
    {
      "name": "creditScore",
      "dataType": "decimal",
      "direction": "input"
    },
    {
      "name": "approved",
      "dataType": "boolean",
      "direction": "output"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.