Customize synchronization packages

  • Updated

Which data maintool mobile transfers between Business Central and the device is defined by the Anvaigo synchronization packages. maintool supplies them with the app configuration. This article describes what each package contains, which maintool settings control the packages and what you need to consider if you customize the packages yourself, for example to reduce the amount of data on the devices.

Prerequisites

  • maintool mobile is installed and the app configuration has been imported, see Install and set up maintool mobile.
  • For changes directly to the packages: knowledge of the Anvaigo setup. The pages for synchronization packages belong to the Anvaigo Mobile App extension and are not part of maintool.

What the packages contain

maintool mobile works offline: only what has been synchronized to the device via the packages is available in the app. Each package contains a number of tables. Filters on the package and links between the tables determine which records are transferred. The app configuration creates these packages:

Package Content Filters and conditions
MAINTOOL Work orders with lines, text and detail lines, comments, locations of work and documents; the technical objects from the detail lines with data sheets, locations (Technical Object Location) and pictures; master data such as resources, resource groups, work types, units of measure, work order categories, malfunction codes, priorities, types of activity and work order statuses; the Work Order Management Setup and the Mobile Setup; the user's own mobile user and own error messages.
  • Work orders with a Work Order Status Value from 200 to 269 (for example Execution, In Progress) that are not blocked. The packages do not filter by resource or department.
  • Work order statuses from 200 to 270.
  • Locations of work only with Main Location.
  • Pictures of technical components only with Use in Mobile.
  • Documents only if they were requested in the app with Sync Documents.
  • Mobile user, user setup and error messages only of the Anvaigo user who is signed in.
  • Work order requests, work order feedback, work order journal lines and follow-up work orders: no existing records are transferred from Business Central.
MAINTOOL TECHN. OBJ All technical objects: component addresses, mounting positions, technical components and vehicles, plus technical specifications, technical manufacturers, component groups, classifications, data sheet templates and vehicle types and models. No filter – the package transfers all technical objects.
MAINTOOL LOCATION Inventory data: items with variants, units of measure and item tracking codes, locations and bins, purchase orders with vendors and lines, transfers, the inventory setup and the stock per item for the app.
  • Items only with Use in Mobile and the Type Inventory or Non-Inventory.
  • Locations without in-transit locations.
  • Only released purchase orders, and of these only lines of type Item.
  • Item journal lines and transfer orders: no existing records are transferred from Business Central.
MAINTOOL HISTORY Work order history: past work orders with lines, comments, locations of work, technical objects with data sheets as well as feedback, photos and signatures.
  • Work orders with a Work Order Status Value of 270 or higher (Reported finished in mobile and higher).
  • Execution Date-Time within the period of the History Time Intervall (default: last month).
#ANVPKG#0001#ANVPKG# Anvaigo system package (main menu, pages, texts of the app). According to the package description, do not edit.
ANVEOSETUPTEST Anvaigo test package for the setup. –

Items are only transferred with the MAINTOOL LOCATION package. Technical objects that are not in the detail lines of a synchronized work order only reach the device with the MAINTOOL TECHN. OBJ package.

Control the amount of data with maintool settings

maintool controls some packages through its own settings. Use these settings before you change packages directly – they are kept when you update.

Setting Effect on the packages
Work Order History enabled (Mobile Setup, Work Order History FastTab) Enabling assigns the MAINTOOL HISTORY package to all existing Anvaigo users, disabling removes it from all of them. Before enabling, maintool points out that the first synchronization afterwards takes significantly longer.
History Time Intervall (Mobile Setup, Work Order History FastTab) 1 Month, 6 Month or 12 Month. maintool uses it to set the filter on Execution Date-Time in the MAINTOOL HISTORY package.
Maximal Picture Size in MB (Mobile Setup, General FastTab) Only pictures up to this size can be marked with Use in Mobile. If you reduce the value, maintool removes the mark from all larger pictures after a confirmation.
Use in Mobile on items and on the picture of a technical component Only marked items and pictures are transferred, see Prepare master data for maintool mobile.

The fields of the Mobile Setup are described in Mobile Setup in maintool.

Customize packages directly

If the maintool settings are not sufficient, you can change the packages in Anvaigo, for example set a filter on locations or technical objects. Plan such changes carefully:

  1. Write down which packages, tables and filters you change and why. The Export Mobile App action in the Mobile Setup downloads the supplied app configuration of the installed version, not the current state in Anvaigo. It is therefore not suitable for backing up your changes.
  2. Decide how to handle updates (see below): repeat the changes after every update or maintain the app configuration manually.
  3. Search for Anvaigo Synchronization Packages and open the package you want to change.
  4. Choose Deactivate, change the package (see Set a filter) and then choose Activate.
  5. Search for Anvaigo Mobile App Setup and choose Administration > Update All Delta Scripts. maintool uses the same order – deactivate, change the filter, activate, update the delta scripts – when it sets the filter for the History Time Intervall.
  6. Check the setup with the Mobile Setup Analyser, see Check the setup with the Mobile Setup Analyser. It reports every inactive package except MAINTOOL HISTORY and every Anvaigo user without a package.
  7. Synchronize a test device and check whether all required data is available in the app.

Set a filter

The Tables FastTab of the package lists the tables the package transfers. Among others, it contains the actions Edit Filter, Edit Relation and Select Fields.

  1. Open the package and choose Deactivate.
  2. On the Tables FastTab, select the table whose records you want to restrict, for example the locations in the MAINTOOL LOCATION package.
  3. Choose Edit Filter and enter the filter.
  4. Choose Activate and update the delta scripts (see above).
  5. Synchronize a test device and check the result.

Do not change the delivered relations and table settings without consulting your maintool partner.

Customizations and updates

  • The app configuration contains the synchronization packages with all tables and filters. An import overwrites the existing configuration in Anvaigo and therefore also your changes to the packages.
  • If Auto Update Mobile App is enabled in the Mobile Setup, maintool imports the app configuration with every installation and every update. Repeat your changes afterwards, or disable the automatic update and maintain your customizations in your own app configuration, see Import and update the app configuration.
  • If you change the History Time Intervall in the Mobile Setup, maintool overwrites the filter on Execution Date-Time in the MAINTOOL HISTORY package.
  • Do not rename the packages. maintool expects the names MAINTOOL and MAINTOOL HISTORY. If, for example, the MAINTOOL package is missing, maintool reports The app is not installed properly. The synchronization package for the historical data is missing. when you enable the work order history.

Notes and limitations

  • What is not synchronized is not available on the device – not even offline. A filter that is too narrow can restrict functions of the app, for example items are missing when reporting material or work orders are missing in the history.
  • Packages are assigned per Anvaigo user. Assign MAINTOOL, MAINTOOL TECHN. OBJ and MAINTOOL LOCATION to every user, see Set up Anvaigo users. When the work order history is enabled, maintool assigns MAINTOOL HISTORY only to the users that exist at that time.
  • More data makes the synchronization take longer. After a change, check how long the synchronization takes on the device.
  • If synchronization errors occur after a change, find them as described in Find synchronization errors.

Note for partners:
In the maintool App.xml app configuration, the packages are stored in the Anvaigo tables 5327170 (package headers), 5327171 (package lines), 5327172 (relations), 5327174 (filters) and 5327175 (fields); in the code they are called ACF Synch. Package Header, ACF Synch. Package Line, ACF Synch. Package Relation, ACF Synch. Pckg. Filter Entry and ACF Synch. Package Field, the assignment to the users ACF User Synch. Pckg. Setup. For the History Time Intervall, maintool sets the filter on field 55 of the GLI Work Order Header table in the MAINTOOL HISTORY package, deactivates and activates the package in the process and then updates the Anvaigo delta queries (UpdateDeltaQueries). You can set a different period using the OnBeforeSetFilterInHistoryTimeIntervall event of the GLI Mobile Setup table.

Related articles

Related to

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request