MOVE_OBJECT

Script-Funktion: Verschiebt ein Objekt in einen Ordner.

Syntax

MOVE_OBJECT (Objektname, Zielordner)

Syntax	Beschreibung/Format
Objektname	Name des Objektes Format: Script-Literal oder Script-Variable
Zielordner	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" - Dieses Objekt ist nicht vorhanden. "20657" - Der Zielordner ist nicht vorhanden.

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.

Wichtig!

• Ein Laufzeitfehler tritt auf, wenn Sie eine :ON_ERROR-Anweisung mit dem Parameter ABEND verwenden, aber das Objekt oder der Ordner nicht vorhanden ist. In letzterem Fall verbleibt das Objekt in seinem ursprünglichen Ordner. Weitere Informationen finden Sie unter :ON_ERROR.
• Sie benötigen Schreibzugriff (W) auf das Objekt und den Zielordner, da andernfalls ein Laufzeitfehler auftritt. Weitere Informationen finden Sie unter Automation Engine-Berechtigungen gewähren.

Hinweise: Die Script-Anweisung 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 ("WIEN","TIME_ZONES/OBJECTS")

Siehe auch: