Skip to main content

CREATE

Use the CREATE function to create a new array from values that can be literals, fields and a formula that returns values.

Use

CREATE( item1, [item2], ... )
Creates an array using the values provided.

ParameterRequiredDescription
item1Yesthe first value of the array
item2, ...Noadditional values of the array

ReturnsArray matching the type of item1

Examples

Manual Activity Assignment

Activity Assignment formulas must return a Person Array. You can use the CREATE function to manually assemble a list of specific individuals who should be assigned to an activity.

  • Formula: CREATE('person:Adele Vance', 'person:Megan Bowen', @Trigger.out.Manager)
  • Logic:
    • 'person:Adele Vance' and 'person:Megan Bowen': These are person literals representing specific employees.
    • @Trigger.out.Manager: This is a data field captured from the trigger form where a submitter might have selected their manager.
    • Result: The CREATE function joins these three distinct identities into a single Person Array. This allows the activity to be assigned to all three people simultaneously.

Data Aggregation for Validation

You can use CREATE to group separate pieces of data (that are not already in an array) into a single collection so they can be processed by array functions like COUNTIF or SUM.

  • Scenario: You have a form with three separate logical (True/False) checkboxes for different safety checks. You want to ensure that at least two of these checks are marked as TRUE before the form is valid.
  • Formula: COUNTIF(CREATE(@Trigger.out.Check1, @Trigger.out.Check2, @Trigger.out.Check3), TRUE) >= 2
  • Logic:
    • CREATE(...): This takes three independent logical outputs and places them into one temporary array.
    • COUNTIF(..., TRUE): This function then looks at the newly created array and counts how many of those items are TRUE.
    • Comparison: The formula returns TRUE only if the resulting count is 2 or higher, fulfilling the validation requirement.