Tools

our tools section includes several useful modules that can enhance your {{scenario singular lowercase}} tools menu triggers basic trigger allows you to create a custom trigger and define its input bundles create custom bundles by adding array items the array consists of the name value pairs for example, you can use this tool for contacts or any other list that is scheduled to be sent to a specified email address ( email > send an email , gmail > send an email modules), or as a simple reminder to be triggered whenever it is necessary actions get multiple variables retrieves values that were previously created by the tools docid\ cwfbo7bvo3bpzcsxcaqof module within a single operation the main benefits of the set multiple variables module are one get multiple variables module can replace a whole series of tools docid\ cwfbo7bvo3bpzcsxcaqof modules one get multiple variables module consumes just a single operation get variable retrieves a value that was previously created by the tools docid\ cwfbo7bvo3bpzcsxcaqof module note that this module can read a variable that was set anywhere in the {{scenario singular lowercase}} the only requirement is that the tools > set variable module is executed before (in time) the tools > get variable module see the documentation for the router docid\ opqxxzcge19tawxhiaehn module for information about the order in which routes are processed increment function see our template controlled distribution of data flow for an example of the increment function tool returns a value incremented by 1 after each module's operation it is possible to configure the module to reset the value one of this tool's uses is to implement a round robin assignment of tasks to users in a group the algorithm chooses the assignees from a group in some rational order, usually going from the top to the bottom of a list and then repeating until finished (like you would deal a deck of cards) the following {{scenario singular lowercase}} sends an email to the first recipient after every odd {{scenario singular lowercase}} run, and to the second recipient after every even {{scenario singular lowercase}} run increment function scenario configure the module to never reset the value add a router set the first condition after the router odd use the mod math function set equal to 1 61d5a3ca16a69 gif do not forget to change the equal to operator from the default text operator to the numeric operator set the second condition after the router even – use the mod math function that equals 0 set multiple variables creates multiple variables that can be mapped by other modules in the route or by the tools docid\ cwfbo7bvo3bpzcsxcaqof module for every route in the {{scenario singular lowercase}} within a single operation the main benefits of the set multiple variables module are one set multiple variables module can replace a whole series of tools docid\ cwfbo7bvo3bpzcsxcaqof modules one set multiple variables module consumes just a single operation variables add multiple variables you want to set variable name enter the variable name this name will be displayed when mapping the variable in other modules variable value enter the value of the variable variable lifetime one cycle the variable is valid only for one cycle useful when multiple webhooks in one {{scenario singular lowercase}} run are received (more webhooks = more cycles) one execution the variable is valid for one execution one execution can contain more cycles set variable creates a variable that can be mapped by other modules in the route or by the tools docid\ cwfbo7bvo3bpzcsxcaqof module for every route in the {{scenario singular lowercase}} field description variable name enter the variable name this name will be displayed when mapping the variable in other modules variable lifetime one cycle the variable is valid only for one cycle useful when multiple webhooks in one {{scenario singular lowercase}} run are received (more webhooks = more cycles) one execution the variable is valid for one execution one execution can contain more cycles variable value enter the value of the variable sleep allows you to delay the {{scenario singular lowercase}} flow for up to 300 seconds (5 minutes) this function can be useful, for example, if you want to lower the target service server load or to simulate more human behavior when sending bulk sms or emails if you wish to pause the flow for longer periods of time, we suggest splitting your {{scenario singular lowercase}} into two {{scenario plural lowercase}} the first {{scenario singular lowercase}} would contain the part before the pause the second {{scenario singular lowercase}} would contain the part after it the first {{scenario singular lowercase}} would store all the necessary information in a data store together with the current timestamp the second {{scenario singular lowercase}} would periodically check the data store for records with a timestamp older than the intended delay, retrieve the records, finalize the processing of the data, and remove the records from the data store aggregators numeric aggregator allows you to retrieve numerical values, then apply one of the selected functions (sum, avg, count, max, ), and return the result in one bundle in this example, the module sums up values under the number parameter number aggregator table aggregator merges values from the selected fields of received bundles into a single bundle using a specified column and row separator, allowing you to create a table field description source module select the module you want to aggregate fields from aggregated fields select the fields from the module selected above whose values you want to aggregate into one bundle column separator select or enter the type of separator that will separate the field value columns in the resulting bundle row separator select or enter the type of separator that will separate the field value rows in the resulting bundle group by define an expression containing one or more mapped items the aggregated data will then be separated into groups with the same expression's value each group outputs a separate bundle containing a key with the evaluated expression and the aggregated text by doing this, you can use the key as a filter in subsequent modules text aggregator merges values from the selected fields of received bundles into a single bundle you can use the text aggregator tool to insert more values (e g customer names or notes) into a single bundle and send an email containing all the values in the email body or the email subject transformers compose a string converts any value to a string data type (text), making the mapping easier when mapping, for example, binary data convert the encoding of the text converts entered input text (or binary data) to the selected encoding field description input data enter the content you want to convert input data codepage enter the input data encoding type this is important for the binary form of data output data codepage select the target encoding of your data switch checks the input value for a match with the provided list of values returns output based on the result field description input enter the expression you want to evaluate cases if the input contains a value entered to the pattern field, then the value entered to the output field is returned if the condition is not met, then no output is returned or the value from the else field (below) is returned when using regex patterns, make sure to adhere to the ecmascript flavor else enter the value that is returned when the criteria set in the cases field is not met