1 Themenübersicht
In dieser Dokumentation wird die Vorgehensweise für den Umgang mit der Anwendung „Daten importieren“ bezogen auf Lieferauftrags-Rückmeldungen beschrieben.
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
Mithilfe von Lieferauftrags-Rückmeldungen können Sie Mengen, Gewichte und Volumen für bereits im System vorhandene externe Lieferaufträge (z. B. Streckengeschäft) importieren.
Das für den Import verwendete Datenmodell weicht vom Datenmodell des Lieferauftrags ab. Es besteht aus zwei Parts:
- Ein Part für die erforderlichen Attribute für die Rückmeldung von Mengen
- Ein Part für die erforderlichen Attribute für die Rückmeldung Gewicht und Volumen.
Die Rückmeldung von Mengen bzw. Gewicht und Volumen erfolgt in zwei Verarbeitungsschritten.
Mit einem Filter zum Part „DeliveryDetailTransaction“ kann man pro Lieferposition die vom Lieferpartner an den Lieferempfänger versendete Liefermenge in einen bereits bestehenden externen Lieferauftrag (z. B. für ein Streckengeschäft) importieren. Der zweite Part „DeliveryTransaction“ dient dazu das gelieferte Bruttogewicht, Nettogewicht, Bruttovolumen und Nettovolumen per Import in einem bereits bestehenden externen Lieferauftrag eines solchen Prozesses zu aktualisieren.
3 Vorgehensweise
3.1 Rückmeldung von Mengen importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für folgenden Part anzeigen: cisag.app.inventory.delivery.obj.DeliveryDetailTransaction
- Der Filter für den Import von Lieferauftrags-Rückmeldungen zu Mengen wird geöffnet.
- Duplizieren oder erfassen Sie bei Bedarf einen neuen Filter für diesen Part.
- Ä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 der Dokumentation „Daten importieren“.
- Drücken Sie einen der Buttons „Im Hintergrund“ oder „Sofort“.
- Der Import wird ausgeführt.
Ein Beispiel für den Import der Rückmeldungen von Mengen:
<?xml version=”1.0″ encoding=”UTF-8″?>
<semiramis xmlns=”com.cisag.app.inventory.delivery.obj.DeliveryDetailTransaction” xmlns:a=”com.cisag.app.inventory.delivery.obj.DeliveryDetailTransaction” xmlns:sem=”com.dvb.app.util.BISFunctionsLibrary” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” dateTimeMode=”COMPACT” nlsMode=”SINGLE_LANGUAGE” locale=”en-US-XMLSchemaCompliant” created=”2008-01-24T07:46:47.046Z” xsi:schemaLocation=”com.cisag.app.inventory.delivery.obj.DeliveryDetailTransaction DeliveryDetailTransaction.xsd”>
<DeliveryDetailTransaction>
<ShippingOrder>
<number>0000013330</number>
<Type>
<code>HEX</code>
</Type>
</ShippingOrder>
<Item>
<number>10020</number>
</Item>
<ShippingOrderDetail>
<number>10</number>
<subNumber>0</subNumber>
</ShippingOrderDetail>
<reportedQuantities index=”0″>
<amount>6</amount>
<Uom>
<code>Pal</code>
</Uom>
</reportedQuantities>
</DeliveryDetailTransaction>
</semiramis>
3.2 Rückmeldung von Gewicht und Volumen importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für folgenden Part anzeigen: cisag.app.inventory.delivery.obj.DeliveryTransaction
- Der Filter für den Import von Lieferauftrags-Rückmeldungen zu Gewicht und Volumen wird geöffnet.
- Duplizieren oder erfassen Sie bei Bedarf einen neuen Filter für diesen Part.
- Ä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 der Dokumentation „Daten importieren“.
- Drücken Sie einen der Buttons „Im Hintergrund“ oder „Sofort“.
- Der Import wird ausgeführt.
Ein Beispiel für den Import der Rückmeldungen von Gewicht und Volumen:
<?xml version=”1.0″ encoding=”UTF-8″?>
<semiramis xmlns=”com.cisag.app.inventory.delivery.obj.DeliveryTransaction” xmlns:a=”com.cisag.app.inventory.delivery.obj.DeliveryTransaction” xmlns:sem=”com.dvb.app.util.BISFunctionsLibrary” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” dateTimeMode=”COMPACT” nlsMode=”SINGLE_LANGUAGE” locale=”en-US-XMLSchemaCompliant” created=”2008-01-24T07:46:47.046Z” xsi:schemaLocation=”com.cisag.app.inventory.delivery.obj.DeliveryTransaction DeliveryTransaction.xsd”>
<DeliveryTransaction>
<ShippingOrder>
<number>0000013330</number>
<Type>
<code>HEX</code>
</Type>
</ShippingOrder>
<reportedNetWeight>
<amount>120</amount>
<Uom>
<code>kg</code>
</Uom>
</reportedNetWeight>
<reportedGrossWeight>
<amount>132</amount>
<Uom>
<code>kg</code>
</Uom>
</reportedGrossWeight>
<reportedNetVolume>
<amount>10</amount>
<Uom>
<code>m³</code>
</Uom>
</reportedNetVolume>
<reportedGrossVolume>
<amount>12</amount>
<Uom>
<code>m³</code>
</Uom>
</reportedGrossVolume>
</DeliveryTransaction>
</semiramis>
4 Lieferauftrag über die Import-Schnittstelle rückmelden
Die Rückmeldung bzw. das Ändern der Daten eines Lieferauftrags über die Import-Schnittstelle erfolgt immer positionsweise. Bei der Rückmeldung des Lieferauftrags müssen nur die Daten angegeben werden, die eine Zuordnung der Rückmeldung zu einer Lieferauftragsposition ermöglichen. Wenn Sie über den Import die Lieferauftragsdaten ändern möchten, dann müssen Sie die entsprechenden Attribute in der Import-Datei angeben.
Einige Attribute können über Fremdschlüssel-Beziehungen (erkennbar durch Kursivschrift im Filter) angegeben werden. Diese Attribute sind nicht Bestandteil der Lieferauftrags-Rückmeldung. Business Objects, die mit Fremdschlüssel-Beziehungen referenziert werden, werden durch deren Identifikationsattribute identifiziert. Sie können nicht über den Import für Lieferauftrags-Rückmeldungen importiert werden und müssen bereits im System vorhanden sein.
4.1 Import-Attribute für Rückmeldung von Mengen
Nachfolgend sind die für den Import notwendigen Attribute der einzelnen Business Objects aufgeführt. Bei Fremdschlüsselattributen steht zusätzlich der entsprechende Beziehungsname dabei. Die Identifikations- und Pflichtfelder sind Änderungen unterworfen und können durch Anpassungen erweitert werden.
Die Identifikationsattribute (Key-Attribute) werden über ein (K) gekennzeichnet.
Attribut | Beziehung | Erläuterung |
detail (K) | ShippingOrderDetail | Detailposition zum Lieferauftrag |
item | Item | Artikel, der rückgemeldet wird |
order (K) | ShippingOrder | Lieferauftrag |
reportedQuantities [0 – 3] · reportedQuantities.amount · reportedQuantities.uom |
Uom |
Mengen, die rückgemeldet werden
· Wert
· Einheit |
4.2 Import-Attribute für Rückmeldung von Gewicht und Volumen
Nachfolgend sind die für den Import notwendigen Attribute der einzelnen Business Objects aufgeführt. Bei Fremdschlüsselattributen steht zusätzlich der entsprechende Beziehungsname dabei. Die Identifikations- und Pflichtfelder sind Änderungen unterworfen und können durch Anpassungen erweitert werden.
Die Identifikationsattribute (Key-Attribute) werden über ein (K) gekennzeichnet.
Attribut | Beziehung | Erläuterung |
order (K) | ShippingOrder | Lieferauftrag |
reportedGrossVolume
· reportedGrossVolume.amount · reportedGrossVolume.uom |
Uom |
Rückgemeldetes Bruttovolumen
· Wert · Einheit |
reportedGrossWeight
· reportedGrossWeight.amount · reportedGrossWeight.uom |
Uom |
Rückgemeldetes Bruttogewicht
· Wert · Einheit |
reportedNetVolume
· reportedNetVolume.amount · reportedNetVolume.uom |
Uom |
Rückgemeldetes Nettovolumen
· Wert · Einheit |
reportedNetWeight
· reportedNetWeight.amount · reportedNetWeight.uom |
Uom |
Rückgemeldetes Nettogewicht
· Wert · Einheit |