Export de la hiérarchie

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.

• Noeuds supérieurs : cliquez sur Ajouter, sélectionnez une hiérarchie et choisissez un noeud, puis cliquez sur OK. Reprenez l'opération jusqu'à ce que tous les noeuds aient été ajoutés.

  Remarque :

  Utilisez les flèches pour repositionner les noeuds, afin de déterminer l'ordre dans lequel les noeuds de la hiérarchie sont exportés.

• Groupe de hiérarchies : sélectionnez une propriété de groupe de hiérarchies et un groupe de hiérarchies.

  Remarque :

  Vous pouvez utiliser des variables de substitution pour la propriété de groupe de hiérarchies et le groupe de hiérarchies.

  • Propriété de groupe de hiérarchies : sélectionnez une propriété de groupe de hiérarchies ou sélectionnez [Obtenir la valeur à partir du paramètre], puis sélectionnez le paramètre à utiliser pour la propriété.

  • Groupe de hiérarchies : sélectionnez un groupe de hiérarchies ou sélectionnez [Obtenir la valeur à partir du paramètre], puis sélectionnez le paramètre à utiliser pour le groupe.

• Sélection de noeud : détermine les noeuds (Tous les noeuds, Noeuds branche uniquement, Noeuds feuille uniquement) à inclure dans l'export.

• Répéter à partir du noeud supérieur : sélectionnez cette option pour inclure la sortie pour tous les noeuds situés en dessous du noeud supérieur. Si cette option n'est pas sélectionnée, seul le noeud supérieur est inclus. Cette option est utile lors de l'export d'un enregistrement unique pour chaque hiérarchie sélectionnée.

• Inclure les noeuds inactifs : sélectionnez cette option pour inclure les noeuds désactivés 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.

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

• Enlever les doublons en fonction de la clé : sélectionnez cette option pour utiliser la clé primaire (définie dans l'onglet Options des colonnes) pour supprimer les enregistrements en double avant l'export.

• Sortie tabulée : sélectionnez cette option pour mettre en retrait les noeuds pour chaque niveau d'une hiérarchie à l'aide de tabulations afin de produire un format de sortie structuré.

• Aucune : aucune validation n'est exécutée.

• Affecté : toutes les validations affectées à la version, aux hiérarchies et aux noeuds pour l'export sont exécutées.

• Sélectionné : cliquez sur pour sélectionner les validations à exécuter.

• Répéter la propriété de nombre : fait référence à une propriété locale de nombre entier de niveau noeud, qui répète un noeud au sein d'une structure d'export. Par exemple, prenons une hiérarchie parent-enfant A-B-C, si la propriété du nombre de répétitions a la valeur 2 pour le noeud B et la valeur 1 pour les noeuds A et C, l'export apparaît sous la forme A,B,B,C (le noeud B est répété deux fois).

  Remarque :

  Lors de l'utilisation de la propriété du nombre de répétitions, la valeur doit être définie au minimum sur 1 pour les noeuds à inclure dans les résultats de l'export. Il est recommandé de définir la valeur par défaut de l'option Répéter la propriété de nombre sur 1.

• Propriété de niveau inférieur et Valeur de niveau inférieur : déterminent la profondeur maximale de la structure d'export. Cette valeur peut être définie comme une propriété de nombre entier de niveau hiérarchie (Propriété de niveau inférieur) ou sous la forme d'une valeur absolue (Valeur de niveau inférieur).

  Si un niveau inférieur est défini, les options de répétition sont activées pour répéter automatiquement les noeuds vers le bas jusqu'au niveau défini dans la structure d'export. Par exemple, pour les noeuds A-B-C dans une hiérarchie parent-enfant, si la valeur de niveau inférieur est définie sur 6, que la propriété du nombre de répétitions a la valeur 2 pour le noeud B et que l'option Répéter le noeud feuille inférieur est sélectionnée, la structure d'export correspond à A,B,B,C,C,C (elle comporte six niveaux, le noeud feuille C est répété jusqu'à ce que le niveau 6 soit atteint et le noeud B est répété deux fois).

• Dans la section Validation, sélectionnez la validation à utiliser pour filtrer l'export.

• Dans la section Requête, sélectionnez la requête à appliquer à l'export ou, pour définir une requête, cliquez sur .

• Utiliser le fichier texte pour inclure/exclure des noeuds descendants : indiquez si vous avez créé un fichier texte avec les noeuds à inclure à l'export (ou à exclure de l'export). Le format de fichier est une liste de noms de noeud à raison d'un par ligne. Sélectionnez une connexion, saisissez un nom de fichier et choisissez d'inclure les noeuds à l'export (ou de les exclure).

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

• Pivot : si la propriété contient une liste de valeurs séparées par des virgules, un enregistrement distinct est exporté pour chaque valeur avec toutes les autres colonnes d'export définies sur les mêmes valeurs. L'option Pivot ne peut être sélectionnée que pour une seule colonne.

• Ignorer les valeurs par défaut : permet de placer une valeur vide (chaîne vide) ou NULL (dans la sortie vers une table de base de données) dans l'export si la valeur de champ est égale à la valeur par défaut de la propriété.

• Clé primaire : permet de définir au moins un champ comme clé primaire à utiliser lors de la détermination de l'existence de doublons. (Ce paramètre est utilisé par l'option Enlever les doublons dans l'onglet Style).

• Valeur dynamique : si vous avez ajouté une colonne dynamique, définissez sa valeur ici. La valeur peut être NULL ou une combinaison de variables de substitution et de valeurs constantes.

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

• 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 en fonction des libellés des propriétés sélectionnées.

  • 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. Le codage s'applique au fichier de sortie et au fichier Include/Exclude du noeud, s'il est indiqué.

  • Options Remplacer : sélectionnez jusqu'à trois caractères à remplacer dans les listes. Toutes les instances de l'export sont remplacées comme indiqué. Par exemple, toutes 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.

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

• 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. Ensuite, 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.