Workflow – Array Functions Premium Action

SEARCH OUR BLOG

CATEGORIES

Categories

FOLLOW US

In this Article

  • What is Array Function?

  • How to use new Action Types?

    • Add the Action

    • Action Type List

    • Action Type : Find

    • Action Type : Filter

    • Action Type : Find by Index

    • Action Type : Line Items

    • Action Type : Math



1. What is Array Function?


Array Functions is a premium action in workflow automation specifically designed to handle array data.

This functionality is very useful for complex workflows involving arrays.



2. How to use Action Types?


  • Add the Action – Click the “+” button to add an action. Search for Array Functions or scroll down to the “Actions” tab to select the same.



fjQnzTB eWi A8Hfc5BY3eu6O9nu6FEipg


  • Select Action Type – Post selecting the Array Function action we need to select the Action Type.

KSwN0UZVF2fVvtmfdqM8r7dRgG T43pWsA



 2.1 Action Type : Find

  • To find the matching key-value’s in an array of objects and return the object.0Tw hirDse81dg 5f9O BvY27bytE5yvbw
  • All the fields with data type array available in the workflow are listed here. The list of available array data is collected from Shopify Triggers, Inbound Webhook Trigger and Custom Webhook action response data.
  • In the below example we are using Shopify Order Placed Trigger and checking if a product with product id “zGhad23wfadfa” is part of the shopify line items

   Select Shopify → Line Items


  • Select Key-value to find matching object.


QxRgxTlL8BWZ5hoDcLpJAPh fowlvGpriQ


  • The list of key variables from the selected array field are listed here. In this example, the list of shopify line items key variables are listed.


RpK0iZ5yjiJVqA2JvGhDC9nz9JEg yzI Q

  • Enter value to find the match.


Ot0QmleSKXSPoaAwTNt9NoJLoLKwCoSlQA


  • Add another item – You can also find the matching object with multiple key-value pairs by adding another key-value item.


41xVo7YOiUb2fSNfhf4p0TTLqOiezC8 og

  • By completing the above steps, you can now use the returned object variables from Array Function as custom values in email, sms, if/else, etc. In the below example, the shopify line items variables are listed in the custom values.




2.2 Action Type : Filter


  • Select the “Filter” action type from the dropdown. This action type will help in filtering the array by matching key-value in an array of objects.


Use case

  • Eg: Filter the array by product group and then send it via Custom Webhook.





xYzM wzdpBz2mBtkY69Uu6eyjkwhngVWVA


  • All the fields with data type array available in the workflow are listed here. The list of available array data is collected from Shopify Triggers, Inbound Webhook Trigger and Custom Webhook action response data.


          Select Shopify → Line Items





  • Select Key value to find the matching index. 
  • The list of key variables from the selected array field are listed here. In this example, the list of shopify line items key variables are listed.





mVWjVRr



  • Enter value to find the match.


IUH8jw0yTbR6UyeyXYMeu gAt 3tYsuCOw



  • Add another item – You can also find the matching object with multiple key-value pairs by adding another key-value item.


usZi6Df 8v34CIdrgGZsofXqBSUDEzVbXA

2.3 Action Type : Find by Index


  • Select the “Find by Index” action type from the dropdown. This action type will help in finding the array’s index data.




  • All the fields with data type array available in the workflow are listed here. The list of available array data is collected from Shopify Triggers, Inbound Webhook Trigger and Custom Webhook action response data.


            Select Shopify → Line Items

F7mXn8dOquj4nkiaeTA9hSImTZ6g1iJv3w



  • The entered index value will return.



qjxe WxHvE8XW60w3rxvGErFy Mo 4IKOg




2.4 Action Type : Line Items


  • Select the “Line Items” action type from the dropdown. This action type will help to reconstruct an array with custom keys.


Use case

  • To reconstruct the array structure before sending it via Custom Webhook

  • To reconstruct the array before storing in Google Sheet (Create Rows – later)

  • To reconstruct the array to match Email Builder Shopping cart structure



8J6vtj8w bgqDcY4BBFfaBYKUn3OK6N9aQ



  • All the fields with data type array available in the workflow are listed here. The list of available array data is collected from Shopify Triggers, Inbound Webhook Trigger and Custom Webhook action response data.


            Select Shopify → Line Items


XmndzS0LCzGdu grChYUZppXaTiU2lkaQg



  • Enter the custom value in the “Key” input field and select the corresponding value from the value dropdown.


aib abONBpv6PG RZzpsLZVwWl5 YH22g




  • Add another item – You can also find the matching object with multiple key-value pairs by adding another key value item.


6UzL6kE8c0lbbZh8IrPKc8IloAgImeA 7Q


2.5 Action Type : Math


  • Select the “Math” action type from the dropdown. This action type will help to calculate Sum, Min, Max, Avg by matching key-value in an array of objects.


Use case

  • Eg: To calculate Sub total(line item total), Line Items in cart(count), Total items (qty).

zG1TSCNoTSnZHG3K6gpnM0upXPfWvajH0g




  • All the fields with data type array available in the workflow are listed here. The list of available array data is collected from Shopify Triggers, Inbound Webhook Trigger and Custom Webhook action response data.


            Select Shopify → Line Items




  • Select Key value to find the matching index. 

  • The list of key variables from the selected array field are listed here. In this example, the list of shopify line items key variables are listed.


qBzOcJkkva7R4Z5pDu4KLBaCJgrYN7gd7A



  • Select or deselect from the list of options available.

HwoW4SPTqSuBIC32wtFh7luPkQu1IiUCJg