Creates, reads, updates, and deletes reports and report states

visualization_and_reports

2022.09

2023.10

2023.03

2024.09

2024.10

2024.08

2024.03

2024.07

This API creates and manipulates "transforms" of SAS reports that conform to the Business Intelligence Report Definition (BIRD)  specification. A transform is a wrapper for a BIRD report. When a transform is part of a request, it contains instructions and parameters to perform an editing action or structural modification to the report. When a transform is part of a response, it describes the action or modification that was performed or attempted. The response transform  contains either the BIRD report directly, or it has a reference to a persistent report. All GET operations have a corresponding HEAD that is identical in all respects, except that a response body is not returned.

Report Transforms

Viya_35

Pre-flight validation of the PUT operation, which would update the internal localization strings of an existing report. Always returns HTTP response 200 unless a server error prevents the actual validation logic from being executed.

Prior to version 2, this was not an object. Instead, it was serialized as lines of user-editable plain text. When serialized as text, the first line is the locale indicator, and the subsequent lines have the form `proprietary path identifiers = translatable text`.

The body of the request is a string translation worksheet.

ETag identifier from last GET of the report.

If-Match

The id of the report that would have its localization be updated by the PUT operation.

reportId

The response from a pre-flight validation request. For APIs which support validation, the client can run operations (typically on resources in the `/commons/validation`) with `application/vnd.sas.validation+json` as the requested response type (via the `Accept:` request header). The service will validate the request but not execute the request, and return this response to indicate if the request was valid at the time it was made.

Validation Response

application/vnd.sas.validation

Except for unusual server problems, this will always be returned. However, the validation will contain information about errors that would happen if the PUT were actually called, as shown by the additional errors.

Content-Type

Current content ETag for the report to be modified. Use for subsequent PUT operation.

ETag

Bad request. The response object will contain an error code and further information.

Error

application/vnd.sas.error

The request was invalid. Some error in the request resulted in failure to perform the action. See the error codes table for further details.

The header If-Match Etag value does not match.

The If-Match head ETag did not match current report.

Validate conditional put operations

The tranform is the primary payload in this service, for both requests and responses. Depending on the operation, some fields are required. For example, if the report to transform is a saved report, the `inputReportUri` field is required. Otherwise, the input report is in the body of request (in the transform) and `reportContent` is required.

transform

A report content that is the equivalent of the application/vnd.sas.report.content media type.  The report content is defined by a non-public XML Schema. The structure shown here is an abbreviation showing only a few of the descriptive attributes of the object.

sasReport

A data source that is used in a data mapping operation in a report.

dataSource

A message for the user with an associated error or warning code.

codedMessage

translationWorksheet

A link to a related operation or resource.

Link

The representation of a report. This representation is version 1.

report

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

Name	Type	Required	Description
locale	string	false	A valid IETF language tag.
lines	array [string]	false	Individual lines with translatable strings. Each line has a substructure of `identifier=value`, where the value part is what should be translated.
links	array [Link]	false	Link objects, as described in SAS standards documentation.
version	integer	false	Standard field. This media type's schema version number. This representation is version 1.

Status	Meaning	Description
200	OK	Except for unusual server problems, this will always be returned. However, the validation will contain information about errors that would happen if the PUT were actually called, as shown by the additional errors.	Headers	Schema
400	Bad Request	The request was invalid. Some error in the request resulted in failure to perform the action. See the error codes table for further details.	Headers	Schema
412	Precondition Failed	The header If-Match Etag value does not match.	Headers	Schema
428	Precondition Required	The If-Match head ETag did not match current report.	Headers	Schema

Validate conditional put operations

Request Samples

Response Samples

Path Parameters

Header Parameters

Request Body

Responses