Inputs

actions are individual capabilities of connectors that interact with external technologies by passing in data via action inputs results are available from action outputs actions can call another playbook interact with external technologies contain inputs and outputs (outputs can be promoted through the playbook outputs dialog) you do not need a trigger to add an action to your playbook create actions from your current playbook, open the add panel on the left side of the screen the add panel displays available actions, connectors, and components organized by category the panel has three tabs triggers , actions , and components browse or search for the desired action from the available connectors and native actions native actions (such as create variables, update variables, http request, script, transform data, condition, loop, parallel, create record, delete record, search records) appear at the bottom of the add panel connector actions are organized by vendor/connector above the native actions drag the action from the add panel drop the action onto the canvas drop onto a drop zone (indicated by a plus icon) to add it to the flow drop onto an edge to insert it between existing actions drop onto a node to connect it after that action after dropping, the action appears on the canvas and the action details panel automatically displays to the right of the playbook in the action details panel, under the info section the action field displays the selected action type enter the required title field the key field auto populates based on the title field, but you can edit it if needed optionally add a description the key field must be unique and only contain a z, a z, 0 9, or underscore characters you can drag and drop connector actions, native actions, or existing playbooks (components) as actions to nest in your current playbook once you have dropped an action, you can configure its inputs and outputs by clicking the configure button in the data section of the action details panel, or by clicking the edit icon on the action node in the canvas configure action inputs action inputs are information necessary for the execution of the task action icon meanings icon meaning edit icon opens the configure dialog to edit action inputs and outputs delete icon this deletes the entire action open the configure dialog to configure action inputs and outputs, open the configure dialog in one of two ways from the action details panel in the data section, click the configure button from the canvas click the edit icon that appears when you hover over an action node the configure dialog opens with inputs and outputs tabs, where you can configure the action properties the configure dialog appearance and available options vary depending on the action type for example, native actions like create variables, update variables, http request, script, transform data, condition, loop, and record actions each have their own specialized configuration dialogs based on the selected connector or action type, action inputs auto populates properties under connector action or action inputs also, the additional options section displays available assets, which are based on the connector the section also includes repeat property options see repeats for details assets allow users to create a reusable set of values that can be applied to actions as inputs in playbooks assets can be for a specific connector, or created as a custom asset which can be applied to any action inputs assets are most useful for standardizing and securing configurations assets = action configuration templates configure connector properties when configuring an action, the available property types display under connector action depending on the property type, there are different values you can apply the value options are different for string property types and all other types the default value for string property type is dynamic value the default value for other property types is static value what's a dynamic value? a dynamic value for string property types allows you to add context and/or repeats to a playbook property or expression for details, see the configure concatenation for strings without formats sub section and/or action repeats configure other values for property types the default value for other property types is static value for property types other than string, the drop down menu options are static value , playbook property , or expression , which allow you to enter a static value, apply a playbook property, or create a dot notation expression to configure the connector properties click the property type drop down, then select from static value , playbook property , or expression complete for all required properties click apply select assets connectors have assets assets are pre defined configurations for some input fields required in actions, or you can customize assets select pre defined assets navigate to the action inputs if you want to apply an existing asset, click the select from available assets menu and select an asset the available asset property fields are auto filled complete any fields that are not auto populated click apply customize assets see create custom assets for instructions on how to create and configure a custom asset and apply it to a playbook action property types actions have the following input property types property types description string sequence of alphanumeric characters number floating point and integers integer real numbers that do not have a floating point boolean either of the values true or false object structure that contains more properties array ordered list of zero or more elements, each of which may be of any type arrays use square bracket notation with comma separated elements array types arraynumber, arraystring, and arrayobject null empty value, using the word null date iso 8601 date string without time information date & time iso 8601 string with date and time password obfuscated string, the text will not be human readable within the platform code formatted code string configure concatenation for strings without formats concatenation is the ability to add context to a playbook input property turbine currently only supports the string property type without formatting concatenation only works with string properties that do not have a format, i e , api keys would not be used with string concatenation the property types date , date & time , and password are string inputs; however , they are formatted therefore, you cannot create a string concatenation using those properties before configuring concatenation for strings without formats, ensure you complete (as needed) configure action inputs configure connector properties select assets now, create a concatenation for strings without formats you need playbook inputs and/or expressions to configure an action input for string concatenation let's begin by creating a playbook input from the action inputs window from action inputs, in the desired property field, click + select a property click playbook inputs if you have not added any playbook inputs yet, you will need to click add a playbook input configure a playbook input for the string click done , then select the playbook input you configured the input displays as a token in the appropriate field next to the token, enter text, for example, world! the token and static value text display as string concatenation you have successfully created a string concatenation! see string concatenation use case for an example of executing string concatenation using expressions with playbook input data playbook inputs can be structured as arrays or objects, allowing you to pass complex data structures into your playbook you can use expressions (dot notation) to access nested properties within playbook input data understanding playbook input structure when playbook inputs contain arrays or objects, you can structure your input data as follows example input data structure { "inputs" \[ { "name" "applicationname", "value" "alert exceptions" } ] } in this example, inputs is an array containing an object with name and value properties accessing playbook input data with expressions to access nested properties in playbook input data, use the $inputs prefix followed by dot notation to navigate through the data structure expression syntax $inputs propertyname access a top level property $inputs arrayname\[index] access an array element by index $inputs arrayname\[index] propertyname access a property within an array element $inputs objectname propertyname access a nested object property example given the input data structure above, you can access the name property using $inputs inputs\[0] name this expression $inputs references the playbook inputs inputs\[0] accesses the first element of the inputs array name accesses the name property of that object result the expression evaluates to "applicationname" using expressions in action inputs to use expressions with playbook input data in action inputs navigate to the action inputs configuration for the property where you want to use an expression, select expression from the drop down menu (for non string types) or use dynamic value (for string types) enter the expression using dot notation, starting with $inputs example use cases accessing array elements if your playbook input is an array of objects, use $inputs items\[0] id to get the id of the first item accessing nested objects if your playbook input contains nested objects, use $inputs config settings timeout to access deeply nested properties dynamic array access use expressions like $inputs inputs\[$inputs selectedindex] value to dynamically select array elements based on other input values note expression evaluation occurs at runtime, allowing you to dynamically access playbook input data based on the structure you provide when running the playbook add object sub properties the property types object and array have sub properties you can map the sub properties as a static value, playbook property, or dot notation expression to add an object sub property navigate to the action inputs navigate to the object property type click add object properties select a sub property from the drop down repeat steps 3 and 4 if you want to add more than one sub property map the property type by selecting from static value , playbook property , or expression the dynamic value option defaults for string property types if desired, you can also change the name of the sub property to enable editing, click in the sub property field and enter a new name the new name and selected mapped option display add array sub properties navigate to the action inputs depending on the connector, array types might be available navigate to the array property type click add array items click add an item click add a dynamic value field displays that allows you to add context and/or select a property repeat steps 4–6 if you want to add more than one sub property configure the array sub property click apply clear a sub property entry to clear the information for the sub property click the clear value icon click apply to save the changes delete a sub property entry to delete the information for the sub property click the delete vertical ellipsis click apply to save the changes