EXPORT

Modification d'objets

MODIFY_OBJECT

---

IMPORT

Fonction de script : Importe des objets d'un fichier XML.

Syntaxe

IMPORT(File [,[Folder], [Object Setting], [Link Setting]])

Commentaires

Cette fonction de script peut être utilisée pour importer des objets ou des structures de dossier depuis un fichier XML correctement formaté.

La fonctionnalité d'importation et d'exportation n'est pas adaptée aux transports de masse ! Utilisez le conteneur Transport à cet effet.

Quand vous importez des structures de dossier, vous retrouverez les informations relatives à la structure du dossier en haut du fichier XML. Au cours de l'importation, tous les objets de dossier et de non-dossier, les objets liés et les sous-dossiers sont inclus, et un nouveau dossier nommé ##INCLUDED_EXTERNALS## sera créé au même niveau que le dossier dédié sur le système cible. Les objets de dossier et de non-dossier liés seront stockés dans le dossier ##INCLUDED_EXTERNALS##.

Les objets de non-dossier ne sont pas traités comme des objets au cours de l'importation. Ainsi, les paramètres d'importation s'appliquent uniquement aux objets de dossier.

Les objets sont créés dans le dossier indiqué. Si celui-ci n'existe pas ou que ce paramètre est absent, les objets sont enregistrés dans <défaut>.

Vous povuez utiliser l'instruction de script :ON_ERROR pour définir la réaction en cas d'importation erronée. Vous pouvez encore utiliser les fonctions de script pour le traitement des erreurs pour analyser l'importation. Le traitement du script se poursuit. Toutefois, vous avez également la possibilité de l'interrompre.

La taille normale d'un fichier XML est de 1 024 ko ; la taille maximale est de 30 720 ko. L'administrateur peut indiquer une taille différente dans la clé "MAX_IMPORT_SIZE" de la variable UC_SYSTEM_SETTINGS.

Vous trouverez des informations complémentaires sur le processus d'importation dans le rapport d'activation de l'objet réalisant l'importation.

L'importation échoue lorsque vous ne possédez pas d'autorisation d'écriture sur l'objet ou sur le dossier de destination.

Attention : Attention : l'importation dans le dossier "Gestion des Versions" est impossible !

Dans un environnement AE distribué (où les processus de travail sont exécutés sur plusieurs ordinateurs), vous ne pouvez pas déterminer l'ordinateur sur lequel l'importation sera effectuée. Automic vous recommande d'indiquer le chemin UNC sous Windows. Notez que le serveur doit être exécuté sous un utilisateur de domaine approprié pour accéder aux noms UNC. Si un serveur UNIX est utilisé, le chemin absolu doit être indiqué en langage UNIX. Le système de fichier doit aussi être accessible (NFS, commande mount), bien qu'il ne joue aucun rôle sur la machine où il se trouve. C'est le seul moyen de s'assurer que le fichier XML souhaité est également utilisé. 

Cette instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE.

Exemple

Dans l'exemple suivant, les objets éventuellement présents sont ignorés lors de l'importation. Le nom du fichier et du dossier sont transmis à la fonction de script sous forme de variable de script. 

:SET &FILE#  = "\\PCUC4\UC4global\IMPORT\uc4_import.xml"
:SET &FOLDER# = "IMPORT/JOBS"
:SET &RET#    = IMPORT(&FILE#,&FOLDER#,"0")

Exemple d'importation d'une structure de dossier :

Exemple pour UNIX :

:SET &FILE#  = "/opt/UC4/import/uc4_import.xml"
:SET &FOLDER# = "IMPORT/JOBS"
:SET &RET#    = IMPORT(&FILE#,&FOLDER#,"0")

Rubriques connexes :

Eléments de script - Traitement des objets

Importation et exportation d'objets

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle