Show TOC

HintergrundBenutzerdefinierte Message-Suche konfigurieren Dieses Dokument in der Navigationsstruktur finden

 

Wenn Sie die Informationen in der Payload oder im dynamischen Header einer Message kennen, können Sie eine solche Message über die benutzerdefinierte Suche suchen und finden. Hierbei gehen Sie wie folgt vor::

  1. Geben Sie an, nach welcher Art von Informationen Sie suchen möchten.

    Legen Sie Filter an und definieren Suchkriterien. Zuerst legen Sie einen Filter an, bei dem Sie angeben, für welches Interface, welchen Sender und welchen Empfänger Sie Messages suchen wollen. Dann legen Sie für jeden Filter Suchkriterien an. Für jedes Suchkriterium geben Sie an, in welchen Elementen der Payload oder des dynamischen Headers Sie suchen wollen.

  2. Indizieren Sie die Messages.

    Messages werden für einen Filter indiziert sobald der Filter angelegt wird. Wenn Sie ältere Messages indizieren möchten, die vor dem Anlegen des Filters verarbeitet wurden, verwenden Sie die Option zur Indizierung von Messages für einen bestimmten Zeitraum.

  3. Wählen Sie im Message-Monitor die Suchkriterien aus und geben Sie die Werte an, nach denen Sie suchen möchten.

    Hierfür sollte im Message-Monitor mindestens ein Filter verfügbar sein. Der Index wird überprüft und nur die Messages werden angezeigt, die Ihren Suchkriterien entsprechen. Weitere Informationen finden Sie unter Erweiterte Message-Suche.

Voraussetzungen

  • Das von Ihnen verwendete Benutzerkonto sollte einer Rolle des PI-Monitoring zugewiesen sein. Weitere Informationen darüber, mit welchen Rollen Sie Messages anzeigen und ändern können, finden Sie unter Monitoring-Rollen.

  • Um die benutzerdefinierte Suche für synchrone Messages verwenden zu können, müssen Sie die Protokollierung dieser Messages aktivieren. Weitere Informationen finden Sie unter Message-Versionen auf der AAE speichern (lokale Message-Verarbeitung) und im SAP-Hinweis 1760915.

Vorgehensweise

1. Filter anzeigen

  1. Sie haben folgende Möglichkeiten, um auf die Konfiguration der benutzerdefinierten Suche zuzugreifen:

    • Öffnen Sie ein Browser-Fenster und rufen Sie über http://[host]:[port]/pimon die Werkzeuge der Process Integration auf. Wählen Sie dann   Konfiguration und Administration   Adapter-Engine   Benutzerdefinierte Suchkonfiguration  .

    • Öffnen Sie ein Browser-Fenster und rufen Sie über http://[host]:[port]/nwa den SAP NetWeaver Administrator auf. Wählen Sie dann   SOA   Monitoring   PI-Adapter: Benutzerdefinierte Message-Suche  .

  2. Verwenden Sie die folgenden Optionen im Bereich Liste der Filter, um die Filter anzuzeigen:

    • Verwenden Sie das Dropdown-Menü Anzeigen, um aktive, inaktive oder alle Filter anzeigen.

    • Verwenden Sie die Controls auf der rechten Seite, um die Filterliste zu aktualisieren, die Such- oder Filteroptionen ein- oder auszublenden, und die Größe der Tabelle auszuwählen, in der die Filter angezeigt werden.

2. Filter anlegen

  1. Führen Sie eine der folgenden Aktionen durch:

    • Um einen neuen Filter anzulegen, wählen Sie die Taste Neu.

    • Um vorhandene Filter zu bearbeiten, wählen Sie die Filter in der Tabelle aus und wählen die Taste Bearbeiten.

      Durch Betätigen der Taste Strg oder Umschalt können Sie mehrere Filter gleichzeitig auswählen.

  2. Spezifizieren oder ändern Sie die Filterdetails wie folgt:

    • Interface und Namensraum müssen eingegeben werden. Bei Bedarf können Sie mehrere Filter für dasselbe Interface anlegen.

    • Legen Sie den Status des Filters fest.

    • Bei neuen Filtern muss der Name des Filters eingegeben werden.

    • Machen Sie, wenn gewünscht, Angaben zu Sender und Empfänger.

    Hinweis Hinweis

    Die Eingabewerte für Messages, die im Enterprise Services Repository als sensibel gekennzeichnet sind, werden nicht angezeigt, da diese Messages vertrauliche Informationen enthalten.

    Ende des Hinweises.

  3. Um die Bearbeitung des Filters zu beenden, wählen Sie Hinzufügen.

    Optional können Sie weitere Filter anlegen oder Filter aus der Liste der ungesicherten Filter ändern oder löschen.

  4. Wählen Sie Sichern.

3. Suchkriterien definieren

  1. Wählen Sie den Filter aus, für den Sie Suchkriterien definieren möchten, und wählen Sie anschließend die Registerkarte Suchkriterien.

  2. Wählen Sie Neu, um neue Suchkriterien anzulegen.

    Wenn Sie die für diesen Filter vorhandenen Suchkriterien bearbeiten möchten, wählen Sie sie aus und wählen Bearbeiten.

  3. Bei einem neuen Suchkriterium geben Sie den Namen und optional eine Beschreibung ein.

  4. Wählen Sie für die Art der Suche eine der folgenden Optionen aus:

    • Wählen Sie Dynamischer Header, wenn Sie nach zusätzlichen Informationen suchen möchten, die von Sender-Adaptern in den Message-Header geschrieben werden. Geben Sie den Header und seinen Namensraum ein.

    • Wählen Sie XPath-Ausdruck, wenn Sie nach Informationen in einem bestimmten Element oder Attribut in der Message-Payload suchen möchten. Geben Sie den XPath-Ausdruck gemäß den Regeln von Version 1.0 der Sprache XPath ein. Weitere Informationen finden Sie unter http://www.w3.org/TR/xpath/.

      Hinweis Hinweis

      Verwenden Sie nur XPath-Ausdrücke, die einen Einzelwert zurückliefern. Verwenden Sie keine XPath-Ausdrücke, die ganze Teilbäume zurückliefern, wie child::* oder //Person (wo Person ein Element in der Message-Payload ist, das Unterelemente enthält).

      Ende des Hinweises.

  5. Um die Bearbeitung der Suchkriterien zu beenden, wählen Sie Hinzufügen.

    Optional können Sie weitere Kriterien anlegen oder welche aus der Liste der ungesicherten Kriterien ändern oder löschen.

  6. Wählen Sie Sichern.

4. Namensraumpräfixe definieren

In XPath-Ausdrücken können Sie anstelle eines Namensraums ein Namensraumpräfix verwenden. Für einen Filter müssen Sie immer ein Namensraumpräfix definieren. Sie können es dann für alle Suchkriterien vom Typ XPath für diesen Filter verwenden. Um ein Namensraumpräfix zu definieren, gehen Sie wie folgt vor:

  1. Wählen Sie in der Filterliste den Filter aus, für den Sie das Namensraumpräfix definieren möchten.

  2. Wählen Sie die Registerkarte Präfixe und anschließend Neu.

  3. Geben Sie den Namensraum und das Präfix ein und wählen Sie Hinzufügen.

    Optional können Sie weitere Präfixe definieren oder welche der ungesicherten Präfixen löschen.

  4. Wählen Sie Sichern.

5. Messages indizieren und Suchkriterien testen

  1. Wählen Sie Indizierungsoptionen, um einen Index der Messages anzulegen, die die aktiven Filter und Suchkriterien erfüllen.

    Beachten Sie, dass Messages automatisch für einen Filter indiziert werden sobald der Filter angelegt wird. Sie können die Indizierungsoptionen verwenden, wenn Sie ältere Messages indizieren möchten, die in einem bestimmten Zeitraum vor dem Anlegen des Filters verarbeitet wurden.

    Geben Sie Anfang und Ende des Zeitraums an, für den die Messages indiziert werden sollen. Nachdem die Indizierung begonnen hat, können Sie mit der Taste Indizierungsstatus prüfen, ob der Indizierungsjob abgeschlossen ist.

    Hinweis Hinweis

    Es werden keine Messages indiziert, die im Enterprise Services Repository als sensibel gekennzeichnet sind, da diese Messages vertrauliche Informationen enthalten.

    Ende des Hinweises.

  2. Sie können testen, ob ein Suchkriterium eine bestimmte Message wie beabsichtigt findet. Hierzu wählen Sie Suchkriterien testen, geben die ID der Message ein, geben die Richtung der Message an, und führen den Test aus.

    Hinweis Hinweis

    • Das Testergebnis hält die Reihenfolge der Attribute in der Payload ein.

    • Während der Suche werden keine Messages angezeigt, die im Enterprise Services Repository als sensibel gekennzeichnet sind.

    • Wird eine Message nicht nach der Empfängerermittlung oder dem Mapping in der Advanced Adapter Engine abgelegt, wird die Message nicht im Testergebnis angezeigt.

      Weitere Informationen finden Sie unter Message-Versionen auf der AAE speichern (lokale Message-Verarbeitung)

    Ende des Hinweises.

Weitere Informationen

  • Die benutzerdefinierte Suche ist eine von vielen Möglichkeiten mit dem Message-Monitor Messages in der Advanced Adapter Engine zu suchen. Weitere Informationen finden Sie unter Messages überwachen.

  • Die benutzerdefinierte Suche steht auch zur Suche von Messages in der Integration Engine zur Verfügung. Sie können sie mit der Transaktion SXMS_LMS_CONF konfigurieren. Weitere Informationen finden Sie in der Dokumentation zur Integration Engine.

  • Weitere Informationen zum Aktivieren der Protokollierung von synchronen Messages finden Sie unter http://wiki.sdn.sap.com/wiki/x/qQF8Dw.