Industries Common Resources Developer Guide
jNewer Version Available
OmniScript
Represents the processes with fast, personalized, and
consistent responses.
This type extends the Metadata metadata type and inherits its
fullName field.
File Suffix and Directory Location
OmniScript components have the suffix omniScript and are stored in the omniScripts folder.
Version
OmniScript components are available in API version 56.0 and later.
Special Access Rules
To use this metadata type, you must enable the Discovery Framework feature in your Salesforce org.
Fields
| Field Name | Description |
|---|---|
| customHtmlTemplates |
|
| customJavaScript |
|
| designerCustomizationType |
|
| elementTypeComponentMapping |
|
| isActive |
|
| isIntegrationProcedure |
|
| isMetadataCacheDisabled |
|
| isOmniScriptEmbeddable |
|
| isTestProcedure |
|
| isWebCompEnabled |
|
| language |
|
| lastPreviewPage |
|
| name |
|
| namespace |
|
| omniProcessElements |
|
| omniProcessKey |
|
| omniProcessType |
|
| overrideKey |
|
| propertySetConfig |
|
| questionDevName |
|
| requiredPermission |
|
| responseCacheType |
|
| subType |
|
| type |
|
| uniqueName |
|
| versionNumber |
|
| webComponentKey |
|
OmniProcessElement
Represents the OmniScript element associated with the OmniScript.
| Field Name | Description |
|---|---|
| childElements |
|
| description |
|
| designerCustomizationType |
|
| embeddedOmniScriptKey |
|
| isActive |
|
| isOmniScriptEmbeddable |
|
| level |
|
| name |
|
| omniProcessVersionNumber |
|
| parentElementName |
|
| parentElementType |
|
| propertySetConfig |
|
| QuestionDevName |
|
| sequenceNumber |
|
| type |
|
Declarative Metadata Sample Definition
The following is an example of a OmniScript component.
1<?xml version="1.0" encoding="UTF-8"?>
2<OmniScript
3 xmlns="http://soap.sforce.com/2006/04/metadata">
4 <elementTypeComponentMapping>{"ElementTypeToHTMLTemplateList":[]}</elementTypeComponentMapping>
5 <isActive>false</isActive>
6 <isIntegrationProcedure>false</isIntegrationProcedure>
7 <isMetadataCacheDisabled>false</isMetadataCacheDisabled>
8 <isOmniScriptEmbeddable>false</isOmniScriptEmbeddable>
9 <isTestProcedure>false</isTestProcedure>
10 <isWebCompEnabled>true</isWebCompEnabled>
11 <language>English</language>
12 <name>OS5</name>
13 <omniProcessElements>
14 <parentElementType></parentElementType>
15 <parentElementName></parentElementName>
16 <description>test</description>
17 <isActive>true</isActive>
18 <isOmniScriptEmbeddable>false</isOmniScriptEmbeddable>
19 <embeddedOmniScriptKey>key</embeddedOmniScriptKey>
20 <designerCustomizationType></designerCustomizationType>
21 <level>0.0</level>
22 <name>Step1</name>
23 <omniProcessVersionNumber>0.0</omniProcessVersionNumber>
24 <propertySetConfig>{"label":"Step 1","validationRequired":true,"previousLabel":"Previous","previousWidth":3,"nextLabel":"Next","nextWidth":3,"cancelLabel":"Cancel","cancelMessage":"Are you sure?","saveLabel":"Save for later","saveMessage":"Are you sure you want to save it for later?","completeLabel":"Complete","completeMessage":"Are you sure you want to complete the script?","instruction":"","showPersistentComponent":[true,false],"remoteClass":"","remoteMethod":"","remoteTimeout":30000,"remoteOptions":{},"knowledgeOptions":{"language":"English","publishStatus":"Online","keyword":"","dataCategoryCriteria":"","remoteTimeout":30000,"typeFilter":""},"show":null,"conditionType":"Hide if False","HTMLTemplateId":"","instructionKey":"","chartLabel":null,"allowSaveForLater":true,"errorMessage":{"custom":[],"default":null},"wpm":false,"ssm":false,"message":{},"pubsub":false,"businessCategory":"","businessEvent":""}</propertySetConfig>
25 <sequenceNumber>0.0</sequenceNumber>
26 <type>Step</type>
27 <questionDevName></questionDevName>
28 </omniProcessElements>
29 <omniProcessElements>
30 <isActive>true</isActive>
31 <level>0.0</level>
32 <name>Step2</name>
33 <omniProcessVersionNumber>0.0</omniProcessVersionNumber>
34 <isOmniScriptEmbeddable>false</isOmniScriptEmbeddable>
35 <propertySetConfig>{"label":"Step2","validationRequired":true,"previousLabel":"Previous","previousWidth":3,"nextLabel":"Next","nextWidth":3,"cancelLabel":"Cancel","cancelMessage":"Are you sure?","saveLabel":"Save for later","saveMessage":"Are you sure you want to save it for later?","completeLabel":"Complete","completeMessage":"Are you sure you want to complete the script?","instruction":"","showPersistentComponent":[true, false],"remoteClass":"","remoteMethod":"","remoteTimeout":30000,"remoteOptions":{},"knowledgeOptions":{"language":"English","publishStatus":"Online", "keyword":"","dataCategoryCriteria":"","remoteTimeout":30000,"typeFilter":""},"show":null,"conditionType":"Hide if False","HTMLTemplateId":"","instructionKey":"","chartLabel":null,"allowSaveForLater":true,"errorMessage":{"custom":[],"default":null},"wpm":false,"ssm":false,"message":{},"pubsub":false,"businessCategory":"","businessEvent":""}</propertySetConfig>
36 <sequenceNumber>1.0</sequenceNumber>
37 <type>Step</type>
38 <questionDevName></questionDevName>
39 </omniProcessElements>
40 <omniProcessElements>
41 <isActive>true</isActive>
42 <level>0.0</level>
43 <name>Step3</name>
44 <omniProcessVersionNumber>0.0</omniProcessVersionNumber>
45 <isOmniScriptEmbeddable>false</isOmniScriptEmbeddable>
46 <propertySetConfig>{"label":"Step3","validationRequired":true,"previousLabel":"Previous","previousWidth":3,"nextLabel":"Next","nextWidth":3,"cancelLabel":"Cancel","cancelMessage":"Are you sure?","saveLabel":"Save for later","saveMessage":"Are you sure you want to save it for later?","completeLabel":"Complete","completeMessage":"Are you sure you want to complete the script?","instruction":"","showPersistentComponent":[true, false],"remoteClass":"","remoteMethod":"","remoteTimeout":30000,"remoteOptions":{},"knowledgeOptions":{"language":"English","publishStatus":"Online", "keyword":"","dataCategoryCriteria":"","remoteTimeout":30000,"typeFilter":""},"show":null,"conditionType":"Hide if False","HTMLTemplateId":"","instructionKey":"","chartLabel":null,"allowSaveForLater":true,"errorMessage":{"custom":[],"default":null},"wpm":false,"ssm":false,"message":{},"pubsub":false,"businessCategory":"","businessEvent":""}</propertySetConfig>
47 <sequenceNumber>2.0</sequenceNumber>
48 <type>Step</type>
49 <questionDevName></questionDevName>
50 </omniProcessElements>
51 <omniProcessType>OmniScript</omniProcessType>
52 <propertySetConfig>{"persistentComponent":[{"render":false,"label":"","remoteClass":"","remoteMethod":"","remoteTimeout":30000,"remoteOptions":{"preTransformBundle":"","postTransformBundle":""},"preTransformBundle":"","postTransformBundle":"","sendJSONPath":"","sendJSONNode":"","responseJSONPath":"","responseJSONNode":"","id":"vlcCart","itemsKey":"cartItems","modalConfigurationSetting":{"modalHTMLTemplateId":"vlcProductConfig.html","modalController":"ModalProductCtrl","modalSize":"lg"}},{"render":false,"dispOutsideOmni":false,"label":"","remoteClass":"","remoteMethod":"","remoteTimeout":30000,"remoteOptions":{"preTransformBundle":"","postTransformBundle":""},"preTransformBundle":"","postTransformBundle":"","id":"vlcKnowledge","itemsKey":"knowledgeItems","modalConfigurationSetting":{"modalHTMLTemplateId":"","modalController":"","modalSize":"lg"}}],"allowSaveForLater":true,"saveNameTemplate":null,"saveExpireInDays":null,"saveForLaterRedirectPageName":"sflRedirect","saveForLaterRedirectTemplateUrl":"vlcSaveForLaterAcknowledge.html","saveContentEncoded":false,"saveObjectId":"%ContextId%","saveURLPatterns":{},"autoSaveOnStepNext":false,"elementTypeToHTMLTemplateMapping":{},"seedDataJSON":{},"trackingCustomData":{},"enableKnowledge":false,"bLK":false,"lkObjName":null,"knowledgeArticleTypeQueryFieldsMap":{},"timeTracking":false,"hideStepChart":false,"mergeSavedData":false,"visualforcePagesAvailableInPreview":{},"cancelType":"SObject","allowCancel":true,"cancelSource":"%ContextId%","cancelRedirectPageName":"OmniScriptCancelled","cancelRedirectTemplateUrl":"vlcCancelled.html","consoleTabLabel":"New","wpm":false,"ssm":false,"message":{},"pubsub":false,"autoFocus":false,"currencyCode":"","showInputWidth":false,"rtpSeed":false,"consoleTabTitle":null,"consoleTabIcon":"custom:custom18","errorMessage":{"custom":[]},"stylesheet":{"newport":"","lightning":"","newportRtl":"","lightningRtl":""},"stepChartPlacement":"right","disableUnloadWarn":true,"scrollBehavior":"auto","currentLanguage":"en_US"}</propertySetConfig>
53 <subType>SBT5</subType>
54 <type>Type5</type>
55 <omniProcessKey>Type5_SBT5</omniProcessKey>
56 <uniqueName>Type5_SBT5_English_1</uniqueName>
57 <versionNumber>1.0</versionNumber>
58 <nameSpace></nameSpace>
59 <lastPreviewPage>LastPage</lastPreviewPage>
60 <customHtmlTemplates></customHtmlTemplates>
61 <customJavaScript></customJavaScript>
62 <description>TestOS</description>
63 <requiredPermission>OmniStudioAdmin</requiredPermission>
64 <responseCacheType>Org Cache</responseCacheType>
65 <designerCustomizationType></designerCustomizationType>
66 <webComponentKey>WebComponentKey</webComponentKey>
67 <overrideKey></overrideKey>
68</OmniScript>The following is an example package.xml that references the previous definition.
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 ~ Copyright 2020 Salesforce, Inc.
4 ~ All Rights Reserved
5 ~ Company Confidential
6-->
7<Package xmlns="http://soap.sforce.com/2006/04/metadata">
8 <types>
9 <members>*</members>
10 <name>OmniScript</name>
11 </types>
12 <version>56.0</version>
13</Package>Wildcard Support in the Manifest File
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.
Usage Type
Before you retrieve or deploy OmniScripts, we recommend that you review these considerations.
- If the DesignerCustomizationTypeof the OmniScript is discoveryframework, then the questions in the OmniScript must be within the <questionDevName> tag in the metadata definition file.
- 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.