You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: business-central/includes/admin-setup-email-public-folder.md
+48-39Lines changed: 48 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,69 +3,78 @@ author: edupont04
3
3
4
4
ms.service: dynamics365-accountant
5
5
ms.topic: include
6
-
ms.date: 04/01/2021
6
+
ms.date: 09/02/2021
7
7
ms.author: edupont
8
8
---
9
9
10
-
Before you can set up email logging, you must prepare your Exchange Online with [public folders](/exchange/collaboration/public-folders/public-folders?view=exchserver-2019&preserve-view=true). You can do this in the [Exchange admin center](/Exchange/architecture/client-access/exchange-admin-center?view=exchserver-2019&preserve-view=true), or you can use the [Exchange Management Shell](/powershell/exchange/exchange-management-shell?view=exchange-ps&preserve-view=true).
10
+
> [!NOTE]
11
+
> The following sections assume that you have administrator access for Exchange Online.
12
+
13
+
Before you can set up email logging, you must prepare Office 365 [public folders](/exchange/collaboration-exo/public-folders/public-folders?preserve-view=true). You can do this in the [Exchange admin center](/exchange/exchange-admin-center?preserve-view=true), or you can use the [Exchange Online PowerShell](/powershell/exchange/exchange-online-powershell?view=exchange-ps&?preserve-view=true).
11
14
12
15
> [!TIP]
13
-
> If you want to use the [Exchange Management Shell](/powershell/exchange/exchange-management-shell?view=exchange-ps&preserve-view=true), you can find inspiration for how to set up your script in a sample script that we published to [the BCTech repo](https://github.com/microsoft/BCTech/tree/master/samples/EmailLogging).
16
+
> If you want to use the [Exchange Online PowerShell](/powershell/exchange/exchange-online-powershell?view=exchange-ps&preserve-view=true), you can find inspiration for how to set up your script in a sample script that we published in [the BCTech repo](https://github.com/microsoft/BCTech/tree/master/samples/EmailLogging).
17
+
18
+
Follow the steps below to set up Exchange Online, with links to where you can learn more.
19
+
20
+
### Create an admin role group
21
+
22
+
Create an admin role group for public folders based on the information in the following table:
23
+
24
+
|Property |Value |
25
+
|----------------|--------------------------|
26
+
|Name |Public Folders Management |
27
+
|Selected roles |Public Folders |
28
+
|Selected users |The email of the user account that Business Central will use to run the email logging job|
29
+
30
+
For more information, see [Manage role groups in Exchange Online](/exchange/permissions-exo/role-groups?preserve-view=true).
31
+
32
+
### Create a new public folder mailbox
14
33
15
-
The following list describes the main steps with links to learn more.
34
+
Create a new public folder mailbox based on the information in the following table:
16
35
17
-
- Create an admin role for public folders based on the information in the following table:
36
+
|Property |Value |
37
+
|----------------|--------------------------|
38
+
|Name |Public MailBox |
18
39
19
-
|Property |Value |
20
-
|----------------|--------------------------|
21
-
|Name |Public Folders Management |
22
-
|Selected roles |Public Folders |
23
-
|Selected members|The email of the user account that Business Central will use to run the email logging job|
40
+
For more information, see [Create a public folder mailbox](/exchange/collaboration-exo/public-folders/create-public-folder-mailbox?preserve-view=true).
24
41
25
-
For more information, see [Manage role groups](/exchange/permissions/role-groups?view=exchserver-2019&preserve-view=true).
42
+
### Create new public folders
26
43
27
-
- Create a new public folder mailbox based on the information in the following table:
44
+
1. Create a new public folder with the name **Email Logging** in the root so that the full path to the folder becomes `\Email Logging\`.
45
+
2. Create two sub-folders so that the the result is the following full paths to the folders:
28
46
29
-
|Property |Value |
30
-
|----------------|--------------------------|
31
-
|Name |Public MailBox |
47
+
-`\Email Logging\Queue\`
48
+
-`\Email Logging\Storage\`
32
49
33
-
For more information, see [Create a public folder mailbox in Exchange Server](/exchange/collaboration/public-folders/create-public-folder-mailboxes).
50
+
For more information, see [Create a public folder](/exchange/collaboration-exo/public-folders/create-public-folder?preserve-view=true).
34
51
35
-
- Create new public folders
52
+
### Set public folder ownership
36
53
37
-
- Create a new public folder with the name *Email Logging* in the root so that the full path to the folder becomes ```\Email Logging\```
38
-
- Create two subfolders so that the the result is the following full paths to the folders:
39
-
-```\Email Logging\Queue\```
40
-
-```\Email Logging\Storage\```
54
+
Set the email logging user as an owner of both public folders, *Queue* and *Storage*.
41
55
42
-
For more information, see [Create a public folder](/exchange/collaboration/public-folders/create-public-folders?view=exchserver-2019&preserve-view=true).
56
+
For more information, see [Assign permissions to the public folder](/exchange/collaboration-exo/public-folders/set-up-public-folders#step-3-assign-permissions-to-the-public-folder).
43
57
44
-
- Mail-enable the *Queue* public folder
58
+
###Mail-enable the *Queue* public folder
45
59
46
-
For more information, see [Mail-enable or mail-disable a public folder](/exchange/collaboration/public-folders/mail-enable-or-disable?view=exchserver-2019&preserve-view=true)
60
+
For more information, see [Mail-enable or mail-disable a public folder](/exchange/collaboration-exo/public-folders/enable-or-disable-mail-for-public-folder?preserve-view=true).
47
61
48
-
- Mail-enable sending emails to the *Queue* public folder using Outlook or the Exchange Management Shell
62
+
###Mail-enable sending emails to the *Queue* public folder
49
63
50
-
For more information, see [Allow anonymous users to send email to a mail-enabled public folder](/exchange/collaboration/public-folders/mail-enable-or-disable#allow-anonymous-users-to-send-email-to-a-mail-enabled-public-folder?view=exchserver-2019&preserve-view=true)
64
+
Mail-enable sending emails to the *Queue* public folder using Outlook or the Exchange Management Shell.
51
65
52
-
- Set the email logging user as an owner of both public folders, *Queue* and *Storage*public folders using Outlook or the Exchange Management Shell based on the information in the following table:
66
+
For more information, see [Allow anonymous users to send email to a mail-enabled public folder](/exchange/collaboration-exo/public-folders/enable-or-disable-mail-for-public-folder#allow-anonymous-users-to-send-email-to-a-mail-enabled-public-folder?preserve-view=true).
53
67
54
-
|Property |Value |
55
-
|----------------|--------------------------|
56
-
|User |The email of the user account that Business Central will use to run the email logging job|
57
-
|Permission level|Owner |
68
+
### Create mail flow rules
58
69
59
-
For more information, see [Assign permissions to the public folder](/exchange/collaboration-exo/public-folders/set-up-public-folders#step-3-assign-permissions-to-the-public-folder).
70
+
Create two mail flow rules based on the information in the following table:
60
71
61
-
- Create two mail flow rules based on the information in the following table
72
+
|Purpose |Name |Apply this rule if... |Do the following... |
|A rule for incoming email |Log Email Sent to This Organization|*The sender* is located *Outside the organization*, and *the recipient* is located *Inside the organization*|BCC the email account that is specified for the *Queue* public folder|
75
+
|A rule for outgoing email | Log Email Sent from This Organization |*The sender* is located *Inside the organization*, and *the recipient* is located *Outside the organization*|BCC the email account that is specified for the *Queue* public folder|
|A rule for incoming email |Log Email Sent to This Organization|*The sender* is located *Outside the organization*, and *the recipient* is located *Inside the organization*|BCC the email account that is specified for the *Queue* public folder|
66
-
|A rule for outgoing email | Log Email Sent from This Organization |*The sender* is located *Inside the organization*, and *the recipient* is located *Outside the organization*|BCC the email account that is specified for the *Queue* public folder|
67
-
68
-
For more information, see [Manage mail flow rules in Exchange Online](/exchange/security-and-compliance/mail-flow-rules/manage-mail-flow-rules) and [Mail flow rule actions in Exchange Online](/exchange/security-and-compliance/mail-flow-rules/mail-flow-rule-actions).
77
+
For more information, see [Manage mail flow rules in Exchange Online](/exchange/security-and-compliance/mail-flow-rules/manage-mail-flow-rules?preserve-view=true) and [Mail flow rule actions in Exchange Online](/exchange/security-and-compliance/mail-flow-rules/mail-flow-rule-actions?preserve-view=true).
69
78
70
79
> [!NOTE]
71
80
> If you make changes in the Exchange Management Shell, the changes become visible in the Exchange admin center after a delay. Also, the changes made in Exchange will be available in [!INCLUDE[prod_short](prod_short.md)] after a delay. The delay might be several hours.
Copy file name to clipboardExpand all lines: business-central/marketing-set-up-email-logging.md
+13-8Lines changed: 13 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,31 +27,36 @@ Next, you connect [!INCLUDE[prod_short](includes/prod_short.md)] with Exchange O
27
27
28
28
Get started with email logging in two easy steps:
29
29
30
-
1. Connect [!INCLUDE[prod_short](includes/prod_short.md)] with Exchange Online for your Microsoft 365 subscription. Exchange Online handles your email messages. We've made this step easy by providing an assisted setup guide. You just need your administrator credentials for your administrator account in Microsoft 365. To start the guide, go to **Assisted Setup**, and then choose **Set up email logging**.
30
+
1. Connect [!INCLUDE[prod_short](includes/prod_short.md)] with Exchange Online for your Microsoft 365 subscription. Exchange Online handles your email messages. We've made this step easy by providing an assisted setup guide. You just need your administrator credentials for your administrator account in Microsoft 365. To start the guide, go to the **Assisted Setup** page, and then select the **Set up email logging** guide.
31
31
32
32
2. Make sure that valid email addresses have been entered in [!INCLUDE[prod_short](includes/prod_short.md)] for your sales people and contacts, depending on whether they are potential or existing customers. To do that, for each customer or salesperson, open the **Contact** or **Salesperson/Purchaser** card and have a look in the **Email** field.
33
33
34
34
> [!Tip]
35
-
> After you complete the steps in the guide you can check whether the connection was successful. Search for **Marketing Setup**, choose **Process**, then **Functions**, and then **Validate Email Logging Setup**.
35
+
> After you complete the steps in the guide you can check whether the connection was successful. Search for **Marketing Setup**, and select **Access**, then **Functions**, and then **Validate Email Logging Setup**.
36
36
37
37
## Viewing Email Message Exchanges in the Interaction Log
38
-
[!INCLUDE[prod_short](includes/prod_short.md)] creates an entry on the **Interaction Log** page each time a salesperson and a contact exchange an email message. To view the interaction log, open the **Contact** or **Salesperson Purchaser** card for the person, and then choose **History**, and then choose **Interaction Log Entries**. There are a few things we can do with each entry in the log, for example:
39
38
40
-
- View the content of the email message that was exchanged by clicking the **Show Attachments** action.
41
-
- Turn an email exchange into a sales opportunity - If an entry looks promising, you can turn it into an opportunity and then manage its progress toward a sale. To do that, choose the entry, and then choose the **Create Opportunity** action. For more information, see [Managing Sales Opportunities](marketing-manage-sales-opportunities.md).
39
+
[!INCLUDE[prod_short](includes/prod_short.md)] creates an entry on the **Interaction Log** page each time a salesperson and a contact exchange an email message. To view the interaction log, open the **Contact** card for the person, choose **Related**, then **History**, and then **Interaction Log Entries**. There are a few things you can do with each entry in the log, for example:
40
+
41
+
- View the content of the email message that was exchanged by selecting **Process** and then **Show Attachments**.
42
+
- Turn an email exchange into a sales opportunity - If an entry looks promising, you can turn it into an opportunity and then manage its progress toward a sale. To do this, select the entry, and then select **Process**, and then **Create Opportunity**. For more information, see [Managing Sales Opportunities](marketing-manage-sales-opportunities.md).
42
43
43
44
## Connecting On-Premises Versions to Microsoft Exchange
44
-
You can connect [!INCLUDE[prod_short](includes/prod_short.md)] on-premises to Exchange on-premises or Exchange Online for email logging. For both versions of Exchange, settings for the connection are available on the **Marketing Setup** page. For Exchange Online, you can also use an assisted setup guide.
45
+
46
+
You can connect [!INCLUDE[prod_short](includes/prod_short.md)] on-premises to Exchange on-premises or Exchange Online for email logging. For both versions of Exchange, settings for the connection are available on the **Marketing Setup** page. For Exchange Online, you can also use an assisted setup guide.
45
47
46
48
### Connecting to Exchange On-premises
47
-
To connect [!INCLUDE[prod_short](includes/prod_short.md)] on-premises to Exchange on-premises, on the **Marketing Setup** page, you can use **Basic** as the **Authentication Type**, and then enter credentials for the user account for Exchange on-premises. Then turn on the **Enabled** toggle to start logging email.
49
+
50
+
To connect [!INCLUDE[prod_short](includes/prod_short.md)] on-premises to Exchange on-premises, on the **Marketing Setup** page, you can use **Basic** as the **Authentication Type**, and then enter credentials for the user account for Exchange on-premises. Then turn on the **Enabled** toggle to start logging email.
48
51
49
52
### Connecting to Exchange Online
50
-
To connect to Exchange Online, you must use **OAuth2** as the **Authentication Type**. You must also register an application in Azure Active Directory, and provide the application ID, key vault secret, and the redirect URL to use. The redirect URL is pre-populated and should work for most installations. For more information, see [To register an application in Azure AD for connecting from Business Central to Exchange Online](marketing-set-up-email-logging.md#to-register-an-application-in-azure-ad-for-connecting-from-business-central-to-exchange-online).
53
+
54
+
To connect to Exchange Online, you must use **OAuth2** as the **Authentication Type**. You must also register an application in Azure Active Directory, and provide the application ID, key vault secret, and the redirect URL to use. The redirect URL is pre-populated and should work for most installations. For more information, see To register an application in Azure AD for connecting from Business Central to Exchange Online below.
51
55
52
56
You must set up your installation to use HTTPS. For more information, see [Configuring SSL to Secure the Business Central Web Client Connection](/dynamics365/business-central/dev-itpro/deployment/configure-ssl-web-client-connection). If you are setting up your server to have a different home page, you can change the URL. The client secret will be saved as an encrypted string in your database.
53
57
54
58
### To register an application in Azure AD for connecting from Business Central to Exchange Online
59
+
55
60
The following steps assume that you use Azure Active Directory to manage identities and access. For more information, see [Quickstart: Register an application with the Microsoft identity platform](/azure/active-directory/develop/quickstart-register-app). If you do not use Azure Active Directory, see [Using Another Identity and Access Management Service](marketing-set-up-email-logging.md#using-another-identity-and-access-management-service).
56
61
57
62
1. In the Azure Portal, under **Manage**, choose **Authentication**.
0 commit comments