Antje (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung Markierung: [[MediaWiki:Visualeditor-descriptionpagelink|Visuelle Bearbeitung]] |
Antje (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung Markierung: [[MediaWiki:Visualeditor-descriptionpagelink|Visuelle Bearbeitung]] |
||
(6 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 2: | Zeile 2: | ||
<bs:bookshelf src="Buch:Cs HUB" /> | <bs:bookshelf src="Buch:Cs HUB" /> | ||
In dieser Übersicht finden Sie detaillierte Informationen zu den von '''FMS''' gelieferten Daten und wie diese von '''cs JOB''' übernommen und verarbeitet werden. Zudem zeigen wir Ihnen auf, welche Daten Sie an '''FMS''' zurückmelden können. | '''<span class="col-red">IN BEARBEITUNG</span>'''<br /><br />In dieser Übersicht finden Sie detaillierte Informationen zu den von '''FMS''' gelieferten Daten und wie diese von '''cs JOB''' übernommen und verarbeitet werden. Zudem zeigen wir Ihnen auf, welche Daten Sie an '''FMS''' zurückmelden können. | ||
{{Hinweisbox|boxtype=Erfolg|icon=ja|header=|Note text=Die Schnittstelle ist durch ein ausgeklügeltes System in der Lage, sogar unstrukturierte Daten, sowie logistisch relevante Informationen in Freitextfeldern sinnvoll zu interpretieren und automatisiert in '''cs JOB''' zu verarbeiten. | {{Hinweisbox|boxtype=Erfolg|icon=ja|header=|Note text=Die Schnittstelle ist durch ein ausgeklügeltes System in der Lage, sogar unstrukturierte Daten, sowie logistisch relevante Informationen in Freitextfeldern sinnvoll zu interpretieren und automatisiert in '''cs JOB''' zu verarbeiten. | ||
Zeile 31: | Zeile 32: | ||
|[[Datei:csHUB:Lieferumfang FMS Revision 04 22 V1.pdf|alternativtext=|ohne|mini|212x212px]] | |[[Datei:csHUB:Lieferumfang FMS Revision 04 22 V1.pdf|alternativtext=|ohne|mini|212x212px]] | ||
|} | |} | ||
<br />{{TOClimit|limit=2}} | |||
{{TOClimit|limit=2}} | |||
==Interpretationen== | ==Interpretationen== | ||
Zeile 86: | Zeile 86: | ||
In '''cs JOB''' sieht es demnach so aus:<br /><br /> | In '''cs JOB''' sieht es demnach so aus:<br /><br /> | ||
[[Datei:csHUB: | [[Datei:csHUB:FMS_1719235618408.png]] | ||
== Generelles== | == Generelles== | ||
Zeile 103: | Zeile 103: | ||
Die erstellten Aufträge sind dabei identisch, lediglich die Inhalte innerhalb von <TransportContainer> können abweichend sein. | Die erstellten Aufträge sind dabei identisch, lediglich die Inhalte innerhalb von <TransportContainer> können abweichend sein. | ||
=== Erstellung einer Externen Wegpunkt ID === | |||
Die '''Externe Wegpunkt ID''' ist im Bereich '''cs HUB / Order''' zu einem Pflichtfeld geworden. Diese ID wird benötigt um die Wegpunkte in einem Auftrag oder der Fahrt, bei einem Update, gezielt zu aktualisieren. | |||
In dieser Schnittstelle wird die '''Externe Wegpunkt ID''' nicht mit übermittelt. Somit wird eine Erstellung der '''Externen Wegpunkt ID''' durch eine Programmierung seitens '''cargo support''' übernommen. Dabei wird aus dem Feld <nowiki><Code codelist="UNIQUE"> ein Hashwert gebildet.</nowiki> | |||
=== Supplement Key "Warstein" === | |||
Steht in der Übertragungsdatei eine Zeile mit dem Supplement key Warstein, die so aussieht wie im folgenden Bild, dann wird in das Feld '''Auftragsvariante Importtext''' in '''cs JOB''' das Wort "Warstein" geschrieben.<br /><br /> | |||
[[Datei:csHUB:FMS 1719576872454.png]]<br /><br />Das sieht in '''cs JOB''' dann wie folgt aus:<br /><br />[[Datei:csHUB:FMS 1719577319979.png]] | |||
==Änderungshistorie== | ==Änderungshistorie== | ||
Die Änderungshistorie bezieht sich auf den Lieferumfang und beschreibt die Änderungen der Spezifikation der jeweiligen Schnittstelle. Bitte informieren Sie sich regelmäßig über die jeweiligen Änderungen. Der Spalte | Die Änderungshistorie bezieht sich auf den Lieferumfang und beschreibt die Änderungen der Spezifikation der jeweiligen Schnittstelle. Bitte informieren Sie sich regelmäßig über die jeweiligen Änderungen. Der Spalte '''Inhalt''' können sie entnehmen, ob es sich um eine Änderung, eine neu aufgenommene oder um eine Löschung einer Spezifikation handelt. Für Rückfragen können Sie sich auch gerne an unseren Support wenden. | ||
Zeile 119: | Zeile 128: | ||
|9.36.1.323 | |9.36.1.323 | ||
|Supplement key "Auftragsvariante" | |Supplement key "Auftragsvariante" | ||
| | |Bei Übermittlung eines entsprechenden Supplement keys wird der Text "Warstein" in das Feld Auftragsvariante Importtext / OrderVariantImportText geschrieben. | ||
|255873 | |255873 | ||
|- | |- | ||
Zeile 125: | Zeile 134: | ||
|9.36.1.322 | |9.36.1.322 | ||
|Storno | |Storno | ||
|Bei Storno werden alle Container, die zu einem Auftrag gehören, storniert. | |Bei Storno werden alle Container, die zu einem Auftrag gehören, storniert. | ||
|255024 | |255024 | ||
|- | |- | ||
|06 24 V1 | |06 24 V1 | ||
|9.34.2.171 | |9.34.2.171 | ||
|Kundenmatchcode / Importtext unvollständig | |Kundenmatchcode / Importtext unvollständig | ||
|Im Feld | |Im Feld '''Matchcode Auftraggeber''' stehen neben dem Namen jetzt auch Straße, PLZ und der Ort. | ||
|239356 | |239356 | ||
|- | |- | ||
Zeile 143: | Zeile 146: | ||
|9.34.0.340 | |9.34.0.340 | ||
|Statusmeldung (IsoCode) | |Statusmeldung (IsoCode) | ||
|Der ISO-Code wird aus dem | |Der ISO-Code wird aus dem Lademittel übernommen, alternativ aus dem Feld '''Gruppen-ISO-Code.''' Ist beides leer, wird keiner übernommen. | ||
|203467 | |203467 | ||
|- | |- | ||
Zeile 149: | Zeile 152: | ||
|9.34.0.319 | |9.34.0.319 | ||
|Rückmeldung | |Rückmeldung | ||
| | |Rückmeldungen werden bei jedem Wegpunkt bei den Wegpunktstatus "Ankunft" und "Abgeschlossen" erstellt. | ||
|204179 | |204179 | ||
|- | |- style="height:25px;" | ||
|06 24 V1 | |06 24 V1 | ||
|9.33.2.193 | |9.33.2.193 | ||
|Status Response Ergänzung / Veränderung "Externe Wegpunkt-ID" | |Status Response Ergänzung / Veränderung "Externe Wegpunkt-ID" | ||
|'' | |Die '''Externe Wegpunkt-ID''' wird in einem Hash-Wert dargestellt. | ||
|201611 | |201611 | ||
|- | |- | ||
Zeile 161: | Zeile 164: | ||
|9.33.2.166 | |9.33.2.166 | ||
|Adressenamen werden nicht zusammengefügt | |Adressenamen werden nicht zusammengefügt | ||
|Gibt es mehrere Zeilen mit dem Typ <Name>, wird der Inhalt aller durch Semikolon getrennt in das entsprechende Feld übernommen. | |Gibt es mehrere Zeilen mit dem Typ <Name>, wird der Inhalt aller durch Semikolon getrennt in das entsprechende Feld übernommen. | ||
|200882 | |200882 | ||
|} | |} | ||
Zeile 177: | Zeile 180: | ||
*[[Vorlage:Order/Allgemeine_Konfiguration|Allgemeine Konfigurationen]] | *[[Vorlage:Order/Allgemeine_Konfiguration|Allgemeine Konfigurationen]] | ||
===Anlagetypen=== | ===Anlagetypen=== | ||
Hier erklären wir Ihnen wie die Software entscheidet, um welchen Anlagetyp es sich handelt: | Hier erklären wir Ihnen, wie die Software entscheidet, um welchen Anlagetyp es sich handelt: | ||
*[[Vorlage:Order/Anlagetypen|Anlagetypen]] | *[[Vorlage:Order/Anlagetypen|Anlagetypen]] | ||
[[Category:Order]] | [[Category:Order]] | ||
[[Category:Cs hub]] | [[Category:Cs hub]] |
Version vom 28. Juni 2024, 14:57 Uhr
IN BEARBEITUNG
In dieser Übersicht finden Sie detaillierte Informationen zu den von FMS gelieferten Daten und wie diese von cs JOB übernommen und verarbeitet werden. Zudem zeigen wir Ihnen auf, welche Daten Sie an FMS zurückmelden können.
Begriff | Erklärung |
---|---|
1:1 | Hier werden die Daten ohne weitere Verarbeitung in cs JOB übernommen. |
Matching | Hier muss ein Mitarbeiter eine Zuordnung vornehmen. Einmal getätigte Zuordnungen müssen bei Folgeaufträgen nicht erneut getätigt werden. Die Software lernt so stets dazu und kann immer mehr Zuordnungen eigenständig vornehmen. |
Interpretation | Diese Daten werden von der Universalschnittstelle Container interpretiert. Die übermittelten Daten passen im "rohen" Zustand nicht in cs JOB. |
Hinweise | Hier finden Sie weiterführende Hinweise zu Feldern, wenn diese in cs JOB generiert werden sowie Erläuterungen zu den Interpretationen. Teilweise sind die Hinweise zu den Interpretationen zu umfangreich und werden daher am Ende dieser Seite im Detail dargestellt. |
Übersicht |
Interpretationen
Interpretation Wegpunkttypen
FMS übermittelt verschiedene Adressen. Diese Adressen sind immer einem Wegpunkttyp zugeordnet. Damit diese je Richtung (Import / Export) direkt zugeordnet werden können, ergänzen wir diese Informationen hinter jedem Wegpunkttyp Importtext.
Datei:csHUB:image2022-4-20 7-39-46.png
Multistop
Der Wegpunkttyp für einen Multistopp wird als <AddressData role="ServiceStop"> übermittelt. Da dieser für verschiedene Arten von Multistopps stehen kann, ergänzen wir zusätzlich den Inhalt aus Adressname 1.
Datei:csHUB:image2022-4-20 7-47-12.png
Interpretation Datum von / Datum bis
Bei jeder Adresse werden entsprechende Zeiten übermittelt. Dabei gibt es drei Arten von Zeiten:
- delivery
- start
- end
Bei der Übermittlung werden in der Regel Datum und Uhrzeit gesendet. Kommt es allerdings zu dem Fall, dass nur ein Datum versendet wird, ergänzen wir die Uhrzeit. Dabei wird bei "Start" die Uhrzeit 00:00 Uhr und "End" die Uhrzeit 23:59 Uhr ergänzt.
Datei:csHUB:image2022-4-20 9-7-51.png
Datei:csHUB:image2022-4-20 9-7-11.png
Bei der <AddressData role="Terminal"> übernehmen wir nur die Zeitart "delivery".
Datei:csHUB:image2022-4-20 9-26-12.png
Datei:csHUB:image2022-4-20 9-25-29.png
Interpretation Adressnamen
Wenn es mehrere Übermittlungen mit dem Typ <Name> gibt, werden alle Inhalte hintereinander in das entsprechende Feld übernommen. Die Trennung der Informationen erfolgt mit einem Semikolon.
Datei:csHUB:FMS 1719235490706.png
In cs JOB sieht es demnach so aus:
Datei:csHUB:FMS 1719235618408.png
Generelles
Mehrfachaufträge
Es besteht die Möglichkeit, dass mehrere Container in einem Auftrag übermittelt werden. Dies ist immer dann der Fall, wenn mehrere Positionen vom Typ <TransportContainer> vorhanden sind.
Datei:csHUB:image2022-4-20 7-23-36.png
Bei einer Mehrfachübermittlung werden Aufträge entsprechend der Anzahl an Positionen <TransportContainer> erstellt. An die Referenznummer der erstellten Aufträge wird die jeweilige Positionsnummer aus <TransportContainer> angehängt.
Datei:csHUB:image2022-4-20 7-26-7.png
Die erstellten Aufträge sind dabei identisch, lediglich die Inhalte innerhalb von <TransportContainer> können abweichend sein.
Erstellung einer Externen Wegpunkt ID
Die Externe Wegpunkt ID ist im Bereich cs HUB / Order zu einem Pflichtfeld geworden. Diese ID wird benötigt um die Wegpunkte in einem Auftrag oder der Fahrt, bei einem Update, gezielt zu aktualisieren.
In dieser Schnittstelle wird die Externe Wegpunkt ID nicht mit übermittelt. Somit wird eine Erstellung der Externen Wegpunkt ID durch eine Programmierung seitens cargo support übernommen. Dabei wird aus dem Feld <Code codelist="UNIQUE"> ein Hashwert gebildet.
Supplement Key "Warstein"
Steht in der Übertragungsdatei eine Zeile mit dem Supplement key Warstein, die so aussieht wie im folgenden Bild, dann wird in das Feld Auftragsvariante Importtext in cs JOB das Wort "Warstein" geschrieben.
Datei:csHUB:FMS 1719576872454.png
Das sieht in cs JOB dann wie folgt aus:
Datei:csHUB:FMS 1719577319979.png
Änderungshistorie
Die Änderungshistorie bezieht sich auf den Lieferumfang und beschreibt die Änderungen der Spezifikation der jeweiligen Schnittstelle. Bitte informieren Sie sich regelmäßig über die jeweiligen Änderungen. Der Spalte Inhalt können sie entnehmen, ob es sich um eine Änderung, eine neu aufgenommene oder um eine Löschung einer Spezifikation handelt. Für Rückfragen können Sie sich auch gerne an unseren Support wenden.
Revision | Version | Titel | Inhalt | User Story |
---|---|---|---|---|
06 24 V1 | 9.36.1.323 | Supplement key "Auftragsvariante" | Bei Übermittlung eines entsprechenden Supplement keys wird der Text "Warstein" in das Feld Auftragsvariante Importtext / OrderVariantImportText geschrieben. | 255873 |
06 24 V1 | 9.36.1.322 | Storno | Bei Storno werden alle Container, die zu einem Auftrag gehören, storniert. | 255024 |
06 24 V1 | 9.34.2.171 | Kundenmatchcode / Importtext unvollständig | Im Feld Matchcode Auftraggeber stehen neben dem Namen jetzt auch Straße, PLZ und der Ort. | 239356 |
06 24 V1 | 9.34.0.340 | Statusmeldung (IsoCode) | Der ISO-Code wird aus dem Lademittel übernommen, alternativ aus dem Feld Gruppen-ISO-Code. Ist beides leer, wird keiner übernommen. | 203467 |
06 24 V1 | 9.34.0.319 | Rückmeldung | Rückmeldungen werden bei jedem Wegpunkt bei den Wegpunktstatus "Ankunft" und "Abgeschlossen" erstellt. | 204179 |
06 24 V1 | 9.33.2.193 | Status Response Ergänzung / Veränderung "Externe Wegpunkt-ID" | Die Externe Wegpunkt-ID wird in einem Hash-Wert dargestellt. | 201611 |
06 24 V1 | 9.33.2.166 | Adressenamen werden nicht zusammengefügt | Gibt es mehrere Zeilen mit dem Typ <Name>, wird der Inhalt aller durch Semikolon getrennt in das entsprechende Feld übernommen. | 200882 |
Allgemeine Informationen
Technik
Informationen über die notwendigen Einstellungen in der Software und auf dem Server vorgenommen finden Sie hier:
Aufbau und Bedienung
Allgemeine Informationen zum Aufbau des Bearbeitungsfensters sowie Details der Bedienung finden Sie hier:
Allgemeine Konfigurationen
Hier erfahren Sie, welche Konfigurationen Sie für Ihre Auftragsschnittstelle vornehmen müssen:
Anlagetypen
Hier erklären wir Ihnen, wie die Software entscheidet, um welchen Anlagetyp es sich handelt: