Mobile setup for D365FO

Introduction

This section contains the basic configuration required in Dynamics 365 for Finance and Operations > Dynaway mobile to let users connect to and work with the Mobile Client.

Prerequisite

You have completed mobile backend installation, as described in the section above.

Audience

Sysadmin, Partner Consultant

Overview

The initial setup of Dynaway mobile includes the following steps:

1. Set up security roles (in D365FO)
2. Set up change tracking
3. Set up handlers
4. Set up users
5. Set up entities (for more information on entity setup, refer to the Data entities section)
   1. Set up entity documents (optional)
6. Initialize entities for synchronization

Security roles

You must set up security roles in Dynamics 365 for Finance and Operations for administrators or managers to work with setup in the Dynaway mobile module, and for workers to be able to access the Mobile Client.

Role	Related tasks	CAL level in Microsoft Dynamics 365 for Finance and Operations
Dynaway Mobile administrator	This role has access to the Dynaway mobile module in Dynamics 365 for Finance and Operations. Here, the user can set up and change the configuration of the Mobile Clients. This includes setting up the functionality available on the Mobile Client as well as setting up the users who should be able to log in on the Mobile Client.	Team Members
Dynaway mobile data manager	Load setup data from data entities for data migration.	None
Dynaway Mobile user	This role is required to log in and make registrations on the Mobile Client.	None

Change tracking

Change tracking is a feature on the database, which is used to track entity changes. Change tracking determines which changes to send to the Mobile Clients during synchronization. The feature must be enabled on the database if it is not already, and on the Asset management tables used in synchronization.

Select Dynaway mobile > Setup > Mobile parameters > Change tracking to set up change tracking and view synchronization status:

• The Database section shows if change tracking is enabled on the database. If not, it must be done in the database itself. In the Change tracking retention field, the period (days) in which change information will be stored on the database is shown.
• The Entity tables section shows if the tables used for synchronization have been enabled. If not, select the Enable/disable button. Entity tables must be enabled for synchronization to function properly.
• Refer to the article "Entity initialization" in the Data entities section for information regarding Synchronization paging and Synchronization status.

Handlers

Handlers are methods that are visible to the Mobile Client. You must set up handlers to allow the Mobile Client to make external calls to Dynamics 365 for Finance and Operations.

1. Select Dynaway mobile > Setup > Handler setup and open the form to initialize handlers for the Mobile Client.
2. Check that handlers are listed.
3. Handlers are now set up, and you can close the form.

User configuration

Users must be created in Dynamics 365 for Finance and Operations and be associated with a person. The setup is made in System administration > Users > Users. Next step is to add persons to mobile users.

Mobile users (workers) must be set up in three forms in Dynamics 365 for Finance and Operations to be able to make registrations on the Mobile Client:

1. General setup in the User form, in which you select the Dynamics 365 for Finance and Operations security roles that define which registrations a user (worker) can make on a Mobile Client. Select System administration > Users > Users to open the form.
2. Mobile client setup in the Users form, in which you select a company account ID for the user (worker). All registrations made by the worker on a Mobile Client will be related to the selected company account in Dynamics 365 for Finance and Operations. Select Dynaway mobile > Setup > Users to open the form. If required, you can also create user groups for convenient module configuration.
3. Worker setup in Asset management > Setup > Workers > Workers. In this form, a worker from the Human resources module is added as an Asset management worker.

In System administration > Users > Users, three Dynamics 365 for Finance and Operations security roles are required for each mobile user to make registrations on a Mobile Client:

• The System user is a general Dynamics 365 for Finance and Operations user, which is always required.
• The Dynaway Mobile user role is required to log in and make registrations on the Mobile Client.
• In order to make registrations in Asset management, one of the following roles is required, depending on the worker's primary work area:
  • Maintenance manager
  • Maintenance clerk
  • Maintenance requester
  • Maintenance worker

For further information regarding general mobile configuration setup, refer to the Dynaway mobile setup section.

Initialize entities

All data (the entities) for the Mobile Clients are kept in a single table that must be initialized before use. If entities are changed (code changes), the table must be reinitialized. In Dynamics 365 for Finance and Operations, select Dynaway mobile > Periodic > Initialize synchronization data, and click OK, to carry out data initialization.

For more information about data initialization, refer to the section Data entities.