Consumer Goods Cloud Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
Get Started with Consumer Goods Cloud
Retail Execution
Trade Promotion Management
Custom Objects for Trade Promotion Management
Trade Promotion Management Service APIs
Trade Promotion Management Business APIs
Promotion Wizards & Customization
Metadata Wizard
Metadata Definition
Metadata Wizard Expression
Metadata Components
Promotion Wizard Input Structure
Apex Classes for Trade Promotion Management
Business Objects API
Custom Objects for Retail Execution and Trade Promotion Management
Custom Objects for Future Use
API End-of-Life Policy
PDF

Metadata Wizard Expression

Expressions provide dynamic values to Wizard Components. Wizard Components accept expressions in some of their metadata properties. With expressions, you can also access instance values of other Wizard Components and dynamically set the metadata attributes, and create conditions. When a Wizard Component has an expression as a metadata attribute, the Wizard Component gets re-rendered every time the expression value changes.

Literal Value

An expression that doesn’t match the structure of the other expression types.

Example
"{! !(promoTemplate.Name == 'Test' || promoTemplate.Name != 'Test2') }"
...
Access the properties of identifiers using the dot notation:
"{! promoTemplate.Name }"
Literal Example Resolves to
true "{! true }" Boolean true
false "{! false }" Boolean false
null "{! null }" null

String Expressions

A string with a specific start and end sequence of characters ("{!" and "}").

Use these expressions to retrieve values from other Wizard Component instances by specifying the component ID of the Wizard Component instance.

Example
...
{
    "id": "myCheckboxField",
    "type": "Checkbox",
},
...
{
    "id": "myOtherField",
    "active": "{! myCheckboxField }",
...

Logical Expressions

An object with these three properties - left, right, and operator.

Use this expression to perform operations between different values.

Example
{
    "left": <expression>
    "operator": "equal",
    "right" : <expression>
}
  
// Example
...
"active" : {
    "left": "{! myCheckbox}",
    "operator":"equal",
    "right": true
},
...

List of available operators:

  • and
  • or
  • equal
  • notEqual
  • greaterThan
  • lessThan
  • greaterThanOrEqual
  • lessThanOrEqual
  • sum
  • subtract
  • multiply
  • divide

Expression Variables

Additional values can also be referenced from expressions:

  • _input_ → The input payload passed to the Wizard instance during its creation. Use this variable to set default values:
    • "{! _input_.Slogan }"

Identifiers for Custom, SObject, and SObject Field Labels

To get custom, sObject, and sObject field labels, use the identifiers, $Label and $SObjectType in expressions.

All Wizard Components support expressions with the $Label and $SObjectType identifiers.

Note

Expression Syntax for a Custom Label
{! $Label.<Label name with namespace> }
Expression Syntax for an sObject Label
{! $SObjectType.<SObject names with namespace>.label }
Expression Syntax for a Field Label
$SObjectType.<SObject names with namespace>.fields.<SObject Field with namespace>.label }
Examples
{! $Label.cgcloud__NPW_KPI }
{! 'Test ' + $Label.cgcloud__NPW_KPI + ' Test' }
{! $SObjectType.cgcloud__Promotion__c.label }
{! $SObjectType.cgcloud__Promotion__c.pluralLabel }
{! $SObjectType.cgcloud__Promotion__c.fields.cgcloud__Slogan__c.label }
{! $SObjectType.cgcloud__Promotion__c.label + ' - ' + $SObjectType.cgcloud__Promotion__c.fields.cgcloud__Slogan__c.label }