Update Exchange Item

This activity updates an existing task, appointment, or contact in Microsoft Exchange. You can only update Exchange items that were created by a Create Exchange Item activity earlier in the workflow definition. Whether this activity was successful or not is available as a token.

How does this activity look in the Designer Pane?

To add this activity to a workflow definition

Drag it from the Toolbox Pane and drop it in the Designer Pane.

To configure this activity

Select the activity in the Designer Pane to configure the following property boxes in the Properties Pane.

• Activity Name

  Once added to a workflow definition, the default name of an activity can be changed. Providing a custom name for an activity helps you remember the role it plays.

  To name an activity

  1. Add an activity to your workflow by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
  2. Select the activity in the Designer Pane.
  3. Under Activity Name in the Properties Pane, replace the default name.

  

  Note: Activity names cannot be the same as any other activity name in the workflow, they cannot be the same as the workflow's name, they must be less than 100 characters, they must contain at least one alphanumeric character, they cannot be "Name," and they cannot be the same as the activity's runtime type (which is usually only an issue with custom activities).

• Activity Description

  Use the Activity Description to provide descriptive text to help you remember the role that the activity plays in the workflow. All activities contain a default description that you can modify while constructing your workflow.

  To modify an activity description

  1. Add an activity to your workflow by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
  2. Select the activity in the Designer Pane.
  3. Under Activity Description in the Properties Pane, replace the default description.

  

• Item to update

  In the Item to update property box you can choose which Exchange item you want to update with the activity. You can only update Exchange items that were created by a Create Exchange Item activity earlier in the workflow definition.

  

  To update an item

  1. Add the Update Exchange Item activity to your workflow definition by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
  2. Select the activity in the Designer Pane.
  3. Under Item to Update in the Properties Pane, click the Select link.
  4. In the Select List Item dialog box, click the green arrow next to the Exchange item you want to update.

  

  5. Click OK.
• Item

  The Item property box lets you update a previously-created Exchange item.

  

  1. Add the Update Exchange Item activity to your workflow definition by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
  2. Select the activity in the Designer Pane.
  3. Under Item in the Properties Pane, click anywhere in the property box.
  4. In the Edit Exchange Item dialog box, modify options as desired.
  5. After entering a value for each column, click OK.
• Assign To

  

  Use this property box to specify an email address. Workflow will attempt to create the task, appointment, or contact in the mailbox of the specified email address.

• Tokens

  The Update Exchange Item activity produces the following token.

  Name	Description	Sample Syntax*
  was updated	Whether the Exchange Item was updated. This token can have one of two values: True or False.	%(UpdateExchangeItem_was updated)

  *The "UpdateExchangeItem" portion of the syntax changes to match the activity's name as specified in the Activity Name property box. All non-alphanumeric characters, except underscores, are removed from the name.

  Example: If you rename the activity "Update Task," the syntax for the was updated token will be %(UpdateTask_was updated).