OmniScript

Represents an OmniScript for the Discovery Framework, which guides users through sales, service, and other business processes. For Discovery Framework, the customization type is discoveryframework.

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

This type extends the Metadata metadata type and inherits its fullName field.

OmniScript components have the suffix omniScript and are stored in the omniScripts folder.

OmniScript components are available in API version 56.0 and later.

To use this metadata type, you must have an Omnistudio license and the Discovery Framework feature enabled in your Salesforce org.

  • Field Type: string
  • Description: The angular OmniScript template definitions.
  • Field Type: string
  • Description: The custom JavaScript used for an OmniScript.
  • Field Type: string
  • Description: The Omnistudio designer customization type.
  • Field Type: string
  • Description: Overrides all elements of one type with a custom Lightning web component by mapping the element type to the Custom LWC.
  • Field Type: boolean
  • Description: Indicates whether the OmniScript is active (true) or not (false).
  • Default value: false
  • Field Type: boolean
  • Description: Indicates whether OmniScript is an Integration Procedure (true) or OmniScript metadata (false).
  • Default value: false
  • Field Type: boolean
  • Description: Indicates whether Omniscript is managed using standard designer (true) or not (false). Available in API version 64.0 and later.
  • Field Type: boolean
  • Description: Indicates whether metadata cache for the integration procedure is disabled (true) or not (false).
  • Default value: false
  • Field Type: boolean
  • Description: Indicates whether the OmniScript can be embedded in other OmniScripts (true) or not (false).
  • Default value: false
  • Field Type: boolean
  • Description: Indicates whether OmniScript is a test procedure setting (true) or not (false).
  • Default value: false
  • Field Type: boolean
  • Description: Indicates whether web component OmniScript (not Angular) is enabled (true) or not (false).
  • Default value: false

  • Field Type: string

  • Description: Required.

    The language of the OmniScript.

  • Field Type: string
  • Description: The last page previewed in the OmniScript designer.

  • Field Type: string

  • Description: Required.

    The name of the OmniScript.

  • Field Type: string
  • Description: The namespace associated with this OmniScript record.

  • Field Type: OmniAssessmentTaskMetadata[]

  • Description: The omniAssessmentTasks associated with the OmniScript. Available in API version 63.0 and later.

    This field is available only if the Dynamic Assessment Access license is enabled.

  • Field Type: OmniProcessElement[]
  • Description: The OmniProcessElements associated with the OmniScript.
  • Field Type: string
  • Description: The integration procedure Type_SubType value.

  • Field Type: OmniProcessType (enumeration of type string)

  • Description: Required. Integration Procedure or OmniScript.

  • Possible values:

    • OmniScript
  • Field Type: string
  • Description: Reserved for future use.
  • Field Type: string
  • Description: The configuration information associated with the OmniScript.

  • Field Type: string

  • Description: The developer name of the assessment question in the OmniScript.

    This field is relevant only for Omniscripts with designerCustomizationType as discoveryframework.

  • Field Type: string
  • Description: The required permissions to execute the integration procedure.
  • Field Type: string
  • Description: Response cache used for the integration procedure (session or Org).

  • Field Type: string

  • Description: Required.

    The OmniScript sub type value.

  • Field Type: string

  • Description: Required.

    The OmniScript type value.

  • Field Type: string

  • Description: Required.

    The unique name for the OmniScript as Type_SubType_Language_VersionNumber.

  • Field Type: string

  • Description: Required.

    The OmniScript version number.

  • Field Type: string
  • Description: Internal unique key for the generated Lightning Web Components (LWC).

Represents the metadata associated with the assessment definition.

  • Field Type: dateTime
  • Description: The date and time when this version of the assessment definition was approved.
  • Field Type: string
  • Description: The way this assessment is displayed in a user interface.
  • Field Type: dateTime
  • Description: The date and time from which the assessment definition becomes active and can be used.
  • Field Type: dateTime
  • Description: The date and time until when this assessment definition is effective.
  • Field Type: dateTime
  • Description: The date and time when this assessment definition was last modified.
  • Field Type: string
  • Description: The type of user, role, or system qualified or intended to complete the assessment.
  • Field Type: string
  • Description: Reason for the assessment.

Represents the omni assessment tasks associated with the OmniScript.

  • Field Type: string
  • Description: Required. The name of the omni assessment task.

  • Field Type: picklist

  • Description: The status of the omni assessment task.

  • Default value: IsDefined

  • Possible values:

    • Completed
    • InProgress—In Progress
    • IsDefined—Is Defined
    • NotStarted—Not Started
  • Field Type: string
  • Description: A unique name for the omni assessment task.

Represents the OmniScript element associated with the OmniScript.

  • Field Type: OmniProcessElement[]
  • Description: The child elements associated with the OmniProcessElement.
  • Field Type: string
  • Description: The description of the OmniProcessElement.

  • Field Type: string

  • Description: The Omnistudio designer customization type.

    To create assessment questions using the Discovery Framework feature, use the customization type as discoveryframework.

  • Field Type: string
  • Description: The usage type for industries that use the Discovery Framework. For example, the value for Health Cloud is HcUsageType. The value for no specific industry is Default.
  • Field Type: string
  • Description: The ID of the embedded OmniScript
  • Field Type: boolean
  • Description: Indicates whether the status of the OmniProcessElement is active (true) or not (false).
  • Field Type: boolean
  • Description: Indicates whether the OmniScript with the OmniProcessElement can be embedded in other OmniScripts (true) or not (false).
  • Field Type: double
  • Description: The vertical level in which the OmniProcessElement occurs on the OmniScript.

  • Field Type: string

  • Description: Required.

    The name of the OmniProcessElement.

  • Field Type: double
  • Description: The related OmniProcess version.
  • Field Type: string
  • Description: The name of the parent OmniProcessElement.
  • Field Type: string
  • Description: The type of the parent OmniProcessElement.
  • Field Type: textarea
  • Description: The property set of the OmniProcessElement.
  • Field Type: double
  • Description: The horizontal level in which the OmniProcessElement occurs on the OmniScript.
  • Field Type: string
  • Description: The OmniProcessElement type. For example, Text and TextArea.

  • Field Type: string

  • Description: The developer name of the assessment question in the OmniScript.

    This field is relevant only for Omniscripts with designerCustomizationType as discoveryframework.

Here’s an example of an Omniscript component.

The following is an example package.xml that references the previous definition.

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.

Before you retrieve or deploy Discovery Framework OmniScripts, we recommend that you review these considerations.

  • If the DesignerCustomizationType of the OmniScript is discoveryframework, then the questions in the OmniScript must be within the <uniqueIndex> tag in the metadata definition file.
  • When deploying the OmniScript of type Discovery Framework, enable Discovery Framework Metadata Enabled setting.
  • OmniScripts of type Discovery Framework don’t support IDX Workbench.
  • If any question associated with the OmniScript doesn’t exist in the target org or, if the active version of that question doesn’t exist in the target org, then deploying the OmniScript fails.