IMPORT

La fonction de script IMPORT vous permet d'importer des objets ou des arborescences de dossiers provenant d'un fichier XML.

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##.

La taille par défaut du fichier XML est de 1024 Ko, avec une taille maximale de 30720 Ko. Les administrateurs peuvent spécifier une autre limite MAX_IMPORT_SIZE. Pour plus d'informations, voir UC_SYSTEM_SETTINGS - Paramètres système.

Remarques :

• N'utilisez pas la fonction IMPORT 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.
• Les objets sont créés dans le dossier indiqué. Si le dossier n'existe pas ou si le paramètre est absent, les objets sont enregistrés dans <Défaut>.
• Les objets non-dossiers ne sont pas traités comme des objets au cours de l'importation. Les paramètres d'importation ne s'appliquent qu'aux objets Dossier.
• Vous devez avoir l'accès en écriture à l'objet ou au dossier cible. Si vous n'avez pas les permissions suffisantes, l'importation échoue. Pour plus d'informations, voir Accorder des autorisations Automation Engine.
• 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'importation sont consignées dans le rapport d'activation de l'objet qui appelle l'importation.

Important !

• Les importations vers le dossier "Gestion des versions" ne sont pas autorisées.
• 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 ê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 XML souhaité est utilisé.

Syntaxe

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

Paramètres

• File
  Nom du fichier (avec chemin complet) à importer
  Format : littéral de script ou variable de script
• Folder
  Nom du dossier d'enregistrement du contenu importé
  Format : littéral de script ou variable de script
• Object Setting
  Ignore ou remplace le contenu existant
  Format : littéral de script, variable de script ou nombre
  Valeurs autorisées :
  • 0
    Ignore les objets existants
  • 1 (par défaut)
    Remplace les objets ou dossiers existants
    
• Link Setting
  Ignore ou conserve les liens du dossier existant ou les objets externes
  Format : littéral de script, variable de script ou nombre 
  Remarque : Ce paramètre n'est important que si Object Setting vaut 1.
  Valeurs autorisées :
  • 0
    Ignore ou conserve les liens du dossier existant et les objets externes
  • 1 (par défaut)
    Conserve les liens du dossier existant et importe les objets externes

Codes retour

• 0
  Importation réussie
  
• 20657
  Le dossier cible n'existe pas
  
• 20692
  Le fichier n'existe pas
  
• 21724
  Accès au fichier impossible dû à une autorisation manquante.
  
• 21729
  Importation impossible. Le fichier XML à importer ne dispose pas du format AE requis.
  
• 21730
  Le fichier XML importé ne correspond pas à l'encodage requis.
  
• 21732
  Erreur lors de l'importation - voir le rapport d'activation pour plus d'informations

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

Exemples

L'exemple suivant ignore les objets existants lors de l'importation. Les scripts utilisent une variable de script pour transmettre les noms de fichier et de dossier à la fonction IMPORT.

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

(UNIX) L'exemple suivant illustre l'importation d'une arborescence de dossiers :

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

Voir aussi :