Benutzerdefinierte Message-Suche konfigurieren

1. Test-Messages vorbereiten

Bereiten Sie mindestens eine Test-Message mit der zu indizierenden Payload vor. Achten Sie darauf, dass diese Message erfolgreich verarbeitet wird und dass Sie sie im NWA-Message-Monitor sehen. Öffnen Sie die Message mit dem NWA-Message-Editor und achten Sie darauf, dass es eine Version mit der Payload gibt, die Sie indizieren möchten. Um eine optimale Performance zu erzielen, achten Sie darauf, dass Sie für die Message so wenig wie möglich Staging- und Logging-Versionen konfigurieren. Notieren Sie die exakten Header-Daten für die Message-Version, die Sie indizieren möchten, da sie in den nächsten Schritten benötigt werden.

2. 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.

3. 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 Die Felder des Message-Headers werden wortwörtlich verglichen, so dass zum Beispiel eine leere Senderkomponente nur zu Message-Versionen mit leerer Senderkomponente passt. Der Platzhalter * passt zu jedem Wert.

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.

4. 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. Sie müssen den Header und seinen Namensraum eingeben.

   • Wählen Sie XPath-Ausdruck, wenn Sie nach Informationen in einem bestimmten Element oder Attribut in der Message-Payload suchen möchten.

     Beispiel Um die OrderID im folgenden XML zu finden:

     <urn: OrderReqMT xmlns:urn="urn:test"> 
         <Order>
             <ID>1</ID>
             <Name>nuts</Name>
         </Order>
     </urn: OrderReqMT>
     

     Würden Sie den folgenden XPath-Ausdruck verwenden: //ns0: OrderReqMT/Order/ID sowie die Präfixdefinition mit dem Wert: ns0 und dem Namensraum: urn:test.

     Sie müssen den XPath-Ausdruck gemäß den Regeln von Version 1.0 der Sprache XPath eingeben. Weitere Informationen finden Sie unter http://www.w3.org/TR/xpath/.

     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).

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.

5. 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.

6. Messages indizieren und Suchkriterien testen

1. 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.
2. Wählen Sie Indizierungsoptionen, um einen Index der Messages anzulegen, die die aktiven Filter und Suchkriterien erfüllen.

   Dieser Index wird verwendet, wenn Sie im Message-Monitor mit der benutzerdefinierten Suche nach Messages suchen möchten. Sie müssen Anfang und Ende des Zeitraums angeben, 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.

7. Fehlerbehebung

• Achten Sie darauf, dass Ihre Filter und Extraktoren korrekt mit den Testsuchkritieren konfiguriert sind. Es macht keinen Sinn, den Index-Job zu starten, wenn Ihre Test-Message nicht korrekt indiziert werden konnte.
• Um die bestmögliche Performance zu erreichen, definieren Sie spezifische Filter, die auf die ausdrückliche Message-Version ausgerichtet sind. Verwenden Sie möglichst wenige Platzhalter, damit nicht zu viele Extraktoren verwendet werden.