In dieser Dokumentation wird der Umgang mit der Anwendung „Daten importieren“ bezogen auf Artikel-Artikelmerkmal-Zuordnungen 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 Dokumentation: Daten importieren
1 Allgemeines
Der Import von Artikel-Artikelmerkmal-Zuordnungen 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 Artikel-Artikelmerkmal-Zuordnungen 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 „Artikel-Artikelmerkmal-Zuordnungen“ eine Beispiel-Zuordnung und exportieren Sie diesen 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.
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 Artikel-Artikelmerkmal-Zuordnungen 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 Artikel-Artikelmerkmal-Zuordnungen und die Besonderheiten für die Reihenfolge des Imports sind in folgenden Kapiteln beschrieben:
- Artikel-Artikelmerkmal-Zuordnungen importieren
- Reihenfolge des Imports
2.1 Artikel-Artikelmerkmal-Zuordnungen importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für dieses Business Object anzeigen: cisag.app.general.obj.ItemPropertyCollection
- Der Filter für den Import von Artikel-Artikelmerkmal-Zuordnungen wird geöffnet.
- Duplizieren oder erfassen Sie bei Bedarf einen neuen Filter für dieses Business Object.
- Ändern Sie bei Bedarf die bereits ausgewählten Attribute des Filters.
- Drücken Sie in der Standard-Symbolleiste den Button „Daten importieren“.
- Das Dialogfenster „Daten importieren“ wird geöffnet.
- Im Dialogfenster „Daten importieren“ können Sie Einstellungen für die Importdatei vornehmen. Eine Beschreibung der Felder finden Sie in dieser Dokumentation: Daten importieren
- 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
Wenn Sie Daten importieren möchten, die voneinander abhängig sind, dann müssen Sie eine bestimmte Reihenfolge einhalten. Für den Importvorgang von Artikel-Artikelmerkmal-Zuordnungen wird vorausgesetzt, dass vorher folgende Business Objects erfolgreich importiert wurden:
- Import aller Feldarten (cisag.app.general.extension.obj.Datatype), die in Artikel- oder Konfigurationsmerkmalen verwendet werden.
- Import der Artikelmerkmale (cisag.app.general.obj.ItemPropertyDefinition) mit den Merkmaltypen „Global“ und „Gruppe“, sofern Sie diese verwenden.
- Import der Artikelmerkmal-Klassifikation (cisag.app.general.obj.ItemPropertyHierarchy). Lokale Artikelmerkmale können Sie mit importieren.
- Import der Artikel-Artikelmerkmal-Zuordnungen (cisag.app.general.obj.ItemPropertyCollection).
Wenn Sie voneinander abhängige Daten importieren möchten, dann müssen Sie die referenzierten Daten immer zuerst importieren.
Der Import von Daten kann sofort oder im Hintergrund durchgeführt werden. Bei Verarbeitung im Hintergrund werden Prozesse vom System gestartet. Der Startzeitpunkt dieser Prozesse wird jedoch vom System bestimmt und kann vom Benutzer nicht beeinflusst werden. Bei Verarbeitung im Hintergrund kann also die Einhaltung der notwendigen Reihenfolge nicht garantiert werden.
Hinweis:
Beim Import von Daten wird die Verarbeitung „Im Hintergrund“ nur für voneinander unabhängige Daten empfohlen.
3 Notwendige Attribute für den Import
Erfassen Sie mindestens folgende Attribute pro Business Object „Artikelmerkmale“:
- Identifikationsattribute (Business Key)
- Pflichtfelder
Ohne die Identifikationsattribute kann das Business Object „Artikel-Artikelmerkmal-Zuordnungen“ nicht zugeordnet werden. Fehlt ein Pflichtfeld, dann wird in jedem Fall die Nachbearbeitung gestartet. Die Pflichtfelder und Identifikationsattribute der einzelnen Business Objects finden Sie in diesem Kapitel: Übersicht: Attribute
Zusätzlich bestehen Beziehungen zu anderen Business Objects, die nicht direkt zum Business Object „Artikel-Artikelmerkmal-Zuordnungen“ gehören (Beziehungen über Fremdschlüssel, erkennbar durch Kursivschrift im Filter). Um diese Beziehungen herstellen zu können, müssen die Identifikationsattribute dieser Business Objects im Filter ausgewählt werden.
4 Übersicht: Attribute
Nachfolgend sind die Attribute der einzelnen Business Objects aufgeführt, die für den Import zur Verfügung stehen. Bei Fremdschlüsselattributen steht zusätzlich der entsprechende Beziehungsname dabei. Die Attribute sind Änderungen unterworfen und können durch Anpassungen erweitert werden.
Die Identifikationsattribute (Key-Attribute) werden über ein (K) gekennzeichnet.
4.1 Artikel-Artikelmerkmal-Zuordnung (ItemPropertyCollection)
Die Identifikation einer Artikel-Artikelmerkmal-Zuordnung besteht aus dem Artikel.
| Attribut | Beziehung | Erläuterung |
| classification | Classification | Artikelmerkmal-Klassifikation
Hinweis: Bei Klassifikationsattributen importieren Sie den Pfad. |
| guid (K) | Technische Identifikation für die Änderung/ Löschung bereits gespeicherter Daten – sofern bekannt. |
|
| item (K) | Item | Artikel (fachliche Identifikation)
Optional bei Neuerzeugung – wird sonst automatisch ermittelt. Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
| Values | Unter der Beziehung werden im Filter für den Import alle im System vorhandenen Artikelmerkmale aufgelistet. Importiert werden können aber nur Werte für jene Artikelmerkmale, die der Klassifikation direkt oder indirekt (per übergeordnetem Knoten) zugeordnet sind. Beim Export werden auch nur diese Artikelmerkmale exportiert. |
Die weiteren Pflichtfelder sind abhängig von den verwendeten Merkmalen in der Artikelmerkmal-Klassifikation. Wenn ein als Pflichtfeld gekennzeichnetes Merkmal hinterlegt ist, dann muss dieses Merkmal zwingend in der Importdatei erfasst werden.
Beispiel:
| Attribut | Beziehung | Erläuterung |
| Values.MERKM1 | MERKM1 ist ein Merkmal, welches als Pflichtfeld erfasst wurde. |
4.2 Varianten-Artikel-Merkmalverwendungen (ItemPropertyCollectionVariantItemUsage, 1:n)
Nur für Referenz-Artikel können Sie eine oder mehrere Varianten-Artikel-Merkmalverwendungen importieren.
| Attribut | Beziehung | Erläuterung |
| definition | Definition | Artikelmerkmal |
| usage | Artikelmerkmalverwendung |