Ansicht
Dokumentation

CREATE_NOTE_01 - Annotation ohne Dialog erzeugen und einfügen

General Material Data   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein CREATE_NOTE_01 zeigt wie ein Verlaufseintrag vom Typ TEST00 in ein vorhandenes Verlaufsdokument direkt mit der Verlaufseintragsschnittstelle erzeugt und eingefügt werden kann. Im Gegensatz zum Beispiel Funktionsbaustein CREATE_NOTE_00 wird dadurch die Kundenerweiterung für die Dialogeingabe nicht aufgerufen.

Beispiel

Die folgenden Schritte sind im Quellcode identisch markiert.

1. Get VD open service
   Die Service-Methode öffnet ein vorhandenes Verlaufsdokument (VD) und gibt das erweiterte Schnittstellenobjekt zurück. Die erweiterte Schnittstelle stellt nun Dokument bezogene Methoden wie das Speichern des Dokumentes und Methoden zum Anzeigen, Bearbeiten und Erfassen von Verlaufseinträgen bereit. Die ändernden Methoden können nur ausgeführt werden, wenn das Verlaufsdokument im Bearbeitungsmodus geöffnet wird. Über Kriterien wie bspw. zu bearbeitende Verlaufseintragstypen und Dokumentationszeiträume lässt sich die potenzielle Bearbeitungsmenge einschränken.
2. Generate note, link it to notes collection without BAdI I/O-stream
   Unter Verwendung der Programmierschnittstelle Verlaufseintrag lässt sich mit der Methode cl_ishmed_vd_note=>create ein neuer Verlaufseintrag zum VD hinzufügen. Der Verlaufseintrag hat im Beispiel die Kategorie TEST00. Die Methode liefert die Referenz auf das neue Verlaufseintragsobjekt. Verlaufseinträge residieren der Objeksammlung notes NOTES COLLECTION. Die Objektsammlung wird in der Schnittstelle bekanntgegegeben. Mit der Service - Schnittstelle notes = service->get_notes( ) erhalten Sie die Referenz auf die Objektsammlung innerhalb des geöffneten Verlaufsdokumentes.
3. Create Note's Annotation
   Die Methode annotation ?= note->create_item( ) erzeugt ein Item vom Typ Annotation.
4. Set annotation text
   Die Methode annotation->add_text( text_table = text ) ermöglicht die Zuweisung des Freitextes zum Annotationsobjekt.
5. Save
   Das Speichern des VD erfolgt mit der Service Methode service->save( ). Dabei werden die Änderungen aller beteiligten Objekt geschrieben. In diesem Fall sind es die Daten der Annotation und des neuen Verlaufseintrags. Es wird ein Anlageprotokoll geführt. Die Speicherung in der Datenbank wird erst mit einem expliziten oder impliziten COMMIT WORK festgeschrieben.
6. Close service object
   Die Methode CLOSE schliesst die Service-Schnittstelle und gibt allozierte Ressourcen frei. Die Methode sollte immer am Ende der Bearbeitung gerufen werden. Das Service-Schnittstellenobjekt ist nach CLOSE initial!

Hinweise

Sollten Sie noch kein Verlaufsdokument für den Test zur Verfügung haben, legen Sie dieses bitte mit dem Funktionsbaustein CREATE_VDOCUMENT an.

Weiterführende Informationen

Parameter

DB_COMMIT
DESCR
DOCUNIT
RESPUSR
TEXT
VDKEY
VDTYPE

Ausnahmen

ERR_NOTE
ERR_SRV_OPEN

Funktionsgruppe

N2_VD_SERVICE

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

Length: 4049 Date: 20240523 Time: 133339     sap01-206 ( 85 ms )