Comprehensive import of work order data

Introduction

The document describes the mechanism for importing comprehensive information specifying work orders in the system into the AMAGE system. This data includes basic information about orders, but also attachments/documentation facilitating the implementation of work, material lists necessary for their execution and the history of work performed.

The document describes import mechanisms and their use in order to fully import data into the system from various sources, but in total constituting complete information necessary to achieve a specific business goal. The tutorial does not describe in detail the functions of the importer mechanisms and individual windows. Please refer to the user manual for the basic user interface.

Principle of operation

Our goal is to import data from various areas of the company’s business systems into the AMAGE system. Let’s call them collectively the ERP system, but it is not necessary to have this data in one system.

Usually, for proper operation we need:

  • employee data - employees will log in to the system, but we also need data of employees who, even though they do not log in to the system, still exist in some way, e.g. they are members of executive teams, of which only their foreman has access to the system.

  • data of supervised elements - resources - these are objects on which business functions are performed. Whether they are devices, machines or construction elements, each of them has its own data, parameters and appropriate categorization of type and manufacturer.

  • assortment/type dictionaries - they can define resources but can also be used in ordering, delivery and warehouse modules as countable elements without specific representation as resources in the system.

  • work orders - orders that group activities to be performed into work units. They may be related to the assortment (what needs to be ordered, delivered) or specific resources (what needs to be built, installed, operated). For this we need additional imports of resources or types related to work orders - they will create material plans or lists of related resources in the system.

  • deliveries, warehouse documents - we can either use existing documents from the ERP system and transfer them to the AMAGE system in order to achieve data completeness or use this mechanism to import delivery documents issued by our subcontractors or suppliers.

The entire set of data mentioned above allows you to enter a significant amount of information into the system and use this data in individual field modules, e.g. supervision, service requests or inspections.

The next stage of automation is to include the imports described above in the integration mechanism. The system can automatically download such files from specific sources (email, ftp, server directory) and use the import schemes (templates) specified in this tutorial. Here let’s focus on the definition of basic structures and import templates.

Let’s go through all the import mechanisms in the order described above.

Importing users

We import users↓users. The XLS/CSV sheet contains user data, login, email, phone number and other data.

We select the import mechanism from the list of available importers.

construction workstructure piping import b925c
Figure 1. Selecting an import from the import list

We select the file to be imported and, if we have already gone through these steps, the mapping template we have. If we don’t have it, we create it in the next steps.

construction workstructure piping import 3af03
Figure 2. Selecting a file and mapping (template)

We define the import parameters. Each importer has its own specific parameters and behaviors. Here we have available:

  • add departments, employers - when importing, we automatically add/create the necessary additional records - departments, employers, etc.

  • deactivate missing employees - we treat the import file as the only data source and users who do not appear there are automatically deactivated in this system.

construction workstructure piping import a4a5f
Figure 3. Import definition

Then we define the fields and their meaning in the imported file. Here we can also save all previously defined data in the template under a specific name. We will be able to use it in subsequent imports or to automate the process.

construction workstructure piping import b3983
Figure 4. Field mapping

We import. Employees/users are in the system.

Importing types

We move on to importing the assortment - element types. We usually have this data from the ERP system, from the warehouse or ordering module. We can also import data provided by our subcontractors.

We select the importer from the list.

construction workstructure piping import e41df
Figure 5. Selecting a type from the import list

Let’s define field mapping and their meaning

construction workstructure piping import a0974
Figure 6. Type field mapping definition

We import data. An example result of imported data with the division of the product range into categories is presented below.

construction workstructure piping import baa84
Figure 7. Import result with categories

Let’s move on to importing resources.

Resource import

We select the resource importer from the list.

construction workstructure piping import 13608
Figure 8. Selecting resources from the import list

We define additional information and parameters. ATTENTION. The importer has an extensive parameter panel and please refer to the user manual for additional information about the meaning of individual parameters.

construction workstructure piping import 97180
Figure 9. General definitions

We define field mapping and their meaning.

construction workstructure piping import f365a
Figure 10. Record mapping definition

We import data. In the import progress view, we receive a visual report of the activities performed and any errors.

construction workstructure piping import cb776
Figure 11. Import progress - completion

The end result is imported resources in the system along with their association in trees and appropriate categorization with element types.

construction workstructure piping import 91ef8
Figure 12. Import result with children

We have a ready data structure on which we can work. Now let’s import the to-do list.

Work orders

We select the work order importer from the list.

construction workstructure piping import 61477
Figure 13. Selecting work orders from the import list

We define general importer options.

construction workstructure piping import 0e0f3
Figure 14. General importer options

We map the fields in the file and determine their meaning.

construction workstructure piping import e9383
Figure 15. Record mapping

We import into the system.

construction workstructure piping import 02061
Figure 16. Import process

As a result, we receive a list of tasks to be performed along with subtasks. The scope of fields to be imported is wide (import of schedule, task assignment, etc.).

construction workstructure piping import 28bc5
Figure 17. Work order import result

To associate tasks with previously imported element types and resources, we need to perform two additional imports.

Work orders - list of material plans

One file contains a link between the assortment (types of elements) and work orders, along with specifying the amount of a given material necessary to complete/order.

We select the importer from the list.

construction workstructure piping import f4161
Figure 18. Plan import options

We choose the field mapping in the imported sheet and their meaning. The main task here is to indicate the relationship between types and work orders.

construction workstructure piping import de04d
Figure 19. Field mapping in the imported sheet

We import data into the system.

construction workstructure piping import e1f71
Figure 20. Import process with data details

As a result, we receive a list of materials in the work order and a material plan. From here we will be able to order them or generate an order to the warehouse for delivery.

construction workstructure piping import f0055
Figure 21. Plan view on a work order

The second link is to link resources to work orders. We carry out similar activities.

construction workstructure piping import 2da37
Figure 22. Selecting an import from the import list
construction workstructure piping import bf7a0
Figure 23. Field mapping
construction workstructure piping import aff83
Figure 24. Import progress

As a result of these operations, we receive information about the resources associated with the work order. Based on this data, it will be possible to conduct further automation or quickly navigate between the task to be performed and the data of the resource (parameters, documentation) that needs to be performed.

construction workstructure piping import 0a7c0
Figure 25. The result of related resources on a work order

Attachments for work orders/resources

In the process we describe, additional documentation is often created, which is very useful during the work performed. The attachment importer allows this. Unlike previous importers, it works on a ZIP archive containing files and an XLS sheet that contains information about which resources/work orders a given document should be attached to.

To create such an importer, we create:

  • zip archive with all files (they may be in subdirectories) and one xls file called import.xls(x)

  • the import.xlsx file contains information about the file path and name, as well as information about the resource or work order to which we are linking the file.

We load such an archive into the system.

you should pay attention to the size of such an archive. It is recommended not to exceed 100MB per archive file. If you need to import a larger number of files, divide them into several imports.
construction workstructure piping import a96e0
Figure 26. Selection of a ZIP file and a field mapping template

We define the mapping between the file and the resource or other object handled by this importer.

construction workstructure piping import 6a6a8
Figure 27. Field definition

We import.

construction workstructure piping import 159b8
Figure 28. Successful data import

As a result, attachments appear in specific resources and can be viewed and downloaded.

construction workstructure piping import 172cf
Figure 29. Result - list of attachments in the resource structure

Orders

The final step in this tutorial is to import order/delivery data. We use an order import mechanism.

We select the order importer.

construction workstructure piping import 1ad24
Figure 30. List of importers - selection of import orders

We define the mapping of individual fields and perform the import.

construction workstructure piping import acfae
Figure 31. Order import mapping

The end result is imported delivery orders with material details.

Deliveries

We import supplies. Identical to other operations. We choose a supply importer.

construction workstructure piping import 5df12
Figure 32. List of importers - selection of deliveries importer

We define the fields and their meaning and perform the import.

construction workstructure piping import bf75b
Figure 33. Delivery import mapping

Deliveries appear in the system. Using the delivery module, we can verify their completeness, create complaints or transfer the material to warehouses.

Summary

In this way, we imported a significant range of data from the areas of orders, deliveries, data structure and work orders. We divided the imports into individual stages and used the available importer functions to adapt to the existing XLS/CSV data files. We can now use this data in the system.

Further automation may also be the next steps. While defining these imports, we saved individual templates. Now we can enable integration, e.g. via email, and set the system so that when an XLS file arrives with delivery, it will be automatically downloaded to the system and imported in relation to the template for a given supplier. The possibilities are endless :)

The Howto is based on system version 1.17.0.2 (03.2022) and presents features that may not be available in your system. Ask AMAGE about making this functionality available.
Due to ongoing development of the system, some screens or configuration files may look slightly different, but will still retain the full functionality described here. This does not affect the core functionality described in this document.