1                     Themenübersicht

In dieser Dokumentation wird die Vorgehensweise für den Umgang mit der Anwen­dung „Daten importieren“ bezogen auf Verteilanfragen beschrieben. Diese Vorgehensweisen ent­hal­ten allgemeine Anleitungsschritte und welche Besonderheiten zu berücksichtigen sind. Sie werden außerdem über mögliche Vorausset­zungen und Auswirkungen informiert.

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

2                     Allgemeines

Wenn Sie sich nicht sicher sind, welches das geeignete Format der Importdatei ist, dann gehen Sie wie folgt vor: Erfassen Sie über die Anwendung „Verteilanfragen“ eine Beispiel-Verteilanfrage 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:

Bestehende Verteilanfragen können durch den Import zusätzlicher Daten erweitert werden. Die bestehenden Daten werden durch die Importdaten ersetzt.

3                     Vorgehensweise: Verteilanfragen importieren

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

• Der Filter für den Import von Verteilanfragen wird angezeigt.

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 der Dokumen­tation „Daten importieren“.
7. Drücken Sie einen der Buttons „Im Hintergrund“ oder „Sofort“.

• Der Import wird ausgeführt.

4                     Automatische Freigabe nach dem Import

Sofern der Import erfolgreich durchgeführt wurde, können Sie eine bearbeitete Verteilanfrage automatisch nach dem Import freigeben lassen. Diese Möglichkeit ist insbesondere in Kombination mit dem Eröffnungsstatus „In Bearbeitung“ (siehe Art) sinnvoll. So verhindern Sie, dass eine noch nicht vollständig importierte Verteilanfrage bereits in Folgebelegen verwendet werden kann. Während der Freigabe hat die Verteilanfrage den Status „Ungültig“, sodass die Verteilanfrage auch in diesem Schritt nicht verwendet werden kann.

Für diese Funktionalität müssen Sie für die relevante Instanz das virtuelle Basis-Attribut autoRelease auf den Wert true setzen.

Ist diese Funktion aktiviert und bestehen keine sonstigen Fehler, dann wird im Meldungsprotokoll eine zusätzliche Informationsmeldung mit dem Hinweis ausgegeben, dass die Verteilanfrage automatisch freigegeben wurde. War dies nicht möglich, dann wird eine Warnung ausgegeben.

5                     Ü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.

Die folgenden Informationen erhalten Sie auch, indem Sie in der Anwendung „Verteilanfragen“ auf den Neu-Button und anschließend auf den Button „Prüfen“ drücken.

5.1               Verteilanfrage (DistributionRequest)

Die Identifikation einer Verteilanfrage besteht aus einer Verteilanfrageart und einer Nummer aus dem bei der Art hinterlegten Nummernkreis.

5.2               Kundendaten (invoiceCustomerData, DeliveryCustomerAssignments)

Die Kundendaten (Beschaffungsorganisation oder Lieferempfänger) sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part (Beschaffungsorganisation) oder als 1-N-Beziehung (Lieferempfänger) dar. Das gleiche gilt für die Adressdaten in den Kundendaten. Diese stellen sich in beiden Fällen als Part dar.

Die Daten zur Beschaffungsorganisation sind immer nur einmal vorhanden. Diese Daten werden normalerweise automatisch anhand des bevorzugten Lieferpartners/Lieferempfängers ermittelt, können aber bei Bedarf auch per Import festgelegt werden.

Die Kardinalität („1-1“ oder „1-N“) und die Verwendung der Lieferempfängerdaten beim Import ist abhängig von den Art-Einstellungen „Typ“, „Verteilrichtung“ und „Verteilrichtungsebene“:

1    Sie können den bevorzugten Kunden über das folgende Attribut festlegen:
PreferredDeliveryCustomerAssignment

Die folgenden Attribute bestehen also pro Partnerrolle und -verwendung.

5.3               Lieferantendaten (invoiceSupplierData, DeliverySupplierAssignments)

Die Lieferantendaten (Vertriebsorganisation oder Lieferpartner) sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part (Vertriebsorganisation) oder als 1-N-Beziehung (Lieferpartner) dar. Das gleiche gilt für die Adressdaten in den Lieferantendaten. Diese stellen sich in beiden Fällen als Part dar.

Die Daten zur Vertriebsorganisation sind immer nur einmal vorhanden. Diese Daten werden normalerweise automatisch anhand des bevorzugten Lieferpartners/Lieferempfängers ermittelt, können aber bei Bedarf auch per Import festgelegt werden.

Die Kardinalität („1-1“ oder „1-N“) und die Verwendung der Lieferpartnerdaten beim Import ist abhängig von den Art-Einstellungen „Typ“, „Verteilrichtung“ und „Verteilrichtungsebene“:

1    Sie können den bevorzugten Lieferanten über das folgende Attribut festlegen:
PreferredDeliverySupplierAssignment

Die folgenden Attribute bestehen also pro Rolle und Verwendung.

5.4               Lagerortdaten (SourceStorageAreaAssignments, TargetStorageAreaAssignments)

Die Kardinalität („1-1“ oder „1-N“) und die Verwendung der Lagerortdaten (Quelle oder Ziel) beim Import ist abhängig von den Art-Einstellungen „Typ“, „Verteilrichtung“ und „Verteilrichtungsebene“.

SourceStorageAreaAssignments (Quelle):

1    Sie können den bevorzugten Lagerort über das folgende Attribut festlegen:
PreferredSourceStorageAreaAssignment

TargetStorageAreaAssignments (Ziel):

1    Sie können den bevorzugten Lagerort über das folgende Attribut festlegen:
PreferredTargetStorageAreaAssignment

Das folgende Attribut besteht also pro Rolle und Verwendung.

5.5               Texte (TextAssignments)

text

5.6               Verteilanfrageposition (DistributionRequestDetail)