Ansicht
Dokumentation

TFW_SHOW_WHERE_USED - Ausgabe Verwendungsnachweis für Minivorlagen und Vorlagen

TFW_SHOW_WHERE_USED - Ausgabe Verwendungsnachweis für Minivorlagen und Vorlagen

ABAP Short Reference   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Dieses Business Add-In (BAdI) wird in der Komponente Template Framework (AP-MD-BF-TFW) verwendet. Es kommt zum Einsatz, wenn im Template Framework Customizing Änderungen an Minivorlagen, Vorlagen oder der Zuordnung von Minivorlagen zu Vorlagen durchgeführt werden. Mit Hilfe der Methoden aus den BAdIs TFW_MINITP und TFW_TEMPLATE wird ermittelt, auf welche Anwendungsobjekte sich die Änderungen auswirken würden. Das Resultat dieses Verwendungsnachweises wird in der Methode CALL_WHERE_USED_POPUP übergeben. In Ihrer BAdI-Implementierung wird erwartet, dass Sie das Ergebnis des Verwendungsnachweises visualisieren und eine evtl. vom Anwender veranlasste Ablehnung seiner Änderungen zurückmelden. Zur Visualisierung des Verwendungsnachweis wird vom Template Framework der Funktionsbaustein TFW_WHERE_USED_POPUP angeboten, den Sie verwenden können aber nicht müssen.

Die Methoden des BAdIs kommen zum Einsatz:

  • Wenn im Fall des Änderns einer Minivorlage, die Minivorlagenart der betroffenen Minivorlage einen Referenzierungstyp besitzt, der auf eine Referenz hinweist.
  • Wenn im Fall des Löschens einer Vorlage, die Vorlagenart der betroffenen Vorlage den Vorlagentyp nur Referenz möglich besitzt
  • Wenn im Fall des Änderns der Zuordnung einer Minivorlage zu einer Vorlage, die Vorlagenart der betroffenen Vorlage den Vorlagentyp nur Referenz möglich besitzt.
  • Es muss sich um Änderungen halten, die sich auf die Verwender der Minivorlage bzw. der Vorlage auswirken. In folgenden Situationen würden beispielsweise die Methoden nicht aufgerufen werden:
  • Wenn eine Änderung an der Bezeichnung einer Minivorlage oder einer Vorlage vorgenommen wurde

  • Wenn eine Vorlage oder eine Minivorlage hinzugefügt wurde

Die BAdIs TFW_READ, TFW_DISTRIBUTE, TFW_MINITP, TFW_MINITP_DEL_CHECK, TFW_SHOW_WHERE_USED, TFW_TEMPLATE, TFW_TEMPLATE_UPDATE und TFW_TP01_DEL_CHECK stehen den Anwendungsobjekten des Template Framework zur Verfügung, die die Verwendung von Vorlagen und/oder Minivorlagen ermöglichen wollen.

Die BAdIs TFW_MINITP, TFW_MINITP_DEL_CHECK, TFW_TEMPLATE, TFW_TEMPLATE_UPDATE, TFW_TP01_DEL_CHECK und TFW_SHOW_WHERE_USED sind zu implementieren, da sie während der Pflege der Vorlagen und Minivorlagen innerhalb des Template Framework selbst zum Einsatz kommen.

Die BAdIs TFW_READ und TFW_DISTRIBUTE müssen nicht unbedingt implementiert werden; ihre Methoden werden nicht aus dem Template Framework heraus aufgerufen. Sie sind allerdings hilfreich, wenn zu einem Anwendungsobjekt, dem eine Vorlage oder Minivorlage zugeordnet ist, die aktuell gültigen Daten zu ermitteln sind (BAdI TFW_READ) bzw. falls die Änderungen, die sich aufgrund einer Vorlagen- oder Minivorlagenänderungen an den Anwendungsobjekten ergeben an angeschlossene Systeme verteilt werden sollen (BAdI TFW_DISTRIBUTE).

Das BAdI ist filterabhängig. Filterkriterium ist das Anwendungsobjekt des Template Framework.

Nach dem Aufruf der IMG-Aktivität gehen Sie folgendermaßen vor:

  1. Geben Sie im folgenden Dialogfenster im Feld Implementierung einen Namen für die Implementierung des BAdIs ein und wählen Sie Übernehmen.
Falls bereits Implementierungen zu dem BAdI angelegt wurden, erscheint ein Dialogfenster mit den existierenden Implementierungen. Wählen Sie in diesem Dialogfenster Anlegen.
  1. Geben Sie im entsprechenden Feld einen Kurztext zur Implementierung ein.
  2. Fügen Sie im Register EigenschaftenFilter-Ausprägungen ein, wenn es sich um ein filterabhängiges BAdI handelt.
  3. Wählen Sie das Register Interface.
Der Name der implementierenden Klasse wird vom System aufgrund des Namens Ihrer Implementierung generiert. Der Name kann geändert werden.
Sofern das BAdI ein Menü-Exit ist, erscheint zusätzlich die Registerkarte FCodes. Geben Sie hier einen Funktionstext und gegegbenenfalls weitere Daten ein.
  1. Sichern Sie Ihre Eingaben und ordnen Sie ein Paket zu.
  2. Positionieren Sie den Cursor jeweils auf eine Methode. Rufen Sie den Class Builder mit einem Doppelklick auf.
  3. Geben Sie zwischen den Anweisungen method ~. und endmethod. das von Ihnen gewünschte Coding zur Implementierung ein.
  4. Sichern und aktivieren Sie Ihr Coding und navigieren Sie zurück zum Bild Ändern Implementierung.
  5. Sichern Sie auf dem Bild Ändern Implementierung.
Hinweis: Sie können für ein BAdI zunächst eine Implementierung anlegen und diese später aktivieren. In diesem Fall schließen Sie die Bearbeitung zum jetzigen Zeitpunkt ab.
  1. Wählen Sie Aktivieren.
Bei der Ausführung des Anwendungsprogramms wird das von Ihnen angelegte Coding durchlaufen.

Aufgrund der Filterabhängigkeit des BAdIs müssen Sie für Ihre Implementierung eine Filterausprägung angeben. Wählen Sie als Filterausprägung Ihr Anwendungsobjekt des Template Frameworks.

Methods

Übergabe Verwendungsnachweis zwecks Ausgabe im Popup






PERFORM Short Reference   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6538 Date: 20240523 Time: 083658     sap01-206 ( 109 ms )