Ansicht
Dokumentation

ECSFO001 - IS-U: Finder-Erweiterungen im Customer Interaction Center

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Erweiterung

Die Erweiterung ESCFO001 ermöglicht es Ihnen, die Suchfunktionalität des IS-U-Finders im Customer Interaction Center (CIC) nach Ihren Wünschen anzupassen.

Folgende Erweiterungen sind vorgesehen:

• Erweiterung der Struktur aller anzeigbaren Suchkriterien und Felder

• Funktionsbaustein zur Auswertung der eigenen Suchfelder vor der Suche

• Erweiterungs-Subscreen für die CIC-Komponente ISUFINDER

• Erweiterungs-Subscreen für die CIC-Komponente ISUSDPART

Sie können diese Erweiterungen, die nachstehend ausführlich beschrieben werden, unabhängig voneinander nutzen.

Erweiterung der Struktur aller anzeigbaren Suchkriterien und Felder

Diese Erweiterung besteht aus der folgenden Komponente:

• Customer-Include CI_EFINDD

Nehmen Sie alle Felder in diese Struktur auf, die Sie in Ihr Kundensubscreen aufnehmen wollen und die nicht in der Struktur EFINDPAR enthalten sind. Um am Ende zu prüfen, welche Felder Sie insgesamt in Ihren Kundensubscreen aufnehmen können, prüfen Sie die Struktur EFINDD_CIC.

Die Felder können Sie als zusätzliche Suchkriterien für die freien Selektionen des IS-U-Data-Finders (s.u.) oder - nur im alten Layout bei Verwendung der Komponente ISUFINDER - zur Versorgung der Action-Box-Aufrufe mit Parameterwerten verwenden.

Funktionsbaustein zur Auswertung der eigenen Suchfelder vor der Suche

Dieser Funktionsbaustein dient der Auswertung oder Aufbereitung eigener Suchkriterien zur eigentlichen Suche mit dem IS-U-Finder.

Die Erweiterung besteht aus der folgenden Komponente:

• Funktionsbaustein EXIT_SAPLEECIC_COMP00_001

Dieser Funktionsbaustein wird aufgerufen, bevor die eigentliche Suche ausgeführt wird. Hier können Sie aus Ihren neuen Suchkriterien in der Struktur CI_EFINDD (s.o.) die Freien Selektionen des Data-Finders aufbauen, damit die eingegebenen Werte vom Finder bei der Suche ausgewertet werden können.

Weitere Informationen finden Sie in der Funktionsbausteindokumentation.

Erweiterungs-Subscreen für die Komponente ISUFINDER

Mit dieser Erweiterung können Sie eigene Subscreens für die Suchkriterien im CIC anzeigen. Im alten Layout betrifft dies die Komponente ISUFINDER, die die Suchkriterien für die implizite Findersuche zum Prozess-Start (Action-Box) bereitstellt.

Die Erweiterung besteht aus folgenden Komponenten:

• Erweiterungssubscreen in der Funktionsgruppe XEECICCOMP02 (Bildschirm 0100 oder beliebige andere Bildschirme)

Legen Sie in der Erweiterungs-Funktionsgruppe einen oder mehrere Subscreens in der maximalen Größe 80 Spalten auf 18 Zeilen (die maximale Größe verringert sich entsprechend, wenn Sie die Komponentenvariante mit Rahmen verwenden oder Ihren Subscreen zusätzlich zu den Originalfeldern anzeigen) an. Ordnen Sie die von Ihnen gewünschten Felder aus der Struktur EFINDD_CIC auf dem Subscreen an. Nur für diese Felder erfolgt ein automatischer Werteaustausch mit der Komponente ISUFINDER. In den Standardeinstellungen nicht vorgesehene Felder nehmen Sie vorher in das Customer Include CI_EFINDD auf. Die Felder dieser Erweiterung sind ebenfalls automatisch in der Struktur EFINDD_CIC enthalten.

• Funktionsbaustein EXIT_SAPLEECIC_COMP02_001

Dieser Funktionsbaustein wird vor dem PBO Ihres Erweiterungs-Subscreens aufgerufen. Sie erhalten hier die Werte der Suchkriterien (Struktur EFINDD_CIC), den Namen des Felds, auf das der Cursor positioniert werden soll, sowie das aktuelle Action-Box-Profil.

Als Rückgabewert wird die Nummer des anzuzeigenden Bildschirms erwartet. Sie können außerdem per Rückgabewert bestimmen, ob Ihr Subscreen unterhalb des ausgelieferten Bilds zum Data-Finder angezeigt werden soll oder diesen ganz ersetzen soll. Zur Laufzeit können Sie anhand des aktiven Profils der Aktivitätenleiste bestimmen, welcher Ihrer Subscreens angezeigt werden soll.

Wenn Sie die Erweiterung nicht nutzen oder die Dynpronummer 0000 zurückgeben, werden statt dieser Erweiterung die Standardeinstellungen verwendet.

• Funktionsbaustein EXIT_SAPLEECIC_COMP02_002

Dieser Funktionsbaustein wird nach dem PAI Ihres Erweiterungs-Subscreens aufgerufen. Er dient zur Übernahme der Werte der Suchkriterien (Struktur EFINDD_CIC) sowie gegebenenfalls des Namens des Felds, auf dem der Cursor stand, in die Komponente ISUFINDER.

Beachten Sie das Feld EFINDD_EXIT_STD_FLDS_NO_CLEAR in der Struktur EFINDD_CIC, welches Sie zusammen mit den Suchparametern im Exportparameter Y_FINDER_FIELDS übergeben. Das Kennzeichen wird vom System immer gesetzt mit Wert 'X' in den User-Exit übergeben.

Das Kennzeichen sollte gesetzt bleiben, wenn Sie die Standardsuchfelder der Struktur EFINDD_CIC in diesem User-Exit unverändert lassen. D.h., dass Sie in der Implementierung des User-Exit nur die Feldwerte in der Include-Struktur CI_EFINDD modifiziert haben.

Löschen Sie das Kennzeichen nur, wenn Sie in ihrer Implementierung des User-Exit die Feldwerte in der Struktur EFINDD_CIC, die nicht zur Include-Struktur CI_EFINDD gehören, gelöscht oder anderweitig modifiziert haben.

Erweiterungs-Subscreen für die Komponente ISUSDPART

Mit dieser Erweiterung können Sie eigene Subscreens für die Suchkriterien im CIC anzeigen. Dies betrifft im neuen, L-förmigen Layout die Geschäftspartnerkomponente ISUSDPART zur Identifikation und Anzeige des aktuellen Geschäftspartners.

Die Erweiterung besteht aus folgenden Komponenten:

• Erweiterungssubscreen in der Funktionsgruppe XEECICCOMP02 (Bildschirm 0099 oder beliebige andere Bildschirm)

Legen Sie in der Erweiterungs-Funktionsgruppe einen oder mehrere Subscreens in der maximalen Größe 35 Spalten auf 5 Zeilen an. Wenn Sie diese Größenbeschränkung nicht einhalten, werden automatisch Rollbalken eingeblendet, mit denen Sie über den Subscreenbereich scrollen können. Ordnen Sie die von Ihnen gewünschten Felder aus der Struktur EFINDD_CIC auf dem Subscreen an. Nur für diese Felder erfolgt ein automatischer Werteaustausch mit der Komponente ISUSDPART. In den Standardeinstellungen nicht vorgesehene Felder nehmen Sie vorher in das Customer-Include CI_EFINDD auf. Die Felder dieser Erweiterung sind ebenfalls automatisch in der Struktur EFINDD_CIC enthalten. Achten Sie darauf, dass Sie die Suchfelder grundsätzlich nicht - wie bei der Komponente ISUFINDER - für die Parametrierung von Action-Box-Aufrufen verwenden.

In dieser Erweiterung wird grundsätzlich der gesamte Bereich der Geschäftspartner-Suchfelder ersetzt. Die Funktionstasten bleiben jedoch weiterhin automatisch sichtbar und müssen sich nicht auf Ihrem Subscreen befinden.

• Funktionsbaustein EXIT_SAPLEECIC_SD_001

Dieser Funktionsbaustein wird vor dem PBO Ihres Erweiterungs-Subscreens aufgerufen. Sie bekommen hier die Werte der Suchkriterien (Struktur EFINDD_CIC), den Namen des Felds, auf das der Cursor positioniert werden soll, sowie das aktuelle Action-Box-Profil übergeben. Sie erhalten auch ein Feld, das Ihnen anzeigt, ob sich die Komponente im Suchmodus (Suchkriterien eingabebereit) oder im Partner-Anzeige-Modus befindet. In diesem Fall sollten nur Felder sichtbar sein, die sich auf den Geschäftspartner beziehen, und diese sollten nicht eingabebereit sein.

Als Rückgabewert wird die Nummer des anzuzeigenden Bildschirms erwartet. Zur Laufzeit können Sie anhand des aktiven Profils der Aktivitätenleiste oder des Komponentenmodus bestimmen, ob und welcher Ihrer Subscreens angezeigt werden soll.

Wenn Sie die Erweiterung nicht nutzen oder die Bildschirmnummer '0000' zurückgeben, werden statt dieser Erweiterung die Standardeinstellungen verwendet. Sie können also beispielsweise im Suchmodus einen eigenen Subscreen, im Anzeigemodus jedoch die Standardeinstellungen oder einen anderen eigenen Subscreen verwenden.

• Funktionsbaustein EXIT_SAPLEECIC_SD_002

Dieser Funktionsbaustein wird nach dem PAI Ihres Erweiterungs-Subscreens aufgerufen. Er dient zur Übernahme der Werte der Suchkriterien (Struktur EFINDD_CIC) sowie gegebenenfalls des Namens des Felds, auf dem der Cursor stand, in die Komponente ISUSDPART. Diese Erweiterung wird nur im Suchmodus angesprungen, eine Datenübernahme erfolgt im Anzeigemodus nicht.

Hinweis

Um Drucktasten in den Kunden-Subscreen zu integrieren, gehen Sie wie folgt vor:

1. Fügen Sie die Drucktaste mit dem Screen-Painter ein.
2. Vergeben Sie einen OK-Code für die Drucktaste, der von keiner anderen CIC-Komponente verwendet wird.
3. Um auf diesen OK-Code zu reagieren, erstellen Sie eine neue CIC-Komponente, die diesen OK-Code abonniert und die gewünschte Aktion ausführt.

Als Vorlage für eine solche CIC-Komponente können Sie sich die Funktionsgruppe EECIC_COMP01 kopieren und die nötigen Anpassungen durchführen.

In der Komponente ISUFINDER sind die beiden folgenden Sonderfälle vereinfacht implementierbar:

• die Drucktaste zur Vollbildanzeige des Data Finders

• die Drucktaste zum Initialisieren der Suchfelder

Hier genügt es, die Drucktasten in das Kundensubscreen aufzunehmen und als OK-Codes 033M bzw. 034M zu vergeben.

Beispiel

In der Funktionsgruppe XEECICCOMP02 ist Beispiel-Coding für die Einbindung von eigenen Subscreens für die Suchkriterien in die Komponenten ISUFINDER und ISUSDPART enthalten. Dies umfasst neben dem Beispiel-Coding für die Funktionsbausteine auch Beispiel-Coding für die Bildschirm-Ablauflogik sowie für die PBO- und PAI-Module.

Für das Beispiel zu ISUFINDER steht außerdem Beispiel-Coding einer Form zur Verfügung, mit dem die Ikone für die Drucktaste Alle Suchkriterien berechnet werden kann.

Include	Beispiel
LXEECICCOMP02F01	User Exit EXIT_SAPLEECIC_COMP02_001
LXEECICCOMP02F02	User Exit EXIT_SAPLEECIC_COMP02_002
LXEECICCOMP02F03*	User Exit EXIT_SAPLEECIC_COMP00_001
LXEECICCOMP02F04	User Exit EXIT_SAPLEECIC_SD_001
LXEECICCOMP02F05	User Exit EXIT_SAPLEECIC_SD_002
LXEECICCOMP02_TO	TOP-Include passend zu den Userexits
LXEECICCOMP02_DY	Kundensubscreen Ablauflogik
LXEECICCOMP02_PB	Kundensubscreen PBO-Module
LXEECICCOMP02_PA	Kundensubscreen PAI-Module
LXEECICCOMP02_FO	Unterprogramme (FORMS)

(Die mit * gekennzeichneten Includes enthalten kein Coding.)

Das zu den Erweiterungs-Funktionsbausteinen hinterlegte Beispielcoding können Sie vereinfacht übernehmen:

1. Markieren Sie im Einstiegsbild der Projektverwaltung von SAP-Erweiterungen (Transaktion CMOD) Erweiterungskomponenten und wählen Sie Ändern.
2. Setzen Sie den Mauszeiger auf die gewünschte Funktionserweiterung und wählen Sie Bearbeiten -> SAP-Quelltext übern.

Das andere Beispielcoding müssen Sie in der Funktionsgruppe XEECICCOMP02 per Cut&Paste in selbst erstellte Includes übernehmen.

General Material Data   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 13668 Date: 20240426 Time: 150108     sap01-206 ( 221 ms )