Skip to content

Commit e0f36ca

Browse files
380641 - marketing-set-up-email-logging has poor ratings (#1691)
* Try to fix the link so they point to the current Exchange Online docs * Typos and tweaks
1 parent b61ef12 commit e0f36ca

File tree

2 files changed

+61
-47
lines changed

2 files changed

+61
-47
lines changed

business-central/includes/admin-setup-email-public-folder.md

Lines changed: 48 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -3,69 +3,78 @@ author: edupont04
33

44
ms.service: dynamics365-accountant
55
ms.topic: include
6-
ms.date: 04/01/2021
6+
ms.date: 09/02/2021
77
ms.author: edupont
88
---
99

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).
1114

1215
> [!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
1433

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:
1635

17-
- Create an admin role for public folders based on the information in the following table:
36+
|Property |Value |
37+
|----------------|--------------------------|
38+
|Name |Public MailBox |
1839

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).
2441

25-
For more information, see [Manage role groups](/exchange/permissions/role-groups?view=exchserver-2019&preserve-view=true).
42+
### Create new public folders
2643

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:
2846

29-
|Property |Value |
30-
|----------------|--------------------------|
31-
|Name |Public MailBox |
47+
- `\Email Logging\Queue\`
48+
- `\Email Logging\Storage\`
3249

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).
3451

35-
- Create new public folders
52+
### Set public folder ownership
3653

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*.
4155

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).
4357

44-
- Mail-enable the *Queue* public folder
58+
### Mail-enable the *Queue* public folder
4559

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).
4761

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
4963

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.
5165

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).
5367

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
5869

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:
6071

61-
- Create two mail flow rules based on the information in the following table
72+
|Purpose |Name |Apply this rule if... |Do the following... |
73+
|---------|-----|----------------------------------|---------------------------------------------|
74+
|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|
6276

63-
|Purpose |Name |Conditions |Action |
64-
|---------|-----|----------------------------------|---------------------------------------------|
65-
|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).
6978

7079
> [!NOTE]
7180
> 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.

business-central/marketing-set-up-email-logging.md

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,31 +27,36 @@ Next, you connect [!INCLUDE[prod_short](includes/prod_short.md)] with Exchange O
2727

2828
Get started with email logging in two easy steps:
2929

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.
3131

3232
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.
3333

3434
> [!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**.
3636
3737
## 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:
3938

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).
4243

4344
## 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.
4547

4648
### 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.
4851

4952
### 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.
5155

5256
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.
5357

5458
### To register an application in Azure AD for connecting from Business Central to Exchange Online
59+
5560
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).
5661

5762
1. In the Azure Portal, under **Manage**, choose **Authentication**.

0 commit comments

Comments
 (0)