1                     Themenübersicht

In dieser Dokumentation werden die Vorgehensweisen für den Umgang mit der Anwen­dung „Daten importieren“ bezogen auf Vertriebsaufträge 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 Dokumentation „Daten importieren“.

2                     Allgemeines

Der Import eines Vertriebsauftrages 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 im Kapitel „Übersicht: Attribute “.

Sowohl in der Basis als auch in der Position eines Vertriebsauftrages werden Hash-Code-Business-Objects referenziert. Das sind fachlich zusammengehörende Attributgruppen, die für viele Belege immer wieder gleich sind und deren Wiederverwendung einigen Speicherplatz in der Datenbank und im Hauptspeicher spart. Über eine spezielle Konvertierung stellen sich die Hash-Code-Business-Objects für den Export bzw. Import wie Parts dar.

Bestimmte Daten der Vertriebsaufträge wie Hauswährungswerte, Dispositionsmengen, Artikelkonfiguration und deren Konfigurationspositionen sowie 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 „Vertriebsaufträge“ einen Beispiel-Vertriebsauftrag 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.

3                     Vorgehensweise: Vertriebsaufträge importieren

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

• Der Filter für den Import von Vertriebsaufträgen 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 Importdatei vornehmen. Eine Beschreibung der Felder finden Sie in der Dokumentation „Daten importieren“.
7. Drücken Sie einen der Buttons „Im Hintergrund“ oder „Sofort“

• Der Import wird ausgeführt.

4                     Neue Vertriebsaufträge erzeugen

Die minimal notwendigen Attribute pro Basisobjekt:

Optional können Sie mithilfe des Imports auch die Nummer (number) übergeben. In diesem Fall wird die über den Nummernkreis gemäß Art ermittelte Nummer ignoriert. Zudem muss über geeignete Konventionen dafür gesorgt werden, dass die über den Import vergebene Nummer nicht mit einer bereits vergebenen oder zukünftig automatisch zu vergebenen übereinstimmt.

Die minimal notwendigen Attribute pro Positionsobjekt:

Optional können Sie mithilfe des Imports einer Position auch eine Nummer (number) mitgeben.

Ein entsprechendes Minimal-XML mit fachlichen Attributen und zwei Positionen hat z. B. den folgenden Inhalt:

<?xml version=”1.0″ encoding=”UTF-8″?>

<semiramis xmlns=”com.cisag.app.sales.obj.SalesOrder” xsi:schemaLocation=”com.cisag.app.sales.obj.SalesOrder SalesOrder.xsd” created=”2005-01-28T16:25:49.378Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>

<SalesOrder xmlns=”com.cisag.app.sales.obj.SalesOrder”>

<invoicingPartyData>

<Partner>00000</Partner>

</invoicingPartyData>

<Type>100</Type>

<customerData>

<CustomerPartner>10020</CustomerPartner>

</customerData>

<Details>

<Item>4711</Item>

<totalQuantity>

<amount>10</amount>

<Uom>St.</Uom>

</totalQuantity>

<priceOriginType>MANUAL</priceOriginType>

<grossPrice>

<amount>11</amount>

<Currency>EUR</Currency>

</grossPrice>

</Details>

<Details>

<Item>4712</Item>

<totalQuantity>

<amount>20</amount>

<Uom>St.</Uom>

</totalQuantity>

<priceOriginType>MANUAL</priceOriginType>

<grossPrice>

<amount>12</amount>

<Currency>EUR</Currency>

</grossPrice>

</Details>

</SalesOrder>

</semiramis>

Die restlichen Attribute werden in diesem Beispiel über die Vorschlagswerte gemäß Stammdaten etc. hinzugefügt.

Sie können darüber hinaus weitere Werte importieren und statt der fachlichen Attribute auch technische verwenden. Eine Auflistung der Attribute finden Sie im Kapitel „Übersicht: Attribute “.

Hinweis:

Eine vom Basiswert abweichende Währung beim Bruttopreis wird ignoriert.

Wird eine Position erzeugt, dann kann sie nicht mit demselben Import storniert werden (der Fall „canceled==true“ steht nicht zur Verfügung). Möchten Sie eine neue Position stornieren, dann müssen Sie zwei Importe durchführen. Im ersten erzeugen Sie die Position mit allen Daten (ohne das Attribut canceled) und im zweiten stornieren Sie die Position, indem Sie das Attribut canceled auf true setzen. Beachten Sie, dass im zweiten Import jede weitere Änderung an dieser Position ignoriert wird.

5                     Besonderheiten bei der Bearbeitung eines Auftrages

Bei der Bearbeitung eines bestehenden Auftrages müssen Sie Folgendes beachten: Beim Importieren von Vertriebsaufträgen in Multi-Site-Systemen und Single-Site-Systemen mit aktivierten inhaltsbezogenen Berechtigungen wird zwingend eine Vertriebsorganisation benötigt. Beim Bearbeiten eines bestehenden Auftrages ergibt sich die Vertriebsorganisation immer aus dem in der Datenbank gespeicherten Beleg. Eine evtl. abweichende Vertriebsorganisation in der Import-Quelle wird in diesem Fall ignoriert.

Für das Auffinden eines in der Datenbank gespeicherten Vertriebsauftrages wird entweder seine technische Identifikation (SalesOrder:guid) oder seine fachliche Identifikation (Type [oder type] und number) benötigt.

Bei den Positionen können sämtliche Möglichkeiten des Imports – also insbesondere auch das Löschen – verwendet werden. Auch dazu wird für das Auffinden einer gespeicherten Position entweder die technische Identifikation (SalesOrderDetail:guid) oder die fachliche Identifikation (number) benötigt.

Änderungen über den Import sind nur dann möglich, wenn keine Prüfung dies verhindert.

Für stornierte Positionen und für Positionen, die beim Importieren storniert werden (Attribut canceled wird auf true gesetzt), werden keine weiteren Daten aus der Importdatei übernommen.

Wird für eine Detailposition das Stornokennzeichen entfernt, dann wird auch für die dazugehörige Grundposition das Stornokennzeichen entfernt. Hierbei ist zu beachten, dass die Werte der Grundposition nicht aus der Importdatei übernommen werden. Sie können jedoch Daten für die Grundposition als zusätzlichen Block nach den Detailpositionen aufführen.

Mit folgender XML-Datei wird z. B. in der Detailposition 10-10 des Vertriebsauftrages 100-123456789 die Stornierung aufgehoben und gleichzeitig in der Grundposition das Feld „Bezug“ auf den Text „abc“ gesetzt:

<?xml version=”1.0″ encoding=”UTF-8″?><semiramis xmlns=”com.cisag.app.sales.obj.SalesOrder” xsi:schemaLocation=”com.cisag.app.sales.obj.SalesOrder SalesOrder.xsd” created=”2011-11-04T15:10:45.999Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” nlsMode=”SINGLE_LANGUAGE” dateTimeMode=”COMPACT”>

<SalesOrder xmlns=”com.cisag.app.sales.obj.SalesOrder”>

<number>123456789</number>

<Type>

<code>100</code>

</Type>

<Details>

<number>10</number>

<SubDetails>

<number>10</number>

<subNumber>10</subNumber>

<canceled>false</canceled>

</SubDetails>

</Details>

<Details>

<number>10</number>

<reference>abc</reference>

</Details>

</SalesOrder>

</semiramis>

Alternativ können Sie auch für die Grundposition die Stornierung aufheben, wodurch allerdings automatisch bei allen Detailpositionen dieser Position das Stornokennzeichen entfernt wird.

6                     Automatische Freigabe nach dem Import

Sofern der Import erfolgreich durchgeführt wurde, können Sie einen bearbeiteten Vertriebsauftrag 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 ein noch nicht vollständig importierter Vertriebsauftrag bereits in Folgebelegen verwendet werden kann. Während der Freigabe hat der Vertriebsauftrag den Status „Ungültig“, sodass der Vertriebsauftrag 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 der Vertriebsauftrag automatisch freigegeben wurde. War dies nicht möglich, dann wird eine Warnung ausgegeben.

7                     Tipps für die Altdatenübernahme

Für den Import von Altdaten haben wir folgende Tipps:

• Stellen Sie sicher, dass alle Stammdaten korrekt übernommen wurden. Damit vermeiden Sie eine unnötige Fehlerbearbeitung bei den Aufträgen.
• Stellen Sie – wenigstens temporär für die Datenübernahme – die Funktionen in der Anwendung „Customizing“ und den relevanten Arten so ein, dass eine möglichst hohe Importgeschwindigkeit erreicht wird. Deaktivieren Sie z. B. die Verfügbarkeitsabfrage, die Kreditlimitprüfung und Ähnliches. Das Schreiben der temporären Verfügbarkeitssätze ist beim Import automatisch deaktiviert – also selbst dann, wenn die Funktion in der Anwendung „Customizing“ aktiviert ist.
• Möchten Sie beim Import die Ermittlung neuer Preise und Rabatte vermeiden, dann schalten Sie die entsprechende Herkunft auf „Manuell“ und übernehmen Sie die Werte direkt aus dem Quell-System.
• Deaktivieren Sie die automatische Kontraktauswahl.
• Die gelieferte und fakturierte Menge können Sie mithilfe des Imports nicht beeinflussen. Deshalb ist sinnvoll, wenn Sie im Altsystem alle Lieferaufträge und Kommissionen abschließen und fakturieren. Falls noch Auftragsbestätigungen und Pro-forma-Rechnungen ausstehen, dann sollten Sie diese ebenfalls noch im Altsystem erstellen. Offene Liefermengen für noch nicht erledigte Aufträge können Sie dann als Gesamtmenge für die neuen Positionen des Ziel-Systems importieren. Lieferaufträge, Rechnungen usw. lassen Sie danach vom neuen System erzeugen.

8                     Ü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 Identifikations- und Pflichtfelder sind Änderungen unterworfen und können durch Anpassungen erweitert werden.

Bei einigen Business Objects ist für die Umwandlung fachlicher Schlüssel zu technischem Schlüssel eine Organisation notwendig. Bei den Attributlisten ist dies über die folgenden Anmerkungen in der Spalte „Attribut“ gekennzeichnet.

• Vertriebsorganisation (immer gemäß Basis)
• Firma (immer gemäß Basis)
• Land zur Firma (immer gemäß Basis)
• Lagerlogistikorganisation (gemäß Basis oder Position)

Die Identifikationsattribute (Key Attribute) werden über ein (K) gekennzeichnet.

8.1               Basisdaten

8.1.1          Vertriebsauftrag (SalesOrder)

8.1.2          Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData)

Die Kundendaten in den drei Verwendungen sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar. Das gleiche gilt für die Adressdaten. Analog zu den technischen Attributnamen wurden die folgenden Part-Namen vergeben:

• customerData           Auftraggeber
• deliveryCustomerData           Lieferempfänger
• invoiceCustomerData           Rechnungsempfänger

Die folgenden Attribute bestehen demnach pro Verwendung jeweils einmal.

8.1.3          Intrastat-Daten (intrastatData)

Die Intrastat-Daten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

8.1.4          Lieferdaten (deliveryData)

Die Lieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

8.1.5          Rechnungsdaten (invoicingData)

Einige Rechnungsdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

8.1.6          Auftragslieferdaten (orderDeliveryData)

Die Auftragslieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

8.1.7          Ausgabeeinstellungen (outputSettings)

Die Ausgabeeinstellungen sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

8.1.8    Vertriebspositions-Gruppen (DetailGroups)

Zulässige Werte für „type“

Im Attribut type müssen Sie den Namen einer Implementierung des folgenden Hook Contracts hinterlegen:

com.cisag.app.sales.detailgroup.hook.SalesDetailGroupDataType

Folgende Implementierungen sind bereits vorhanden:

8.1.9          Texte (TextAssignments)

text

Das folgende Beispiel enthält zwei Basistexte. Der Kopftext referenziert den Textbaustein „TXT1“, und der zweite Text enthält einen freien Fußtext für die Sprachen de und en:

<?xml version=”1.0″ encoding=”UTF-8″?>

<semiramis xmlns=”com.cisag.app.sales.obj.SalesOrder” xsi:schemaLocation=”com.cisag.app.sales.obj.SalesOrder SalesOrder.xsd” created=”2005-12-28T07:36:29.729Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>

<SalesOrder xmlns=”com.cisag.app.sales.obj.SalesOrder”>

<invoicingPartyData>

<Partner>00000</Partner>

</invoicingPartyData>

<Type>100</Type>

<customerData>

<CustomerPartner>10020</CustomerPartner>

</customerData>

<TextAssignments>

<code>TXT1</code>

<sequence>10</sequence>

<document index=”0″>ORDER_CONFIRMATION</document>

<document index=”1″>PICKING_SLIP</document>

<document index=”2″>DELIVERY_SLIP</document>

<document index=”3″>CUSTOMER_INVOICE</document>

<document index=”4″>PROFORMA_INVOICE</document>

<document index=”5″>SHIPPING_LOAD</document>

<document index=”6″>PRODUCTION_ORDER</document>

<type>HEADER</type>

</TextAssignments>

<TextAssignments>

<code></code>

<sequence>20</sequence>
<document index=”0″>ORDER_CONFIRMATION</document>

<document index=”1″>PICKING_SLIP</document>

<document index=”2″>DELIVERY_SLIP</document>

<document index=”3″>CUSTOMER_INVOICE</document>

<document index=”4″>PROFORMA_INVOICE</document>

<document index=”5″>SHIPPING_LOAD</document>

<document index=”6″>PRODUCTION_ORDER</document>

<type>FOOTER</type>

<text>

<language>de</language>

<text>Dies ist ein Beispieltext.</text>

<contentType>text/plain</contentType>

</text>

<text>

<language>en</language>

<text>This is an example text.</text>

<contentType>text/plain</contentType>

</text>

</TextAssignments>
</SalesOrder>
</semiramis>

Bei den Texten können Sie auch diverse Formatierungen verwenden. Benötigen Sie Beispiele für konkrete Formatierungen, dann erfassen Sie am besten einen Musterbeleg mit den gewünschten Textformatierungen und exportieren diesen.

Hinweis:

Normalerweise werden Texte aus der Importdatei importiert und evtl. Vorschlagswerte aus den Partner-Stammdaten usw. ignoriert. Hat die Server-Property com.cisag.app.general.order.bi.applyAllwaysTextDefaults den Wert true, dann werden in jedem Fall die Vorschlagswerte ermittelt und mit den ggf. in der Importdatei vorhandenen Texten kombiniert. Hierbei ist zum einen zu beachten, dass die Nummern der Textzeilen passend gewählt sein müssen und dass zum anderen im Ergebnis nur eine Text-Zeile mit einem Artikel-text entsteht.

8.2               Positionsdaten (Grundpositionen)

8.2.1          Vertriebsauftragspositionen (SalesOrderDetail)

8.2.2          Kundenlieferdaten (deliveryCustomerData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData)

8.2.3          Intrastat-Daten (intrastatData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Intrastat-Daten (intrastatData)

8.2.4          Lieferdaten (deliveryData)

Die Lieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

8.2.5          Auftragslieferdaten (orderDeliveryData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Auftragslieferdaten (orderDeliveryData)

8.3               Positionsdaten (Naturalrabatte)

8.3.1          Vertriebsauftragspositionen (SalesOrderDetail)

8.3.2          Kundenlieferdaten (deliveryCustomerData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData)

8.3.3          Intrastat-Daten (intrastatData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Intrastat-Daten (intrastatData)

8.3.4          Lieferdaten (deliveryData)

Die Lieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.

8.3.5          Auftragslieferdaten (orderDeliveryData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Auftragslieferdaten (orderDeliveryData)

8.4               Positionsdaten (Komponenten)

8.4.1          Vertriebsauftragspositionen (SalesOrderDetail)

8.4.2          Intrastat-Daten (intrastatData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Intrastat-Daten (intrastatData)

[1] Beachten Sie bitte, dass beim deliveryStatus-Attribut nur der Wert DeliveryStatus.COMPLETE verfügbar ist. Die Angabe dieses Wertes bewirkt eine manuelle Erledigung der Position. Ist dies nicht gewünscht, dann entfernen Sie das Attribut bei Bedarf aus dem Import-Filter.

[2] Beachten Sie bitte, dass beim deliveryStatus-Attribut nur der Wert DeliveryStatus.COMPLETE verfügbar ist. Die Angabe dieses Wertes bewirkt eine manuelle Erledigung der Position. Ist dies nicht gewünscht, dann entfernen Sie das Attribut bei Bedarf aus dem Import-Filter.

[3] Beachten Sie bitte, dass beim deliveryStatus-Attribut nur der Wert DeliveryStatus.COMPLETE verfügbar ist. Die Angabe dieses Wertes bewirkt eine manuelle Erledigung der Position. Ist dies nicht gewünscht, dann entfernen Sie das Attribut bei Bedarf aus dem Import-Filter.