Item assignments

Use assignment files to create a linkage between your uploaded item-related data and the correct items.

Assignment files are used as "lists" with one or more entries. Each entry contained therein corresponds to a link between the item and the set data. The item-related files may be images, long texts or other data formats ( Files).

In principle, assignments consist of an item number and the file name of the data to be linked. This assignment determines which data belongs to which article in OXOMI.

Note: Item-related files, such as images, can be assigned to several items and do not have to be uploaded for each item individually.


For the correct linkage of the data it is important to select the correct type. Types can be found on two levels. First, select from the three main groups of item-related files: images, long texts, and files. You make this selection while you are processing the assignment. In the assignment file, you define for example of which image type (product image, line drawing, etc.) the imported image is.

Further details can be found on the respective sub-pages of the supported assignment formats. (Coming soon!)

Procedure of assignment

The following table describes the procedure with which you can create links between data and items step by step.

Step 1

In the first step, the desired item-specific data is uploaded into the media pool as files. This can be done individually or with several files at once (as ZIP file).

Step 2

If the files are successfully listed in the media pool, the assignment files are used next. These are uploaded to the work directory and processed from there.

Step 3

By clicking on the "Process" link, OXOMI processes the assignment files and links the items with the files.

Step 4

To ensure that the assignment file is interpreted correctly, select the type of article-related data in the next step.

Step 5

In the last step, processing is configured. Here it is still possible to make some adjustments to the item-specific data. For example, if you want the imported images to be available only for certain languages or countries, you can define this in this step.

Note: If the item-related data in the media pool contains path specifications in the file name, you can use the configuration field "Prefix" to restrict the assignment to data of the specified path.

OXOMI creates a "job" for each processing. In this way, you can track the progress of the processing, as well as possible warnings and errors that might occur in order to correct them afterwards if needed.

If the processing has been successful, the affected data is displayed in the corresponding overviews: Images, Long texts or Files under the main navigation point "Items".

Supported assignment formats

In order to keep the assignment of the item-specific data as comfortable as possible, OXOMI supports several file formats. In addition to OXOMI's own assignment format, which can either be imported as an Excel97 or CSV file format, industry-standard formats (for example BMEcat) are also supported.

Further details can be found on the respective sub-pages of the supported assignment formats. (Coming soon!)