In dieser Dokumentation werden die Vorgehensweisen für den Umgang mit der Anwen­dung „Daten importieren“ bezogen auf Länderdaten beschrieben. Diese Vorgehensweise ent­hält allgemeine Anleitungsschritte und Sie werden außerdem über mögliche Vorausset­zungen und Auswirkungen informiert.

Die Beschreibung der Anwendung „Daten importieren“, die unter ande­rem auch Feld- und Button-Beschreibungen enthält, finden Sie in der Dokumentation Daten importieren.

1                  Allgemeines

Lesen Sie nachfolgend allgemeine Informationen zu Länderdaten. Sie erfahren, wie die zu importierenden Datenobjekte zusammengesetzt sind.

Länderdaten bestehen aus:

• Basisdaten
• Regionsdaten

Die Regionsdaten sind Teil der Länderdaten und können nicht separat, sondern nur mit Zuordnung zu einem eindeutig identifizierten Land importiert werden.

2                  Vorgehensweisen

Lesen Sie nachfolgend die Vorgehensweisen beim Import von Länderdaten:

• Daten importieren
• Notwendige Attribute für den Import
• Import von neuen Länderdaten
• Import von Regionsdaten in vorhandene Länderdaten

2.1             Daten importieren

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

• Der Filter für den Import der Daten wird angezeigt.

3. Die ausgewählten Attribute des Filters sind bereits markiert. Bei Bedarf können Sie die Attribute noch anpassen.
4. Drücken Sie in der Standard-Symbolleiste „Daten importieren“.

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

5. In diesem Dialogfenster können Sie Einstellungen für die Importdatei vornehmen. Eine ausführliche Beschreibung der Felder finden Sie in der Dokumentation Daten importieren im gleichnamigen Abschnitt.
6. Durch Drücken des Buttons „Im Hintergrund“ oder „Sofort“ können Sie den Import durchführen.

Hinweis:
Beim Import von Daten ist die Option „Verarbeitung im Hintergrund“ nur für voneinander unabhängige Daten empfohlen.

2.2             Notwendige Attribute für den Import

Geben Sie mindestens folgende Attribute pro Business Entity an:

• Identifikationsattribute (Business Key)
• Pflichtfelder

Ohne die Identifikationsattribute kann das Business Entity nicht zugeordnet werden, und fehlt ein Pflichtfeld, wird in jedem Fall die Nachbearbeitung gestartet. Die Pflichtfelder und Identifikationsattribute der einzelnen Business Objects werden im Abschnitt Übersicht: Identifikations- und Pflichtfelder zusammengestellt.

Zusätzlich gibt es noch Beziehungen zu anderen Business Objects, die nicht direkt zum Business Entity „com.cisag.app.general.obj.Country“ gehören (Beziehungen über Fremdschlüssel, erkennbar durch Kursivschrift im Filter). Um diese Beziehungen auflösen zu können, müssen die Identifikationsattribute dieser Business Objects im Filter ausgewählt werden. Über Fremdschlüssel referenzierte Daten können nicht gemeinsam importiert werden. Sie müssen bereits im System vorhanden sein. Werden über die Fremdschlüssel-Beziehung andere Attribute angegeben als deren Identifikationsattribute, so werden diese ignoriert.

Wenn der Primärschlüssel eines Business Objects ganz oder teilweise aus Fremdschlüsseln besteht, dann muss in der Importdatei das Business Object, auf das sich dieser Fremdschlüssel bezieht, über seine Identifikationsattribute aufgelöst werden.

Zum Beispiel enthält ein Land das Attribut „currency“. Dieses Attribut bezieht sich auf die Währung des Landes, die wiederum durch eine Identifikation (String) spezifiziert wird.

2.3             Import von neuen Länderdaten

In der Importdatei müssen alle Identifikations- und Pflichtattribute der Basisdaten angegeben werden. Regionsdaten können sowohl in der gleichen, als auch in einer separaten Importdatei angeben werden. Lesen Sie die Dokumentation zur Anwendung „Daten importieren“, um zu erfahren, wie separate Importdateien verknüpft werden.

Beispiel für das Importieren von neuen Länderdaten mit einer Importdatei:

2.4             Import von Regionsdaten in vorhandene Länderdaten

Voraussetzung für diesen Weg des Imports von Länderdaten ist, dass die Basisdaten bereits erfolgreich importiert wurden. In der Importdatei muss lediglich das Identifikationsattribut (isoCode) der Basisdaten angegeben werden. Sollten andere Attribute der Basisdaten angegeben werden, werden die vorhandenen Daten überschrieben.

Sollte eine zu importierende Region bereits existieren, so werden die Daten überschrieben.

Sie sollten diese Importmöglichkeit nur zum Aktualisieren eines Landes anwenden. Der getrennte Import von Land- und Regionsdaten führt zu Performance-Einbußen.

Beispiel einer Importdatei für das Aktualisieren von Regionsdaten:

2.5             Übersicht: Identifikations- und Pflichtfelder

In diesem Kapitel werden die Identifikations- und Pflichtattribute zusammengestellt.

2.5.1         Basisdaten

2.5.2         Regionsdaten