Create or Edit a Task

a swimlane task is an action or series of actions that consist of input, configuration details, output, and triggers tasks in swimlane can be very complex and can contain multiple input and output variables use swimlane's task creation process to fine tune the tasks that you want an application to run create a new task to create a new task from the integrations, tasks page, click the plus menu icon, and then select create a task alternatively, scroll down the page until you see your application and then click create task on create a task, swimlane lists plugin actions you can filter by vendor (on the right side of the page), and/or type a task, plugin action, or vendor into the filter field once you find your desired task type, click create if your task is eligible to be forked, you can also select fork when creating your new task a forked task is copied as an editable python script next, swimlane prompts you to name your task you can also associate it with a related application or applet or leave it as a common task applications and applets can only utilize common tasks or tasks associated with them you must provide a unique name for your task in order to save it on the integration, general tab, you can rename the task, provide a description, select or create an asset, set the appropriate roi usage metrics, and enable or disable the task you can also see the task parent and the task type for each task note by default, a task is enabled upon creation you can also set up usage metrics for this task usage metrics track the time and cost you are saving by automating this task to set usage metrics, under integration roi calculation metrics fill out the manual time expenditure and personnel costs fields so that the value of the automation is calculated in usage metrics now you are ready to begin configuring your task configure a task click the integration, configuration tab to configure the task the details that you configure for your task vary depending upon the type of task that you create most tasks have a set of inputs that need to be configured in a form but others, for example python or powershell scripts, require a text editor here, you can also reference the plugin details for the plugin that is associated with the task by clicking view plugin details in addition, you configure the outputs as well swimlane's automapping helps you step through the process of output mapping for detailed information about input and output configuration see configure task input docid\ a18jba9dkqbggtr8d4kjg configure task output docid\ ocwbk73t 1mq2bihofc5p swimlane tasks work best when they are short lived jobs that can be quickly executed tasks will timeout and be terminated by the system after 4 hours when a task times out another execution of the same task is queued to replace it set triggers click the integrations, triggers tab to specify the conditions that will cause this task to run tasks can be triggered by the following conditions scheduled task runs by a specified time frame email task runs when a specified email is received record save task runs whenever a specified record is saved in the associated application integration task runs when an integration runs you can also schedule a custom trigger with a valid cron expression tasks can be referenced from workflow or from an integration button in swimlane's application builder the workflow tab shows any workflow actions that are associated with the current task click add/edit workflow to associate a task with a new workflow action the manual tab displays any layout objects associated to the task in application builder click open application builder to edit the application tasks that are triggered by an integration to update a specific value in a record are set to only affect the value once this was designed so that integration record value changes do not run in a continual loop set scheduled trigger in your task, go to triggers and select the trigger type scheduled select how often you would like the task triggered you can specify minutely, hourly, daily, weekly, monthly, yearly, or custom click save set email trigger to set up an email trigger, you must have an email or imap asset, an application with text fields, and a configured task in your task, go to triggers and set the trigger type to email select the asset you would like to use to trigger the task under configuration , click add parameter in the box that appears under script inputs select the type as trigger, select the trigger name as email, select the trigger parameter to the part of the email you want data pulled from, and enter the name of the parameter in variable continue adding parameters for each section of data you want to be pulled from the emails add any necessary manipulation in the python code under outputs , add the output type create/update records select the application and click map to existing fields map the parameters to a text field these parameters should show up on the outputs page click save set record save trigger to set up a record save trigger, you must have your task associated with an application in your task, go to triggers and set the trigger type to record save this will trigger the task every time a record is saved click save note if initial save only is turned on, the task will only save during the first save of a new record set integration trigger to use an integration trigger, you must have two tasks that you want to use in your first task, go to outputs and click execute another task click the arrow next to execute another task to expand the section select your second task this second task will trigger once the first task is complete click save