Export de version

Les exports de version produisent un enregistrement pour chaque noeud et ses propriétés pour l'ensemble d'une version. Ces informations peuvent être dirigées vers un fichier ou une table de base de données.

Conseil :

Pour préserver l'ordre d'export lors de l'export vers une table de base de données, vous pouvez ajouter une colonne ID d'enregistrement à la sortie. Cette colonne fournit une valeur numérique générée automatiquement, en commençant par 1, qui augmente de manière séquentielle pour chaque ligne de l'export.

Remarque :

Les relations de hiérarchie et les propriétés locales ne sont pas disponibles pour ce type d'export.

Pour créer un export de version, procédez comme suit :

Sur la page d'accueil, sélectionnez Export.
Cliquez sur .
Sélectionnez Version comme type d'export.
Facultatif : pour créer des paramètres de substitution pour l'export, effectuez les opérations suivantes :
1. Cliquez sur .
2. Cliquez sur Ajouter et ajoutez des paires clé-valeur.
  
  Remarque :
  
  Dans les paires clé-valeur, vous ne pouvez pas utiliser les caractères "<%" ou "%>" de manière séquentielle, ni le signe égal.
3. Cliquez sur OK.
Dans l'onglet Source, sélectionnez une version ou une variable de version.

Vous pouvez sélectionner des versions normales, de base ou à date. Par défaut, la liste affiche les versions normales. Pour sélectionner une version de base ou à date, cliquez sur Normal sous la liste Version.
Dans l'onglet Style, effectuez un choix parmi les options suivantes :
- Sélection de noeud : détermine les types de noeud (Tous les noeuds, Noeuds branche uniquement, Noeuds feuille uniquement) inclus dans l'export.
- Inclure les noeuds partagés implicitement : sélectionnez cette option pour inclure les noeuds descendants sous les noeuds branche partagés qui sont explicitement partagés. Les noeuds partagés implicites sont exportés uniquement s'ils ne sont pas filtrés par une autre option, telle qu'une sélection de noeud supérieur ou un filtre de requête. La structure des noeuds partagés implicitement au-dessous d'un noeud parent partagé est représentée dans la section ancêtre de l'export de hiérarchie.
  - Si un filtre de requête est utilisé dans l'export, l'administrateur doit explicitement inclure les noeuds partagés. Par exemple, le filtre (#Children=0) doit être remplacé par ((#Children=0 OR (Indicateur de noeud partagé = True)).
  - Pour le noeud partagé implicitement, les propriétés de parent reflètent les valeurs du noeud réel (le noeud principal). Par exemple, si l'export inclut la propriété Noeud parent pour un noeud partagé implicitement, le parent apparaît en tant que noeud principal.
Dans la section Validations de lot, sélectionnez le type de validations à exécuter.
Remarque :

Les validations de lot sont effectuées pour l'intégralité de la version indiquée dans l'export. Les validations sont exécutées avant l'export. Si des erreurs se produisent, l'export s'arrête.
- Aucune : aucune validation n'est exécutée.
- Affecté : toutes les validations affectées sont exécutées.
- Sélectionné : cliquez sur pour sélectionner les validations à exécuter.
Remarque :

Les validations sont effectuées pour l'intégralité de la version.
Dans l'onglet Filtres, sélectionnez des options :
- Dans la section Validation, sélectionnez la validation à appliquer à l'export.
- Dans la section Requête, sélectionnez la requête à appliquer à l'export ou, pour définir une requête, cliquez sur .
  
  Remarque :
  
  Le filtre d'inclusion détermine l'ensemble de noeuds de chaque hiérarchie à comparer.
Dans l'onglet Colonnes, sélectionnez les propriétés à afficher sous forme de colonnes dans les résultats de l'export et déplacez-les de la liste Disponible vers la liste Sélectionné.

Pour plus d'informations, reportez-vous à Export de colonnes spécifiques

Conseil :

Utilisez la liste Catégorie pour sélectionner une catégorie de propriété pour faciliter la navigation. Utilisez les flèches haut et bas pour positionner la colonne dans la liste Sélectionné. Le premier élément de la liste est la première colonne, le second correspond à la deuxième colonne, et ainsi de suite.
Dans l'onglet Cible, sélectionnez le type de sortie pour les résultats :
- Fichier client : téléchargez les résultats via le navigateur.
- Fichier de serveur : utilisez une connexion externe et enregistrez les résultats dans un système de fichiers réseau ou un répertoire FTP.
- Table de base de données : enregistrez les résultats dans une table de base de données.
Effectuez une action :
- Si vous avez choisi d'exporter les résultats vers un fichier client, sélectionnez des options :
  - En-têtes de colonne : inclut les en-têtes de colonne dans l'export.
  - Chaînes entre guillemets : met les chaînes entre guillemets. Tous les guillemets existants dans la valeur de colonne sont doublés.
    
    Par exemple :
```
=IF("ABC","XYZ",)
```
    devient
```
"=IF(""ABC"",""XYZ"",)"
```
  - Largeur fixe : permet de préciser les largeurs de champ, la justification à gauche ou à droite pour la colonne, et le nombre de caractères de remplissage. Vous pouvez saisir des informations de colonne dans la section Option de largeur fixe.
  - Codage de caractères : sélectionnez l'une des options de codage.
  - Options Remplacer : sélectionnez jusqu'à trois caractères à remplacer dans les listes. Par exemple, les virgules peuvent être remplacées par des tabulations.
  - En-tête/Pied de page : ajoutez une ligne entre l'en-tête/le pied de page et le corps ou saisissez le texte à imprimer dans l'en-tête et le pied de page des résultats de l'export. Saisissez des lignes de texte dans la zone de texte ou cliquez sur pour ouvrir un éditeur de texte.
    
    Remarque :
    
    Vous pouvez insérer des balises de personnalisation pour améliorer la lisibilité des résultats de l'export. Pour plus d'informations, reportez-vous à la section Balises de personnalisation.
  - Options Séparateur : permet de sélectionner un délimiteur de champ et un délimiteur d'enregistrement.
- Si vous avez choisi d'exporter les résultats vers une table de base de données, vous devez définir votre connexion et sélectionner la table de base de données. Vous devez avoir créé une connexion externe valide à une base de données afin qu'elle s'affiche dans la liste déroulante. Vous pouvez également effectuer un choix parmi les options suivantes :
  - Options Effacer la table
    - Ne pas effacer la table : ajoute les résultats aux données existantes dans la table indiquée.
    - Effacer en fonction des ID de version : supprime des données de la table lorsque la clé indiquée est égale à l'ID de la version actuelle des données en cours d'export. Si cette option est sélectionnée, un champ Clé doit être spécifié dans la section Options de colonnes de base de données. Lorsque l'export est exécuté, toutes les données de la table sont d'abord supprimées lorsque la clé est égale à l'ID de la version actuelle des données en cours d'export. Pour les autres options Effacer la table, le champ Clé est ignoré.
    - Effacer toutes les lignes : supprime les données de la table avant d'écrire la sortie de l'export.
  - Utiliser les transactions : l'export est effectué dans une transaction de base de données et permet l'annulation de l'ensemble de l'opération si une erreur d'export se produit.
  - Utiliser les ajouts rapides : exécute une opération d'insertion en bloc dans la table de base de données cible pour améliorer les performances d'export. Uniquement disponible avec une connexion propre à la base de données.
  - Utiliser les suppressions rapides : exécute une opération de suppression en bloc dans la table de base de données cible pour améliorer les performances. Uniquement disponible avec une connexion propre à la base de données.
  - Options de colonnes de base de données : chaque colonne exportée doit être mappée avec un champ dans la table de base de données externe. Sous Nom du champ, sélectionnez le nom d'un champ. Si vous avez sélectionné Effacer en fonction des ID de version, indiquez un champ Clé.
    
    Conseil :
    
    L'option Longueur peut être laissée vide de sorte que les longueurs de chaîne jusqu'à la déclaration de colonne de base de données peuvent être envoyées à la base de données.
    
    Remarque :
    
    La colonne doit être de même type de données que le champ de base de données auquel il est mappé. Par exemple, si une propriété de chaîne est mappée avec un champ de base de données numérique, une erreur se produit.
- Si vous avez choisi d'exporter les résultats vers un fichier de serveur, vous devez définir votre connexion et entrer un nom de fichier. Vous devez avoir défini une connexion externe valide à un fichier UNC ou FTP. Vous pouvez également effectuer un choix parmi les options suivantes :
  - En-têtes de colonne : inclut les en-têtes de colonne.
  - Chaînes entre guillemets : met les chaînes entre guillemets. Tous les guillemets existants dans la valeur de colonne sont doublés.
    
    Par exemple :
```
=IF("ABC","XYZ",)
```
    devient
```
"=IF(""ABC"",""XYZ"",)"
```
  - Largeur fixe : permet de préciser les largeurs de champ, la justification à gauche ou à droite pour la colonne, et le nombre de caractères de remplissage. Vous pouvez saisir des informations de colonne dans la section Option de largeur fixe.
  - Codage de caractères : sélectionnez l'une des options de codage.
  - Options Remplacer : sélectionnez jusqu'à trois caractères à remplacer dans les listes. Par exemple, les virgules peuvent être remplacées par des tabulations.
  - En-tête/Pied de page : ajoutez une ligne entre l'en-tête/le pied de page et le corps ou saisissez le texte à imprimer dans l'en-tête et le pied de page des résultats de l'export. Saisissez des lignes de texte dans la zone de texte ou cliquez sur pour ouvrir un éditeur de texte.
    
    Remarque :
    
    Vous pouvez insérer des balises de personnalisation pour améliorer la lisibilité des résultats de l'export. Pour plus d'informations, reportez-vous à la section Balises de personnalisation.
  - Options Séparateur : permet de sélectionner un délimiteur de champ et un délimiteur d'enregistrement.
Effectuez l'une des opérations suivantes :
- Pour enregistrer l'export, cliquez sur .
  
  L'application vous invite à définir le nom, la description et le groupe d'accès à l'objet de l'export. Sélectionnez un groupe personnalisé ou l'un des éléments suivants :
  - Utilisateur : objets personnels qui ne sont disponibles que pour un utilisateur en particulier à des fins de visualisation et d'exécution.
  - Standard : objets publics qui sont disponibles pour tous les utilisateurs à des fins de visualisation et d'exécution. Seuls les utilisateurs Gestionnaire de données peuvent créer et modifier des exports standard.
  - Système : objets limités qui ne sont accessibles qu'aux utilisateurs disposant du rôle Administrateur de l'application à des fins de visualisation et d'exécution.
- Pour valider l'export, cliquez sur .
  
  Vous pouvez copier les erreurs de validation dans le presse-papiers.
- Pour exécuter l'export, cliquez sur .
  
  Si vous avez choisi d'exécuter des validations dans l'onglet Style, le fait de cliquer sur exécute les validations. Si aucune erreur ne se produit, l'export est exécuté. En cas d'erreur de validation, l'export s'arrête et un message d'erreur est affiché. Cliquez sur pour obtenir la liste des erreurs de validation.