Corporate logotype
  • Tonkean
  • Platform
  • Community
Corporate logotype
  • Get Started
    • Tonkean Platform
      • What is Tonkean?
        • What is a Solution?
          • What is a Module?
            • What is a Business Report?
            • Navigate Tonkean
              • Solutions Studio
                • Enterprise Components
                  • Business Reports
                    • Runtime
                    • Quick Start Guide
                      • Build Your First Solution
                    • Maker Playbook
                      • Create a Solution
                        • Create a Module
                          • Create and Manage Fields
                            • Basic Fields
                            • Manual Fields
                            • Matched Entity Fields
                            • Formula Fields
                              • Global Fields
                              • Set Up Actions
                                • People Coordination
                                  • Ask a Question
                                    • Ask for Status
                                      • Send Update Form
                                        • Ask for Information
                                          • Approval Cycle
                                            • Ask for Next Steps
                                              • Assign Owner
                                                • Send Notification
                                                • Workflow
                                                  • Update Field
                                                    • Ops Module
                                                      • Text Analysis (NLP)
                                                        • Train
                                                          • Create Sub Items
                                                            • Delay
                                                              • Wait Trigger
                                                                • Iterate Related Items
                                                                  • Text Extractor
                                                                    • OCR Conversion
                                                                    • Data
                                                                  • Set Up Triggers
                                                                    • Item is Added
                                                                      • Match Conditions
                                                                        • Field Changed
                                                                          • Form Filled
                                                                            • On Scheduled
                                                                            • Create and Manage Forms
                                                                              • Add a Create Form
                                                                                • Add an Update Form
                                                                                  • Collect Inner Items Forms
                                                                                    • Upload File Forms
                                                                                  • Add Matched Entities
                                                                                    • Create a Matched Entity
                                                                                    • Create and Manage Training Sets
                                                                                      • Create a Training Set
                                                                                        • Configure a Text Extraction Training Set
                                                                                          • Configure an NLP Search Training Set
                                                                                            • Use Training Sets in a Module
                                                                                          • Admin Playbook
                                                                                            • Connect Native Data Sources
                                                                                              • Manage Data Sources
                                                                                                • Email Inboxes
                                                                                                • Connect Custom Data Sources
                                                                                                  • Create a Webhook Connection
                                                                                                    • Create a Manual Custom Data Source
                                                                                                    • Create a Custom Data Source with CSV Upload
                                                                                                  • Manage Users
                                                                                                    • Connect an Identity Provider
                                                                                                      • Connect an Okta Directory
                                                                                                    • Create and Manage People Directories
                                                                                                      • Create a People Directory
                                                                                                        • Assign Business Groups to Environments
                                                                                                        • Add Group Communication Methods
                                                                                                    • Business Reports and Metrics
                                                                                                      • Create Key Metrics
                                                                                                      • Runtime Jobs
                                                                                                      • Resources
                                                                                                        • Data Sources
                                                                                                          • Google Sheets
                                                                                                            • Slack
                                                                                                              • Salesforce
                                                                                                                • Okta
                                                                                                                • Security and Data
                                                                                                                  • Architecture and Stability
                                                                                                                    • Data Monitoring
                                                                                                                      • Permissions and Access Control
                                                                                                                      • Frequently Asked Questions
                                                                                                                      • Release Notes
                                                                                                                        • Reference
                                                                                                                          • Formulas
                                                                                                                            • Numbers
                                                                                                                            • Date
                                                                                                                            • Boolean
                                                                                                                            • Strings
                                                                                                                          • Conditions
                                                                                                                            • Markdown Format
                                                                                                                              • Glossary
                                                                                                                              • Tonkean
                                                                                                                              • Platform
                                                                                                                              • Community
                                                                                                                              print
                                                                                                                              • Prev
                                                                                                                              • Next
                                                                                                                              • Tonkean Docs
                                                                                                                              • Maker Playbook
                                                                                                                              • Set Up Actions
                                                                                                                              • Workflow
                                                                                                                              • Iterate Related Items

                                                                                                                              Iterate Related Items

                                                                                                                              The Iterate Related Items action allows you to pull in items related to a matched entity and use those items in your module. This action is commonly used when you need to pull items into a workflow that are not from the input data source.

                                                                                                                              For example, if the input source for a module is an email inbox where you receive client requests and you have a Google Sheet matched entity containing detailed information on all clients, you might use an Iterate Related Items action to pull in the relevant information for the client who contacted you and add it to a Slack notification that's sent to the relevant member of your team. That team member can then address the request with all the important information about that client, automatically pulled from the Google Sheet.

                                                                                                                              The Iterate Related Items action is always followed by a trigger. When selecting the add block button, add_block.png, after an Iterate Related Items action, an Item is Added trigger is automatically created.

                                                                                                                              overview.png

                                                                                                                              Name the Action Block

                                                                                                                              Select the action title or the blue pencil icon, blue_edit_pencil.png, and provide a descriptive title for the action.

                                                                                                                              Turn Action Block On or Off

                                                                                                                              By default, action blocks are enabled and turned on. Select the toggle in the top right of the action panel to disable or turn it off.

                                                                                                                              When building a module, remember you can toggle actions on and off rather than deleting them.

                                                                                                                              turn_action_block_on_toggle.png

                                                                                                                              Select a Matched Entity that will be monitored

                                                                                                                              Select an existing matched entity from the dropdown or select New Matched Entity to create a new matched entity to monitor.

                                                                                                                              select_matched_entity.png

                                                                                                                              Preview Items

                                                                                                                              Select Preview Items to preview the data that the Iterate Related Items action will pull in from the selected matched entity.

                                                                                                                              preview_items.png

                                                                                                                              Continuously sync vs. Import only once

                                                                                                                              You have two options for configuring how the Iterate Related Items action monitors and acts on the matched entity's related items:

                                                                                                                              • Continuously sync - The Iterate Related Items action syncs every time a new related item is created in the matched entity data source.

                                                                                                                              • Import only once - The Iterate Related Items action syncs only once, pulling in related items in the matched entity data source. Any related items added to the data source in the future are not synced.

                                                                                                                              In this section:
                                                                                                                              • Iterate Related Items
                                                                                                                              • Name the Action Block
                                                                                                                              • Turn Action Block On or Off
                                                                                                                              • Select a Matched Entity that will be monitored
                                                                                                                              • Preview Items
                                                                                                                              • Continuously sync vs. Import only once

                                                                                                                              Search results

                                                                                                                                No results found

                                                                                                                                Would you like to provide feedback? Just click here to suggest edits.

                                                                                                                                • Prev
                                                                                                                                • Next
                                                                                                                                © 2022
                                                                                                                                Last modified: February 4, 2022
                                                                                                                                Publication date: