Create a Data Collection Task
Create a data collection task in a Cortex XSOAR playbook.
Multi-question survey (form), responses are recorded in incident’s
context data.
The Data Collection task is a multi-question
survey (form), which recipients access from a link in the message.
The survey resides on an external site that does not require authentication,
allowing survey recipients to respond without restriction.
All
responses are collected and recorded in the incident's context data,
whether you receive responses from a single user or multiple users.
This enables you to use the survey questions and answers as input
for subsequent playbook tasks.
You can include the following
types of questions in the survey:
- Stand alone questions. These are presented to users directly in the message, and from which users answer directly in the message (not an external survey).
- Field-based questions. These are based on a specific Cortex XSOAR field (either system or custom), for example, a Grid field. The response (data) received for these fields automatically populates the field for this incident in Cortex XSOAR. For single select field based questions, theuse first as defaultdefinition is taken from the field’s matching attribute.
You
can collect responses in custom fields, for example, a Grid field.
If responses are received from multiple users,
data for multi-select fields and grid fields are aggregated. For
all other field types, the most recent received response will override
previous responses as it displays in the field. All responses are
always viewable in the context data.
If the playbook
was installed from a Content Pack, duplicate or detach the
playbook, before creating a data collection task.
- In a playbook, click+(Create Task).
- Select theData Collectionoption.
- Enter a meaningful name in the Task Name field for the task that corresponds to the data you are collecting.
- In the Ask by option, select how the message or survey will appear to users and how the message or survey will be sent.
- If you select email, enter the subject and message of the email and the email addresses of the users who should receive this message or survey.
- If you do not select email, this will be a task. Enter the task message.
The survey does not appear in the message. A link to the survey is automatically placed at the bottom of the message.
- Enter the questions and answer types that the survey will contain.You create questions in the survey, you can drag-and-drop questions to rearrange the order in which they display in the survey.
- OptionalTo customize the look and feel of your email message, clickPreview.You can determine the color scheme and how text in the message header and body appear, as well as the appearance and text of the button the user clicks to submit the survey.
