Recipients tab

1. To add a recipient click the Add button.
   
2. Click the drop down menu of the field.
   

The following table explains the available options:

Option	Description
Default Built In Recipients	Select one of the default recipient options, either Originator and Originator Manager. By default, when adding a new recipient, the Originator is selected but this may not be correct for your logic.
Browse	Select this option to browse and search for a specific user or group. For more information about the different browse states and errors, see the Browse State topic.
Type/Construct my own	Select this option to type or construct a dynamic recipient.

3. Select the Browse option from the menu.
   
4. The Select User page displays.
   
5. If you need to search for people belonging to a different label, click the drop down menu.
   

   Use any of these methods to search for a user, role and group:

   Search method	Description
   Display name	Use the display name or part thereof to search on. Example: Type par in the search area to return results.
   Group	Use the display name or part thereof to search for a group of users. Example: Type Human in the search area to return Human Resources. Click the See Users link to view all members of the selected group.
   FQN	Use the Fully Qualified Name (FQN) to search on. Example: Type denallix\bob in the search area to return Bob. When you type a user name into the field, make sure it is a valid user and you've not made any spelling mistakes as user names are not validated. Typing an invalid user may result in orphaned workflow instances. If you think you have orphaned workflow instances, go to K2 Management and redirect the tasks to a valid user.
   Email	Use the Email address to search on. Example: Type bob@denallix.com in the search area to return Bob.

6. Type the name of the person in the search box and press Enter. Once found, select them and click OK. You can also double click to add them.
   
7. This adds the person as a recipient. If you need to add more people, click the Add button.
   

8. Your changes are automatically saved.

Sometimes you may need to drag recipients to reorder them or create recipient groups. Do this by selecting and dragging them.

1. Click to select a recipient.
2. Drag the recipient into the field.
   

3. Your changes are automatically saved.

1. To remove a recipient, select them and click the Trash bin button.
   
2. Another way to remove them is to click and drag to the Trash bin.
   

3. Your changes are automatically saved.

You can create groups in order to use them in recipient rules for controlling who gets tasks. You edit the rule by clicking the Certain Recipients, based on a rule option.

1. To create a new group of recipients, click the Add Group link.
   
2. Double click the Group title to change it.
   
3. Click the drop down menu and select the Browse option.
   
4. Use the Select User page to add a person to the group.
   
5. Use the drop down menu to specify which domain to search for the person.
   
6. In the search box type the name of the person. Select the them and click OK, or you can double-click to add them.
   
7. The person is added as a recipient in the group. To add another recipient, click the Add button.
   

8. Your changes are automatically saved.

1. You can add recipients to groups by clicking the Add button. Browse and search for users and groups.
2. Another way is to drag configured recipients into the group.
   
3. Drag recipient into the group.
   
4. You can also create a group by dragging and dropping one recipient onto another one.
   
5. To delete a group, click the X button.
   

6. Your changes are automatically saved.

Use the Type/Construct my own option to create a dynamic task recipient. A dynamic recipient a field, function, SmartObject result, or manual text that you enter into the field. You can use these for single recipients and as part of a recipient group.

1. Click the Add button to add a recipient.
   
2. Click the field menu and select Type/Construct my own.
   
3. The recipient field is in dynamic mode which you can use to drag in fields, functions, and text to construct an email address.
   
4. Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.
   

In dynamic mode, you cannot type an email address into the recipient field of the task. Recipient must be a valid email address from a SmartObject, data field, or another field or function. A dynamic recipient can be a user, group, or role that the server can resolve at runtime.

5. To toggle between the dynamic mode and the built in mode, click the toggle button.
   
6. When toggling between dynamic mode back to the standard mode, your dynamic configuration is resolved. If it cannot be resolved, the field displays Choose Recipient...:
   
7. In dynamic mode, you can specify whether it is a user, group, or role. Click the person icon to select an option from the menu.
   
8. Your changes are automatically saved.

Use the Recipients Rule section to specify the rule logic which determines who receives the task.

There are two options:

• All Recipients - All configured users and groups receives the task. By default, this option is selected.
• Certain Recipients, based on a rule - Define conditions to control which recipients receive the task.

To create a custom rule:

1. Select the Certain Recipients, based on a rule option to define conditions to determine which recipients receive a task. This enables the Edit Recipients Rule button. Click this button to edit the rule using the Rules Designer.
2. The Rules Designer shows.
   

For more information on how to use the error console, see the Error Console topic.

The following table explains the options available in the Recipients Rule panel:

Option	Description	How to Use
Recipient properties	Specify which recipient or group receives the task.	Click the Add button to add recipients or recipient groups.
Recipients Rule	Use this to choose which path is followed.	Select the Certain Recipients, based on a rule option and click the Edit Recipients Rule button.
Design Canvas	Use the design canvas to design the rule.
Rules Toolbar	Use the Rules Toolbar to drag conditions, outcomes, IF/THEN statements onto the canvas to build the rule.	Click and drag conditions onto the design canvas.
Trash bin	Use the Trash bin to delete any unwanted conditions dragged onto the canvas.	Click and drag items from the canvas to the trash bin to remove them.
Expand / Collapse toggle	Use this button to expand or collapse the Context Browser.	Click the toggle button to expand the Context Browser.
Quick Insert Toolbar (QIT)	The Quick Insert Toolbar consists of corresponding outcomes and condition blocks. Click an item to instantly add the block to the rule you are working on (you don't drag-and-drop actions from the QIT).	Click and drag conditions onto the design canvas.

3. For this example, accounting tasks should to go to the Finance department, and any task assigned to the Sales department where the amount is more than 5000 should go to the Sales group. All other tasks should go to a particular user.
4. Click the expand / collapse toggle to expand the Configuration Panel and ensure the Fields tab is selected. For the first part of the rule, type or drag the Department field into the task IF condition.
   
5. Type or drag a field to specify the condition, in this case if Department is equal to Finance.
   
6. From the recipients drop down, because it is a financial task, it is sent to the Finance Group (a recipient group you created earlier that contains the Finance department approvers).
   

The Originator is configured by default. Remember to uncheck this option if you don't need the task assigned to the originator.

7. The second part of building the rule is to add the conditions for the sales tasks. Use a condition block to add the user and amount conditions.
8. From the Rules Toolbar click and drag an IF/THEN condition onto the ELSE block.
   
9. Notice the added If / Then / Else block added to the ELSE block.
   
10. Click the Condition icon on the Quick Insert Toolbar (QIT) to add a condition block.
    
11. Type or drag a field to specify the condition for the sales tasks.
    
12. To add another condition, in this example for the Amount, click and drag a condition from the Rules Toolbar onto the IF block. The new condition displays within the condition block.
    
13. Type or drag a field to specify the condition.
    
14. Click the operator drop-down menu to select a operator for this condition, in this case select > Greater Than to assign the sales tasks with a value of more than 5000.
    
15. Click AND. From the menu you can select between AND or OR to control how multiple conditions are logically related. You can also add conditions or task conditions using this menu.
    
16. Type or drag a field to specify the condition and click the Recipient Outcome icon from the Quick Insert Toolbar (QIT).
    
17. From the recipients menu select who is to receive this task. In this example, any sales tasks above 5000 are sent to the Sales Group.
    
18. Add a Task Condition from the Rules Toolbar by dragging it into the condition block.
    
19. Click the task condition menu. Available workflow tasks are available on the menu.
    
20. Select your outcome from the Outcomes menu. In this example, the task is sent to the Sales Group if the department is Sales, the value is greater than 5000, and HR approved a different task in the workflow.
21. You can group conditions together within a condition block. Doing so ensures that certain conditions always run together, and even in order. To group conditions, click the AND button between the conditions. Select Group Conditions.
    
22. You can move conditions up or down. Below is an example on moving and grouping conditions.
    
You can also group conditions together by dragging one condition on top of the other.
23. Your final step of configuring the recipient rule is to specify what happens to the tasks that did not meet the requirements, basically configuring the final Else statement. In this example, all any remaining tasks are sent to Bob. From the recipients menu select Bob Maggio.
    
24. To delete any conditions, click and drag them from the design canvas to the Trash bin.
    

For additional information on how to configure rules, see the Rules Designer topic.

25. Click the expand / collapse toggle to collapse the Rules Designer.

26. Your changes are automatically saved.