@servicenow/sdk
Version:
ServiceNow SDK
169 lines (102 loc) • 4.14 kB
Markdown
---
tags: [LookupSelectBoxVariable, variable, service catalog, lookup, select]
---
# LookupSelectBoxVariable
A CatalogItem variable for a lookup select box field.
## Signature
```typescript fluent
LookupSelectBoxVariable(config)
```
## Parameters
### config
`LookupSelectBoxVariableType<keyof Tables, string | ExplicitKey<string> | Record<keyof Tables>>`
Configuration for the lookup select box variable including:
**Properties:**
- **question** (required): `string`
- **active** (optional): `boolean`
- **alwaysExpand** (optional): `boolean`
Always expand
- **attributes** (optional): `string`
Attributes of the variable
- **category** (optional): `string`
Category
- **choiceDirection** (optional): `'down' | 'across'`
- **choiceField** (optional): `string`
- **choicesDependOn** (optional): `string`
- **choiceTable** (optional): `RefTable`
- **conversationalLabel** (optional): `string`
- **createRoles** (optional): `(string | Role)[]`
- **defaultValue** (optional): `string | Type`
- **deliveryPlan** (optional): `string`
Delivery plan
- **dependentQuestion** (optional): `string`
Dependent question for dynamic default value
- **description** (optional): `string`
Description
- **disableInitialSlotFill** (optional): `boolean`
- **dotWalkPath** (optional): `string`
Dot walk path for dynamic default value
- **exampleText** (optional): `string`
- **field** (optional): `string`
Field to map (required when mapToField is true)
- **global** (optional): `boolean`
Global
- **helpTag** (optional): `string`
- **helpText** (optional): `string`
- **hidden** (optional): `boolean`
Indicates whether the field is hidden. Cannot be true when mandatory is true.
- **includeNone** (optional): `boolean`
- **instructions** (optional): `string`
- **layout** (optional): `'normal' | '2across' | '2down'`
Layout style for the container
- **lookupFromTable** (optional): `RefTable`
Lookup from a table. Mutually exclusive with lookupSource='choices'.
- **lookupLabelFields** (optional): `string[]`
- **lookupPriceField** (optional): `string`
Price fields (not allowed when uniqueValuesOnly is true)
- **lookupRecurringPriceField** (optional): `string`
- **lookupSource** (optional): `'choices'`
Lookup from choices. Mutually exclusive with lookupFromTable.
- **lookupValueField** (optional): `string`
- **mandatory** (optional): `boolean`
Indicates whether the field must contain a value. Cannot be true when hidden or readOnly is true.
- **mapToField** (optional): `boolean`
Map to field
- **order** (optional): `number`
Order in which the variable appears
- **postInsertScript** (optional): `string`
Post insert script
- **pricingDetails** (optional): `PricingDetail[]`
Pricing details
- **pricingImplications** (optional): `boolean`
Pricing implications
- **readOnly** (optional): `boolean`
Indicates whether the field is read-only. Cannot be true when mandatory is true.
- **readRoles** (optional): `(string | Role)[]`
- **readScript** (optional): `string`
Read script
- **referenceQual** (optional): `string`
- **removeFromConversationalInterfaces** (optional): `boolean`
Remove from Conversational Interfaces
- **showHelp** (optional): `boolean`
- **tooltip** (optional): `string`
- **unique** (optional): `boolean`
Unique value
- **uniqueValuesOnly** (optional): `boolean`
Unique values only (price fields not allowed when true)
- **useDynamicDefault** (optional): `boolean`
Use dynamic default
- **visibility** (optional): `'Always' | 'Bundle' | 'Standalone'`
Visibility
- **visibleBundle** (optional): `boolean`
- **visibleGuide** (optional): `boolean`
Indicates whether the variable is visible in guides
- **visibleStandalone** (optional): `boolean`
Indicates whether the variable is visible when standalone
- **visibleSummary** (optional): `boolean`
Indicates whether the variable is visible in summaries
- **width** (optional): `100 | 25 | 50 | 75`
Width of the variable
- **writeRoles** (optional): `(string | Role)[]`
## See
- https://docs.servicenow.com/csh?topicname=variable-types.html&version=latest