Match Data Record

The match-data-record function type finds a data record with fields matching a query. Unlike find-data-record-by-id which searches by ID, this function type searches by field values.

Usage

This function type is used in Actions to provide access to data collection match functionality.

Configuration Example

name: Find Contact by Email
key: find-contact-by-email
inputSchema:
  type: object
  properties:
    email:
      type: string
type: match-data-record
config:
  dataSource:
    collectionKey: contacts
  lookup:
    query:
      email:
        $var: $.input.email
  fieldMapping:
    importValue:
      name:
        $var: $.fullName
      email:
        $var: $.primaryEmail

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
• lookup - Query configuration for matching records
  • query - Field values to match against (supports formulas)
  • universalQuery - Universal field values for matching (for universal integrations)
• fieldMapping - Field mapping configuration
  • importValue - Maps fields from external app to your app format

Output

Single record object or null if no match is found