MOVE_OBJECT

Verwenden Sie die Script-Funktion MOVE_OBJECT, um ein Objekt in einen Ordner zu verschieben. Es ist irrelevant, in welchem Ordner sich das zu verschiebende Objekt befindet, da es automatisch abgerufen wird. Vorhandene Objektverknüpfungen werden 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. Falls der Ordner nicht vorhanden ist, 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 Gewähren von Automation Engine-Berechtigungen.
• Diese Script-Funktion schreibt alle offenen Transaktionen des Scripts in die AE-Datenbank. Weitere Informationen finden Sie unter Script-Verarbeitung.

Syntax

MOVE_OBJECT (Objektname, Zielordner)

Parameter

• MOVE_OBJECT
  Verschiebt ein Objekt in einen Ordner
• Objektname
  Name des Objekts
  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

Die Skriptfunktion gibt die folgenden Werte zurück:

• 0
  Das Objekt wurde erfolgreich verschoben
• 20645
  Dieses Objekt ist nicht vorhanden
• 20657
  Der Zielordner ist nicht vorhanden

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: