Flexible Importer

The export of data to another system is always a challenging task. During this action team may experience a lot of difficulties. One of the hardest is applying the expected data model for the system that will import those data.

The new Flexible Importer will help you with that. With Flexible Importer, you'll be able to export data from your system without any specific format or structure. The only requirement, for now, is to have your data in *.csv or *.xlsx file format (in the future, we will extend the list of supported file type e.g. *xml). Once you have your data exported from an external system, Flexible Importer will allow you to write a transform script into objects definitions understandable for LogiX Platform by yourself using C# syntax. Flexible Importer will allow you to import:

  • SKUs with packaging structure and line configuration

  • Orders

Defining Transform Function Definition

Adding New Function

Adding a new transform function will be possible through the Add new function button located on the Formats list view. Each factory has its own list of formats. By default, there will be standard PackOS formats available. Defined in Preparing a Material Master Import ✔️.

To create a new function, fill in the required name and script fields. Additionally, you can decide if you want to make your function visible to other users using the Visible slider. After hitting the Save function button, the Test file upload become active.

Testing Newly Created Function

The newly added functionality also allows you to test your newly created function by letting you upload a test file. After the successful transformation, you'll see definitions of SKUs or Orders that were successfully transformed with your transform as below.

If the import fails, a list of errors encountered during script execution will be returned.

Uploading Import Files

The entry to the Flexible Importer mechanism will be located in the PackOS UI component. It will be placed in the same place as Items Import. The new view will look like this:

To start the whole process, in the first step, you need to pick desired Format from the dropdown as below. The mentioned operation is shown in the graphic below:

Now you can drop your file by the Drop file component or browse for the file by clicking here. The import process will start immediately after the file upload finishes.

Importing summary

Users will access each import summary by visiting the Import view. At the bottom of the mentioned view, there will be located list of performed imports.

This list contains three columns.

  • Import status

  • Filename

  • Import data

The import process can be in the following states:

  • In progress - visualized with a work indicator graphic

  • Success - visualized with a thick graphic

  • Errors - visualized with an exclamation mark graphic

The summary report can be accessed by clicking on the desired file name. The summary report view contains a list of extracted SKU or Order definitions.

As seen in the picture above, the report also shows information about Old value if imported SKU or Order already exists in the system - this way you can clearly see what has been updated as the result of the import. The important thing about Flexible Importer is that this mechanism does not delete any existing data - it just updates and adds them; if an update cannot be performed, the Error message is provided with an explanation of why it fails.

 

You can see template of order import file here: Importing Orders ✔️


When using import default functions remember:

  • ‘Line’ has to be the Line Code, not the Line Name


Future Plans

In the future releases of Flexible Importer we are planning to implement the following functionalities:

  • Ability to start import process through our Public API

  • Ability to automate the import process. We want to allow the end-user to set up the location from where the file with data to import can be downloaded e.g. external server and then set a schedule when the import has to start.