In dieser Dokumentation wird die Vorgehensweise für den Umgang mit der Anwen­dung „Daten importieren“ bezogen auf Bestellbestätigungen 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“.

1                     Allgemeines

Der Import einer Bestellbestätigung 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. Des-halb 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 (organization) 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 einer Bestellbestätigung 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 Bestellbestätigungen wie Hauswährungswerte 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 „Bestellbestätigungen“ eine Beispiel-Bestellbestätigung 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.

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, die im aktuellen Kontext nicht übernommen werden können, werden ignoriert. 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 Bestellbestätigungen können durch den Import zusätzlicher Daten erweitert werden. Die bestehenden Daten werden sofern möglich durch die Importdaten ersetzt.

2                     Vorgehensweise: Bestellbestätigungen importieren

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

• Der Filter für den Import von Bestellbestätigungen 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.
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.

3                     Neue Bestellbestätigungen erzeugen

Die minimal notwendigen Attribute pro Basisobjekt:

Optional können Sie bei der Erzeugung über den Import 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.

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.purchasing.obj.SupplierConfirmation” xsi:schemaLocation=”com.cisag.app.purchasing.obj.SupplierConfirmation SupplierConfirmation.xsd” created=”2007-12-10T12:00:52.090Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” nlsMode=”SINGLE_LANGUAGE” dateTimeMode=”COMPACT”>

<SupplierConfirmation xmlns=”com.cisag.app.purchasing.obj.SupplierConfirmation”>

<supplierConfirmationData>

<salesConfirmation>1234567</salesConfirmation>

<date>

<value>10#12#2007</value>

</date>

</supplierConfirmationData>

<Type>

<code>100</code>

</Type>

<Correspondence>

<number>POC1375</number>

</Correspondence>

</SupplierConfirmation>

</semiramis>

Die restlichen Basis-Attribute werden in diesem Beispiel über die Vorschlagswerte gemäß Basis der Bestellung hinzugefügt.

Für die Steuerung der Vorschlagswerte für Positionen beachten Sie insbesondere die Funktionen und Einstellungen, die Sie beim Erzeugen einer Bestellbestätigung im Dialogfenster „Aus Bestellung erzeugen“ treffen. Folgende Attribute sind relevant:

• Vorschlagswerte für Mengen (quantityDefaults)

Vorschlag: true

• Liefertermin Positionen (detailDeliveryDateOrigin)

Vorschlag: LAST_CONFIRMATION

Beim Wert „Angegebenes Datum verwenden“ (SPECIFIED) muss zusätzlich das Attribut „Liefertermin“ (specifiedDeliveryDate) befüllt sein

Sie können darüber hinaus weitere Basiswerte importieren und statt der fachlichen Attribute auch technische verwenden. Eine Auflistung der Attribute finden Sie in diesem Kapitel: Übersicht: Attribute, Basisdaten

4                     Positionsauswahl

Wie mit der Aktion „Aus Bestellung erzeugen“ in der Anwendung „Bestellbestätigungen“ können Sie auch beim Import den „Bestätigungsstatus“ festlegen, der als Auswahlmerkmal für die Positionsauswahl dient.

Die Festlegung beim Import erfolgt über eine mit Komma getrennte Aufzählung der technischen Identifikationen der zu verwendenden Bestätigungsstatus, die mit dem Attribut confirmationStatusSelection zur Verfügung stehen. Folgende Werte sind zulässig:

Das Attribut confirmationStatusSelection schlägt folgenden Wert vor:

„1, 13“ („Nicht bestätigt“ und „Bestätigte Konditionen geändert“)

Sofern diese Funktion in der Basis festgelegt wurde, wird sie in das entsprechende Basis-Attribut übernommen.

Standardmäßig hat die festgelegte Auswahl beim Import zunächst keinen weiteren Effekt. Neben der Basis werden nur jene Positionen bearbeitet, die direkt in der Import-Quelle enthalten sind. Nur wenn Sie das virtuelle Basis-Attribut takeSelectedDetails auf den Wert true setzen, dann verhält sich der Import so, dass vor der eigentlichen Positionsbearbeitung alle Positionen gemäß der Auswahl gemäß dem Attribut confirmationStatusSelection übernommen werden.

Das folgende Beispiel übernimmt z. B. vor der eigentlichen Positionsbearbeitung alle Positionen, bei denen der Bestätigungsstatus der Bestellgrundposition einen der Werte „Bestätigt“, „Storno bestätigt“, „Änderungsvorschlag erhalten“, „Abgelehnt“ oder „Storno abgelehnt“ hat:

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

<semiramis xmlns=”com.cisag.app.purchasing.obj.SupplierConfirmation” xsi:schemaLocation=”com.cisag.app.purchasing.obj.SupplierConfirmation SupplierConfirmation.xsd” created=”2007-12-10T12:00:52.090Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” nlsMode=”SINGLE_LANGUAGE” dateTimeMode=”COMPACT”>

<SupplierConfirmation xmlns=”com.cisag.app.purchasing.obj.SupplierConfirmation”>

<supplierConfirmationData>

<salesConfirmation>1234567</salesConfirmation>

<date>

<value>10#12#2007</value>

</date>

</supplierConfirmationData>

<takeSelectedDetails>true</takeSelectedDetails>        <confirmationStatusSelection>5, 6, 9, 12, 14 </confirmationStatusSelection>

<Type>

<code>100</code>

</Type>

<Correspondence>

<number>POC1375</number>

</Correspondence>

</SupplierConfirmation>

</semiramis>

5                     Abweichende Positionsdaten

Für die Bestätigungspositionen können Sie, wie in der Anwendung „Bestellbestätigungen“, über den Import gegenüber der Bestellposition abweichende Daten angeben. Im einfachsten Fall ändern sich nur einzelne Werte. Sie können eine vorhandene Bestellposition bzw. eine vorhandene Bestätigungsposition auch aufteilen.

Standardmäßig wird bei einer Aufteilung immer die Bestellgrundposition mit allen dazugehörigen Detailpositionen als Quelle verwendet. Über das virtuelle Positions-Attribut creationSourceSequence können Sie auch eine vorhandene Bestätigungsgrundposition mit allen dazugehörigen Detailpositionen als Quelle verwenden:

• creationSourceSequence<0 (Vorschlag):

Die Bestellgrundposition wird als Quelle für die Aufteilung verwendet.

• creationSourceSequence>=0:

Die Bestätigungsgrundposition mit der angegebenen sequence wird als Quelle für die Aufteilung verwendet.

Hinweis:

Die angegebene Bestätigungsgrundposition muss vorher über die Positionsauswahl oder über die bereits bearbeiteten Positionen in der aktuellen Bestätigung vorhanden sein.

Möchten Sie eine Position aufteilen, dann müssen Sie entweder für die neue Position das virtuelle Positions-Attribut creationSourceSequence festlegen (für sequence wird dann der Vorschlag verwendet) oder Sie legen das Attribut sequence mit einem positiven Wert fest. Die Angabe des sequence-Wertes hat den Vorteil, dass bei späteren Änderungen solch eine Aufteilungsposition einfach wieder gefunden werden kann.

Im folgenden Beispiel wird die Lieferung der gemäß Bestellung nicht stornierten Position 10 vom Lieferanten abgelehnt (storniert) und die ursprüngliche Position 20 mit der Menge 20 St. zum Termin 02.01.2008 wird als Änderungsvorschlag auf zwei Positionen mit den Mengen 7 St. zum 03.01.2008 (sequence: 0 – nicht änderbar für ursprüngliche Position) und 13 St. zum 04.01.2008 (sequence: 1) aufgeteilt:

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

<semiramis xmlns=”com.cisag.app.purchasing.obj.SupplierConfirmation” xsi:schemaLocation=”com.cisag.app.purchasing.obj.SupplierConfirmation SupplierConfirmation.xsd” created=”2007-12-10T15:19:19.577Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” nlsMode=”SINGLE_LANGUAGE” dateTimeMode=”COMPACT”>

<SupplierConfirmation xmlns=”com.cisag.app.purchasing.obj.SupplierConfirmation”>

<supplierConfirmationData>

<salesConfirmation>1234567</salesConfirmation>

<date>

<value>10#12#2007</value>

</date>

</supplierConfirmationData>

<Type>

<code>100</code>

</Type>

<Correspondence>

<number>POC1376</number>

</Correspondence>

<Details>

<canceled>true</canceled>

<CorrespondenceDetail>

<number>10</number>

</CorrespondenceDetail>

</Details>

<Details>

<deliveryDate>2008-01-02T23:00:00.000Z</deliveryDate>

<totalQuantity>

<amount>7</amount>

<Uom>

<code>St.</code>

</Uom>

</totalQuantity>

<CorrespondenceDetail>

<number>20</number>

</CorrespondenceDetail>

</Details>

<Details>

<deliveryDate>2008-01-03T23:00:00.000Z</deliveryDate>

<sequence>1</sequence>

<totalQuantity>

<amount>13</amount>

<Uom>

<code>St.</code>

</Uom>

</totalQuantity>

<CorrespondenceDetail>

<number>20</number>

</CorrespondenceDetail>

</Details>

</SupplierConfirmation>

</semiramis>

6                     Bearbeitung offener Bestätigungen

Zu einem Beschaffungsauftrag darf zur gleichen Zeit nur eine Bestellbestätigung in Bearbeitung sein. Beim Versuch eine zweite Bestellbestätigung zum gleichen Beschaffungsauftrag zu erzeugen, wird beim Import eine Fehlermeldung erzeugt, so wie in der Anwendung „Bestellbestätigungen“.

Sie können eine vorhandene offene Bestellbestätigung weiter bearbeiten, wenn Sie in der Import-Quelle die Art (Type oder type) und Nummer (number) referenzieren, wobei number die relevante Bestätigungsnummer ist, die bei der Erzeugung gemäß Nummernkreis vergeben wurde.

Zur Vereinfachung kann eine offene Bestellbestätigung auch ohne explizite Angabe der number unter den folgenden Bedingungen weiter bearbeitet werden:

• Der Modus CREATE wurde nicht explizit angegeben.
• Die Import-Quelle enthält eine Referenz auf die relevante Bestellbasis.
• Die Import-Quelle enthält keine Bestätigungsnummer.
• Die Bestellung der offenen Bestätigung entspricht der in der Import-Quelle angegebenen Bestellung.
• Die Fremdbelegnummer der offenen Bestätigung entspricht der Fremdbelegnummer gemäß Import-Quelle.
• Die offene Bestellbestätigung hat den Allgemeinen Status „In Bearbeitung“.

7                     Automatische Erledigung nach dem Import

Sofern der Import erfolgreich durchgeführt wurde und weder gegenüber der dazugehörigen Bestellung bzw. Bestelländerung noch gegenüber dem aktuellen Auftrag relevante Änderungen bestehen, dann können Sie eine bearbeitete Bestellbestätigung automatisch nach dem Import erledigen lassen. Hierzu müssen Sie für die relevante Instanz das virtuelle Basis-Attribut autoCompletion auf den Wert true setzen.

Ist diese Funktion aktiviert und werden keine sonstigen Fehler festgestellt, dann wird im Meldungsprotokoll eine zusätzliche Informationsmeldung ausgegeben, welche die Information enthält, ob die Bestellbestätigung automatisch erledigt wurde oder ob dies wegen Abweichungen nicht möglich war.

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 er-weitert werden.

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

• Beschaffungsorganisation (immer gemäß Bestellung)
• Firma (immer gemäß Bestellung)
• Land zur Firma (immer gemäß Bestellung)

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

8.1               Basisdaten

8.1.1          Bestellbestätigung (SupplierConfirmation)

Die Identifikation einer Bestellbestätigung besteht aus einer Beschaffungs-Auftragsart und einer Nummer aus dem bei der Beschaffungs-Auftragsart hinterlegten Nummernkreis.

8.1.2          Lieferantendaten (deliverySupplierData, invoiceSupplierData)

Die Lieferantendaten in den beiden Partnerrollen 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:

• deliverySupplierData Lieferpartner
• invoiceSupplierData Rechnungssteller

Die folgenden Attribute bestehen also pro Rolle jeweils einmal.

8.1.3          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.4          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.5          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.6          Informationstexte (InfoTexts)

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.purchasing.obj.SupplierConfirmation” xsi:schemaLocation=”com.cisag.app.purchasing.obj.SupplierConfirmation SupplierConfirmation.xsd” created=”2008-08-08T13:53:43.905Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” nlsMode=”SINGLE_LANGUAGE” dateTimeMode=”COMPACT”>

<SupplierConfirmation xmlns=”com.cisag.app.purchasing.obj.SupplierConfirmation”>

<supplierConfirmationData>

<salesConfirmation>1234567</salesConfirmation>

<date>

<value>10#12#2007</value>

</date>

</supplierConfirmationData>

<Type>

<code>100</code>

</Type>

<Correspondence>

<number>POC1376</number>

</Correspondence>

<InfoTexts>

<language>de</language>

<text>&lt;html&gt;Infotext der Basis&lt;/html&gt;</text>

<contentType>text/html</contentType>

</InfoTexts>

</SupplierConfirmation>

</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.

8.2               Positionsdaten (Grundpositionen)

8.2.1          Bestellbestätigungspositionen (SupplierConfirmationDetail)

8.2.2          Lieferantendaten (deliverySupplierData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Lieferantendaten (deliverySupplierData, invoiceSupplierData)

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 Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Lieferdaten (deliveryData)

8.2.5          Informationstexte (InfoTexts)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Informationstexte (InfoTexts)

8.3               Positionsdaten (Naturalrabatte)

8.3.1          Bestellbestätigungspositionen (SupplierConfirmationDetail)

8.3.2          Lieferantendaten (deliverySupplierData)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Lieferantendaten (deliverySupplierData, invoiceSupplierData)

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 Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Lieferdaten (deliveryData)

8.3.5          Informationstexte (InfoTexts)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Informationstexte (InfoTexts)

8.4               Positionsdaten (Komponenten)

8.4.1          Bestellbestätigungspositionen (SupplierConfirmationDetail)

8.4.2          Intrastat-Daten (intrastatData)

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

8.4.3          Informationstexte (InfoTexts)

Die Attribute entsprechen denen in der Basis. Siehe dieses Kapitel: Informationstexte (InfoTexts)