Append text or update traces from TSV

post/traces
Internal-Use Only

Appends text to the collection or updates the processorNote field of appended text. There are two types of traces: one is at the decision step boundary and other is at the variable assignment. The scope query parameter is used to specify the type of trace.

This operation processes tab-separated-values (TSV) text with a case-insensitive header row that specifies the order of these required columns:

The text column value must not include the TAB character.

The text column contains whole or part of a decision trace.

The value of the action column is either append or update.

When the POST call is used to append text to the collection, all the above columns except the processorNote column must be given non-empty values.

When the POST call is used to update text to the collection, the only column that can be changed is the processorNote column. The traceId column must have a value for the service to know which execution trace to update. Since a trace has one or more rows, the seqNo column is normally left empty so that all rows of the trace receive the same processorNote value. The other columns (traceTimeStamp, objectUri, text) should be left empty. If values are specified for these columns, they are ignored since they cannot be changed. Here is the order that the columns for updated:

Request Samples

1

Response Samples

1{
2  "part1": {
3    "contentType": "text/csv; charset=\"utf-8\"",
4    "contentId": "Accepted-CSV",
5    "body": "3d4120b3-1fe7-4fce-b333-0ae1b93aa03c,The record with the trace ID \"3d4120b3-1fe7-4fce-b333-0ae1b93aa03c\" is updated."
6  },
7  "part2": {
8    "contentType": "text/csv; charset=\"utf-8\"",
9    "contentId": "Rejected-CSV",
10    "body": ""
11  },
12  "part3": {
13    "contentType": "text/csv; charset=\"utf-8\"",
14    "contentId": "Global-Issue",
15    "body": ""
16  }
17}

Query Parameters

NameTypeRequiredDescription
scope
string
false

The type of traces.

Allowed values:
assignmentstep
Default:
step

Header Parameters

NameTypeRequiredDescription
Accept
string
true

In addition to multipart/mixed, also include application/vnd.sas.error+json in the Accept header. The two media types are separated by a comma. If there is a processing error, the error is reported in a JSON error object. In that case, without this arrangement, since the client is expecting only a response of multipart/mixed type, the server uses Http status of 406 to tell the client that it cannot match the expectation because a JSON error object cannot be mapped into a multipart/mixed response. By also accepting application/vnd.sas.error+json, this is avoided.

Allowed value:
multipart/mixed, application/vnd.sas.error+json

Request Body

The tap-separated-values that contains a header row.

Responses

StatusMeaningDescription
200OKThe request succeeded. One or more rows of text are appended. Check the response for any error.Schema
400Bad RequestThe request was invalid.Schema