Manage and publish models; decision flows and business rule management

models_and_decisions

2024.09

The Decisions API supports the life cycle of decision data.

Decisions

2024.03

2024.06

2024.07

2024.08

2023.10

2023.03

2022.09

Viya_35

Retrieves the legacy variables of the decision, which can be added back to the decision.

Used for selecting the desired item representation.

Accept-Item

decisionId

The criteria for filtering the decision legacy variables. See [Filtering in REST APIs](https://developer.sas.com/rest-apis/decisions/docs/getting-started/usage-notes#filtering).

filter

The criteria for sorting the decision legacy variables. See [Sorting in REST APIs](https://developer.sas.com/rest-apis/decisions/docs/getting-started/usage-notes#sorting).

sortBy

The starting index of the first item in a page. The index is
0-based. The default is 0.


start

The maximum number of items to return in this page of results.
The actual number of returned items might be less if the collection has
been exhausted. The default is 10.


limit

Decision variables related to a decision flow.

A collection of variables for a decision.

Decision Variable Collection

Indicates whether the response is coming from a SAS service.

Sas-Service-Response-Flag

Error

application/vnd.sas.error

No decision exists at the requested path.

Get legacy Variables of decision

One page of the objects as resource summary representations, with optional links to the first, previous, next, and last page of the list.

Resource Summary Collection

One page of the objects as revision summary representations, with optional links to the first, previous, next, and last page of the list.

Revision Summary Collection

A paginated list of decision representations, with optional links to first, prev, next, and last page of the collection.

Decision Collection

A collection of decision node reference objects.

Decision Node Reference Object Collection

Contains the details about the external artifact.

External Artifact

A collection of external artifact representations.

External Artifacts Collection

One page of decision representations, with optional links to first, prev, next, and last page of the collection.

Code File Collection

A paginated list of segmentation tree representations, with optional links to the first, previous, next, and last page of the collection.

Segmentation Tree Collection

A collection of validation errors for a decision.

Decision Validation Errors Collection

A paginated list of decision node type representations, with optional links to first, prev, next, and last page of the collection.

Decision Node Types Collection

An un-paginated list of term usage summaries.

Term Usage Summary Collection

A collection of error markers for a decision scoring test.

Decision Error Marker Collection

An un-paginated list of tag merge decision components.

Tag Merge Decision Component Collection

The object contains an unpaginated list of URIs of the direct dependents of this resource. A resource can be a decision or a code file.

Direct Dependent Objects

A paginated list of decision type representations, with optional links to first, prev, next, and last page of the collection.

Decision Type Collection

The error reported from CAS while validating the expression.

CAS Error from Expression Validation

The response from validating the expression.

Decision Expression Validation Response

Executable code generated by a score object using a score definition and input data. This represents application/vnd.sas.score.mapped.code media type (version 1).

Mapped Code

The representation of a rule set, model, treatment group, code file, or sub-decision used in a decision flow, including those used by sub-decisions.

Decision Node Reference Object

The summarized representation of a resource. Often used in collection responses when more specific details aren't needed.

Resource Summary

Wrapper to file resource, which contains the signature of the code. This represents application/vnd.sas.decision.code.file media type (version 9).


Code File

The list of links to top-level resources and operations available from the root of the API.

Represents where an error occurred during execution of a decision scoring test.

Decision Error Marker

Contains information needed to extend the decision flow with a new node type

Decision Node Type

A summary representation of a term and it's usage.

Term Usage Summary

Contains information needed to extend the decision flow with a new node type including the decision node type's signature and provision for acquiring decision step code for the associated decision node type.

Decision Node Type Content

A decision type modifies the available functionality that can be used to build a decision. 
Currently it controls the available decision node types that can be used to build a decision.


Decision Type

Request containing hints to generate Analysis Code using the Scoring Execution. This represents application/vnd.sas.dcm.score.analysis.code.generation.request media type (version 1).

Analysis Code Generation Request

The summarized representation of a decisioning revision resource.

Revision Resource Summary

Contains information about an expression to be validated. The expression may contain literals, terms, built in functions and custom functions.

Decision Expression Validation Request

This is a base schema used to define paginated collections of resources. This base schema is extended by other schemas in APIs by adding an 'items' array property. These extensions define the application/vnd.sas.collection media type (version 2)

Base Collection

Represents a term that is used for a condition comparison within a decision.

Decision Condition Term

Represents an individual decision component to be included in a tag based merge.

Tag Merge Decision Component

The representation of a segmentation tree.

Segmentation Tree

A code file that accepts its code as a property. This represents
application/vnd.sas.decision.code.file.with.code media type (version 1).

This variant of code file is useful for creating a code file revision without
managing the creation of the underlying file resources used to store the code.


Analysis Code generated by a Score Object using Score Execution. This represents application/vnd.sas.score.analysis.code media type (version 1).

Analysis Code

Request containing hints and mappings to generate Mapped Code not bound to a score definition.

Unbound Code Generation Request

Decision Validation Error

Request containing hints to generate mapped code using the Scoring Definition by Score Object.

Score Code Generation Request

Decision

Contains the structure of code that is needed to generate the decision code.

Decision Step Code

Code File Signature Term

Segmentation Tree Boolean Expression Node

Segmentation Tree Matrix Node

Segmentation Tree Variable Node

Decision Flow

Represents the revision for the component that has the specified tags associated with it

Tag Merge Component Revision Reference

Outcome contains actions to assign values to variables.

Segmentation Tree Outcome

Represents a term that is used within a segmentation tree.

Segmentation Tree Signature Term

Signature term extension is used to store the column information of a data grid variable.

Signature Term Extension

Two dimensional array with down and across variable values with their intersection outcomes.

Segmentation Tree Matrix

Named boolean expression which evaluates to a boolean value.

Segmentation Tree Boolean Expression

The representation of a decision, which may be the parent or a sub-decision, that references a specific decision node reference object.

Referencing Decision

Assigning Input Data column to a variable of the generated Mapped Code of Score Object. This doesn't represent any top-level media type.

Mapping

A link to a related operation or resource.

Link

Terms that are a part of the signature for the object that is used in a decision step.

Decision Step Code Signature Term

Represents an error that occurred during execution of a decision scoring test

Decision Error Marker Message

Code file which is internal to the segmentation tree

Segmentation Tree Internal Code File

Represents the parent decision associated with the decision component

Tag Merge Component Parent Decision

Decision Model Step

Decision Record Contact Step

Represents a branch decision flow step. A branch step contains a list of branchCases and a defaultCase. During the execution of a branch step each branchCases condition is evaluated in order. The decision flow will follow the first branchCases condition that evaluates as true. If a branchCases condition does not evaluate as true, then the defaultCase path for the branchStep is followed.

Decision Branch Step

Decision Condition Step

Outcome action in which a variable is assigned a value

Segmentation Tree Variable Assignment Outcome Action

Code File Signature Term DataGrid Extension is used to store the column information of a DataGrid variable.

Code File Signature Term DataGrid Extension

Outcome action in which a specified code is executed to assign values to variables.

Segmentation Tree Code Assignment Outcome Action

Segmentation Tree Value Node

Decision Custom Object Step

Decision Step Code Signature Term DataGrid Extension is used to store the column information of a DataGrid variable.

Decision Step Code Signature Term DataGrid Extension

Decision Rule Set Step

Represents a link within a decision flow, which directs the execution flow of the decision to an arbitrary node based on the linkLabel of the target node.

Node Link Decision Step

Represents the mapping between the terms input and output by a decision step and the signature entries of the decision.

Decision Step Mapping

Represents the user specifying that contact information should be recorded at this step within the flow and details that should be recorded.

Record Decision Contact Step

Specifies the rule set that is being referenced for this step. Required if type is set to 'application/vnd.sas.decision.step.ruleset'.

Rule Set Decision Step

Represents a step containing a custom implemented step within the decision flow. Treatment groups, code files, and other decisions can be referenced using a custom object step.

Custom Object Decision Step

Represents a single case within a branch step of a decision flow. A case can contain a simpleCondition or compoundCondition, but not both.

Decision Case

Represents a model be referenced as a step within a decision flow.

Model Decision Step

Represents a condition step within a decision flow.

Represents a term that is being recorded for auditing purposes during contact recording.

Audit Term

Represents a simple condition.  The left hand side (lhs), right hand side (rhs) and operator of the condition are evaluated to produce a boolean result of "true" or "false".  The left hand side may be a variable or an experssion.

Decision Simple Branch Condition

Represents a compound condition.  The left hand side (lhs), right hand side (rhs) and operator of the condition are evaluated to produce a boolean result of "true" or "false".  A compound condition has a left hand side (lhsSimpleCondition or lhsCompoundCondition) a right hand side (rhsSimpleCondition or rhsCompoundCondition) and a boolean operator.

Status	Meaning	Description
200	OK	The request succeeded.	Headers	Schema
404	Not Found	No decision exists at the requested path.	Headers	Schema

Get legacy Variables of decision

Request Samples

Response Samples

Path Parameters

Query Parameters

Header Parameters

Responses

Name	Type	Required	Description
filter	string<filter-criteria>	false	The criteria for filtering the decision legacy variables. See Filtering in REST APIs. Examples: "gt(modifiedTimeStamp, '2021-05-03T15:38:45.654Z')"
limit	integer	false	The maximum number of items to return in this page of results. The actual number of returned items might be less if the collection has been exhausted. The default is 10. Examples: 500
sortBy	string<sort-criteria>	false	The criteria for sorting the decision legacy variables. See Sorting in REST APIs. Examples: "modifiedTimeStamp:descending"
start	integer	false	The starting index of the first item in a page. The index is 0-based. The default is 0. Examples: 100