LogoLogo
Visit Contextual.ioSign Up
  • Getting Started
    • Welcome
    • Tour: Hello, AI World!
  • TRAINING
    • Basic Developer Training Course
      • Lesson 1: HTTP Agent Introduction
      • Lesson 2: Logging and Error Handling Basics
      • Lesson 3: Event Processing Agent Introduction
  • Services Catalog
    • What's in the Catalog?
      • Intro Patterns
      • Object Type Bundles
    • Browse by Platform
    • All Intro Patterns
      • Anthropic Claude Image Analysis
      • Mistral AI Prompt and Response
      • xAI Grok Prompt and Response
      • DeepSeek Chat Prompt and Response
      • Qwen Chat Prompt and Response
      • Perplexity AI Search and Response
      • Firecrawl Website Scraper
      • Groq Prompt and Response
      • Nyckel Dog Breed Classification
      • RapidAPI ClassifyAI Text Classification
      • RapidAPI YouTube AI Video Summary
      • UnifyAI Model Comparison
      • WebPilot URL Analysis and Summarization
      • OpenAI Assistants Prompt and Response
      • OpenAI Sync
    • All Prebuilt Solutions
      • Invoice AI
      • Lead Generation Form
    • All Object Type Bundles
      • Work Order Management System ITIL Object Type Bundle
        • Work Order
        • User
        • Role
        • Permission
        • Asset
        • Task
        • Action
        • Attachment
        • Comment
        • Notification
        • Audit Log
        • Service Level Agreement
        • Custom Fields
        • Work Order Template
        • Work Order Transition
        • Escalation Policy
        • Tag
  • Components & Data
    • Object Types
      • Data in Contextual
        • Secrets
        • Validation
        • Versioning
      • Examples
      • Creating an Object Type
      • Object Type Details
        • Definition
        • Data Schema
          • Automatic Record Metadata
          • Generated Values
            • Dates and Times
            • UUIDs
          • Frequently Used Validation
          • Disallowing Null Property Values
          • Disallowing Undefined Properties
          • Secrets
          • AI Assistant
          • ID and PrimaryKey Permanence
        • UI Schemas
        • Features
        • Triggers
        • Actions
        • Audit Trail
        • Versions
        • Templates
        • Records
      • Using Object Types in Flows
      • Records
        • Records and Your Tenant API
        • Record Import
    • Flows
      • Nodes
      • Wires
      • Message Object
      • Flow Editor
        • Basics
        • Saving Changes
        • In-Flow Testing with Debugger
        • Restart Agents to Make Changes Active
        • Config
      • Node Reference
        • Common
          • Log Tap
          • Inject
          • Debug
          • Complete
          • Catch
          • Status
          • Link In
          • Link Call
          • Link Out
          • Comment
        • Event
          • Prepare Event
          • Event Start
          • Event End
          • Event Error
        • Object
          • Search Object
          • Get Object
          • Create Object
          • Patch Object
          • Put Object
          • Delete Object
          • Run Action
        • Request
          • Send to Agent
          • HTTP GET
          • HTTP PATCH
          • HTTP PUT
          • HTTP DELETE
          • HTTP POST
          • GQL
          • Produce Message
        • Function
          • Function
          • Switch
          • Change
          • Range
          • Template
          • Delay
          • Trigger
          • Exec
          • Filter
          • Loop
        • Models
          • ML Predict
        • Network
          • MQTT In
          • MQTT Out
          • HTTP In
          • HTTP Response
          • HTTP Request
          • WebSocket In
          • WebSocket Out
          • TCP In
          • TCP Out
          • TCP Request
          • UDP In
          • UDP Out
        • Sequence
          • Split
          • Join
          • Sort
          • Batch
        • Parser
          • csv
          • html
          • json
          • xml
          • yaml
    • Agents
      • Creating an Agent
      • Types of Agents
        • Event to Flow
        • HTTP to Flow
          • Custom Domains
      • How Agents Work
        • Flow Execution
        • HTTP Load Balancing
        • Event Routing
      • Scale and Performance
        • Flow execution
        • Parallel Instances
        • Event Lag Scaling
        • Compute Threshold Scaling
        • Instance Compute Sizing
      • Agent Details
        • Definition
        • Operations
        • Logs
          • Session Log
          • Message Log
        • Audit Trail
        • Versions
      • Using Agents in Flows
    • Connections
      • Creating a Connection
      • Types of Connections
        • Basic
        • Bearer
        • Client Grant
        • Kafka
        • Password Grant
        • Public
        • Pulsar
      • Using Connections in Flows
    • JWKS Profiles
      • Using JWKS Profiles in Your Solution
  • PATTERNS
    • Solution Architecture
      • Events, Messages, Queues
    • Working with Data
      • Search Object Node & Pagination
      • Message Payload Content - Triggers and Actions
    • Industry Cookbooks
      • Field Services
  • Tenants
    • Tenant Workspace
    • Tenant Logs
      • Contextual Log Query Language (CLQL)
        • String Searches
        • Keyword Searches
        • Advanced Operators
    • Tenant API
      • API Keys
        • API Key Settings
        • API Key Permissions
      • Documentation
  • Release Notes
    • 2024
      • 2024.12.09
Powered by GitBook
On this page

Was this helpful?

  1. Components & Data
  2. Flows
  3. Node Reference
  4. Object

Search Object

PreviousObjectNextGet Object

Last updated 12 months ago

Was this helpful?

Use a Search Object node in your Flow to query, filter, sort, and return matching Records of the specified Object Type to your Flow. To configure a Search Object node in the , drag it from the Palette to the Workspace canvas, then double-click the node to open and configure its behavior.

  1. Provide an optional Name for the node.

    • By default a Search Object node will be shown with a label of "search object", but the value you provide in the Name field will replace it in the Flow Editor UI making your flow easier to read and understand.

  2. Select a Config for the node.

    • Note

  3. Select a Type Id for the node, a value specified using one of several options.

    • type - choose this option for a dropdown that includes the Display Names of the Object Types you have created in your Contextual tenant. If the dropdown appears empty for you, be sure that your Flow has been , after which the dropdown will be kept in sync with your tenant.

    • string - choose the string option, and type in a string for the Object Type ID that you want to search, using type is recommended instead of string

    • msg. - choose this option to specify a path in the msg. object that contains the Object Type ID value that you want to perform the search against, e.g. msg.payload.thePropertyWithTheObjectTypeId, msg.event.thePropertyWithTheObjectTypeId, or msg.customObject.thePropertyWithTheObjectTypeId- the msg. object and its content are available to nodes within any flow in the same Flow Editor window (i.e., across multiple tabs in the Node-RED Flow Editor interface).

    • flow. - values in the flow. scope can be set and retrieved by nodes that exist within the same tab of your flow in the Contextual Flow Editor.

    • global. - values in the .global scope are shared, and can be set and retrieved, by nodes across any tab of your flow in the Contextual Flow Editor.

    • env variable - Environmental Variables are a feature of Agents in Contextual. Any Environmental Variables that you define as Label/Value pairs for an Agent that is sending events to a Flow, will be available to the Flow, simply type the Label of the Evironmental Variable from which you want to use the value.

  4. Specify a required Page Size to limit the number of results that will be returned to your flow.

  5. Specify the Output for the search results, e.g. msg.mySearchNodeResults.

  6. Choose a Filter Mode

    • AND will... note

    • OR will... note

  7. Add one or more Search Statements by clicking "+add" at the bottom left of the Search panel. Searches are partial match, are not case-sensitive, and are applied sequentially and cumulatively top to bottom as they are arranged in the Search panel. Use the drag-and-drop handle on the left of each row to re-order as needed.

    • Type the object path you want to evaluate on the left

    • Choose the source of the value you want to use to perform the search

      • Designate a msg. object path

      • Designate a flow. or global. variable as the source of the value

      • Choose string, and type in a value

  8. Add one of more Filter Operations by clicking "+add" at the bottom left of the Filter panel. Filters are applied sequentially and cumulatively top to bottom as they are arranged in the Filter panel. Use the drag-and-drop handle on the left of each row to re-order as needed.

    • exactSearch - Not supported at this time.

    • exists - Not supported at this time.

    • exclude - Not supported at this time.

    • includes - Not supported at this time, use a Search Statement instead.

    • from - often paired with to, can be used to filter to results in a particular range of numeric, date, or string values

    • to - often paired with from, can be used to filter to results in a particular range of numeric, date, or string values

  9. Add an optional Order By Statement by clicking "+add" at the bottom left of the Order By panel to order the data using the value of a numerical or date property.

    • Type the object path you want to evaluate on the left

    • Designate either asc or desc sort order

    • Best practice is to have a single Order By statement. If you have defined more than one Order By statement, generally, the first row in the list is the one that will be used. However, if you declare conflicting Order By statements (e.g. date asc as the first row, then date desc as the second statement) the last one in the list (date desc in this example) will be used. Use the drag-and-drop handle on the left of each row in the list to re-order as needed.

When the Search Object node is included in the path of your flow, it will retrieve and return Record data as configured, for further use within your flow.

Flow Editor
initialized with a Config
msg. object path
Example of settings for a Search Object node
Example of settings for a Search Object node