This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
bw2:global_connections [2021/02/07 18:25] akoehler [DI API Connections] |
bw2:global_connections [2023/01/29 12:48] (current) mfoster [SMTP Connections] |
||
|---|---|---|---|
| Line 161: | Line 161: | ||
| ===== SMTP Connections ===== | ===== SMTP Connections ===== | ||
| - | SMTP connections are used to provide connection information for the server(s) that handle email. Most installation | + | SMTP connections are used to provide connection information for the server(s) that handle email. Most installations |
| - | {{ :bw:gcimage7.png? | + | {{ :bw2:bizweaverconnectionmanager8.png |}} |
| * **Server** is the server where your SMTP application is found | * **Server** is the server where your SMTP application is found | ||
| - | * **Port Number** is the specific communication port used to connect to the SMTP application. Port 25 is the most common when connecting to an internal server. Port 465 or 567 are common when SSL is in use. Contact your system administrator if you are not sure of what value to use. | + | * **Port Number** is the specific communication port used to connect to the SMTP application. Port 25 is the most common when connecting to an internal server. Port 465 or 587 are common when SSL is in use. Contact your system administrator if you are not sure of what value to use. |
| * **Enable SMTP Credentials** (Username & password) \\ <WRAP info round center> Your installation may not require SMTP credentials to send mail from Bizweaver. However, identifying a valid user in this step is required to use the error handling functions of Bizweaver. </ | * **Enable SMTP Credentials** (Username & password) \\ <WRAP info round center> Your installation may not require SMTP credentials to send mail from Bizweaver. However, identifying a valid user in this step is required to use the error handling functions of Bizweaver. </ | ||
| * The connection information is saved but is not validated. Any connection errors will only be shown when the connection is used in a workflow. | * The connection information is saved but is not validated. Any connection errors will only be shown when the connection is used in a workflow. | ||
| Line 172: | Line 172: | ||
| ==== Email Setup for Microsoft Office365 ==== | ==== Email Setup for Microsoft Office365 ==== | ||
| - | There are three different options for using Microsoft Office365 as your SMTP connector to send email from Bizweaver. Fortunately, | + | There are three different options for using Microsoft Office365 as your SMTP connector to send emails |
| **Option 1 (recommended): | **Option 1 (recommended): | ||
| - | This option supports most usage scenarios and it's the easiest to set up. Choose this option when: | + | This option supports most usage scenarios, and it's the easiest to set up. Choose this option when: |
| - | * You want to send email from a third-party hosted application, | + | * You want to send an email from a third-party hosted application, |
| - | * You want to send email to people inside and outside your organization. | + | * You want to send emails |
| To configure your device or application, | To configure your device or application, | ||
| Line 187: | Line 187: | ||
| **How to set up SMTP client submission** | **How to set up SMTP client submission** | ||
| - | Enter the following settings directly on your device or in the application **as their guide instructs** (it might use different terminology than this article). As long as your scenario meets the requirements for SMTP client submission, the following settings will enable you to send email from your device or application. | + | Please enter the following settings directly on your device or in the application **as their guide instructs** (it might use different terminology than this article). As long as your scenario meets the SMTP client submission |
| ^Device or Application setting | ^Device or Application setting | ||
| Line 193: | Line 193: | ||
| |Port |Port 587 (recommended) or port 25 | | |Port |Port 587 (recommended) or port 25 | | ||
| |TLS/ StartTLS | |TLS/ StartTLS | ||
| - | |Username/ | + | |Username/ |
| The following image shows how this setup is implemented as a Bizweaver Global Connection. | The following image shows how this setup is implemented as a Bizweaver Global Connection. | ||
| - | {{ :bw:gcimage11.png? | + | {{ :bw2:bizweaverconnectionmanager8.png |}} |
| ===== Exchange Connections ===== | ===== Exchange Connections ===== | ||
| - | Exchange connections are used to access a Microsoft Exchange server directly. | + | Exchange connections are used to access a Microsoft Exchange server directly. |
| - | {{ :bw:gcimage12.png? | + | {{ :bw2:bizweaverconnectionmanager9.png |}} |
| - Select the **Exchange Version** from the drop-down list. | - Select the **Exchange Version** from the drop-down list. | ||
| + | - Versions include: 2007_SP1, | ||
| - Enter the **Username** and **Password** for a user that can access Exchange. | - Enter the **Username** and **Password** for a user that can access Exchange. | ||
| - Enter the **Domain** name of which the Exchange service is a member. | - Enter the **Domain** name of which the Exchange service is a member. | ||
| Line 211: | Line 211: | ||
| <WRAP center round help 60%> | <WRAP center round help 60%> | ||
| - | Only one mailbox can be monitored per connection. | + | Only one mailbox can be monitored per connection. |
| </ | </ | ||
| Line 227: | Line 227: | ||
| ==== Basic Authentication ==== | ==== Basic Authentication ==== | ||
| - | {{ :bw:gcimage8.png? | + | {{ :bw2:bizweaverconnectionmanager10.png |}} |
| - Select the **Basic Authentication** radio button. | - Select the **Basic Authentication** radio button. | ||
| Line 235: | Line 235: | ||
| ==== oAuth 2 Authentication ==== | ==== oAuth 2 Authentication ==== | ||
| - | {{ :bw:gcimage9.png? | + | {{ :bw2:bizweaverconnectionmanager11.png |}} |
| - Select the **oAuth 2 Authentication** radio button. | - Select the **oAuth 2 Authentication** radio button. | ||
| Line 242: | Line 242: | ||
| - The remaining fields that can be accessed will change based on the Grant Type. | - The remaining fields that can be accessed will change based on the Grant Type. | ||
| - Again, the API documentation should provide instructions on how to obtain the various authorization elements. | - Again, the API documentation should provide instructions on how to obtain the various authorization elements. | ||
| - | - The Redirect URI can generally be anything you like (e.g. https:// | + | - The Redirect URI can generally be anything you like (e.g., https:// |
| - The connection information is saved but is not validated. Any connection errors will only be shown when the connection is used in a workflow. | - The connection information is saved but is not validated. Any connection errors will only be shown when the connection is used in a workflow. | ||
| Line 249: | Line 249: | ||
| The SAP **Service Layer** is an API connection to Business One company databases. | The SAP **Service Layer** is an API connection to Business One company databases. | ||
| - | {{ :bw:gcimage13.png? | + | {{ :bw2:bizweaverconnectionmanager12.png |}} |
| - the **URL** is the pointer to the server where SAP Business One is installed. | - the **URL** is the pointer to the server where SAP Business One is installed. | ||
| Line 257: | Line 257: | ||
| </ | </ | ||
| - **Database** is the SAP Business One company database name. This value is case sensitive. | - **Database** is the SAP Business One company database name. This value is case sensitive. | ||
| - | - **Username** and **Password** are the credentials that will be used to " | + | - **Username** and **Password** are the credentials that will be used to " |
| - The connection information is saved but is not validated. Any connection errors will only be shown when the connection is used in a workflow. | - The connection information is saved but is not validated. Any connection errors will only be shown when the connection is used in a workflow. | ||
| ====== Delete A Global Configuration ====== | ====== Delete A Global Configuration ====== | ||
| - | When a Global | + | To delete a connection, double-click on the desired connection to delete. In the upper right corner of the connection, select " |
| + | |||
| + | When a Connection is deleted, a consistency check is performed to ensure that any workflows using the connection are updated. A list of associated workflows and steps is listed in the lower area of the window. Replacement connections must be specified, or the deletion process will not continue. | ||
| - | {{ :bw:gcimage10.png? | + | {{ :bw2:bizweaverconnectionmanager13.png |}} |
| - | - Option 1 is to use the “Replace | + | - Option 1 uses the “Replace |
| - Use the drop-down to select a connection from the list presented. | - Use the drop-down to select a connection from the list presented. | ||
| - The “New Connection” value for all rows is set automatically. | - The “New Connection” value for all rows is set automatically. | ||
| - Option 2 is to update each workflow/ | - Option 2 is to update each workflow/ | ||
| - Use the drop-down in each row to select a connection from the list presented. | - Use the drop-down in each row to select a connection from the list presented. | ||
| - | - Option 3 is use options 1 and 2 together. | + | - Option 3 is to use options 1 and 2 together. |
| - Use option 1 to update the “New Connection” value for all rows. | - Use option 1 to update the “New Connection” value for all rows. | ||
| - Use option 2 to update individual rows to a different connection as needed. | - Use option 2 to update individual rows to a different connection as needed. | ||
| - | - Click [**Replace and Save**] to complete the update. | + | - Click [**Save**] to complete the update. |
| - Click [**Close**] to exit without saving any changes. | - Click [**Close**] to exit without saving any changes. | ||