Extract List Data Based on Tags

Description

This operator extracts matching data items from 'List 2' (Data Source) based on a specified set of unique tags. The tags can either be sourced dynamically from 'List 1' (Reference List) or provided manually via a specific tag list.

Overview

Retrieves list items by their unique tag IDs.

Scenarios

  • Data sync filtering: Extract from list B the data that corresponds to list A.

  • Lookup by ID: Given known IDs, extract the corresponding data objects directly from a large list.

  • Data alignment: After multi-branch processing, use tags to realign or filter data from different branches.

Inputs and Outputs

Inputs

Input List 1 (Reference List): Used only to supply tag IDs. The operator reads the tags of all elements in this list as filter criteria; when "Extract by Specified Tags" is enabled, this input is ignored.

Input List 2: Data source list. The operator extracts data items from this list whose tags match the selection criteria.

Outputs

Output List: List of data items extracted from Input List 2.

Parameters

Extraction Strategy

Description

Defines how to handle cases where multiple items in 'List 2' share the same matching tag.

Tuning Instructions

  • Extract All: Retrieves all items that match the specified tags.

  • Extract First: Only retrieves the first item encountered for each matching tag.

Parameter Range

Values/Range:

  • Extract all matches

  • Extract first match only

Default: Extract all matches

Tag List

Description

Manual list of integer tags for extraction (only active when 'By Specified Tag' is enabled).

Example

Extract by Specified Tags

Description

Determines the source of the filtering tags.

Tuning Instructions

  • False (Default): Dynamically uses the tags from 'List 1' as the search criteria.

  • True: Ignores 'List 1' and uses the manually entered list in the 'Tag List' parameter.

Parameter Range

Default: False