Video Screencast Help

Configurable Collection Filter

Created: 13 Jun 2012 • Updated: 10 Jan 2013
Language Translations
Collaborators: SymantecWorkflowTeam, Chan Eil Fhios
SymantecWorkflowTeam's picture
0 0 Votes
Login to vote

Component definition

This component filters a collection based on a configurable, embedded decision model. It can optionally work in place or store the results into a separate variable.

Component icon

[Insert component icon Image file here.]

Definition of component input value or values

General
Input Value Name Input Value Data Type Req'd Example Format Explanation
Data Type String Yes Process Contacts Specifies what type of data is stored in the collection.
Array Variable Name String Yes AllContacts The name of the collection whose elements will be filtered. if "Copy Result To New Variable" is not checked the filtered collection will overwrite this variable.
Copy Result To New Variable Boolean Yes   If checked, the filtered collection will be stored into a new variable, preserving the values in the original collection. If not, then the original variable will be overwritten with the filtered results.
Variable to Copy Results String * PrimaryContacts If checked, the filtered collection will be stored into a new variable, preserving the values in the original collection. If not, then the original variable will be overwritten with the filtered results.
Filter Model EmbeddedDecisionModelDataType Yes   This is an embedded decision model that will be applied to each member in the source collection in turn to determine which ones to keep. This model will have a called Element containing the item currently being reviewed. If this value should be kept, route to the "Keep Value" end component. If not, route to the "Filter Out Value" end component.

*When the field is required is described in the "Explanation" column.

Definition of component output value or values

If "Copy Result To New Variable" is selected, the filtered list will be output in a variable with the name provided in "Variable To Copy Result".

Connection information

None

Component settings

None

Use case

Notify Primary Contact

A common use case would be to notify the primary contact on a workflow that some event has occurred. In this case, we need to find the primary contact from the full list of contacts retrieved from the process and use the contact's email address to send the message:

The embedded decision model would check the Element.IsPrimary and route to "Keep Value" when it is true:

[Example 2]

[Describe the use case. Insert screen shots or package files. Insert a description of how the settings are configured. Insert additional information about the use case that you are submitting.]