To enable your technicians to work with maintool mobile, install the extension in Business Central and then set up Anvaigo, the users and the master data. This article shows the order of all setup steps and describes the installation, the synchronization packages and the permission sets.
Prerequisites
- maintool is installed and set up.
- You have a license for maintool mobile, see Licensing of maintool mobile.
- You are allowed to install extensions in Business Central.
Order of the setup
Ideally, set up maintool mobile in this order. Each step builds on the previous ones.
- Install the collana maintool mobile extension and set up Anvaigo (this article).
- Check whether the app configuration has been imported: Import and update the app configuration.
- Activate the synchronization packages (this article).
- Define the general settings: Mobile Setup in maintool.
- Prepare master data, for example resources, units of measure and items: Prepare master data for maintool mobile.
- Create an Anvaigo user for each person: Set up Anvaigo users.
- Define for each user which functions they use and what is posted: Set up mobile users and user groups.
- Assign permission sets (this article).
- Check the setup: Check the setup with the Mobile Setup Analyser.
The users then sign in to the Anvaigo app on their device, see maintool mobile overview.
Install the extension
- In Business Central, install the collana maintool mobile extension. The extension requires the Anvaigo Mobile App, collana maintool and collana maintool-suite licensing extensions.
- During installation, maintool creates the Mobile Setup with default values: Maximal Picture Size in MB 5, Background Synchronization off, Auto Update Mobile App on, History Time Intervall 1 month, App Type Maintenance, Record Reservation off.
- maintool then automatically imports the app configuration of maintool mobile into Anvaigo – with the MAINTOOL main menu, pages and synchronization packages. This also happens with every update of the extension as long as Auto Update Mobile App is turned on.
Available from version 20260900.2: The app configuration is part of the extension and is imported automatically. In older versions, it was provided as a file and imported manually via Import Anvaigo data.
If you have customized the app, turn off the automatic update so that an update does not overwrite your customizations. How to export the configuration and import it manually is described in Import and update the app configuration.
Set up Anvaigo
maintool mobile runs on the Anvaigo platform. The initial setup of Anvaigo is a function of the Anvaigo Mobile App extension and is not part of maintool. You can find the Anvaigo settings, for example for the Anvaigo license, on the Anvaigo Setup page. This is also where you import the app configuration manually if required. The Mobile Setup Analyser checks whether the Anvaigo license is valid.
Activate the synchronization packages
Synchronization packages define which data is transferred between Business Central and the device. Synchronization is not possible without active packages. The app configuration creates these packages:
| Package | Content |
MAINTOOL |
Work orders, master data and setup for maintool mobile |
MAINTOOL TECHN. OBJ |
technical objects |
MAINTOOL LOCATION |
inventory data, only items with Use in Mobile |
MAINTOOL HISTORY |
work order history; controlled via Work Order History enabled in the Mobile Setup |
#ANVPKG#0001#ANVPKG# |
Anvaigo system package |
In the Anvaigo setup, check under the synchronization packages whether all packages except MAINTOOL HISTORY are active, and activate any missing packages. The Mobile Setup Analyser reports every inactive package. Which packages a user receives is defined on the Anvaigo user, see Set up Anvaigo users.
Up to version 20260900.2, the main menu and the packages were called MAIN-TOOL, MAIN-TOOL HISTORY, MAIN-TOOL LOCATION and MAIN-TOOL TECHN. OBJ. When you update to a newer version, maintool renames them automatically, including their assignment to the users.
Assign permission sets
maintool mobile includes two permission sets:
| Permission set | Name | For whom |
GLI Mob Base |
maintool App | all users of maintool mobile: read the Mobile Setup and the mobile users, write errors, pictures and signatures, inventory data and feedback lines |
GLI Mob Setup |
maintool App Setup | administrators who set up maintool mobile: Mobile Setup, Mobile Setup Analyser, user groups |
The permissions for the maintool mobile tables are also included in the standard permission sets D365 BUS PREMIUM, D365 BUS FULL ACCESS, D365 FULL ACCESS and LOCAL.
Business Central processes the data from the app into work order feedback, work order requests, work orders, journal lines and inventory documents. Therefore, also assign the users the maintool and Business Central permission sets for the functions they use in the app, for example GLI WO Write (work orders), GLI WO Fdb Write and GLI WO Fdb Post (work order feedback) or GLI WO Req Write (work order requests).
Notes and limitations
- The app configuration is only imported during installation and update if Auto Update Mobile App is turned on in the Mobile Setup. An import overwrites the existing configuration of the app in Anvaigo.
- The
GLI-OBJpermission set from older versions no longer exists.
Related articles
- maintool mobile overview
- Import and update the app configuration
- Set up Anvaigo users
- Check the setup with the Mobile Setup Analyser
Related to