Update a score definition

put/definitions/{definitionId}

Updates the specified score definition based on the representation in the request body.

Request Samples

Response Samples


1{
2  "createdBy": "sasdemo",
3  "creationTimeStamp": "2021-09-18T03:20:14.136294Z",
4  "id": "2e585929-9334-4db9-9f52-2dbc01fc6d0f",
5  "inputData": {
6    "type": "CASTable",
7    "serverName": "cas-shared-default",
8    "libraryName": "Public",
9    "tableName": "HMEQ_EN"
10  },
11  "links": [
12    {
13      "method": "GET",
14      "rel": "up",
15      "href": "/scoreDefinitions/definitions",
16      "uri": "/scoreDefinitions/definitions",
17      "type": "application/vnd.sas.collection"
18    },
19    {
20      "method": "GET",
21      "rel": "self",
22      "href": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f",
23      "uri": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f",
24      "type": "application/vnd.sas.score.definition"
25    },
26    {
27      "method": "GET",
28      "rel": "alternate",
29      "href": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f",
30      "uri": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f",
31      "type": "application/vnd.sas.summary"
32    },
33    {
34      "method": "DELETE",
35      "rel": "delete",
36      "href": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f",
37      "uri": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f"
38    },
39    {
40      "method": "PUT",
41      "rel": "update",
42      "href": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f",
43      "uri": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f",
44      "type": "application/vnd.sas.score.definition",
45      "responseType": "application/vnd.sas.score.definition"
46    },
47    {
48      "method": "POST",
49      "rel": "mappedCode",
50      "href": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f/mappedCode",
51      "uri": "/scoreDefinitions/definitions/2e585929-9334-4db9-9f52-2dbc01fc6d0f/mappedCode",
52      "type": "application/vnd.sas.score.code.generation.request",
53      "responseType": "application/vnd.sas.score.mapped.code"
54    }
55  ],
56  "mappings": [
57    {
58      "variableName": "findAllRetCode",
59      "mappingType": "datasource",
60      "mappingValue": "MORTDUE"
61    },
62    {
63      "variableName": "itemCount",
64      "mappingType": "datasource",
65      "mappingValue": "LOAN"
66    },
67    {
68      "variableName": "fired",
69      "mappingType": "datasource",
70      "mappingValue": "JOB"
71    }
72  ],
73  "modifiedBy": "sasdemo",
74  "modifiedTimeStamp": "2021-09-18T03:20:14.136294Z",
75  "name": "Code_file_9130_Test_1",
76  "objectDescriptor": {
77    "name": "Code_file_9130",
78    "type": "codeFile",
79    "uri": "http://decisions/codeFiles/5f7a0523-5fd8-4cba-90d1-a6971f12d220/revisions/2c99a55e-e4c9-4518-8f54-918ffc18c9a7"
80  },
81  "properties": {
82    "outputLibraryName": "Public",
83    "outputServerName": "cas-shared-default",
84    "tableBaseName": "Code_file_9130_Test_1_Code_file_9130",
85    "test": "true",
86    "version": "1.0"
87  },
88  "version": 2
89}

Path Parameters

Name	Type	Required	Description
definitionId	string	true	The unique identifier for the score definition.

Header Parameters

Name	Type	Required	Description
If-Match	string	true	The entity tag obtained from the most recent `ETag` response header. Must match the current entity tag for the score definition.

Request Body

The representation of a score definition.

A definition containing details about Input Data, Score Object and Mapping. This represents application/vnd.sas.score.definition media type (version 1).

Name	Type	Required	Description
id	string	false	The system-assigned unique ID for this object
name	string	true	The score definition name
description	string	false	The score definition description
createdBy	string	false	The user who created the score definition.
creationTimeStamp	string<date-time>	false	The date and time that the score definition was created.
modifiedBy	string	false	The userId of the authenticated user who last updated the score definition.
modifiedTimeStamp	string<date-time>	false	The date and time that the score definition was last modified.
preprocessingCode	string	false	Preprocessing code that is executed before executing the Mapped Code.
objectDescriptor	Object Descriptor	true	Descriptor of a Score Object whose logic is used to produce a score for Input Data. This doesn't represent any top-level media type.
inputData	Input Data	true	Input Data that will be scored. This doesn't represent any top-level media type.
mappings	array [Mapping]	false	Array of mappings between Score Object variables and Input Data columns.
properties	object	false	The properties for this score definition that support scoring for decisions and business rules. outputServerName: The name of a Cloud Analytic Server. outputLibraryName: The name of a Cloud Analytic Server library. tableBaseName: The name of a table in the output library. test: A flag that indicates whether the score definition is used for test scoring. Valid values are "true" and "false". These additional properties support publish validation for decisions and business rules. asssetUri: The URI of the decision or business rule that is being validated. publishDestination: The name of a publish destination. publishType: The type of publish destination. publishName: The name for publishing the asset.
folderType	string	false	Indicates the kind of folder where the score definition is housed.
links	array [Link]	false	Zero or more links to related resources or operations.
version	integer	false	This media type's schema version number. This representation is version 2.

Responses

Status	Meaning	Description
200	OK	The request succeeded.	Headers	Schema
400	Bad Request	The request was invalid.		Schema
404	Not Found	No score definition exists at the requested path.		Schema
412	Precondition Failed	The `If-Match` request header did not match the resource's entity tag.		Schema
428	Precondition Required	The request headers did not include a `If-Match` precondition.		Schema