Ansicht
Dokumentation

SO_FOLDER_MOVE_API1 - SAPoffice: Umhängen einer Mappe für Externe (RFC)

CPI1466 during Backup   ROGBILLS - Synchronize billing plans  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein ermöglicht das Umhängen einer Mappe in eine andere Mappe. Die Zielmappe darf dabei nicht innerhalb des Mappenbaums der abzulegenden Mappe enthalten, bereits Elternmappe der abzulegenden Mappe oder mit dieser identisch sein. Das Ablegen zwischen der allgemeinen und der persönlichen Ablage eines Benutzers ist nicht zulässig. Es ist außerdem nicht möglich, die private oder allgemeine Wurzelmappe als Quellmappe sowie den Eingang, Ausgang, Papierkorb oder die Mappe für Wiedervorlagen als Quell- oder Zielmappe auszuwählen.

Importparameter

FOLDER_ID

Objekt-ID der Mappe, die abgelegt werden soll.

NEW_PARENT_FOLDER_ID

Okjekt-ID der Zielmappe.

Ausnahmen

NEW_PARENT_FOLDER_NOT_EXIST

Die angegebene Zielmappe existiert nicht. Wahrscheinlich wurde entweder eine falsche ID übergeben oder die betroffene Mappe mittlerweile gelöscht.

FOLDER_NOT_EXIST

Die Mappe, die abgelegt werden soll, existiert nicht. Wahrscheinlich wurde entweder eine falsche ID mitgegeben oder die betroffene Mappe mittlerweile gelöscht.

OPERATION_NO_AUTHORIZATION

Das angegebene Mappe durfte nicht abgelegt werden. Dies kann z.B. daran liegen, daß es sich um die persönliche Mappe eines anderen Benutzers oder um eine Mappe in der allgemeinen Ablage, für die der aktive Benutzer keine Änderungsberechtigung besitzt, handelt.

PARAMETER_ERROR

Es wurde dem Funktionsbaustein eine unzulässige Kombination von Parameterwerten übergeben. Möglicherweise wurde versucht, eine unzulässige Mappe (Eingang, Ausgang, Wiedervorlagen-Mappe oder die Wurzelmappe der privaten oder allgemeinen Ablage) zu verschieben oder ein Ablegen zwischen persönlicher und allgemeiner Ablage veranlaßt. Der Eingang, Ausgang und die Wiedervorlagen-Mappe können selbst keine weiteren Mappen beinhalten.

X_ERROR

Es ist ein interner Fehler oder eine Datenbankinkosistenz aufgetreten.

ENQUEUE_ERROR

Die zum Ablegevorgang gehörenden Mappen konnten nicht gesperrt werden. Wahrscheinlich findet gerade eine Bearbeitung durch einen anderen Benutzer statt.

Beispiel

Ablegen einer Mappe aus der privaten Wurzelmappe in eine andere Mappe innerhalb der persönlichen Wurzelmappe. Zum Bestimmen der ID der persönlichen Wurzelmappe wird der Funktionsbaustein SO_USER_READ_API1 verwendet, der Mappeninhalt wird mit dem Funktionsbaustein SO_FOLDER_READ_API1 gelesen.

DATA: FOL_CONT LIKE SOFOLENTI1 OCCURS 10 WITH HEADER LINE.

DATA: USER_DATA LIKE SOUDATAI1.

DATA: FOLDER_TO_MOVE LIKE SOFOLENTI1-OBJECT_ID.

DATA: DESTINATION_FOLDER LIKE SOFOLENTI1-OBJECT_ID.

DATA: COUNTER_FOUND TYPE I.

CALL FUNCTION 'SO_USER_READ_API1'

IMPORTING

USER_DATA = USER_DATA

EXCEPTIONS

OTHERS = 1.

IF SY-SUBRC <> 0.

WRITE: / 'Die Benutzerdaten konnten nicht gelesen werden !'.

EXIT.

ENDIF.

CALL FUNCTION 'SO_FOLDER_READ_API1'

EXPORTING

FOLDER_ID = USER_DATA-PRIVATFOL

TABLES

FOLDER_CONTENT = FOL_CONT

EXCEPTIONS

OTHERS = 1.

IF SY-SUBRC <> 0.

WRITE: / 'Die pers. Wurzelmappe konnte nicht ausgelesen werden !'

EXIT.

ENDIF.

LOOP AT FOL_CONT WHERE OBJ_TYPE = 'FOL'.

ADD 1 TO COUNTER_FOUND.

IF COUNTER_FOUND = 1.

FOLDER_TO_MOVE = FOL_CONT-OBJECT_ID.

ELSE.

DESTINATION_FOLDER = FOL_CONT-OBJECT_ID.

EXIT.

ENDIF.

ENDLOOP.

IF COUNTER_FOUND < 2.

WRITE: / 'Es sind weniger als zwei Mappen in der persönlichen',

'Wurzelmappe !'.

EXIT.

ENDIF.

CALL FUNCTION 'SO_FOLDER_MOVE_API1'

EXPORTING

FOLDER_ID = FOLDER_TO_MOVE

NEW_PARENT_FOLDER_ID = DESTINATION_FOLDER

EXCEPTIONS

OTHERS = 1.

IF SY-SUBRC &lt;&gt; 0.

WRITE: / 'Fehler beim Ablegen der Mappe aufgetreten !'.

ELSE.

WRITE: / 'Die Mappe wurde erfolgreich abgelegt !'.

ENDIF.

Hinweise

Weiterführende Informationen

Informationen zum Aufruf der Funktionsbausteine SO_UDER_READ_API1 und SO_FOLDER_READ_API1 finden sich in der Dokumentation der entsprechenden Funktionsbausteine.

Parameter

FOLDER_ID
NEW_PARENT_FOLDER_ID

Ausnahmen

ENQUEUE_ERROR
FOLDER_NOT_EXIST
NEW_PARENT_FOLDER_NOT_EXIST
OPERATION_NO_AUTHORIZATION
PARAMETER_ERROR
X_ERROR

Funktionsgruppe

SOI1

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

Length: 6130 Date: 20240523 Time: 104630     sap01-206 ( 88 ms )