Ansicht
Dokumentation

TFW_TEMPLATE - Verwendungen von Vorlagen des Template Frameworks

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

Dieses Business Add-In (BAdI) wird in der Komponente Template Framework (AP-MD-BF-TFW) verwendet und kommt bei der Ermittlung, welche Anwendungsobjekte eine Vorlage verwenden zum Einsatz. Dies ist der Fall:

• Wenn Sie im Customizing des Template Framework eine Minivorlage ändern oder eine Vorlage löschen wollen.

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

• Es muss sich um Änderungen handeln, 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 Vorlage vorgenommen wird.

• Wenn eine Vorlage hinzugefügt wird.

Das Löschen einer Vorlage wirkt sich auf die Anwendungsobjekte aus, die auf die Vorlage referenzieren. Sobald im Template Framework Customizing das Löschen einer Vorlage versucht wird, werden mittels der Methode WHERE_USED_TP die Anwendungsobjekte ermittelt, denen die Vorlage zugeordnet ist. Eine Löschung wird vom System abgelehnt, solange es noch solche Anwendungsobjekte gibt.

Änderungen an einer Vorlage wirken sich nicht auf die Anwendungsobjekte aus, die auf die Vorlage referenzieren. Dies gilt deshalb, weil einer Vorlage nur Minivorlagen zugeordnet sein können und der Zugriff auf die Instanzdaten über diese Minivorlagen erfolgt.

Änderungen an einer Minivorlage im Template Framework Customizing wirken sich nicht nur auf die Anwendungsobjekte aus, denen die Minivorlage direkt zugeordnet ist, sondern auch auf die Anwendungsobjekte denen die Minivorlage über eine Vorlage zugeordnet ist. Deshalb wird in dieser Situation nicht nur die Methode WHERE_USED_MINITP des BAdIs TFW_MINITP aufgerufen, sondern auch die Methode WHERE_USED_TP des BAdIs TFW_TEMPLATE. Da es aber sein kann, dass die dabei ermittelten Anwendungsobjekte mit anderen Daten (z.B. eigenen Daten) statt den über die Vorlage zugeteilten Minivorlage-Daten arbeiten, wird anschließend ebenfalls die Methode NOT_USED_MINITP des BAdIs TFW_MINITP aufgerufen (s.a. die Dokumentation des BAdI TFW_MINITP).

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. Das Filterkriterium setzt sich zusammen aus:

• Anwendungsobjekt des Template Framework,

• Lesemethode

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 das Anwendungsobjekt und die Lesemethode für die Sie eine Implementierung der Methoden vornehmen möchten.

Methods

Objekte, denen eine Vorlage zugeordnet ist

PERFORM Short Reference   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 7268 Date: 20240523 Time: 054618     sap01-206 ( 125 ms )