Literals and Data Types

Literals and Data Types

Dynamic Expressions support various types of literals and data types that enhance the flexibility and interactivity of your workspace.

Supported Literals

Understanding supported literals helps you use direct values in expressions, such as numbers, text, booleans, and null values, to create dynamic and precise calculations or display content.

• numbers: You can use raw decimal numbers directly in your expressions.
  • Examples:{{ 2 + 2 }}
{{ 2.5 + 3 }}
{{ 2.33 * sessionUser.stats.likes }}

• text: You can use literal strings of text in your expressions by surrounding them with quotes.
  • Supported Quotes:
    • Double quotes: "Hello"
    • Single quotes: 'Hello'
    • Curly double quotes: “Hello”
• booleans: Boolean values true and false can be used directly.
  • Examples:{{ true }}
{{ false }}

• null: Represents the absence of a value.
  • Examples:{{ null }}

• undefined: Represents the absence of a value, similar to null.
  • Examples:{{ undefined }}

  • Note: Both undefined and null are supported for compatibility with programming conventions.

Supported Data Types

Familiarity with data types ensures you know what kind of information your expressions will return or process, which helps avoid errors and improves data handling.

• date: A timestamp representing a specific date and time.
  • Example:2025-01-09T22:46:24.872Z

• boolean: Represents the values true or false.
  • Example:true

• number: A decimal number.
  • Example:125

• text: A string of text.
  • Example:"Hello, World!"

• uuid: A universally unique identifier (UUID) string.
  • Example:"590ff486-aa05-468e-839c-e3fe2548fed5"

• json: A record containing structured data in key-value pairs.
  • Example:{"a": 1, "b": 2}

• unknown: Represents data of an unknown type.
  • Example:N/A
• file: Represents a file object.
  • Example:File { filename: "screenshot.jpeg" }
• user_rank: The rank of a user.
  • Example:2000
  • Possible Values:
    • 1000 (guest)
    • 2000 (member)
    • 3000 (admin)
    • 5000 (owner)
• locale: A locale string in BCP 47 format.
  • Example:"en"
• review_result: The outcome of a review.
  • Possible Values:
    • "accepted"
    • "rejected"
• mission_status: The status of an idea collection.
  • Possible Values:
    • "PENDING"
    • "ACTIVE"
    • "ENDED"
• device_kind: A type of device.
  • Possible Values:
    • "desktop"
    • "mobile"
    • "tablet"
• activity_kind: A type of activity.
  • Possible Values:
    • "CREATE_IDEA"
    • "CREATE_IDEA_EXPANSION"
    • "CREATE_ASSIGNMENT"
    • "CREATE_TAG"
    • "CREATE_MISSION"
    • (and more)
• chart_kind: A type of chart.
  • Possible Values:
    • "BAR"
    • "LINE"
    • "PIE"
    • "SCORECARD"
    • "XY_PLOT"
    • "LIST"
    • "WORD_FREQUENCY"
    • "MAP"
    • "FUNNEL"
    • "RADAR_PLOT"
• status_kind: A category of status.
  • Possible Values:
    • "ACTIVE"
    • "COMPLETED"
    • "ARCHIVED"
• like_kind: Determines whether a "like" is related to an idea or a comment.
  • Possible Values:
    • "idea"
    • "comment"
• phase_kind: A type of phase in an idea process.
  • Possible Values:
    • "REVIEW"
    • "GROW"
    • "RATE"
    • "ACT"
    • "EXPAND"
    • "DONE"
• media_kind: A type of media.
  • Possible Values:
    • "video"
    • "image"
    • "audio clip"
    • "custom font"
    • "icon"
    • "document"
• invitation_status: The status of a user invitation.
  • Possible Values:
    • "Invited"
    • "Opened"
    • "Accepted"
• idea_field_kind: A type of form field in an idea collection.
  • Possible Values:
    • "SHORT_TEXT"
    • "LONG_TEXT"
    • "ATTACHMENTS"
    • "NUMERIC"
    • "CHECKMARK"
    • "SLIDER"
    • "RADIO"
    • "SELECT"
    • "DATETIME"
    • "CODE"
    • "IMAGE_CHOICE"
    • "SCORE"
    • "USER"
    • "STATIC"
• mention_kind: A type of @mention.
  • Possible Values:
    • "comment"
    • "idea_field_instance" (represents part of an idea or form entry)
• id<entity>: A UUID string that corresponds to a unique object of a specific entity.
  • Example:"27ce21c9-a174-4c34-becc-f1068426f36a"

• ref<entity>: A reference to a full object of a specific type of entity.
  • Example:{ "_entity": "comment", "id": "93f970de-334c-423e-be0a-f0cf84c3da3b", "createdAt": "2025-01-09T23:05:17.042Z" }


By understanding literals and data types, you can create richer, more dynamic expressions that suit a variety of contexts.