In dieser Dokumentation wird der Umgang mit der Anwen­dung „Daten importieren“ bezogen auf Artikelmerkmal-Klassifikationen beschrieben. Sie finden allgemeine Anleitungsschritte und welche Besonderheiten zu berücksichtigen sind. Sie werden außerdem über Attribute informiert, die für den Import notwendig sind.

Die Beschreibung der Anwendung „Daten importieren“, die unter anderem auch Feld- und Button-Beschreibungen enthält, finden Sie in dieser Doku­men­tation: Daten importieren

1             Allgemeines

Der Import einer Artikelmerkmal-Klassifikation basiert im Wesentlichen auf dem aktuellen Datenmodell, welches in der Repository-Datenbank hinterlegt ist. Für den Datenexport stehen mehr Attribute als für den Datenimport zur Verfügung. Deshalb ist sinnvoll, für den Export und Import separate Filter festzulegen.

1:1-Beziehungen basieren im Datenmodell in der Regel auf einem technischen GUID-Attribut. Je nach Anwendungsfall kann beim Import entweder das technische GUID-Attribut verwendet werden oder der fachliche Schlüssel aus dem Ziel-Objekt (meist code oder number). Bei einigen Business Objects ist für die Umwandlung fachlicher Schlüssel zu technischem Schlüssel eine Organisation notwendig. Die jeweils relevante Organisation steht im Normalfall nicht direkt in der Import-Quelle, sondern ist über den Belegkontext vorgegeben. Weitere Informationen dazu finden Sie in diesem Kapitel: Übersicht: Attribute

Bestimmte Daten der Artikelmerkmal-Klassifikationen wie interne Hilfsattribute können nicht importiert werden.

Wenn Sie sich nicht sicher sind, welches das geeignete Format der Importdatei ist, dann gehen Sie wie folgt vor: Erfassen Sie über die Anwendung „Artikelmerkmal-Klassifikationen“ eine Beispiel-Klassifikation und exportieren Sie diese mit dem Filter für den Import im gewünschten Format mit den gewünschten Attributen. Die so entstehende Beispieldatei lässt sich als Vorlage für die zu erzeugenden Importdateien verwenden.

Hinweis:

Aufgrund der Strukturtiefe einer Klassifikation und in diesem Bezug potentiell vorkommender diverser 1:n-Beziehungen auf den jeweiligen Ebenen wird für den Export der Metadaten ein Export als CSV nicht empfohlen.

Beim Import gelten die gleichen Regeln wie bei der Bearbeitung über die Anwendung. Zum Beispiel kann in einer gespeicherten Position der Artikel nicht mehr nachträglich geändert werden. Attributwerte werden ignoriert, wenn sie im aktuellen Kontext nicht übernommen werden können. Ebenso wird bei der Vorschlagswertermittlung die gleiche Logik durchlaufen, sodass sich Import und Anwendung identisch verhalten. Gleiches gilt für die Prüfungen.

Hinweis:

Bestehende Artikelmerkmal-Klassifikationen können durch den Import zusätzlicher Daten erweitert werden. Die bestehenden Daten werden sofern möglich durch die Importdaten ersetzt.

2             Vorgehensweise

Die Vorgehensweise für den Import von Artikelmerkmal-Klassifikationen und die Besonderheiten für die Reihenfolge des Imports sind in folgenden Kapiteln beschrieben:

• Artikelmerkmal-Klassifikationen importieren
• Reihenfolge des Imports

2.1       Artikelmerkmal-Klassifikationen importieren

1. Öffnen Sie die Anwendung „Daten importieren“.
2. Lassen Sie sich den bzw. einen Filter für dieses Business Object anzeigen: cisag.app.general.obj.ItemPropertyHierarchy

• Der Filter für den Import von Artikelmerkmal-Klassifikationen wird geöffnet.

3. Duplizieren oder erfassen Sie bei Bedarf einen neuen Filter für dieses Business Object.
4. Ändern Sie bei Bedarf die bereits ausgewählten Attribute des Filters.
5. Drücken Sie in der Standard-Symbolleiste den Button „Daten importieren“.

• Das Dialogfenster „Daten importieren“ wird geöffnet.

6. Im Dialogfenster „Daten importieren“ können Sie Einstellungen für die Import­datei vornehmen. Eine Beschreibung der Felder finden Sie in dieser Dokumentation: Daten importieren
7. Drücken Sie einen der Buttons „Im Hintergrund“ oder „Sofort“.

• Der Import wird ausgeführt.

Hinweis:

Beim Import von Daten wird die Verarbeitung „Im Hintergrund“ nur für voneinander unabhängige Daten empfohlen.

2.2       Reihenfolge des Imports

Beachten Sie, dass in der Import-Datei vor einem Knoten der übergeordnete Knoten A enthalten oder dieser bereits in der Datenbank vorhanden ist.

Beispiel:

• zulässig:

path           description

A               …

A-1            …

• nicht zulässig:

path           description

A-1            …

A               …

Hinweis:

Verwenden Sie folgende OQL-Anweisung für den Export der Artikelmerkmal-Klassifikationen, um die richtige Reihenfolge sicherzustellen:

select distinct h:guid, h:path from com.cisag.app.general.obj.ItemPropertyHierarchy h order by h:path

Reihenfolge der abhängigen Business Objects

Für den Import der Daten ist unbedingt folgende Reihenfolge einzuhalten:

1. Import aller Feldarten (cisag.app.general.extension.obj.Datatype), die in Artikel- oder Konfigurationsmerkmalen verwendet werden.
2. Import der Artikelmerkmale (cisag.app.general.obj.ItemPropertyDefinition) mit den Merkmaltypen „Global“ und „Gruppe“, sofern Sie diese verwenden.
3. Import der Artikelmerkmal-Klassifikation (cisag.app.general.obj.ItemPropertyHierarchy). Lokale Artikelmerkmale können Sie mit importieren.

Nach dem erfolgreichen Import müssen Sie die Aktion „Tabellenschema erzeugen…“ in der Anwendung „Artikelmerkmal-Klassifikationen“ ausführen.

3             Notwendige Attribute für den Import

Erfassen Sie mindestens folgende Attribute pro Business Entity:

• Identifikationsattribute (Secondary Key)
• Pflichtfelder

Hinweis:

Für den Import müssen Sie das Attribut „path“ und nicht „code“ verwenden. Das Attribut „code“ wird automatisch aus dem Attribut „path“ bestimmt.

Ohne die Identifikationsattribute kann das Business Entity nicht zugeordnet werden. Fehlt ein Pflichtfeld, dann wird in jedem Fall die Nachbearbeitung gestartet. Die Pflichtfelder und Identifikationsattribute der Artikelmerkmal-Klassifikationen finden Sie in diesem Kapitel: Übersicht: Attribute

Beschrieben sind alle Identifikations- und Pflichtfelder, die für den Import der Metadaten der Artikelmerkmale und Konfigurationsmerkmale samt der Zuordnung zu den Klassifikationsknoten notwendig sind. Die eigentlichen Ausprägungen der Artikelmerkmale (Nutzdaten) müssen nach dem Import der Artikelmerkmal-Klassifikation importiert werden. Weitere Informationen dazu finden Sie in dieser Dokumentation: Artikel-Artikelmerkmal-Zuordnungen importieren

4             Übersicht: Attribute

Vor dem Import der Artikelmerkmal-Klassifikationen müssen alle Artikelmerkmale mit den Merkmaltypen „Global“ und „Gruppe“ erfolgreich importiert sein (siehe dieses Kapitel: Reihenfolge der abhängigen Business Objects).

Nachfolgend sind die Attribute der einzelnen Business Objects aufgeführt, die für den Import zur Verfügung stehen. Die Identifikationsattribute (Key-Attribute) werden über ein (K) gekennzeichnet.

4.1       Artikelmerkmal-Klassifikation (ItemPropertyHierarchy)

Die Identifikation einer Artikelmerkmal-Klassifikation besteht aus dem Pfad.

4.2       Lokale Artikelmerkmale (LocalItemProperty.ItemPropertyDefinition, 1:n)

Lokale Artikelmerkale können Sie zusammen mit der Artikelmerkmal-Klassifikation importieren.

4.3       Zuordnung von Entity Extensions (EntityExtensionAssignments, 1:n)