Introduction

This document contains description of procedures of Import data application in reference to number ranges. The procedures describe, among others, the order of performing steps that should be observed when importing number ranges, as well as information regarding possible requirements, results and limitations. The data import regards external number ranges.

Detailed information regarding data import can be found in Data import technical documentation.

Number ranges are used for an automatic assignment of number ranges by the system for object identification purposes. For more information, refer to Number ranges article.

Data import

1. Open Import data application

2. In the Filter field, with the use of [Value assistant] option, select the following business entity: cisag.app.general.obj.NumberRange

3. The filter used for importing data is displayed

Application Import data with the filter for Number ranges application

4. Selected filter attributes are checked, by default. If needed, at this stage, it is possible to edit the attributes.

5. Click on the [Import data] button on the standard toolbar.

6. Import data dialog window is opened.

7. In this dialog window, it is possible to enter settings for the import file. Detailed information regarding fields and buttons, can be found in Data import article.

8. Start data import by clicking on [In batch] button.

However, it must be remembered that the set of available filters does not contain all business units, but only part of them as predefined values. Other business units must be searched and saved as a new filter.

Defining number ranges

When creating new number range in Number ranges application, it is necessary to specify identification attribute and complete all mandatory fields. Without an identification attribute, it is not possible to import a number range. If the data is not correct, Number ranges application is opened in a dialog window in Import data, so that it is possible to correct the data.

Mandatory field and identification attributes are listed in the table below.

The following data must be available for each number range component.

If number range numbers have been already created, it is necessary to specify the following attributes, so that the system can correctly define subsequent numbers which are to be generated.

Obsolete attributes

The system handles the following obsolete attributes. They can be imported, if the import file was created on the basis of an export file, with the use of obsolete attributes.

Particular processing characteristics of existing components of number ranges

Attribute Last created number (lastNumber) is not subject to replacement during the import. The attribute (lastNumber) can be imported only if number range is created from the beginning or if selection fled Last created number does not have any value assigned. Otherwise, the attribute is ignored during the import.

To be able to delete the definition of the component in the import file, the component must be empty. In such component, column Length must have value 0 assigned. Columns Origin and Format must be empty. In columns View and New counter, value false must be assigned. During the import of old files, attributes startPosition and endPosition must remain empty.

If the component gets deleted from the import file, it is necessary to change other number change attributes as well. It is recommended to list all other components in the import file and then specify the empty component for each deleted component.

If a component is changed, its index must be equal to the number of the row of the component which is to be changed. Component numbering starts with zero.