Kundenspezifische XML-Dokumente importieren

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

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs

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. Dieser Code wird 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.
  • Erstellen Sie einen Code für die Codeliste CustomMessageIDs, die im Prozess verwendet wird. Dieser Code wird verwendet, um den Absender 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.

  • 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 XML-Dokuments zu bestimmen.
    • 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.

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 im Bereich Kommunikation implementiert wurde, können Sie das XML-Dokument auch über Exchange Services importieren.
    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.