Wiki

Scale Your Enterprise

User Tools

Site Tools


bw2:exchangeconnector_tool

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
bw2:exchangeconnector_tool [2020/12/15 13:54]
akoehler created
bw2:exchangeconnector_tool [2024/01/10 14:19] (current)
wgates [Introduction (ExchangeConnector)]
Line 1: Line 1:
 ====== Introduction (ExchangeConnector) ====== ====== Introduction (ExchangeConnector) ======
  
-This page describes the configuration of the Bizweaver ExchangeConnectortool. This tool is used to read email from a designated user and create new appointments for any user defined in Exchange.+This page describes the configuration of the Bizweaver ExchangeConnector tool. This tool is used to read an email from a designated user and create new appointments for any user-defined in Exchange.
  
  
 ====== Related Documents ====== ====== Related Documents ======
  
-The following pages contain additional information that may be helpful with the development of Bizweaver workflows using the Exchange Connector tool.+The following pages contain additional information that may help develop Bizweaver workflows using the Exchange Connector tool.
  
   * **[[bw2:global_connections|Introduction (Global Connections)]]**   * **[[bw2:global_connections|Introduction (Global Connections)]]**
Line 12: Line 12:
 ====== Before You Begin ====== ====== Before You Begin ======
  
-You will need to have at least one Exchange global connection defined.  Instructions to do this are found in the Global Connections page noted in the previous section.+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.
  
 <WRAP center round tip 80%> <WRAP center round tip 80%>
-An Exchange global connection can only reference one user mailbox for reading email.  If you need to read email from multiple mailboxes, each mailbox will need its own connection to be defined.+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.
 </WRAP> </WRAP>
  
Line 21: Line 21:
 ====== General Configuration ====== ====== General Configuration ======
  
-{{  :bw:exchange1.png?400  |}}+{{ :bw2:bizweaverexhange1.png |}}
  
   - Select the **Exchange Connection** from the drop-down list.   - Select the **Exchange Connection** from the drop-down list.
   - Select the desired **Action** from the drop-down list.   - Select the desired **Action** from the drop-down list.
-      - "Read Mails" is used to retrieve and read email from a designated mailbox folder.+      - "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.       - "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.     - The available options will change depending on the action selected.  Specific options for each action are described below.
Line 35: Line 35:
   - 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.   - 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).   - 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.+  - Time values must be entered or passed in HH: MM XX (including the colon), where "XX" is AM or PM.
 </WRAP> </WRAP>
 ===== Read Mail Options ===== ===== Read Mail Options =====
  
-{{  :bw:exchange2.png?400  |}}+{{ :bw2:bizweaverexhange2.png |}}
  
   - Select the mailbox **Folder** to process from the drop-down list.   - Select the mailbox **Folder** to process from the drop-down list.
Line 47: Line 47:
     - Enter the filtering value in the  __Value__ field.     - Enter the filtering value in the  __Value__ field.
       - This will most typically be a variable but can also be directly entered as needed.       - 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'.+      - Multiple filtering statements can be used.  In the example abovethe 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.   - 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.     - 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.
Line 53: Line 53:
     - This is a Windows folder.  Use the standard Windows Explorer tool to locate the folder if needed.     - 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.     - 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.
- 
- 
- 
- 
  
  
Line 62: Line 58:
 "Appointment" and "Meeting" are used interchangeably for the Exchange Connector tool.  An "Appointment" is simply a meeting with only one person attending. "Appointment" and "Meeting" are used interchangeably for the Exchange Connector tool.  An "Appointment" is simply a meeting with only one person attending.
  
-{{  :bw:exchange3.png?400  |}}+{{ :bw2:bizweaverexhange3.png |}}
  
   - Enter the **Subject** of the appointment.   - Enter the **Subject** of the appointment.
Line 71: Line 67:
   - Enter one or more email addresses of **Required Attendees**.   - Enter one or more email addresses of **Required Attendees**.
     - Appointments can be sent to users that are not part of your Exchange system.     - Appointments can be sent to users that are not part of your Exchange system.
-      - If the recipient uses Exchange/Outlook, the appoint will be handled in the normal manner. +      - 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.+      - If the recipient does not use Exchange/Outlookthey will receive as .ics calendar file.
   - Enter one or more email addresses of **Optional Attendees**.   - Enter one or more email addresses of **Optional Attendees**.
   - Enter a **Remind before minutes** (numeric) value.   - Enter a **Remind before minutes** (numeric) value.
Line 81: Line 77:
  
  
 +====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|
  
  
bw2/exchangeconnector_tool.1608058495.txt.gz · Last modified: 2020/12/15 13:54 by akoehler