|
Node name
|
Name that identifies this node in the topic flow.
|
|
Variable name
|
Name of the variable that stores the user response to this prompt. The variable name is automatically created from the **Node name** property.
|
|
Prompt
|
Prompt or question for the user. The prompt can be either a text string or a script that returns text. This value is used only when the default value is not specified. For example: `What's your name?`
You can create rich text to alter the styling of the prompt:
- Use single asterisks or underscores for italic text. For example, `*text*` or `_text_`.
- Use double asterisks or underscores for bold text. For example, `**text**` or `__text__`.
- Use triple asterisks or underscores for italic and bold text. For example, `***text***` or `___text___`.
- Use a spaced hyphen to add a bullet point to a line. For example, `- text`.
- Use a spaced right angle bracket to create a block quote. For example, `> text`.
- Use between one and six hash marks to create headers. For example, `#text#` or `######text######`
- Use brackets and parentheses to create a hyperlink. For example, `[Link text](url)`. Add an exclamation point to a hyperlink to display an image. For example, ``
|
|
Choices
|
|
Populate choices by
|
Type of dynamic variable to be used. Select one of the following options:
- **Record**: Returns records from the table selected. The values for these options are GlideRecord objects.
- **Script**: Expression that returns an array of options.
**Note:**
For more efficient pagination return results for a large data set when using a script expression, review the following script and determine whether you want to use this script:
```
(function execute() {
var pagingUtil = new global.VirtualAgentChoicePagingUtil(null, "sys_user", null, "user_name,name",
"active=true", null, vaVars);
var gr = pagingUtil.getPagingGlideRecordSecure("name", false);
var options = pagingUtil.getSecureOptions(gr, null,'user_name', ['user_name','name']);
return options;
})()
```
For more information about the preceding scripting details, review information about [GlideRecords](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/server-api-reference/c_GlideRecordAPI.md) and the additional information:
- **fieldName**: Field name is optional information. Pass with `null`.
- **table**: Table name to query for displaying the available options.
- **pageSize**: Page size is optional information. Pass with `null`.
- **searchColumns**: Table columns in a comma-delimited list that applies to any searchText.
- **encodedQuery**: Initial query to apply to table rows. For example, `active=true`.
- **searchText**: Search text is optional information. Pass with `null`.
- **vaVars**: Reference to virtual agent context variables \(`vaVars`\).
- **orderByColumn**: Table column used to order the options.
- **orderDescending**: Options appear in descending order. Only `true` or `false` values accepted.
- **gr**: Glide record name.
- **startRow**: Starting row is optional information. Pass with `null`.
- **valueColumn**: Table column name to use as the value of each option.
- **labelColumns**: Array of table columns to use for each option display.
|
|
Table
|
Table to be searched, available only if you selected **Record** as the method to populate choices.
|
|
Filter choices
|
Option to use the condition builder or provide a script. Select one of the following:
- **Condition Builder**: Creates a filter used to select a subset of records from the table.
- **Script**: Defines the enumeration list for the options \(choice list\) to be displayed. The name-value pair is stored as a string object.
This field is available only when the **Record** option is selected.
|
|
Allow the user to select more than one choice
|
Option to allow users to choose multiple choices from the choice list.
|
|
No records response message
|
Message displayed to the user when the table search doesn’t return any records. The message can be either a text string or a script that returns text.
|
|
Advanced
|
|
Header card
|
Toggle to open a field to add cards which may include images or YouTube videos. For more information, see [Insert a header card in a Static Choice or Dynamic Choice control](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/insert-header-card-user-input-control.md)
|
|
Default value
|
|
Default Value
|
Predefined value for the user response to the question or prompt. The response defined in the **Default value confirmation** field asks the user to confirm the default value. If the user responds with `no`, the value becomes null. The default value can be either a text string or a script that returns text. For example, if you're using dot-walking, the default value might be: `Script Variables > Last username`. Or if you're using a script, the default value might be: `{{vaScripts.lastUsername}}`.
|
|
Confirmation messages
|
|
Input completion confirmation
|
Bot response shown to the user when the node interaction is complete. The message can be either a text string or a script that returns text. For example, if you're using dot-walking: `Thanks, (Input Variables > Username)!` Or if you're using a script, the acknowledgement might be: `Thanks, {{vaInputs.username}}!`
|
|
Default value confirmation
|
Message that asks the user to verify that the value in the **Default value** field is correct. This message is used instead of a value in the **Prompt** field. It can contain either a text string or a script that returns text. For example, if you're using dot-walking: `Are you (Input Variables > Username)?` Or if you're using a script, the confirmation message might be: `Are you {{vaScripts.lastUsername}}?`.
|