Install and configure Microsoft Dynamics 365 for Finance and Operations – Warehousing

This topic describes how to install and configure Microsoft Dynamics 365 for Finance and Operations - Warehousing.

Finance and Operations - Warehousing is an application available on Google Play Store and Windows Store. For the current version of Finance and Operations, this app is provided as a standalone component, which means self-deployment on devices used for warehouse tasks. In order to use the app in your Finance and Operations environment, you must download the app on each device and configure it to connect to your Finance and Operations environment. This topic describes how to install the app on your devices. It also explains how to configure the app to connect to your Finance and Operations environment.

Prerequisites

The app is available on Android and Windows operating systems. To use this app, you must have one of the following supported operating systems installed on your devices. You must also have one of the following supported versions of Finance and Operations. Use the information in the following table to evaluate if your hardware and software environment is ready to support the installation.

Platform Version
Android 4.4, 5.0, 6.0
Windows (UWP) Windows 10 (all versions)
Finance and Operations Microsoft Finance and Operations version 1611
-or-
Microsoft Dynamics Dynamics AX version 7.0/7.0.1 and Microsoft Dynamics AX platform update 2 with hotfix KB 3210014

Get the app

Create a web service application in Active Directory

To enable the app to interact with a specific Finance and Operations server, you must register a web service application in a Azure Active Directory for the Finance and Operations tenant. For security reasons, we recommend that you create a web service application for each device that you use. To create a web service application in Azure Active Directory (Azure AD), complete the following steps:

  1. In a web browser, go to https://manage.windowsazure.com.
  2. Enter the name and password for the user who has access to the Azure subscription.
  3. In Azure Portal, in the left navigation pane, click Active Directory.wh-01-active-directory-example
  4. In the grid, select the Active Directory instance that is used by Finance and Operations.
  5. On the top toolbar, click Applications. wh-02-active-directory-applications
  6. In the bottom pane, click Add. The Add application wizard starts.
  7. Enter a name for the application and select Web application and/or web API. wh-03-active-directory-add-application
  8. Enter the sign-on URL, which is your web app URL. This URL is the same as your deployment URL, but oauth is added to the end. Enter the App ID URI, this value is mandatory, but isn’t required for the authentication. Make sure that this App ID URI is a mock URI like https://contosooperations/wmapp, since using the URL of your deployment can cause sign-in issues in other AAD applications such as the Excel Add-in. WH-04-AD-add-properties3
  9. Go to the Configure tab. wh-05-ad-configure-app
  10. Scroll down until you see the Permissions to other applications section. Click Add application. wh-06-ad-app-add-permissions
  11. Select Microsoft Dynamics ERP in the list. Click the Complete check button in the right corner of the page. wh-07-ad-select-permissions
  12. In the Delegate Permissions list, select all the check boxes. Click Save. wh-08-ad-delegate-permissions
  13. Make a note of the following information:
    • Client ID - As you scroll up the page, you will see Client ID displayed.
    • Key - In the Keys section, create a key by selecting duration, and copy the key. This key will later be referred to as the Client secret.

Create and configure a user account in Finance and Operations

To enable Finance and Operations to use your Azure AD application, you need to complete the following configuration steps:

  1. Create a new user account in Azure Active Directory for the Finance and Operations tenant. The purpose of this user account is to access the specific custom service of the warehousing app, which the Finance and Operations server exposes. After completing this step, you will have WMDP user credentials, which consist of a WMDP email address and a WMDP password. To learn about the basic steps for adding users to Azure AD and Finance and Operations, refer to this tutorial: Sign up for a Finance and Operations subscription.
  2. Create a Finance and Operations user that corresponds to the warehousing app user credentials.

    1. In Finance and Operations, go to System administration > Common > Users.
    2. Create a new user.
    3. Assign the Warehouse mobile device user, as shown in the following screenshot. wh-09-add-user-security-role
  3. Associate your Azure Active Directory application with the warehousing app user.

    1. In Finance and Operations, go to System administration > Setup > Azure Active Directory applications.
    2. Create a new line.
    3. Enter the Client ID (obtained in the last section), give it a name, and select the previously created user. We recommend that you tag all your devices so that you can easily remove their access to Finance and Operations from this page in case they are lost. wh-10-ad-applications-form

Configure the application

You must configure the app on the device to connect to the Finance and Operations server through the Azure AD application. To do this, complete the following steps.

  1. In the app, go to Connection settings.
  2. Clear the Demo mode field.
    wh-11-app-connection-settings-demo-mode
  3. Enter the following information:
    • Azure Active directory client ID - The client ID is obtained in step 13 in "Create a web service application in Active Directory".
    • Azure Active directory client secret - The client secret is obtained in step 13 in "Create a web service application in Active Directory".
    • Azure Active directory resource - The Azure AD directory resource depicts the Finance and Operations root URL. Note: Do not end this field with a forward slash character (/).
    • Azure Active directory tenant - The Azure AD directory tenant used with the Finance and Operations server: https://login.windows.net/your-AD-tenant-ID. For example: https://login.windows.net/contosooperations.onmicrosoft.com.
      Note: Do not end this field with a forward slash character (/).
    • Company - Enter the legal entity in Finance and Operations to which you want the application to connect.
      wh-12-app-connection-settings
  4. Select the Back button in the top-left corner of the application. The application will now connect to your Finance and Operations server and the log-in screen for the warehouse worker will display.
    wh-13-log-in-screen

Remove access for a device

In case of a lost or compromised device, you must remove access to Finance and Operations for the device. The following steps describe the recommended process to remove access.

  1. In Finance and Operations, go to System administration > Setup > Azure Active Directory applications.
  2. Delete the line that corresponds to the device to which you want to remove access. Note down the Client ID used for the removed device.
  3. Sign in the Azure classic portal at https://manage.windowsazure.com.
  4. Click the Active Directory icon on the left menu, and then click the desired directory.
  5. On the top menu, click Applications, and then click the application you want to configure. The Quick Start page will appear with single sign-on and other configuration information.
  6. Click the Configure tab, scroll down and ensure that the Client ID of the application is the same as in step 2 in this section.
  7. Click the Delete button in the command bar.
  8. Click Yes in the confirmation message.