MOVE_OBJECT

Fonction de script : Déplace un objet dans un dossier.

Syntaxe

MOVE_OBJECT (Object Name, Destination Folder)

Syntaxe

Description / format

Object Name

Nom de l'objet.
Format : littéral de script ou variable de script

Destination Folder

Chemin du dossier dans lequel l'objet doit être déplacé.
Format : littéral de script ou variable de script


Codes retour

"0" : l'objet a été déplacé.
"20645" : l'objet n'existe pas.
"20657" : le dossier cible n'existe pas.

Le dossier dans lequel se trouve l'objet à déplacer n'a pas d'importance, car il est récupéré automatiquement. Si l'objet possède des liens, ils sont ignorés et ne sont pas déplacés.

 Une erreur de temps d'exécution se produit lorsque vous ne possédez pas de droit d'écriture sur l'objet ou sur le dossier de destination.

Si l'objet ou le dossier n'existe pas, une erreur d'exécution se produit si l'instruction de script :ON_ERROR a été utilisée avec le paramètre ABEND. Si le dossier n'existe pas, l'objet reste dans son dossier d'origine.

L'instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE. Pour plus d'informations, voir Traitement du script.

Exemple

L'exemple suivant illustre le déplacement de l'objet VIENNA dans le sous-dossier OBJETS du dossier TIME_ZONES.

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

Voir aussi :

voiraussi

Éléments de script pour la gestion des tâches