Show TOC

Dokumentation zur VorgehensweiseMessage-Versionen auf der AAE speichern (lokale Message-Verarbeitung) Dieses Dokument in der Navigationsstruktur finden

 

Sie können asynchrone Messages, die auf der Advanced Adapter Engine (AAE) verarbeitet werden, vor oder nach den Verarbeitungsschritten speichern.

Sie können dann die Message bearbeiten und, in bestimmten Fällen, die Verarbeitung der geänderten Message neu starten.

Hinweis Hinweis

Diese Art des Speicherns von Message-Versionen wird auch Staging genannt (im Unterschied zur Protokollierung, bei der synchrone Messages gespeichert werden aber dann nur angezeigt werden können).

Ende des Hinweises.

Wenn Sie die lokale Message-Verarbeitung mit der AAE (mit integrierter Konfiguration) konfiguriert haben, können Sie Message-Versionen nach den folgenden Verarbeitungsschritten innerhalb der Pipeline speichern:

Verarbeitungsschritt

Beschreibung

Message-Vorbereitung (Parameter BI)

Nach der Verarbeitung mit dem Sender-Adapter wird die Message dem Messaging-System übergeben und für die weitere Verarbeitung vorbereitet.

XML-Validierung Eingang (Parameter VI)

Die eingehende Message wird anhand eines Schemas validiert.

Empfänger- und Interface-Ermittlung (Parameter MS)

Die Empfänger der Messages und die Inbound-Interfaces werden validiert anhand der Konfigurationseinstellungen in der entsprechenden integrierten Konfiguration im Integration Directory.

Mapping (Parameter AM)

Das Mapping findet anhand der Konfigurationseinstellungen in der entsprechenden integrierten Konfiguration im Integration Directory statt.

XML-Validierung Ausgang (Parameter VO)

Die ausgehende Message wird anhand eines Schemas validiert.

Die folgende Abbildung zeigt die Reihenfolge der Verarbeitungsschritte für die lokale Message-Verarbeitung in der Advanced Adapter Engine und kennzeichnet, wo Message-Versionen gespeichert werden können:

Die Abbildung wird im Begleittext erläutert.

Verarbeitungsschritte in der AAE

Sie können mit den Parametern BI, VI, MS, AM und VO festlegen, ob eine Message-Version gespeichert werden und wie die weitere Verarbeitung erfolgen soll. Die Art der Weiterverarbeitung können Sie für jeden Schritt wie folgt definieren:

  • 0 (MODE_NO_STORE)

    Der Prozessor speichert keine Message-Version und fährt mit dem nächsten Verarbeitungsschritt fort.

  • 1 (MODE_STORE_ON_ERROR)

    Der Prozessor speichert eine Message-Version nur dann, wenn im nachfolgenden Verarbeitungsschritt ein Fehler auftritt.

  • 3 (MODE_STORE_AND_RETURN)

    Der Prozessor speichert die Message und setzt die Verarbeitung mit dem nächsten Verarbeitungsschritt fort.

Hinweis Hinweis

Mindestens einer der Schritte muss mit dem Wert 3 konfiguriert werden.

Ende des Hinweises.

Um das Speichern von Message-Versionen zu konfigurieren, verwenden Sie den Parameter xiadapter.stage.conf des Service XPI Adapter: XI.

Vorgehensweise

Globale Staging-Konfiguration
  1. Rufen Sie den SAP NetWeaver Administrator auf.

    Sie können folgende Adresse verwenden: http://<host>:<port>/nwa

  2. Wählen Sie   Konfigurationsmanagement   Infrastruktur   Java-Systemeigenschaften  .

  3. Auf der Registerkarte Services wählen Sie XPI Adapter: XI.

  4. Geben Sie für die Eigenschaft xiadapter.stage.conf Werte ein.

    • Für jeden Verarbeitungsschritt (BI, MS usw.) können Sie 0, 1 oder 3 eingeben.

    • Geben Sie die Werte in folgender Form ein: BI=1,MS=3, ...

    • Um zusätzlich Angaben für Dual-Stack-Szenarien zu machen, bei denen die Integration Engine beteiligt ist, setzen Sie den Variablensatz in Klammern und fügen einen zweiten Variablensatz in Klammern hinzu. Der erste Variablensatz ist für eine lokale Message-Verarbeitung auf der Advanced Adapter Engine gültig, der zweite Variablensatz ist nur für die Szenarien gültig, die auch eine Message-Verarbeitung auf der Integration Engine beinhalten.

      Weitere Informationen: Message-Versionen auf der AAE speichern (Dual-Stack-Message-Verarbeitung)

      Beispiel Beispiel

      (BI=1,MS=3) (MS=3)

      Ende des Beispiels.
    • Die Parameter AM und VO können für Dual-Sack-Szenarien (zweiter Variablensatz) nicht verwendet werden. Diese Parameter sind nur für die lokale Message-Verarbeitung mit der AAE bestimmt.

    • Machen Sie keine Angaben, wird die Message nach der Empfängerermittlung in der Advanced Adapter Engine gespeichert.

      Dies entspricht dem Eintrag MS=3.

Szenariospezifische Konfiguration des Staging

Sie können das Staging auch für bestimmte Szenarien konfigurieren, die mit der integrierten Konfiguration konfiguriert werden.

Weitere Informationen finden Sie in der Dokumentation zum Integration Directory in der SAP-NetWeaver-Bibliothek unter   SAP-NetWeaver-Bibliothek: Funktionsorientierte Sicht   Process Integration   Integration Directory   Integrierte Konfiguration definieren  .

Ergebnis

Wird eine Message nicht zugestellt, wird die zuletzt gespeicherte Message-Version für einen automatischen Neustart verwendet. Ist die Zeit für einen automatischen Neustart überschritten und die Message erhält den Status Nicht zugestellt, können Sie jede gespeicherte Message-Version für einen manuellen Neustart verwenden.

Verwenden Sie eine Message-Version für den manuellen Neustart und es sind neuere Message-Versionen vorhanden, wird die Nummer der Message-Version erhöht, um sie von den anderen Message-Versionen zu unterscheiden.

Hinweis Hinweis

Wenn eine Message neu gestartet wird, wird sie auch wieder in einer Queue eingeplant. Deshalb kann die Verarbeitungszeit einer Message länger dauern, wenn das Staging verwendet wird. Die Message wird in dem Pool von Messages, die sich bereits in der Queue befinden, neu eingeplant.

Ende des Hinweises.