Benutzerdefinierte Message-Suche konfigurieren

Filter definieren

Sie können Filter zum Auswählen von Messages anlegen (hinzufügen), ändern oder löschen. Im Änderungsmodus können Sie Filter aktivieren oder deaktivieren.

Um einen Filter anzulegen, gehen Sie wie folgt vor:

1. Führen Sie die Transaktion SXMS_LMS_CONF aus.

2. Wählen Sie Hinzufügen in der Filterliste und geben Sie die erforderlichen Auswahlkriterien an.

   Um Ihnen die Angabe der Auswahlkriterien zu erleichtern, steht Ihnen eine Eingabehilfe mit Werten aus dem lokalen Integration-Directory-Cache zur Verfügung.

   Wenn Sie die Kriterien manuell erfassen möchten, können Sie auch Sternchen (*) verwenden. Bei Interface-Namen und Namensräumen gilt dies jedoch nur, wenn Sie adapterspezifische Message-Attribute aus Ihren Messages extrahieren möchten.

   Hinweis

   Berücksichtigen Sie bei der Erfassung Ihrer Filterkriterien, dass die Message-Indizierung zwei Mal erfolgt: ein Mal nach Message-Eingang und ein Mal vor Message-Ausgang.

3. Wählen Sie Weiter. Der neue Filter erscheint in der Filterliste.

Extraktor definieren

Für Filter definieren Sie immer Extraktoren. Sie können Extraktoren anlegen (hinzufügen), ändern oder löschen.

Um einen Extraktor anzulegen, gehen Sie wie folgt vor:

1. Doppelklicken Sie in der Filterliste auf den Filter, für den Sie einen Extraktor definieren möchten.

2. Wählen Sie in der filterspezifischen Extraktorenliste Hinzufügen und geben Sie Folgendes an:

   • Extraktorname

     Geben Sie einen aussagekräftigen Namen ein, da dieser beim Monitoring als Suchbegriff für die Suche nach Messages verwendet wird.

   • Beschreibung

     Geben Sie eine Kurzbeschreibung ein. Sie wird beim Monitoring als Eingabehilfe verwendet.

   • Typ

     Sie können zwischen den folgenden beiden Typen wählen:

     • XPath

       Dieser Extraktortyp verwendet einen XPath-Ausdruck für die Suche nach Attributen in der Haupt-Payload einer Message.

     • Dynamischer Header

       Dieser Extraktortyp sucht nach adapterspezifischen Message-Attributen. Solche Attribute werden anhand von Interface-Name und Namensraum identifiziert.

   • Methode

     Sie können zwischen den folgenden beiden Methoden wählen:

     • Während Message-Verarbeitung extrahieren

       Wählen Sie diese Methode, wenn die Extraktion der Attribute aus den ausgewählten Messages während der Message-Verarbeitung stattfinden soll.

     • Mit externem Job extrahieren

       Wählen Sie diese Methode, wenn Sie Attribute aus bereits verarbeiteten Messages extrahieren möchten oder wenn Sie die Extraktion von Attributen für Messages ändern möchten, aus denen bereits Attribute extrahiert wurden.

       Für diese Methode müssen Sie den Job SXMS_EXTRACT_MESSAGES einrichten und verwenden.

3. Wählen Sie Weiter.

   Der neue Extraktor erscheint in der Extraktorliste für den ausgewählten Filter.

   Hinweis

   Der Extraktor ist nur dann aktiv, wenn Sie mindestens eine der zwei verfügbaren Methoden ausgewählt haben.

Namensraumpräfix 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 das Präfix dann für alle Extraktoren vom Typ XPath für diesen Filter verwenden. Sie können Namensraumpräfixe anlegen (hinzufügen), ändern oder löschen.

Um ein Namensraumpräfix anzulegen, 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 in der filterspezifischen Liste der Namensraumpräfixe Hinzufügen und geben Sie Folgendes an:

   • Präfix: Geben Sie das Präfix an.

   • Namensraum: Geben Sie den Namensraum an, für den Sie das Präfix verwenden möchten.

3. Wählen Sie Weiter. Das neue Namensraumpräfix erscheint in der Liste der Namensraumpräfixe für den ausgewählten Filter.

Extraktor testen

Auf der Integration Engine können Sie testen, ob ein Extraktor die Attribute aus einer bestimmten Message wie vorgesehen extrahiert.

1. Wählen Sie Extraktor testen.

2. Geben Sie die ID der entsprechenden Message ein.

3. Wählen Sie Weiter.

   Sie erhalten ein Extraktorprotokoll mit den gefundenen Werten.