Promote Items of Arrays

arrays are an ordered collection of values of the same data type values vary based on the action connector and/or assets, and may include, but are not limited to ip addresses, file names, urls, etc you may want items of array properties without having to use jsonata transformations to select certain properties out of action results turbine allows you to promote specific items of array action outputs turbine allows you to select all (default), first , or last level array properties array level property action taken all this is the default option this promotes all items for the selected array property first this option promotes the first value in an array property last this option promotes the last value in an array property to select specific items to promote from an array, you need to use a connector that has at least one array property value if not, you will not see the drop down option to select all, first, or last on action outputs, options vary depending on the connector and configuration however, next to array property types, the promotion level drop down menu defaults to all items the promoted playbook outputs pane is empty until you promote action outputs you have a few options let's start with promoting all items on an array promote all items in the example, there are three visible array properties domain , email , and filename for this example, let's focus on the domain array to promote all of the items in the domain array next to the domain array, leave the promotion level drop down menu in its default state all items click +promote to see the array property in the promoted playbook outputs from promoted playbook outputs, the domain array outputs all values for that array promote first value in the example, there are three visible array properties domain , email , and filename for this example, let's focus on the email array to promote the first value of the items in the email array next to the email array, click the promotion level drop down menu and select first click +promote to see the array property in the promoted playbook outputs from promoted playbook outputs, the email array outputs only the first item for that array promote last value in the example, there are three visible array properties domain , email , and filename for this example, let's focus on the filename array to promote the last value of the items in the filename array next to the filename array, click the promotion level drop down menu and select last click +promote to see the array property in the promoted playbook outputs from promoted playbook outputs, the filename array outputs only the last item for that array tips and things notice the difference in the promoted outputs among the three examples domain outputs all items ; email outputs first item ; filename outputs last item to remove a promoted action item, you must click x remove you can rename the key of a promoted output click the edit icon next to the output key name, and then rename as desired then, click ok to return to action outputs