Ansicht
Dokumentation

/IPRO/INSERT_ELM - Elemente prüfen

Fill RESBD Structure from EBP Component Structure   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Mit diesem Business Add-In können Sie festlegen, ob ein Element in ein Dokument eingefügt werden soll.

Dieses Business Add-In besteht aus den im Folgenden beschriebenen Methoden: Sie können die Methode anstelle des Standardalgorithmus verwenden. Mit dem Standardalgorithmus können Benutzer des SAP Document Builder auf der Benutzeroberfläche beliebige Elemente in das Dokument einfügen - vorausgesetzt, das Element wurde nicht bereits in das Dokument eingefügt.

Folgende Importparameter werden benötigt:

• IO_DOCUMENT
  Referenz zum Interface /IPRO/IF_DOCUMENT, mit dessen Methoden Sie alle in einer Dokumentinstanz enthaltenen Elemente und Variablen ermitteln können. Die Methode GET_ELEMENT_LIST dieses Interfaces gibt eine Referenz zum Interface /IPRO/IF_DOCB_SECTION zurück, das den Elementbaum des Dokuments enthält. Mit der Methode LOOKUP dieses Interfaces können Sie über den Elementnamen jedes in einem Dokument enthaltene Element finden.

• IO_ELEMENT
  Referenz zum Interface /IPRO/IF_DOCB_ELEMENT. Dieses Interface enthält eine Referenz zum Element, das eingefügt werden soll. Das Interface enthält eine Reihe von Methoden, mit denen Sie alle mit dem Element verknüpften Attribute abfragen können.

Folgende Rückgabeparameter sind verfügbar:

• RV_VALID
  Boolescher Wert, mit dem sich festlegen lässt, ob das Element in das Dokument eingefügt wird.

Mit der Methode GET_ELEMENT_LIST des Interfaces /IPRO/IF_DOCUMENT können Sie eine Referenz zum Elementbaum des Dokuments ermitteln. Anschließend können Sie mit der Methode GET_CHILDREN des Interfaces /IPRO/IF_DOCB_SECTION alle Referenzen IPRO/IF_DOCB_ELEMENT für sämtliche im Dokument enthaltenen Elemente ermitteln. Sie sind dann in der Lage, auf Grundlage der Bereits im Dokument enthaltenen Elemente zu entscheiden, ob Sie das betreffende Element einfügen möchten.

Nach dem Aufruf der IMG-Aktivität gelangen Sie auf ein Dialogfenster, in dem Sie einen Namen für die Implementierung vergeben können.

Sollten Sie für dieses BAdI bereits andere Implementierungen durchgeführt haben, gelangen Sie auf ein anderes Dialogfenster, das die vorhandenen Implementierungen anzeigt. Wählen Sie in diesem Falle Anlegenund fahren Sie folgendermaßen fort:

1. Geben Sie im Implementierungsfeld des Dialogfensters einen Namen für die BAdI-Implementierung ein und wählen Sie Anlegen.

Sie gelangen auf das Bild zur Anlage von BAdI-Implementierungen.

2. Geben Sie im Feld Kurztext für Implementierung einen Kurztext für die Implementierung ein.

3. Wählen Sie im Registerindex Schnittstelle.

Das Feld Name der implementierten Klasse auf der Registerkarte enthält bereits einen Eintrag, da der Implementierung automatisch ein Klassenname zugeordnet wurde, als Sie diese benannt haben.

4. Sichern Sie Ihre Einträge und ordnen Sie die Implementierung einer Entwicklungsklasse zu.

5. Positionieren Sie den Cursor auf der Methode und führen Sie einen Doppelklick aus, um die Methodenbearbeitung anzustoßen.

6. Geben Sie das Coding für die Implementierung zwischen folgenden Anweisungen ein: method ~ und endmethod.

7. Sichern und implementieren Sie Ihr Coding. Kehren Sie zum Bild Implementierung bearbeiten zurück.

8. Sichern Sie die Einträge im Bild Implementierung bearbeiten.

Hinweis: Sie können eine Implementierung auch anlegen und erst zu einem späteren Zeitpunkt aktivieren. Beenden Sie die Bearbeitung in diesem Fall an diesem Punkt.

9. Wählen Sie Aktivieren.

Das in den Methoden gesicherte Coding wird beim Ausführen des Anwendungsprogramms ausgeführt.

Ein Benutzer sollte ein Standardelement nicht in ein Dokument einfügen können, wenn das Standardelement bereits in das Dokument eingefügt wurde und anschließend in ein benutzerdefiniertes Element konvertiert wurde.

Weiterführende Informationen zur Verwendung von Business Add-Ins finden Sie in der SAP-Bibliothek unter Basis → ABAP Workbench (BC-DWB) → Änderungen des SAP-Standards (BC) → Business Add-Ins.

General Material Data   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5377 Date: 20240419 Time: 194526     sap01-206 ( 79 ms )