Import identifier where-used list

Topic overview

This article describes procedures for using the Import data application in relation to the identifier where-used list.

The description of the Import data application, which also includes field and button descriptions, can be found in the Import data article.

General information

The import of the identifier where-used list is essentially based on the current data model, which is stored in the repository database.

1:1 relationships are generally based on a technical GUID attribute in the data model. Depending on the use case, either the technical GUID attribute or the identification from the target object (usually code or number) can be used during import.

Note
If you are not sure which format is suitable for the import file, proceed as follows (the precondition for this procedure is that your system already contains identifier where-used list data):

Open the Export data application and export one or more data records with a filter that is similar to the filter for the import. The resulting sample file can be used as a template for the import file to be generated. As the filters differ in the number of attributes, you will need to incorporate the additional attributes that were not present in the export file into the import file if necessary.

The import of identifier where-used list data is also used to create an identifier where-used list for external production. From this point on, Comarch ERP Enterprise can no longer track identifier-managed items that were delivered to a supplier (external manufacturer) by delivery order and delivery slip. The supplier refines the product with these marked items. The production item contains these items. If an identifier where-used list is required for these products, you need to know which identifiers were used. It is therefore necessary to import this information from the supplier.

The attributes required for this and the corresponding validations are indicated for each attribute.

Procedures

  1. Open the Import data application
  2. Display the filter for the business object cisag.app.inventory.obj.IdentifierTracking
  • The filter for importing the identifier where-used list is displayed.
    (If required, you can also create a new filter for this business object)
  1. The attributes of the filter are already selected. You can still adjust the attributes if required.
  2. Select the [Import Data] button in the standard toolbar
  • The Import data dialog window opens
  1. You can make settings for the import file in this dialog window. A detailed description of the fields can be found in the Import data article in the chapter of the same name.
  2. You can carry out the import by selecting the [In background] or [Immediately] button

Attributes required for importing from older systems

The minimum attributes required for importing identifier where-used list data are:

  • Item: item
  • Identifier: identifier
  • Warehouse: storageArea
  • Posting key: transactionType
  • Date: date

A corresponding minimum XML file with attributes for importing an identifier where-used list looks as follows:

<?xml version="1.0" encoding="UTF-8"?>
<semiramis xmlns="com.cisag.app.inventory.obj.IdentifierTracking" xsi:schemaLocation="com.cisag.app.inventory.obj.IdentifierTracking IdentifierTracking.xsd" created="2006-01-06T08:23:06.767Z" locale="en-US-XMLSchemaCompliant" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <IdentifierTracking xmlns="com.cisag.app.inventory.obj.IdentifierTracking">
  <storageArea>
   <warehouse>100</warehouse>
  </storageArea>
  <date>2006-01-10T23:00:00.000Z</date>
  <quantity index="0">
   <amount>15.000000</amount>
   <Uom>pc</Uom>
  </quantity>
  <quantity index="1" xsi:nil="true"/>
  <quantity index="2" xsi:nil="true"/>
  <quantity index="3" xsi:nil="true"/>
  <_timeZone>CET</_timeZone>
  <CostCenter xsi:nil="true"/>
  <CostObjective xsi:nil="true"/>
  <Partner>0001</Partner>
  <TransactionType>02</TransactionType>
  <Identifier>
   <number>0001</number>
   <Item>CHARGE_01</Item>
  </identifier>
 </IdentifierTracking>
</semiramis>

Overview: Supported attributes during import

This section lists all the attributes supported when importing an identifier where-used list. The corresponding relationship name is also shown for foreign key attributes. The attributes can be subject to changes and can also be extended through adjustments.

The identification attributes (key attributes) are also marked with a (K).

Attribute Relationship Explanation
guid (K) Technical identification
item(K) Item (this relationship is included in the identifier relationship.) Item of the identifier where-used list to be imported. This attribute is a mandatory attribute.
identifier  (K) Identifier Identifier of the identifier where-used list to be imported. This attribute is a mandatory attribute. The identifier must match the specified item.
orderType Order type. An entry with a value other than 0 indicates that a voucher relationship has been specified. The following order types are supported:

  • Sales order
  • Production order
  • Inventory requisition
  • Purchase order
  • Distribution order
  • Delivery order

Note
The order type Delivery order indicates that the import contains identifier where-used list data that is imported for materials provided to vendor (external production). In this case, the specified delivery slip is replaced by the corresponding production order during import.
order (K) This attribute can be used to specify the order basis of the voucher relationship.
Note
By specifying a “delivery slip”, which indicates the import of identifier where-used list data for materials provided to vendor (external production), the specified delivery slip is replaced by the corresponding production order.
orderDetail (K) This attribute can be used to specify the position of the voucher relationship.
This information is ignored when specifying production orders.
orderTypeCode Identification of the order type of the voucher relationship to be imported. This attribute was added specifically for the data transfer from a V1R2M2 system to Comarch ERP Enterprise 4.2 system and is only taken into account in the course of an legacy data transfer.
This attribute is a mandatory attribute if a voucher relationship is to be imported.
orderTypeGuid GUID of the order type of the voucher relationship to be imported. This attribute was added specifically for the data transfer from a V1R2M2 system to Comarch ERP Enterprise 4.2 system and is only taken into account in the course of an legacy data transfer.
This attribute is a mandatory attribute if a voucher relationship is to be imported.
orderNumber This attribute can be used to specify the order basis of a voucher relationship in the same way as the order attribute.
When transferring legacy data with voucher relationships, this attribute and the order attribute must be specified.
orderDetailNumber This attribute can be used to specify the order line item of a voucher relationship in the same way as the orderDetail attribute.
When transferring legacy data with voucher relationships, this attribute and the orderDetail attribute must be specified.
This attribute is ignored for a relationship to a production order.
orderDetailSubNumber This attribute can be used to specify the detail line item number of a voucher relationship.
When transferring legacy data with voucher relationships, this attribute must be specified for vouchers that support detail line items.
storageArea  (K) This attribute can be used to specify the warehouse of the identifier where-used list to be imported. The warehouse must be specified, except when importing data records for materials provided to vendor (for external production). In this case, and only if no warehouse has been explicitly specified, the warehouse in the associated production order line item is used.
transactionType (K) TransactionType This attribute can be used to specify the posting key of the identifier where-used list to be imported. The posting key must be specified, except when importing data records for materials provided to vendor (external production). In this case, and only if no posting key has been explicitly specified, the issues posting key in the associated production order type is used.
Posting keys from the processes Receipt transfer posting and Issue transfer posting may not be used for the identifier where-used list.
date (K) This attribute can be used to specify the date of the identifier where-used list to be imported.
The specification of this attribute is mandatory.
Quantity This attribute is made up of the value amount and the unit uom of the quantity.
This attribute is used to determine the quantity of the identifier where-used list.
Partner Partner This attribute can be used to specify any partner that exists in the system.
costCenter CostCenter This attribute can be used to specify a cost center.
costObjective CostObjective This attribute can be used to specify a cost object.
noPlausibilityCheck This attribute signals the legacy data transfer, in which plausibility validations such as the existence of a specified order are not carried out.
financialsOrganization Partner This attribute can be used to specify the company of the identifier where-used list to be imported. If the company is not explicitly specified when importing data records for materials provided to vendor (for external production), it is determined using the associated production order.

Special features of legacy data transfer

When transferring legacy data, special handling is carried out for the transfer of voucher relationships, which makes it necessary to specify both the technical key and the number of the order or order line item when specifying a voucher relationship. This information is necessary so that voucher reorganization data can be generated if a voucher relationship does not exist in the destination system.

The noPlausibilityCheck attribute must be set to true for the legacy data transfer, as this is used to recognize the import for a legacy data transfer. The export for the V1R2M2 system has been extended so that this attribute is included in the export file with the value true. The attributes for specifying a voucher relationship are already set for exporting from a V1R2M2 system in accordance with the specifications for a legacy data transfer.

Note
Automatically selected attributes should not be deactivated for the legacy data transfer.

Validating the imported data

Identification attributes
All identification attributes, except for order and orderDetail, are validated to see whether they have been specified and whether they exist in the system.

Optional attributes
When specifying a non-identification attribute that represents a reference to a business object, the existence of the object is validated.

Posting key
When importing the identifier where-used list, no posting keys may be used that have the process Receipt transfer posting or Issue transfer posting.

Plausibility checks
If the noPlausibilityCheck attribute is set to false in the import file or is not imported, a plausibility check is carried out on the specified order. When importing identifier where-used list data for materials provided to vendor (external production), the system also checks whether a matching production order exists for the specified delivery slip and whether the production order has the status Released or Completed. The system also checks whether the specified item is in both the delivery slip line item and the associated production order line item.

Czy ten artykuł był pomocny?