Install Finance agents on a Dataverse environment for Collections in Outlook (preview)

[This article is prerelease documentation and is subject to change.]

This article explains how to install Finance agents in a Dataverse environment for Collections in Outlook. A Dataverse environment is required to support all end-to-end capabilities of Finance agents.

When installed by the tenant administrator, the public preview license entitles the tenant to a trial use of Finance agents and Dataverse.

Prerequisite

Before the following procedure can be completed, the administrator must install Finance agents through the Microsoft 365 admin center. This step is necessary to enable the preview license for the tenant.

To install Finance agents into a Dataverse environment, follow these steps.

1. Sign in to the Microsoft Power Platform Admin Center.
2. In the left pane, select Environments.
3. Select the intended environment where you want to install Finance agents.
4. On the top menu, select Resources.
5. On the dropdown menu, select Dynamics 365 app.
6. On the dropdown menu, select Install App.
7. In the list, search for and select Finance agents.
8. Select Next.
9. Select I agree to the terms of service.
10. Select Install. When installation is completed, the following highlighted banner message is shown: Finance agents installation started.

Add users

Before users can save notes, emails, and email summaries, the following configuration must be completed.

1. In the Microsoft Power Platform Admin center.
2. In the left pane, select Environments.
3. Select the target Dataverse environment.
4. In the access section, under Users, select See All.
5. On the ribbon, select Add User to add all required Finance agents users.

Assign security roles

1. Configure your security roles. For more information, see Assign a security role to a user.
2. For each user, assign the following security roles: Basic User, AR Manager and Collections Coordinator.

Steps required for integration with Dynamics 365 Business Central

To set up Finance agents with Business Central, follow these steps.

1. Deploy the Finance agents for Outlook add-in in the Microsoft 365 Admin Center Install Finance agents App
2. Create or ensure there's a Dataverse enabled environment in the Power Platform Admin Center Create Dataverse environment
3. Install the Finance agents app in the Dataverse enabled Power Platform environment. For more information, see the Prerequisite secton in this article.
4. Allowlist the relevant Business Central environments and companies in Dataverse. For more information, see the Allowlist Business Central Environments and Companies section in this article.

Allowlist Business Central Environments and Companies

For Finance agents to be able to connect successfully to Dynamics 365 Business Central, an administrator must first allowlist the Business Central environments and companies users are allowed to connect to from Outlook. This allowance is done in a Dataverse table that can be accessed in the Power Apps authoring site.

The allowlisting of Business Central companies and environments is made in the Dataverse table in the Finance agents Business Central Environment. You need the following information to allowlist an environment and company in this table:

• The name of the Business Central environment

  • This information can be found in multiple ways:
    • In the Business Central Admin Center. For more information on where to locate the environment name, see The Business Central Administration Center.
    • In the company selector, in Business Central. For more information on where to locate the environment and company name in Business Central, see Switching to Another Company or Environment.

• The company ID of the specific company

  • In Business Central, navigate to the Companies page or search for Companies in the Tell-me search and select Companies from the search results.
  • Select the desired company in the Companies list.
  • Open the Page Inspector with CTRL+ALT+F1.
  • Find the ID field in the list of fields.
  • Copy or note the field value (the guid).

• The company display name (optional)

  • If you want the users to see the same company display name in Outlook as in Business Central, copy or note the Display Name from the selected company in the Companies list.

To create the company and environment allowlisting in Dataverse, follow these steps.

1. Navigate to the Power Apps Maker Portal.
2. Select Tables in the navigation and find the Finance agents Business Central Environment table.
3. Ensure these fields/columns are visible: Name, Environment, Company ID, Company Name.
4. Create a new record in the table
5. Fill in the Environment, Company ID, Company Name, and Name fields. The Company Name is the name that is visible to the user in Outlook. Here you can determine to use something else than the Display Name from Business Central if desired.

Add all the Environment and Company combinations you want to be selectable in Outlook.