Actions

term definition characteristics action actions are individual capabilities of connectors that enable users to create automation workflows interacting with external technologies they define what a connector can do, such as retrieving data, sending requests, or managing assets on the other hand, there are prebuilt actions included by default within a connector they offer a streamlined, customized configuration experience tailored for optimal performance in swimlane turbine, requiring no manual setup by the user for more information refer to native actions docid\ ktk9sjearpgfvnngfuchr pass/process data inputs results available in outputs functionality options conditions, loops, retries, repeats, discovered outputs, testing, promote items (arrays) add panel in turbine canvas, the add panel is where you can view, search, filter, sort, and/or drag and drop actions and components actions can be filtered by vendor sorted by vendor or use case the actions default view is alphabetical by vendor, where you can easily expand or collapse each vendor list native actions are located at the bottom of the add panel turbine unique actions based on a desired outcome such as http request, conditions, loops, etc to add an action, click on the desired action, then drag to the plus icon to the expanding responsive drop zone for more details, click native actions docid\ ktk9sjearpgfvnngfuchr to learn more about individual native actions defining terms and icons the table shows the icon and meaning for the component toolbar icon meaning show/hide the add panel create a component zoom drop down menu enable or disable playbook show/hide the playbook details panel open test console at the bottom of the window click to access playbook operations like export, duplicate, or delete add and configure actions 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 now that you know what an action is, how to add it to the playbook canvas, and the available native actions, let's configure an action first, make sure you have a playbook open and you can see the add panel then follow these steps select an action, drag and drop on the canvas, and then click on the action to display the action panel on the right hand side of the window note the action title field has a maximum character limit of 50 characters ensure your title remains concise while accurately describing the action with turbine canvas, you can configure the action with assets, pools (the designated location for which the action will run), inputs, and outputs all from this action panel to ease and efficiency the following example shows a playbook you are building to call an api for alert data you want an api to retrieve investigations that match your custom parameters select the rapid7 list investigations action, then drag and drop to your canvas to configure, click on the action to display the action panel rather than manually mapping an asset, click the asset drop down select the corresponding asset any proprieties that you filled out when creating the asset automatically map to action inputs on the panel warning! if you see next to a property, it means this is a required field that was not mapped to add more or change the configuration, click configure 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 https //docs swimlane com/turbine/playbooks/actions/repeats htm 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 asset property , 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 the desired action complete required fields and apply changes now configure and save the required fields the list investigation inputs are available downstream to apply within that workflow additional action functions see the following actions inputs https //docs swimlane com/turbine/playbooks/actions/inputs htm sections for more configuration functions such as configure concatenation for strings without formats add object sub properties add array sub properties clear a sub property entry delete a sub property entry