Newer Version Available

This content describes an older version of this product. View Latest

Get Assessment Response Summary

Get Assessment Response Summary makes it easy to use a flow to trigger server-side document generation using Docgen.

In Discovery Framework, the responses from an assessment are stored in the AssessmentQuestionResponse object and the form metadata stays in OmniScript. You can use this invocable action to pass assessment summary data to the downstream processes. This invocable action provides a summary JSON that can be consumed in Docgen workflows to generate documents.

The Get Assessment Response Summary invocable action takes assessment ID as the input to get the OmniProcess ID, which is used to retrieve the OmniProcess elements. The assessment ID also retrieves the assessment response and merges the response with the OmniProcess elements to create an assessment summary response in JSON.

This object is available in API version 56.0 and later.

Supported REST HTTP Methods

URI
/services/data/v56.0/actions/standard/getAssessmentResponseSummary
Formats
JSON
HTTP Methods
GET
Authentication
Authorization: Bearer token

Inputs

Input Details
assessmentId
Type
ID
Description
Required. The ID of the assessment record for which to summarize responses.

Outputs

Output Details
assessmentResponseSummary
Type
string
Description
A JSON string containing the summary assessment question texts and responses for the specified assessment record. The response summary structure follows the structure of the OmniScript.

Usage

Sample Input

When exposing the Get Assessment Response Summary invocable action in a REST API, you can use the following format to pass input, which includes the assessmentId and its value.

Sample Output

In this example, the first line indicates the OmniScript type, subtype, and language. For each step, there are multiple questions that appear in the OmniScript. You can use this information in a downstream process, such as generation of PDF document using Docgen capability.