Kundenspezifische XML- und Nicht-XML-Dokumente importieren

Kundenspezifische XML-Dokumente können in der Anwendung mithilfe von Codelisten transformiert werden. Für die Implementierung einer kundenspezifischen Dokumentenverarbeitung sind diese Codelisten im Bereich Stammdaten der Anwendung verfügbar:

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs
  • CustomBODsOutToIONDesk

Voraussetzungen

Die folgenden Schritte sind erforderlich, bevor Sie diese Funktion konfigurieren können:

  • Erstellen Sie ein kundenspezifisches Stylesheet mit einem zugehörigen XML-Dokument.
  • Bestimmen Sie die gewünschten Werte für den Trading Partner, wenn es sich nicht um eine Standard-Trading Partner handelt.

Einstellung

Folgende Einstellungen müssen für den Bereich Stammdaten vorgenommen werden:

  • Erstellen Sie einen Code für die Codeliste CustomTradingPartner, die in diesem Prozess verwendet wird.
  • Erstellen Sie einen Code für die Codeliste CustomMessageTypes, die im Prozess verwendet wird. Dieser Wert wird für Auswahlfelder zur Auswahl von Standard-Nachrichtenarten verwendet. Erstellen Sie in der Tabelle Codelistenparameter einen Code mit der Kennung, die der im kundenspezifischen XML-Dokument definierten Dokumentart entspricht.
  • Erstellen Sie einen Code für die Codeliste CustomMessageFormats, die im Prozess verwendet wird.
    • Bei XML-Dokumenten wird dieser Code verwendet, um die Art des XML-Dokuments zu bestimmen.
      Hinweis

      Der Prozess durchläuft alle kundenspezifischen Nachrichtenformate, um eine Dokumentart zu finden. Es wird das erste kundenspezifische Nachrichtenformat verwendet, bei dem ein Wert für das angegebene Element gefunden wird.

      • Im Dialogfeld Codeparameter verwalten müssen Sie im Feld Kennung einen eindeutigen Wert eingeben.
      • Geben Sie auf der Registerkarte Werte 1 im Feld Nachrichtenartelement das Element im kundenspezifischen XML-Dokument an, das die XML-Dokumentart bestimmt. Nur die erste Instanz dieses Elements wird in diesem Prozess verwendet. XML-Elemente werden unterstützt, aber keine Attribute.
    • Bei kundenspezifischen Dokumenten, die keine XML-Dokumente sind, wird dieser Code verwendet, um die folgenden Eigenschaften zu identifizieren:
      • Nachricht beginnt mit - Die ersten sechs Zeichen zur Identifizierung der Nachricht
      • Nachrichtenstandard - Der Nachrichtenstandard, der mit der Nachricht verknüpft werden soll
      • Nachrichtenart - Die Nachrichtenart, die mit der Nachricht verknüpft werden soll
  • Erstellen Sie einen Code für die Codeliste CustomMessageIDs, die im Prozess verwendet wird.
    • Dieser Code wird verwendet, um den Sender und den Empfänger des XML-Dokuments zu bestimmen.
      • Geben Sie eine Kennung an, die mit dem erstellten CustomMessageTypes-Code übereinstimmt.
      • Auf der Registerkarte Werte 1 müssen Sie mindestens die Position 1 der Sender-ID und die Position 1 der Empfänger-ID angeben. Diese Werte sind XML-Elemente. Der Prozess beginnt an der Stelle der ersten Instanz von Position 1. Wenn Position 2 angegeben ist, wird mit Position 2 fortgefahren. Wenn Position 3 angegeben ist, wird mit Position 3 fortgefahren. Wenn eine Position angegeben ist, muss sie im Dokument vorhanden sein. Andernfalls ist die Verarbeitung nicht erfolgreich.
        Hinweis

        Die erste Position muss nicht unbedingt das Dokumentenelement sein.

    • Für Nicht-XML-Dateien können Sie auf die gleiche Weise einen Code für die Codeliste CustomMessageTypes erstellen, um den Sender und den Empfänger der Datei zu bestimmen.
      • Geben Sie eine Kennung an, die mit dem erstellten CustomMessageTypes-Code übereinstimmt.
      • Geben Sie auf der Registerkarte Werte 1 die Position 1-Werte für Sender und Empfänger an. Zu Beginn des Prozesses wird von Position 1 der Anfang der Nicht-XML-Datei gescannt, um sicherzustellen, dass die Zeichen mit dem in der Codeliste eingegebenen Text übereinstimmen. Anschließend wird anhand der auf 1 basierten Nummerierung der Startindex (Position 2) und der Endindex (Position 3) ermittelt, um den Sender oder Empfänger zu identifizieren.
  • Erstellen Sie einen Code für die Codeliste CustomStyleSheetRules, die im Prozess verwendet wird. Dieser Code wird verwendet, um das Stylesheet für die Transformation des kundenspezifischen Dokuments zu bestimmen.
    • Dies ist die erforderliche Einstellung für kundenspezifische XML-Dokumente:
      • Geben Sie im Dialogfeld Codeparameter verwalten eine Kennung an, die bei der Verarbeitung verwendet und bei Suchläufen und in Auswahllisten angezeigt wird. Dieser Wert ist normalerweise der Name der Stylesheet-Datei ohne Dateierweiterung.
      • Geben Sie auf der Registerkarte Werte 1 folgende Feldwerte an:
        • Geben Sie im Feld Dateiname des Stylesheets den Dateinamen an, der für die Transformation verwendet wird. Der Dateiname muss die Dateierweiterung enthalten.
        • Geben Sie im Feld Quellformatdateibeschreibung den Wert *Keine an.
        • Geben Sie im Feld Zielformatdateibeschreibung den Wert *Keine an.
        • Wählen Sie im Feld Nachrichtenstandard die Option XML aus.
    • Dies ist die erforderliche Einstellung für kundenspezifische Nicht-XML-Dokumente:
      • Geben Sie im Dialogfeld Codeparameter verwalten eine Kennung an, die bei der Verarbeitung verwendet und bei Suchläufen und in Auswahllisten angezeigt wird. Dieser Wert ist normalerweise der Name der Stylesheet-Datei ohne Dateierweiterung.
      • Geben Sie auf der Registerkarte Werte 1 folgende Feldwerte an:
        • Geben Sie im Feld Dateiname des Stylesheets den Dateinamen an, der für die Transformation verwendet wird. Der Dateiname muss die Dateierweiterung enthalten.
        • Geben Sie im Feld Quellformatdateibeschreibung den Namen der Formatdatei an.
        • Geben Sie im Feld Zielformatdateibeschreibung den Wert *Keine an.
        • Wählen Sie im Feld Nachrichtenstandard den entsprechenden Nicht-XML-Standard aus der Auswahlliste aus (wählen Sie zum Beispiel Durch Komma getrennte Werte für eine Textdatei).
  • Erstellen Sie einen Code für die Codeliste CustomBODsOutToIONDesk, der zulässt, dass kundenspezifische ausgehende BODs aus ION Connector an ION Desk gesendet werden können.
    Hinweis

    Die Codeliste muss das Format Verb.Noun einhalten. Beispiel: Im Dialogfeld Codeeigenschaften verwalten lautet der Wert im Feld Kennung Bestellung verarbeiten, und das Feld Beschreibung enthält eine Beschreibung des kundenspezifischen BOD.

Transformationseinstellung

Dies sind die Schritte zum Einrichten der Partner-ID:

  1. Wählen Sie Transformation > Konfiguration > Partner-IDs aus.
  2. Klicken Sie auf Erstellen.
  3. Wählen Sie auf der Seite Partner-ID in der Auswahlliste Nachrichtenart die kundenspezifische Nachrichtenart aus.
  4. Wählen Sie in der Auswahlliste den Trading Partner aus.
  5. Geben Sie im Abschnitt Sender-/Empfänger-IDs eine Absender-ID und eine Empfänger-ID in den entsprechenden Feldern an.
  6. Geben Sie im Abschnitt Interne/Externe Partnerzuordnung in den Zuordnungsfeldern die entsprechenden Werte an.

Führen Sie folgende Schritte zum Einrichten der Transformationsregel aus:

  1. Wählen Sie Transformation > Konfiguration > Transformationsregeln aus.
  2. Klicken Sie auf Erstellen, um die Transformationsregel zu erstellen.
  3. Wählen Sie auf der Seite Transformationsregeln in den entsprechenden Feldern die Regel für den kundenspezifischen Trading Partner, die kundenspezifische Nachrichtenart und das kundenspezifische Stylesheet-Regel aus.

Führen Sie folgende Schritte zum Einrichten des kundenspezifischen Stylesheets aus:

  1. Wählen Sie Transformation > Konfiguration > Stylesheets aus.
  2. Klicken Sie auf Erstellen, um den kundenspezifischen Stylesheet-Datensatz zu erstellen.
  3. Verwenden Sie auf der Seite Stylesheets den kundenspezifischen Trading Partner und den Namen des Stylesheets einschließlich Dateierweiterung, die für die kundenspezifische Stylesheet-Regel erstellt wurden.

Kundenspezifische XML-Dokumente verarbeiten

Führen Sie folgende Schritte zum Verarbeiten kundenspezifischer XML-Dokumente aus:

  1. Wählen Sie Transformation > Nachrichten importieren aus, um das XML-Dokument zu importieren. Wenn die Lokale Client-Konfiguration dagegen im Bereich Kommunikation implementiert wurde, importieren Sie das XML-Dokument über Exchange Services.
    Hinweis

    Derzeit wird der ION Connector nicht unterstützt.

  2. Wählen Sie Transformation > Nachrichten verwalten aus.
  3. Überprüfen Sie auf der Seite Nachrichten verwalten die Ergebnisse. Korrigieren Sie die für die Verarbeitung erforderlichen Werte.