FlexcardDefinition
Each row represents a Flexcard's configuration
such as its name and author. A Flexcard can display data and launch actions or Omniscripts.
This object stores specific information about a Flexcard to render it at
runtime.
Parent Type
This type extends the Metadata metadata type and inherits its fullName field.
File Suffix and Directory Location
FlexcardDefinition components have the suffix .flexcardDefinition and are stored in the flexcardDefinitions folder.
Version
FlexcardDefinition components are available in API version 67.0 and later.
Special Access Rules
Fields
authorName
- Field Type: string
- Description: A value that identifies who created the Flexcard. This value could indicate the name of the user, team, or company of the Flexcard's creator.
clonedFromFlexcardKey
- Field Type: string
- Description: The Flexcard Definition Key of the Flexcard used to create this Flexcard.
dataSourceConfiguration
- Field Type: string
- Description: A user-defined method that's used for populating the Flexcard with data.
description
- Field Type: string
- Description: The user-defined text added in the Description field when creating or updating a Flexcard.
flexcardKey
- Field Type: string
- Description: The unique identifier of a Flexcard.
flexcardType
- Field Type: FlexcardType (enumeration of type string)
- Description: The Flexcard category that defines where the Flexcard can be used, for example, inside another Flexcard, or in Salesforce Pages.
-
Values: Values are:
- Parent
- Child
isActive
- Field Type: boolean
- Description: Indicates whether this Flexcard version is the currently active version (true) or not (false). The currently active version is the one that executes at runtime.
isManagedUsingStdDesigner
- Field Type: boolean
- Description: Indicates whether the Flexcard is created or updated using the Omnistudio standard designer.
isTrackingEnabled
- Field Type: boolean
- Description: Indicates whether the Flexcard reports to tracking services (true) or not (false).
masterLabel
- Field Type: string
- Description: The user-defined label of the component.
overrideKey
- Field Type: string
- Description: The unique identifier of the Flexcards that's being overriden.
propertySetConfig
- Field Type: FlexcardPropertySetConfig
- Description: Stores the configuration properties for this component.
references
- Field Type: string
- Description: The list of referenced components used by this definition.
sampleDataSourceResponse
- Field Type: string
- Description: The user-defined sample data used when previewing a Flexcard so the current design can be tested with this data.
stylingConfiguration
- Field Type: string
- Description: The custom CSS classes defined for the Flexcard.
FlexcardPropertySetConfig
accessibilityToggle
- Field Type: boolean
- Description: Indicates whether accessibility features are enabled for the Flexcard (true) or not (false).
dataSource
- Field Type: string
- Description: The data source used to populate the Flexcard.
dynamicProperties
- Field Type: string
- Description: Specifies dynamically resolved property values used during rendering or execution.
enableLwc
- Field Type: boolean
- Description: Indicates whether the Flexcard is rendered as a Lightning Web Component (true) or disable it (false).
integrationProcedureRootConfig
- Field Type: IntegrationProcedurePropertySetConfig
- Description: Specifies the root configuration of the integration procedure associated with the Flexcard.
isFlex
- Field Type: boolean
- Description: Indicates whether the component is configured as a Flexcard (true) or not (false).
omniScriptRootConfig
- Field Type: OmniScriptPropertySetConfig
- Description: Specifies the root configuration of the associated Omniscript.
selectableMode
- Field Type: string
- Description: Specifies how selection behavior is handled for this component.
states
- Field Type: FlexcardStatePropertySetConfig
- Description: Stores the state configurations for this Flexcard.
theme
- Field Type: string
- Description: Specifies the visual theme applied to this component.
title
- Field Type: string
- Description: Specifies the display title configured for this component.
xmlObject
- Field Type: string
- Description: Stores the generated XML configuration used by this component.
IntegrationProcedurePropertySetConfig
additionalChainableResponse
- Field Type: string
- Description: Specifies additional response data returned when chainable execution is used.
autoSaveOnStepNext
- Field Type: boolean
- Description: Indicates whether changes are automatically saved when moving to the next step (true) or not (false).
chainableActualTimeLimit
- Field Type: int
- Description: Specifies the maximum execution time, in milliseconds, allowed for a chainable process.
chainableCpuLimit
- Field Type: int
- Description: Specifies the maximum CPU time allowed for a chainable process.
chainableDMLRowsLimit
- Field Type: int
- Description: Specifies the maximum number of DML rows that a chainable process can process.
chainableDMLStatementsLimit
- Field Type: int
- Description: Specifies the maximum number of DML statements that a chainable process can execute.
chainableHeapSizeLimit
- Field Type: int
- Description: Specifies the heap size limit for chainable execution.
chainableQueriesLimit
- Field Type: int
- Description: Specifies the maximum number of SOQL queries that a chainable process can execute.
chainableQueryRowsLimit
- Field Type: int
- Description: Specifies the maximum number of rows that SOQL queries can return in a chainable process..
chainableSoslQueriesLimit
- Field Type: int
- Description: Specifies the SOSL query limit for chainable execution.
columnsPropertyMap
- Field Type: string
- Description: The key-value mappings used for columns property map.
description
- Field Type: string
- Description: The user-defined description added to an Integration Procedure.
disableDefinitionCache
- Field Type: boolean
- Description: Indicates whether caching of the integration procedure definition is disabled (true) or keep it enabled (false).
dynamicProperties
- Field Type: string
- Description: Stores dynamic properties used at runtime.
includeAllActionsInResponse
- Field Type: boolean
- Description: Indicates whether responses from all actions are included in the integration procedure output (true) or not (false).
integrationProcedureInput
- Field Type: string
- Description: The expected input schema or structure for the integration procedure.
integrationProcedureOutput
- Field Type: string
- Description: The output of the integration procedure in the JSON format.
isIntegProcdSignatureAvl
- Field Type: string
- Description: Indicates whether the Integration Procedure has a signature (true) or not (false).
labelPlural
- Field Type: string
- Description: Specifies the plural label used by this configuration.
labelSingular
- Field Type: string
- Description: Specifies the singular label used by this configuration.
linkToExternalObject
- Field Type: string
- Description: Specifies the external object mapping used by this configuration.
mockResponseMap
- Field Type: string
- Description: The key-value mappings used for mock response map.
nameColumn
- Field Type: string
- Description: Specifies the field used as the primary display name.
omniProcessId
- Field Type: string
- Description: Specifies the ID of the associated OmniStudio process.
persistentComponent
- Field Type: boolean
- Description: Indicates whether the component remains persistent across interactions. (true) or not (false).
queueableChainableCpuLimit
- Field Type: int
- Description: Specifies the CPU limit for queueable chainable execution.
queueableChainableHeapSizeLimit
- Field Type: int
- Description: Specifies the heap size limit for queueable chainable execution.
queueableChainableQueriesLimit
- Field Type: int
- Description: Specifies the SOQL query count limit for queueable chainable execution.
relationshipFieldsMap
- Field Type: string
- Description: The key-value mappings used for relationship fields map.
requiredPermission
- Field Type: string
- Description: The list of custom permissions that allow a user to execute an Integration Procedure.
rollbackOnError
- Field Type: boolean
- Description: Indicates whether all changes are rolled back if an error occurs during execution (true) or not (false).
trackingCustomData
- Field Type: string
- Description: Stores custom tracking data emitted by this component.
transientValues
- Field Type: string
- Description: Stores transient (non-persisted) runtime values.
ttlMinutes
- Field Type: int
- Description: Specifies the cache time-to-live in minutes.
OmniScriptPropertySetConfig
accessibilityToggle
- Field Type: boolean
- Description: Indicates whether accessibility toggle is enabled for the Omniscript configuration.
allowCancel
- Field Type: boolean
- Description: Indicates whether cancel is enabled for this Omniscript configuration.
allowSaveChanges
- Field Type: boolean
- Description: Indicates whether users can save changes made in the Omniscript element.
allowSaveForLater
- Field Type: boolean
- Description: Indicates whether users can save progress and resume the Omniscript later.
autoFocus
- Field Type: boolean
- Description: Indicates whether auto focus is enabled for the Omniscript configuration.
autoSaveChanges
- Field Type: boolean
- Description: Indicates whether auto save changes is enabled for the Omniscript configuration.
autoSaveOnStepNext
- Field Type: boolean
- Description: Indicates whether auto save on step next is enabled for the Omniscript configuration.
bulk
- Field Type: boolean
- Description: Indicates whether bulk is enabled for the Omniscript configuration.
cancelRedirectPageName
- Field Type: string
- Description: The cancel redirect page name used to identify this Omniscript artifact in metadata.
cancelRedirectTemplateUrl
- Field Type: string
- Description: The cancel redirect template url reference used by Omniscript integrations or rendering.
cancelSource
- Field Type: string
- Description: The cancel source that identifies the data source or target used by Omniscript.
cancelType
- Field Type: string
- Description: The cancel type value that determines how this Omniscript setting is interpreted.
consoleTabIcon
- Field Type: string
- Description: The console tab icon value used by Omniscript at runtime.
consoleTabLabel
- Field Type: string
- Description: The console tab label text shown in the Omniscript user interface.
consoleTabTitle
- Field Type: string
- Description: The console tab title text shown in the Omniscript user interface.
currencyCode
- Field Type: string
- Description: The currency code value used by Omniscript at runtime.
currentLanguage
- Field Type: string
- Description: The current language value used by Omniscript at runtime.
disableUnloadWarn
- Field Type: boolean
- Description: Indicates whether disable unload warn is enabled for the Omniscript configuration.
dynamicProperties
- Field Type: string
- Description: The dynamic properties used to configure Omniscript behavior.
elementTypeToHTMLTemplateMapping
- Field Type: string
- Description: The element type to htmltemplate mapping value that determines how this Omniscript setting is interpreted.
enableKnowledge
- Field Type: boolean
- Description: Indicates whether knowledge is enabled for this Omniscript configuration.
errorMessage
- Field Type: string
- Description: The error message text shown in the Omniscript user interface.
hideStepChart
- Field Type: boolean
- Description: Indicates whether hide step chart is enabled for the Omniscript configuration.
knowledgeArticleTypeQueryFieldsMap
- Field Type: string
- Description: The knowledge article type query fields map value that determines how this Omniscript setting is interpreted.
lkObjName
- Field Type: string
- Description: The lk obj name used to identify this Omniscript artifact in metadata.
mergeSavedData
- Field Type: boolean
- Description: Indicates whether merge saved data is enabled for the Omniscript configuration.
message
- Field Type: string
- Description: The message text shown in the Omniscript user interface.
persistentComponent
- Field Type: string
- Description: The persistent component value used by Omniscript at runtime.
pubsub
- Field Type: boolean
- Description: Indicates whether pubsub is enabled for the Omniscript configuration.
rtpSeed
- Field Type: boolean
- Description: Indicates whether rtp seed is enabled for the Omniscript configuration.
saveContentEncoded
- Field Type: boolean
- Description: Indicates whether save content encoded is enabled for the Omniscript configuration.
saveExpireInDays
- Field Type: int
- Description: The save expire in days value used by Omniscript at runtime.
saveForLaterRedirectPageName
- Field Type: string
- Description: The save for later redirect page name used to identify this Omniscript artifact in metadata.
saveForLaterRedirectTemplateUrl
- Field Type: string
- Description: The save for later redirect template url reference used by Omniscript integrations or rendering.
saveNameTemplate
- Field Type: string
- Description: The save name template used to identify this Omniscript artifact in metadata.
saveObjectId
- Field Type: string
- Description: The object ID used when saving Omniscript data.
saveURLPatterns
- Field Type: string
- Description: The save urlpatterns value used by Omniscript at runtime.
scrollBehavior
- Field Type: string
- Description: The scroll behavior value used by Omniscript at runtime.
seedDataJSON
- Field Type: string
- Description: The seed data json value used by Omniscript at runtime.
showInputWidth
- Field Type: boolean
- Description: Indicates whether show input width is enabled for the Omniscript configuration.
ssm
- Field Type: boolean
- Description: Indicates whether ssm is enabled for the Omniscript configuration.
stepChartPlacement
- Field Type: string
- Description: The step chart placement value used by Omniscript at runtime.
stylesheet
- Field Type: string
- Description: The stylesheet value used by Omniscript at runtime.
timeTracking
- Field Type: boolean
- Description: Indicates whether time tracking is enabled for the Omniscript configuration.
trackingCustomData
- Field Type: string
- Description: The tracking custom data value used by Omniscript at runtime.
visualforcePagesAvailableInPreview
- Field Type: string
- Description: The visualforce pages available in preview value used by Omniscript at runtime.
wpm
- Field Type: boolean
- Description: Indicates whether wpm is enabled for the Omniscript configuration.
FlexcardStatePropertySetConfig
actions
- Field Type: string
- Description: Stores action definitions configured for the state.
blankCardState
- Field Type: boolean
- Description: Indicates whether the state is displayed when no data is available (true) or not (false).
childCards
- Field Type: string
- Description: Stores child card configurations associated with the state.
components
- Field Type: string
- Description: Stores component definitions configured for the state.
conditions
- Field Type: string
- Description: Stores condition rules that control the state.
definedActions
- Field Type: string
- Description: Stores predefined actions available in the state.
documents
- Field Type: string
- Description: Stores document-related configurations used in the state.
dynamicProperties
- Field Type: string
- Description: Stores dynamic properties used at runtime.
fields
- Field Type: string
- Description: Stores field configurations displayed in this state.
isSmartAction
- Field Type: boolean
- Description: Indicates whether the state includes a smart action (true) or not (false).
name
- Field Type: string
- Description: Specifies the configured name of this item.
omniscripts
- Field Type: string
- Description: Stores related Omniscript references configured in this state.
smartAction
- Field Type: string
- Description: Stores smart action configuration for the state.
styleObject
- Field Type: string
- Description: Defines styling properties (for example, classes, spacing, and sizing) used to render this component.
Declarative Metadata Sample Definition
The following is an example of a FlexcardDefinition component.
1<?xml version="1.0" encoding="UTF-8"?>
2<FlexcardDefinition xmlns="http://soap.sforce.com/2006/04/metadata">
3 <authorName>TestAuthor</authorName>
4 <dataSourceConfiguration>{"dataSource":{"type":null,"value":{},"orderBy":{},"contextVariables":[]}}</dataSourceConfiguration>
5 <description>Test Flexcard Definition for Metadata Gauntlet</description>
6 <flexcardKey>TestFlexcardDefinition/TestAuthor</flexcardKey>
7 <flexcardType>Parent</flexcardType>
8 <isActive>true</isActive>
9 <isManagedUsingStdDesigner>true</isManagedUsingStdDesigner>
10 <isTrackingEnabled>false</isTrackingEnabled>
11 <masterLabel>TestFlexcardDefinition_TestAuthor</masterLabel>
12 <propertySetConfig>
13 <states>
14 <fields>[]</fields>
15 <conditions>{"id":"state-condition-object","isParent":true,"group":[]}</conditions>
16 <definedActions>{"actions":[]}</definedActions>
17 <name>Active</name>
18 <isSmartAction>false</isSmartAction>
19 <smartAction>{}</smartAction>
20 <styleObject>{"padding":[{"type":"around","size":"x-small"}],"margin":[{"type":"bottom","size":"x-small"}],"container":{"class":"slds-card"},"size":{"isResponsive":false,"default":"12"},"sizeClass":"slds-size_12-of-12","class":"slds-card slds-p-around_x-small slds-m-bottom_x-small"}</styleObject>
21 <components>{"layer-0":{"children":[{"name":"Text","element":"outputField","size":{"isResponsive":false,"default":"12"},"stateIndex":0,"class":"slds-col ","property":{"record":"{record}","mergeField":"Test","card":"{card}"},"type":"text","styleObject":{"sizeClass":"slds-size_12-of-12"},"datasourceKey":"state0element0","uKey":"1767799962280-500","elementLabel":"Text-0"}]}}</components>
22 <childCards>[]</childCards>
23 <actions>[]</actions>
24 <omniscripts>[]</omniscripts>
25 <documents>[]</documents>
26 <dynamicProperties></dynamicProperties>
27 <blankCardState>false</blankCardState>
28 </states>
29 <dataSource>{"type":null,"value":{},"orderBy":{},"contextVariables":[]}</dataSource>
30 <title>TestFlexcardDefinition</title>
31 <enableLwc>true</enableLwc>
32 <isFlex>true</isFlex>
33 <theme>slds</theme>
34 <selectableMode>Multi</selectableMode>
35 <accessibilityToggle>true</accessibilityToggle>
36 <xmlObject>{"targetConfigs":"PHRhcmdldENvbmZpZyB0YXJnZXRzPSJsaWdodG5pbmdfX0FwcFBhZ2UiPgogICAgICAgICAgICAgICAgICAgIDxwcm9wZXJ0eSBuYW1lPSJkZWJ1ZyIgdHlwZT0iQm9vbGVhbiIvPgogICAgICAgICAgICAgICAgICAgIDxwcm9wZXJ0eSBuYW1lPSJyZWNvcmRJZCIgdHlwZT0iU3RyaW5nIi8+CiAgICAgICAgICAgICAgICA8L3RhcmdldENvbmZpZz4KICAgICAgICAgICAgICAgIDx0YXJnZXRDb25maWcgdGFyZ2V0cz0ibGlnaHRuaW5nX19SZWNvcmRQYWdlIj4KICAgICAgICAgICAgICAgICAgICA8cHJvcGVydHkgbmFtZT0iZGVidWciIHR5cGU9IkJvb2xlYW4iLz4KICAgICAgICAgICAgICAgIDwvdGFyZ2V0Q29uZmlnPg==","targets":{"target":["lightning__RecordPage","lightning__AppPage","lightning__HomePage"]},"apiVersion":61,"description":""}</xmlObject>
37 <dynamicProperties></dynamicProperties>
38 <integrationProcedureRootConfig>
39 <mockResponseMap></mockResponseMap>
40 <omniProcessId></omniProcessId>
41 <linkToExternalObject></linkToExternalObject>
42 <integrationProcedureOutput></integrationProcedureOutput>
43 <additionalChainableResponse></additionalChainableResponse>
44 <relationshipFieldsMap></relationshipFieldsMap>
45 <integrationProcedureInput></integrationProcedureInput>
46 <description></description>
47 <trackingCustomData></trackingCustomData>
48 <requiredPermission></requiredPermission>
49 <nameColumn></nameColumn>
50 <columnsPropertyMap></columnsPropertyMap>
51 <isIntegProcdSignatureAvl></isIntegProcdSignatureAvl>
52 <transientValues></transientValues>
53 <labelSingular></labelSingular>
54 <labelPlural></labelPlural>
55 <dynamicProperties></dynamicProperties>
56 <autoSaveOnStepNext>false</autoSaveOnStepNext>
57 <persistentComponent>false</persistentComponent>
58 <includeAllActionsInResponse>false</includeAllActionsInResponse>
59 <rollbackOnError>false</rollbackOnError>
60 <disableDefinitionCache>false</disableDefinitionCache>
61 <chainableQueryRowsLimit>0</chainableQueryRowsLimit>
62 <ttlMinutes>0</ttlMinutes>
63 <chainableHeapSizeLimit>0</chainableHeapSizeLimit>
64 <queueableChainableQueriesLimit>0</queueableChainableQueriesLimit>
65 <queueableChainableHeapSizeLimit>0</queueableChainableHeapSizeLimit>
66 <chainableActualTimeLimit>0</chainableActualTimeLimit>
67 <chainableDMLRowsLimit>0</chainableDMLRowsLimit>
68 <chainableDMLStatementsLimit>0</chainableDMLStatementsLimit>
69 <chainableSoslQueriesLimit>0</chainableSoslQueriesLimit>
70 <chainableQueriesLimit>0</chainableQueriesLimit>
71 <queueableChainableCpuLimit>0</queueableChainableCpuLimit>
72 <chainableCpuLimit>0</chainableCpuLimit>
73 </integrationProcedureRootConfig>
74 <omniScriptRootConfig>
75 <cancelRedirectPageName></cancelRedirectPageName>
76 <currencyCode></currencyCode>
77 <consoleTabLabel></consoleTabLabel>
78 <cancelRedirectTemplateUrl></cancelRedirectTemplateUrl>
79 <lkObjName></lkObjName>
80 <stylesheet></stylesheet>
81 <consoleTabIcon></consoleTabIcon>
82 <consoleTabTitle></consoleTabTitle>
83 <saveURLPatterns></saveURLPatterns>
84 <seedDataJSON></seedDataJSON>
85 <cancelSource></cancelSource>
86 <stepChartPlacement></stepChartPlacement>
87 <currentLanguage></currentLanguage>
88 <scrollBehavior></scrollBehavior>
89 <message></message>
90 <visualforcePagesAvailableInPreview></visualforcePagesAvailableInPreview>
91 <saveForLaterRedirectTemplateUrl></saveForLaterRedirectTemplateUrl>
92 <saveNameTemplate></saveNameTemplate>
93 <saveForLaterRedirectPageName></saveForLaterRedirectPageName>
94 <errorMessage></errorMessage>
95 <dynamicProperties></dynamicProperties>
96 <trackingCustomData></trackingCustomData>
97 <persistentComponent></persistentComponent>
98 <cancelType></cancelType>
99 <elementTypeToHTMLTemplateMapping></elementTypeToHTMLTemplateMapping>
100 <knowledgeArticleTypeQueryFieldsMap></knowledgeArticleTypeQueryFieldsMap>
101 <saveObjectId></saveObjectId>
102 <mergeSavedData>false</mergeSavedData>
103 <allowSaveChanges>false</allowSaveChanges>
104 <showInputWidth>false</showInputWidth>
105 <allowCancel>false</allowCancel>
106 <allowSaveForLater>false</allowSaveForLater>
107 <hideStepChart>false</hideStepChart>
108 <rtpSeed>false</rtpSeed>
109 <disableUnloadWarn>false</disableUnloadWarn>
110 <autoSaveChanges>false</autoSaveChanges>
111 <autoFocus>false</autoFocus>
112 <enableKnowledge>false</enableKnowledge>
113 <autoSaveOnStepNext>false</autoSaveOnStepNext>
114 <ssm>false</ssm>
115 <saveContentEncoded>false</saveContentEncoded>
116 <pubsub>false</pubsub>
117 <bulk>false</bulk>
118 <accessibilityToggle>false</accessibilityToggle>
119 <timeTracking>false</timeTracking>
120 <wpm>false</wpm>
121 <saveExpireInDays>0</saveExpireInDays>
122 </omniScriptRootConfig>
123 </propertySetConfig>
124 <references>[]</references>
125</FlexcardDefinition>The following is an example package.xml that references the previous definition.
1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3 <types>
4 <members>*</members>
5 <name>FlexcardDefinition</name>
6 </types>
7 <version>[ftest]</version>
8</Package>