Rule Sets

Create a new revision

Creates a new revision for the rule set. With this request, you supply the content that you want to initialize for a new revision.

ruleSetIdstring required

The rule set ID.

revisionType'major' | 'minor'

Valid values are major or minor. This value determines how the server generates the major and minor numbers. If a major number is provided, the next available major version number is started. For example, if the rule set has revisions 1.0, 1.1, 1.2, 2.0, and 2.1, creating a new major revision results in 3.0. If a minor number is provided, then the next available minor revision number is reserved based on the existing revisions. For example, if the existing revisions have major and minor numbers of 1.1, 1.2, 1.3, 2.1, 2.2, and a user requests a new minor revision, then 2.3 is assigned. This parameter defaults to minor if not supplied.

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

This value specifies the URI of the rule set revision from which the new rule set revision 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 rule set revision was created.