This is an old revision of the document!
Introduction (ExchangeConnector)
This page describes the configuration of the Bizweaver ExchangeConnectortool. This tool is used to read an email from a designated user and create new appointments for any user-defined in Exchange.
The following pages contain additional information that may help develop Bizweaver workflows using the Exchange Connector tool.
Before You Begin
You will need to have at least one Exchange global connection defined. Instructions to do this are found on the Global Connections page noted in the previous section.
An Exchange global connection can only reference one user mailbox for reading an email. If you need to read an email from multiple mailboxes, each mailbox will need its own connection to be defined.
General Configuration
Select the Exchange Connection from the drop-down list.
Select the desired Action from the drop-down list.
“Read Mails” is used to retrieve and read an email from a designated mailbox folder.
“Create Appointment is used to create a new appointment for one or more users in the designated Exchange system.
The available options will change depending on the action selected. Specific options for each action are described below.
Notes for the following sections.
Values used by the two actions, except drop-down selections, can use workflow variables. If necessary (as with the date/time values), clear the field manually, then press <F4> for a list of workflow variables.
Date values must be entered or passed in YYYY-MM-DD format (including the dashes).
Time values must be entered or passed in HH: MM XX (including the colon), where “XX” is AM or PM.
Read Mail Options
Select the mailbox Folder to process from the drop-down list.
Define the Filter criteria to be used.
Select the desired data field from the Search drop-down list.
Select the desired filtering option from the Filter drop-down list.
Enter the filtering value in the Value field.
This will most typically be a variable but can also be directly entered as needed.
Multiple filtering statements can be used. In the example above, the two statements are 'greater than' and 'less than'.
If you wish to use this tool to move email from one folder to another, select the target folder from the Move mail to folder drop-down list.
The target folder must exist in the user's mailbox before it can be used here. The folder must be created in Exchange/Outlook as it cannot be created through the Exchange Connector tool.
Select a folder where any Attachments should be stored.
This is a Windows folder. Use the standard Windows Explorer tool to locate the folder if needed.
This action does not remove the attachments from the Exchange database. It stores a copy of the attachment so that it can be used in other Bizweaver workflow steps.
Create Appointment Options
“Appointment” and “Meeting” are used interchangeably for the Exchange Connector tool. An “Appointment” is simply a meeting with only one person attending.
Enter the Subject of the appointment.
Enter any Body text for the appointment.
Enter/select a Start date and time. Or select the All Day checkbox.
Enter/select an End date and time.
Enter a Location (optional).
Enter one or more email addresses of Required Attendees.
Appointments can be sent to users that are not part of your Exchange system.
If the recipient uses Exchange/Outlook, the appointment will be handled in the normal manner.
If the recipient does not use Exchange/Outlook, they will receive as .ics calendar file.
Enter one or more email addresses of Optional Attendees.
Enter a Remind before minutes (numeric) value.
Select how the notification email should be sent.
Use SendOnlyToAll to notify all attendees via email.
Use SentToAllAndSaveCopy to notify all attendees via email and save a copy in the sender's mailbox.
Using SendToNone is not recommended since no notifications are sent.
Exchange Variables
| Name | Description |
| Action | This indicates the action taken |
| AllDay | True or False indicator if the all-day check box is selected |
| AttachmentsFolder | This indicates if there is an attachments folder selected |
| AttendeesCopy | This indicates who will get a response when an appointment is created |
| Body | This indicates if there is a body to a created appointment |
| ConnectionName | This indicated the name of the connection that is being used |
| Count | This indicates the count of the emails that are to be read |
| DataSourceResultsTable | This displays the results of the emails and all their fields |
| EndDate | This is the end date of an appointment |
| EndTime | This is the end time of an appointment |
| FolderMove | This indicates the folder the selected email will be moved to |
| FolderSearch | This indicates the folder the searched |
| Location | This indicates the location of a meeting |
| OptionalAttendees | This indicates the email addresses of all optional attendees to a meeting |
| ReminderMinutes | This indicates when a meeting will send out a reminder for the meeting |
| RequiredAttendees | This indicates the email addresses of all the required attendees to a meeting |
| SearchFilterCollection | This indicates the search criteria when reading emails |
| StartDate | This indicates the start date of a meeting |
| StartTime | This indicates the start time of a meeting |
| Subject | This indicates the subject of a meeting |
| StepMessage | During a failure the reason for failure will be populated here |
| StepStatus | True or False |