Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte bearbeiten > MOVE_OBJECT

MOVE_OBJECT

Script-Funktion: Verschiebt ein Objekt in einen Ordner.

Syntax

MOVE_OBJECT (Object Name, Destination Folder)

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" - Das Objekt existiert nicht. "20657" - Der Zielordner existiert nicht.

Anmerkungen

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-Sprachmittel bewirkt, dass die offenen Transaktionen des Scripts in die Datenbank geschrieben werden.

Beispiel

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

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

Siehe auch:

Script-Sprachmittel	Beschreibung
:ON_ERROR	Legt die Reaktion auf bestimmte Fehler bzw. Meldungen von Script-Sprachmitteln fest.
CREATE_OBJECT	Erstellt ein Objekt (nur Kalender, Login und Variable).
REMOVE_OBJECT	Löscht ein vorhandenes Objekt.
MODIFY_OBJECT	Ändert ein vorhandenes Objekt (nur Kalender, Login und Variable).

Script-Sprachmittel - Objekte bearbeiten
Script-Sprachmittel - Fehlerbehandlung und Meldungen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support