MOVE_OBJECT

Script-Funktion: Verschiebt ein Objekt in einen Ordner.

Syntax

MOVE_OBJECT (Object Name, Destination Folder)

Syntax	Beschreibung/Format
Object name	Name des Objektes Format: Script-Literal oder Script-Variable
Destination Folder	Pfad des Ordners, in den das Objekt verschoben werden soll. Format: Script-Literal oder Script-Variable

Rückgabewerte
"0" - Das Objekt wurde erfolgreich verschoben. „20645“ - Das Objekt existiert nicht. "20657" - Der Zielordner existiert nicht.

In welchem Ordner sich das zu verschiebende Objekt befindet spielt keine Rolle, da dieser automatisch ermittelt wird. Besitzt das Objekt Verknüpfungen, so werden diese ignoriert und nicht verschoben.

 Es kommt zu einem Laufzeitfehler, wenn Sie kein Schreibrecht auf das Objekt oder den Zielordner besitzen.

Existiert das Objekt bzw. der Ordner nicht, so kommt es nur dann zu einem Laufzeitfehler, wenn die Script-Anweisung :ON_ERROR mit dem Parameter ABEND verwendet wurde. In letzterem Fall verbleibt das Objekt in seinem ursprünglichen Ordner.

Das Script-Statement bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.

Beispiel

Im Beispiel wird das Objekt "WIEN" in den Unterordner "OBJEKTE" des Ordners TIME_ZONES verschoben.

:ON_ERROR ABEND
:SET &RET# = MOVE_OBJECT ("VIENNA","TIME_ZONES/OBJECTS")

Siehe auch: