Kontakt

Ansicht
Dokumentation

CRM_IIA_011 - BAdI: Externe Suchmaschinen

CRM_IIA_011 - BAdI: Externe Suchmaschinen

General Data in Customer Master   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

In dieser Aktivität des Einführungsleitfadens (IMG) definieren Sie neue Suchmaschinen (keine TREX-Suchmaschinen) und Content-Management-Systeme und fügen diese zum Software-Agent-Framework (SAF) hinzu. Dabei kann es sich um eine beliebige Suchmaschine oder ein beliebiges Content-Management-System aus einem SAP-System oder aus einem System eines Drittanbieters handeln. (Wenn Sie eine neue TREX-basierte Suchmaschine definieren, müssen Sie diese IMG-Aktivität nicht durchführen.)

Jede im SAF definierte Suchmaschine kann einer oder mehreren Wissensdatenbanken in der IMG-Aktivität Wissensdatenbank benennen und einstellen zugeordnet werden. Zu einer Wissensdatenbank, für die im SAF eine bestimmte Sprache angegeben ist, kann nur eine Suchmaschine zugeordnet werden. Eine Wissensdatenbank kann jedoch mehreren Anwendungen zugeordnet werden. Somit ist die Suchmaschine indirekt der Anwendung zugeordnet, der die Wissensdatenbank zugeordnet ist.

Die Integration der HTTP-Suche ist die vom SAF unterstützte Standard-Suchmaschinenintegration. Wenn das Produkt eines Drittanbieters HTTP-Kommunikation für die Suchfunktion zur Verfügung stellt, kann das Produkt über diese Herangehensweise am effizientesten in das SAF integriert werden.

Wenn Sie zwischen SAP und der Suchmaschine oder dem Content-Management-System des Drittanbieters zusätzliche Kommunikation (zusätzlich zu HTTP) benötigen, können Sie eine aus der Suchmaschinenklasse CL_CRM_SAF_SE_GENIL erweiterte ABAP-Klasse anlegen. Diese Klasse definiert die von der Suchmaschine des SAF unterstützten grundlegenden Methoden. Siehe dazu unter Zusätzliche Informationen den Abschnitt Unbeschränkte Integration für Suche.

Für das Business Add-In ist eine HTTP-Kommunikation mit der Suchmaschine erforderlich. Für andere Kommunikationsarten kann eine zusätzliche Integration oder zusätzliches Coding innerhalb oder außerhalb des SAP-Servers erforderlich sein, um die Prozesse für Suche und Kompilierung abzuschließen. Dies hängt vom Application Programming Interface (API) ab, das von der externen Suchmaschine bereitgestellt wird.

Sie müssen über die Berechtigung für die Transaktionen SE19, SE24, CRMC_SAF_WZ_SE, CRMC_SAF_WZ_KB, CRMC_SAF_WZ_COMPILE und CRMC_SAF_WZ_RFC verfügen.

Um Ihre bereits vorhandenen Suchservices oder externe Content-Management-Systeme in die Wissenssuche des Interaction Center (IC) WebClients zu integrieren, prüfen Sie folgende Voraussetzungen, bevor Sie mit der Integration beginnen:

  • Der externe Suchservice muss ein API zur Verfügung stellen, auf das von SAP zugegriffen werden kann, z.B. ein Servlet für HTTP-Kommunikation.
  • Das API muss mindestens zwei Protokolle enthalten:
  • Suchanfrage übergeben und Liste von Treffern zurückgeben - jeweils mit eindeutiger ID

  • eindeutige ID übergeben und Detailbeschreibung zurückgeben

  • Jegliche Zugriffssteuerung muss über einen bestimmten Anmeldemechanismus pro Session oder Anfrage steuerbar sein.

  1. Legen Sie eine neue Add-In-Implementierung an.
    1. Rufen Sie im Customizing das Business Add-In BAdI: Externe Suchmaschinen auf.
    2. Wählen Sie Anlegen, geben Sie einen Implementierungsnamen ein (z.B. CRM_SAF_SE_NEW), und wählen Sie Übernehmen.
    3. Sichern Sie die neue Add-In-Implementierung.
Es wird automatisch eine neue implementierende Klasse generiert.
  1. Rufen Sie die Registerkarte Interface auf, und notieren Sie sich den Namen der implementierenden Klasse.
  • Implementieren Sie die Add-In-Klasse.
    1. Rufen Sie den Class Builder (Transaktion SE24) auf.
    2. Geben Sie den Namen der implementierenden Klasse aus Schritt 1 an, und wählen Sie Ändern.
    3. Implementieren Sie für den Retrieval-Prozess der neuen Suchmaschine Codes für folgende Methoden:
    IF_EX_CRM_SAF_SE~COMPOSE_REQUEST_SEARCH
    erforderlich, um Suchanfragen an die Suchmaschine abzusenden
    Mit Hilfe dieser Methode wird eine Suchanfrage in XML zusammengesetzt und/oder textbasierte Name-Wert-Attribute und Attribut-Queries, die an diese Methode übergeben wurden.
    IF_EX_CRM_SAF_SE~COMPOSE_REQUEST
    nicht unterstützt
    IF_EX_CRM_SAF_SE~PARSE_RESPONSE_SEARCH
    erforderlich zum Parsen von Suchergebnissen, die von der Suchmaschine zurückgegeben wurden
    Diese Methode wird zum Parsen von XML- und/oder Name-Wert-Attributen verwendet, die von der Suchmaschine zurückgegeben wurden. Die Informationen müssen in Tabellen geparst werden, die den Namen der Wissensdatenbank, die ID der Wissensentität, eine Beschreibung und ein Ranking enthalten. So wird z.B. im IC WebClient die von der Suchmaschine gelieferte und in diese Methode geparste Trefferliste in der Sicht Suchergebnisse der Wissenssuche angezeigt.
    IF_EX_CRM_SAF_SE~PARSE_RESPONSE
    nicht unterstützt
    IF_EX_CRM_SAF_SE~PARSE_RESPONSE_CHECK
    nicht unterstützt
    1. Legen Sie HTTP-Destinationen an.
    Für diesen Schritt sind Informationen zu Host, Port und Pfad erforderlich.
    1. Rufen Sie die Anzeige und Pflege von RFC-Destinationen (Transaktion SM59) auf.
    2. Wählen Sie HTTP-Verbindungen zu ext. Server.
    3. Wählen Sie Anlegen.
    4. Geben Sie den Namen und die Beschreibung für die Destination ein sowie den Verbindungstyp G, und wählen Sie Enter.
    5. Geben Sie auf der Registerkarte Technische Einstellungen Informationen zu Host, Port und Pfad an, die für den Zugriff auf die Suchmaschine erforderlich sind.
    6. Wählen Sie Sichern.
    7. Um zu testen, ob eine HTTP-Verbindung eingerichtet ist, wählen Sie Verbindung testen.
  • Benennen und konfigurieren Sie die Suchmaschine.
    1. Rufen Sie im Customizing die Aktivität Suchmaschine benennen und einstellen auf.
    2. Geben Sie einen neuen Namen für die Suchmaschine an, setzen Sie den Suchmaschinentyp auf BAdI-erweiterte Suchmaschine und die Kommunikationsart auf HTTP-Kommunikation. Weitere Einträge sind nicht erforderlich.
  • Ordnen Sie die im vorigen Schritt angelegten HTTP-Destinationen der Suchmaschine zu.
    1. Rufen Sie im Customizing die Aktivität RFC-Destinationen einstellen auf.
    2. Lassen Sie sich vom Assistenten durch diesen Vorgang führen.
    Hinweis
    Die HTTP-Destination für den Indizierungsservice wird nicht unterstützt. Machen Sie in diesem Feld daher keine Eingabe.
    1. Benennen und konfigurieren Sie die Wissensdatenbanken, auf die die Suchmaschine zugreifen soll.
      1. Rufen Sie im Customizing die Aktivität Wissensdatenbank benennen und einstellen auf.
      2. Lassen Sie sich vom Assistenten durch diesen Vorgang führen. Geben Sie dabei die Wissensdatenbank und die Sprache an, und ordnen Sie der Wissensdatenbank den Suchmaschinennamen zu.

    Unbeschränkte Integration für Suche

    Unbeschränkte Integration kann implementiert werden, wenn zusätzliche Kommunikation (zusätzlich zu HTTP) zwischen SAP und der Suchmaschine oder dem Content-Management-System des Drittanbieters erforderlich ist. Sie können solch eine Integration folgendermaßen aufbauen:

    1. Legen Sie eine neue ABAP-Klasse an, indem Sie die ABAP-Klasse CL_CRM_SAF_SE_GENIL erweitern.
    Implementieren Sie die neue ABAP-Klasse. Einen Beispielcode finden Sie in der ABAP-Klasse CL_CRM_SAF_SE_HTTP. Um eine Suchfunktion zur Verfügung zu stellen, implementieren Sie die Methode IF_CRM_SAF_SE_GENIL~SEARCH. Detaillierte Beschreibungen der Methoden finden Sie im SAP Help Portal (http://help.sap.com/) unter Software-Agent-Framework -> Suchmaschine.
    1. Benennen Sie die Suchmaschine, und stellen Sie sie ein.
      1. Rufen Sie im Customizing die Aktivität Suchmaschine benennen und einstellen auf, geben Sie einen neuen Suchmaschinennamen ein, und stellen Sie als Suchmaschinentyp BAdI-erweiterte Suchmaschine sowie die erforderliche Kommunikationsart ein.
      2. Um den Suchmaschinenservice umzuleiten, geben Sie den Namen der von Ihnen angelegten ABAP-Klasse ein.
      3. Machen Sie bei Bedarf weitere Eingaben.
    2. Rufen Sie im Customizing die Aktivität Wissensdatenbank benennen und einstellen auf, und verknüpfen Sie die Suchmaschine mit der Wissensdatenbank, auf die die Suchmaschine zugreifen soll.

    Integration mit externen Indizierungsprozessen

    Vom Konzept her verhält sich das Suchmaschinen-API des SAF wie ein Meta-Layer, wo je nach Konfiguration verschiedene Anfragen von verschiedenen Datenquellen an verschiedene Suchmaschinen weitergeleitet werden können.

    Um die Integration zu implementieren, gehen Sie folgendermaßen vor:

    1. Legen Sie eine neue ABAP-Programmierungsklasse an, um den Integration-Layer aufzubauen, indem Sie eine Superklasse CL_CRM_SAF_SE_GENIL vererben.
    2. Implementieren Sie die einzelnen Methoden abhängig von der erforderlichen Funktionalität.
    Es gibt Beispielcodes für:
    • CL_CRM_SAF_SE_HTTP

    verwendet für Standard-HTTP-Integration
    • CL_CRM_SAF_SE_TREX_ABAP

    verwendet für CRM-ABAP-Stack

    Die übrigen Schritte sind davon abhängig, welche Konfiguration des SAF Sie verwenden:

    • ABAP-Konfiguration
    1. Rufen Sie im Customizing die Aktivität Suchmaschine benennen und einstellen auf, geben Sie einen neuen Suchmaschinennamen ein, und richten Sie die Suchmaschine auf die neu angelegte ABAP-Klasse aus.
    2. Sie können (bei Bedarf) in der Aktivität Wissensdatenbank benennen und einstellen die Standardsuchmaschine auf die neue Suchmaschine ausrichten, indem Sie als Wissensdatenbank ALL und als Sprache EN auswählen. Sie können auch die Suchmaschine jeder einzelnen Wissensdatenbank zuordnen.
    • keine ABAP-Konfiguration
    1. Rufen Sie im Customizing die Aktivität Suchmaschine benennen und einstellen auf, geben Sie einen neuen Suchmaschinennamen ein, und geben Sie als Suchmaschinentyp Programmerweiterte Suchmaschine an. Die Kommunikationsart kann entweder HTTP-Kommunikation oder Sonstige sein. Wenn Sie über diese Informationen verfügen, können Sie auch HTTP-Such-Server, Queue-Server und Index-Server einstellen. Diese Einstellungen sind nur dann relevant, wenn die Kommunikation über HTTP stattfindet.
    2. Führen Sie die Transaktion CRMC_SAF_ADV_CLIENT durch.
    3. Wählen Sie im Navigationsbereich auf der linken Seite SAP Suchmaschine per Doppelklick.
    4. Wählen Sie im Arbeitsbereich den Suchmaschinennamen aus, und wählen Sie, wenn diese implementiert sind, Indizieren und Clustering.
    5. Wählen Sie im Navigationsbereich auf der linken Seite Suchmaschinenerweiterung per Doppelklick.
    6. Stellen Sie im Arbeitsbereich sicher, dass der neu angelegte Suchmaschinenklassenname für die ABAP-Klasse eingetragen ist.
    7. Sichern Sie Ihre Daten.
    8. Wählen Sie im Navigationsbereich auf der linken Seite Kompilierungsservice per Doppelklick. Im Arbeitsbereich sehen Sie eine Zuordnung zwischen Wissensdatenbanken und Suchmaschinen. Die Standardsuchmaschine ist der Wissensdatenbank ALL für die Sprache EN zugeordnet. Das bedeutet, dass alle Wissensdatenbanken ohne spezielle Zuordnung diese Suchmaschine standardmäßig verwenden. Bei Bedarf können Sie die neue Suchmaschine als Standardsuchmaschine einstellen. Oder Sie können neue Einträge anlegen, um die Zuordnung zwischen jeder Wissensdatenbank/Sprache und Suchmaschine anzugeben.





    Vendor Master (General Section)   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
    Diese Dokumentation steht unter dem Copyright der SAP AG.

    Length: 15201 Date: 20240520 Time: 165407     sap01-206 ( 218 ms )