EXPORT

La fonction de script EXPORT vous permet d'exporter des objets ou des arborescences de dossiers vers un fichier XML.

Lorsque vous exportez des arborescences de dossiers, le fichier XML contient les informations relatives à l'arborescence de dossiers au début du fichier. Le contenu exporté comprend le contenu intégral de l'arborescence de dossiers :

• Dossiers
• Objets hors dossier
• Sous-dossiers
• Objets liés

Lors de l'importation du contenu, un nouveau dossier ##INCLUDED_EXTERNALS## est créé au même niveau que le dossier dédié sur le système cible. Les objets liés sont stockés dans le dossier ##INCLUDED_EXTERNALS##. Pour plus d'informations, voir IMPORT.

Remarques :

• N'utilisez pas la fonction EXPORT pour un transport de masse. Utilisez le conteneur de transport lorsque vous devez déplacer de gros volumes de contenu. Pour plus d'informations, voir Transporter des données.
• Pour exporter un objet, vous devez avoir l'accès en lecture sur cet objet. Si vous n'avez pas les permissions suffisantes, l'exportation échoue. Pour plus d'informations, voir Accorder des autorisations Automation Engine.
• Avant le démarrage de l'exportation, le système vérifie si le fichier existe déjà. Si le fichier existe, il est remplacé. S'il est protégé en écriture, l'exportation ne peut pas être exécutée.
• 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.
• Les informations relatives à l'exportation sont consignées dans le rapport d'activation de l'objet qui appelle l'exportation.

Important !

Dans des environnements AE distribués, les processus de travail sont exécutés sur des ordinateurs différents. Vous devez définir l'ordinateur de l'exportation :

• (Windows) Spécifiez le chemin UNC sous Windows. Le serveur doit être exécuté sous un utilisateur de domaine approprié pour accéder aux noms UNC.
• (UNIX) Indiquez le chemin absolu en notation UNIX.

Le système de fichier doit aussi être accessible (NFS, commande mount), mais la machine sur laquelle il est situé est sans importance. C'est le seul moyen de s'assurer que le fichier réellement requis est utilisé.

Syntaxe

EXPORT (Folder, File [,Include_External_Objects])
EXPORT (Object, File [, ,Include_Referenced_Objects])

Paramètres

• Folder
  Nom du dossier (avec spécification du chemin complet) à exporter
  Format : littéral de script ou variable de script
• Object
  Nom de l'objet ou des objets à exporter
  Format : littéral de script ou variable de script
  Remarque : Vous pouvez utiliser les caractères génériques * (quelconque) et ? (un caractère exactement)
  
• File
  Nom du fichier (avec le nom complet du chemin) dans lequel les objets doivent être exportés.
  Format : littéral de script ou variable de script
• Include_External_Objects
  (Dossiers uniquement) Inclut les objets externes dans l'exportation
  Remarque : Lorsque le type d'objet n'est pas un dossier, le paramètre est ignoré.
  Valeurs autorisées :
  • Y
    Inclut les objets internes
  • N (défaut)
    N'exporte pas les objets externes
    
• Include_Referenced_Objects
  Inclut les objets utilisés par l'objet exporté, tels que les tâches dans un Workflow ou les objets PromptSet
  N'utilisez pas ce paramètre pour les dossiers, ou avec des caractères génériques.
  Valeurs autorisées :
  • Y
    Exporte les objets références périodiquement.
  • N (défaut)
    N'exporte pas les objets référencés
  Remarque : Les objets référencés des manières suivantes ne sont pas exportés, même si le paramètre est Y.
• Objets Login, utilisateur et agent
• Objets variables référencées dans les champs d'attributs entre des accolades {VARANAME}
• Objets référencés dans les pré- et postconditions au niveau de la tâche dans un workflow
• Objets référencés dans les fonctions de script autres que :INC
• Objets du client système 0000 (par ex. variables UC_* dans les prompts, objets HOST dans les jobs)

Codes retour

• 0
  Exportation réussie
• 20693
  L'objet n'existe pas
• 21723
  Le fichier cible existe et est protégé en écriture

Conseil : Utilisez l'instruction de script :ON_ERROR pour définir l'action à entreprendre en cas d'échec de l'exportation. Pour plus d'informations, voir Éléments de script pour la gestion des erreurs.

Exemples

Dans les exemples suivants, tous les objets dont le nom commence par "MM.DAY" sont exportés. Les scripts utilisent une variable de script pour transmettre les noms d'objet et de fichier à la fonction EXPORT.

(Windows)

:SET &OBJECT# = "MM.DAY*"

:SET &FILE# = "\\PC\AE\EXPORT\Test_export.xml"

:SET &RET# = EXPORT(&OBJECT#,&FILE#)

(UNIX)

:SET &OBJECT# = "MM.DAY*"

:SET &FILE# = "/opt/ae/export/Test_export.xml"

:SET &RET# = EXPORT(&OBJECT#,&FILE#)

Dans l'exemple suivant, une arborescence de dossiers est exportée :

:SET&RET# = EXPORT("\TESTFOLDER\EXPORT_STRUCTURE", "\\PC\AE\EXPORT\Test_export.xml", "Y")

Dans l'exemple suivant, un workflow est exporté avec des références :

:SET&RET# = EXPORT("EXAMPLE_WORKFLOW", "\\PC\AE\EXPORT\Test_export.xml", "Y")

 

Voir aussi :