Exchange 2007 - Trigger Configuration (Magic xpi 3.x)
The Exchange 2007 connector can be used to trigger a flow as a result of entities changed in the Microsoft Exchange 2007 server. When you drag the Exchange 2007 connector into the Magic xpi Studio’s trigger area, the Component Properties dialog box opens. Click Configuration to open the Exchange 2007 Trigger Configuration dialog box.
This dialog box contains the following fields:
|
|
|
|
Connection
|
|
Resource Name
|
This read-only field displays the name(s) of the Exchange 2007 resource(s) that you selected for the trigger in the Service Repository.
|
|
Polling Interval
|
Click  to open the Polling Interval dialog box. Enter the frequency that the connector will check for changes in your organization's data. You can select a combination of minutes, hours, and days.
The value that you set here (for example, three minutes) determines the number of real calls that are made to the Microsoft Exchange 2007 API. This mechanism works in the following way:
-
The trigger calls the GetEvents() Exchange 2007 method.
-
Each call to these methods returns an ID list of the triggered entities.
-
When Magic xpi gets the list of IDs, you can obtain the Exchange 2007 item details by using the GetById() method in an Exchange 2007 step.
|
|
Synchronous
|
Select this check box to invoke the Magic xpi flow in synchronous mode each time an event is executed (for example, the deletion of contacts). This means that the next flow will be invoked only after the complete execution of the previously invoked flow.
The default is unchecked.
|
|
Keep Alive Interval
|
The amount of time in minutes that the trigger can be unresponsive before it is automatically restarted. The default value is 0, which means that the trigger can be permanently unresponsive.
|
Note:
|
-
You should be very careful when selecting a value for this parameter. If the chosen value is too small, a trigger may terminate before it completes a valid operation.
-
If you select the Synchronous check box (above), the trigger and the flow will operate in the same thread. This means that if the trigger is terminated because it is unresponsive, the flow will be terminated as well. Therefore, when setting the Keep Alive Interval parameter, you should also take into account the amount of time it takes for the flow to run.
For example, if the trigger's unresponsive time is three minutes, and the flow takes a maximum of two minutes to run, then you should set the Keep Alive Interval parameter to a value of more than five minutes.
|
|
|
Row Label
|
Enter a label to define the triggered row. The variable mapped in the Store Row Label In field (below) holds the label value when the flow is invoked.
|
|
Entity
|
The entity that the operation will be performed on. Select one of the following entities from the drop-down list:
-
Mail
-
Contact
-
Calendar
-
Task
If you select Mail, click  to open the Trigger's Folder List. Select one or more mail folders to work with. Your selected mail folders will appear at the bottom of the dialog box's Details area.
|
|
Operation
|
Determines which operation will be triggered on an Exchange 2007 item. Select one of the following operations from the drop-down list:
-
Add (default)
-
Update
-
Delete
-
Move
-
Copy
-
New Mail
|
Note:
|
The Update operation is triggered when a Contact entity is created.
|
|
|
Result Store Options
|
|
Store XML Result In
|
This field is used to store the trigger’s polling results.
Click to open the Variables List. Choose the required BLOB variable by clicking Select. The default is C.UserBLOB.
|
|
Store Row Label In
|
This field is used to store the trigger’s row label.
Click to open the Variables List. Choose the required Alpha variable by clicking Select.
|
|
Store Row Unique Identifier
|
This field holds the name of the row label that invoked the trigger.
Click to open the Variables List. Choose the required Alpha variable by clicking Select. The default is C.UserString.
|
The Exchange 2007 Trigger Configuration dialog box contains the following additional buttons:
|
|
|
|
New
|
Creates a new line in the trigger table.
|
|
Delete
|
Deletes a selected line in the trigger table.
|
When you have finished configuring the connector, click OK to save your definitions and to close the Exchange 2007 Trigger Configuration dialog box.
Alternatively, you can click Cancel to close the Exchange 2007 Trigger Configuration dialog box without saving your definitions.
Then click the Component Properties dialog box’s OK button to close the dialog box and to save your configuration settings.
|
|
Since version:
|
V3.2 SP2a
|
