find-data-record-by-id

find-data-record-by-id Function Type

The find-data-record-by-id function type finds a record in a data collection by its ID.

Usage

This function type is used in Actions to provide access to data collection find by ID functionality.

Configuration Example

name: Find Task
key: find-task
type: find-data-record-by-id
config:
  dataSource:
    collectionKey: tasks
  fieldMapping:
    importValue:
      title:
        $var: $.summary
  # Required: record ID
  id:
    $var: $.input.taskId

Configuration Parameters

  • dataSource - Data source configuration
    • collectionKey - Identifier of the data collection to operate on
    • collectionParameters - Parameters passed to the collection methods
    • udm - (for universal integrations only) Universal Data Model to read
  • fieldMapping - Field mapping configuration
    • importValue - Maps fields from external app to your app format
  • id - Record ID to find (supports formulas)

Output

Single record object or null if not found