Activities



Convert From DateTime To FileTime

This activity converts the DateTime value to FileTime.

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:


Convert From FileTime To DateTime

This activity converts the FileTime value to DateTime.

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:

Execution Log:


Custom ForEach

This activity cycles through elements of a collection.

When dragging the activity, the iterator type is required. If the collection to be iterated is of type Collection<Int32> , then the value selected in Select Types window should be of type Int32.

If the collection to be iterated is a collection of sub-collections of type Collection<Collection<PSObject>>, the TypeArgument property of the ForEach activity should be of type Collection<PSObject> and a second ForEach activity is to be used to iterate through the remaining collection. The TypeArgument property of the second ForEach should be of type PSObject.


For each element of the provided collection the activity will execute all activities dragged into the Body area.



Custom ForEach Conditional

This activity cycles through elements of a collection until a condition is met. The type of the input collection is detected automatically without user selection (as for Custom ForEach activity). The values for Condition and Values parameters can be bound to variables, global variables or IN arguments. 


For each element of the provided collection the activity will execute all activities dragged into the Body area. When the condition in Condition field is evaluated to True, it exists the iteration cycle.


NOTE: When a collection of custom type is used, the iterator will be converted to Object type automatically and a conversion to collection  type is required before accessing the iterator. E.g. Collection<KeyValuePair<String,String>> is the collection to be iterated. The iterator automatically is converted to Object not to KeyValuePair<String,String> which is the collection type, so the user must convert the Iterator to the collection type in the workflow logic as follows:

 

 



Custom If

This activity executes a sequence of actions based on the result of a condition.

The condition evaluates if the element of the collection that is being iterated, is equal to "Flowster". If the condition is true, it will execute the "If Branch". If the condition is false it will execute the "Then Branch". The value for Condition parameter can be bound to variables, global variables or IN arguments. 




Custom While

This activity executes a sequence of actions until the given condition is no longer true.

This activity represents a control-flow type activity and it allows activities inside the block to get executed repeatedly on the given Boolean condition. The condition evaluated in the CustomWhile activity is 'Counter < 5' where "Counter" is a predefined IN argument with default value '0'. The block consists of two activities, one Assign activity to increment the value of the "Counter" by 1 at every step and a Write activity to display the "Counter" at each step. The CustomWhile execution stops when "Counter" value is higher than 5. The value for Condition parameter can be bound to variables, global variables or IN arguments. 




Delay 

This activity creates a delay until the given date & time.

Parameters:

Delay by Date

This activity creates a delay until the given date & time.

Parameters:



Evaluate Expression

This activity evaluates an input expression.

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:


 


Log Track Data

This activity writes the input value to the Track Data.

Parameters:




Selective Execution

The "Enabled" property default value is checked, thus the execution of the child activities inside the Selective Execution sequence is enabled. 


 

The switch to disabled may be done either from the Properties panel  or from the Workflow Designer panel.


Write

This activity writes text to console without ending the line.

Parameters:


Start Flowster Workflow

This activity starts the specified workflow using the Flowster RestAPI.

Activity Parameters

The Start Flowster Workflow activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:


Configuration: below there can be seen a detailed example on how to configure Flowster Administrator and the Start Workflow activity in order to properly execute another Flowster workflow via the Start activity.







                                          

                                         




Execution:



Start Snippet Workflow

This activity starts the specified snippet workflow. 

Activity Parameters

The Start Snippet Workflow activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

Snippet (text box editor type) (type: string): select the snippet workflow. This list is populated with active snippets. If this list is empty, this means there is no active snippet configured in Administrator. 

The Read Only Output variable are the possible output values that the activity will provide:



Configuration : before Start Snippet Workflow activity is used , user must have at least one active snippet workflow in Administrator, as seen below. For further on information about createing a snippet workflow, please visit 


IMPORTANT: 



Execution: the execution tracking data of a snippet workflow is inserted into the Tracking Data of the triggering workflow. 



The values for the out arguments are displayed at the end of the snippet's Tracking Data. In order to extract values from Output OutArguments parameter, a Cast activity is needed to cast the object to the type of the out argument in the snippet. For example, if a snippet has an out argument of type Array<Int32>, the output argument is sent as an object to the Output OutArguments in the list of KeyValuePairs of arguments. In order to obtain values from the array, a cast from Object type to System.Int32[] is required using Cast activity, as seen below:

   


One must define a local variable of the resulted type to store the cast result, in this example a new variable MyArrayOfInt32 was created of type System.Int32[]. In the Operand field, the index of the interested out argument from the list was inserted, in this example, the forth out argument:


The array values are now stored in the local variables and may be extracted either by iteration or by index, for example MyArrayOfInt32(0) to extract the first element in the array. 


Stop Flowster Workflow

This activity stops the specified workflow using the Flowster RestAPI.

Activity Parameters

The Stop Flowster Workflow activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:

Get Workflow Execution Status

This activity retrieves the status for the specified workflow using the Flowster Rest API.

Activity Parameters

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:


Get Workflow Parameters

This activity retrieves the specified workflow's parameters using the Flowster Rest API.

Activity Parameters

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:


In order to iterate through the Ouput parameter collection, ForEach activity is used together with Get KeyValuePair activity to extract the value of the key Name:



Execution:


Get Workflow Tracking Data

This activity retrieves the Tracking Data for the specified workflow using the Flowster Rest API.

Activity Parameters

Parameters:

The Read Only Output variable are the possible output values that the activity will provide:

See below an example on how to iterate the list of OutArguments and extract output parameter 'ParamListKeyValuePair' of type List<KeyValuePair<String,DateTIme>> value. NOTE: because the values stored in the 'Value' keys of the list of dictionaries, are of type Object, a conversion is needed if the type of the output argument is different than Object, as seen below:

                      




Wait For More Input

This activity waits for more user input. It sends an email notification to the user(s), mentioning to provide more values from Portal in order to continue the execution.

Functionality

If this activity is included in a workflow, when it is executed, it will send an email to all the users set in the Assigned User(s) parameter. Users must be members of a Security Group in Flowster Studio. If assigned users are members from a Users type group, the group should have permissions to access the Portal.

After the workflow is started, when the execution reaches this activity, the status of the execution is updated from Running to Waiting for user input

When resuming the workflow, a list of selected parameters will be displayed with the initial values  for the user to input (or not) different values. If more than one activity is used in the same workflow with the same selected parameters, on the next resume action, the values of the parameters will be the previous ones, not the initial ones. 

Activity Parameters

Parameters:


The Read Only Output variable are the possible output values that the activity will provide:

The values from the output parameter can be extracted, for example, by using a Custom ForEach activity or by using GetKeyValuePair activity, to extract a specific parameter:

For example, GetKeyValuePair activity is used to extract the new value for ADGroups (String[]) parameter from Output_NewParameterValues output returned by WaitForMoreInput activity:

  

The value extracted from key ADGroups is of type Object, but the value stored is of type String[], therefore a cast is needed to cast the int_NewADGroups parameter from Object to String[], using Microsoft activity, Cast:


If the parameter type is generic (Int32, String), Cast activity is not needed, just an implicit cast of the object type to desired type. For example, CInt(Port) or Username.ToString().

Write Data To Storage

This activity writes the given input data into a text file located in the network path set for the active tenant.

Activity Parameters



Parameters:

The Read Only Output variable are the possible output values that the activity will provide:


This parameter requires a Central Storage Path to be defined in Administrator for the tenant where it will be used (see how to configure the tenant's storage path:  /wiki/spaces/FS/pages/16060940329).

This activity can be used multiple times in a workflow, each time appending the new content to the execution file. It can insert predefined strings and/or variables/arguments values.

When this activity is used in a workflow, in the Flowster Studio Portal - History page there will be given the possibility to download the created file by selecting the Info option for an execution and clicking the Download link:



This is an example of a file which can be created by using this activity: