Export de comparaison

Les exports de comparaison comparent deux hiérarchies et produisent un enregistrement pour chaque noeud qui répond aux critères de comparaison. Vous pouvez diriger ces informations vers un fichier ou une table de base de données. Cet export peut être utilisé pour fournir des modifications incrémentielles aux systèmes cible.

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.

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

  1. Sur la page d'accueil, sélectionnez Export.
  2. Cliquez sur Bouton de barre d'outils Nouvelle comparaison.
  3. Sélectionnez Comparaison comme type d'export.
  4. Facultatif : pour créer des paramètres de substitution pour l'export, effectuez les opérations suivantes :
    1. Cliquez sur Bouton Ajouter des paramètres.
    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.
  5. Dans l'onglet Source, sélectionnez les versions, les hiérarchies et les noeuds supérieurs à comparer.

    Remarque :

    Vous devez sélectionner une hiérarchie et des noeuds supérieurs pour la version en cours et pour la version précédente.

    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.

  6. Dans l'onglet Style, sélectionnez des options :

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

    • Propriété de jointure : par défaut, les comparaisons mappent les noeuds de chaque hiérarchie qui ont le même nom. Vous pouvez également joindre des noeuds en fonction d'autres propriétés. Par exemple, si une propriété nommée SortCode a une clé unique dans les hiérarchies indiquées, cette propriété est utilisée pour identifier les différences entre les noeuds ayant la même propriété SortCode dans chaque hiérarchie.

    • Ajouts : inclut tous les noeuds de la hiérarchie cible ne figurant pas dans la hiérarchie source.

    • Suppressions : inclut tous les noeuds de la hiérarchie source ne figurant pas dans la hiérarchie cible.

    • Fusions : inclut les informations de fusion dans l'export (si la fonction de fusion est activée).

    • Déplacements : inclut tous les noeuds qui ont des noeuds parents différents dans les hiérarchies comparées.

    • Changements de nom : inclut tous les noeuds portant des noms différents mais le même ID de noeud interne dans les hiérarchies comparées.

    • Mises à jour de propriété : inclut tous les noeuds ayant des valeurs différentes dans la liste des propriétés indiquée dans les hiérarchies comparées. Sélectionnez Modifier pour sélectionner des propriétés.

  7. Dans la section Validations de lot, sélectionnez le type de validations à exécuter.

    Remarque :

    Les validations de lot sont effectuées uniquement pour les hiérarchies et les noeuds inclus 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 à la version, aux hiérarchies et aux noeuds pour l'export sont exécutées.

    • Sélectionné : cliquez sur icône représentant des points de suspension pour sélectionner les validations à exécuter.

  8. Dans l'onglet Filtres, effectuez un choix parmi les options suivantes :

    • 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 Bouton Nouvelle requête.

      Remarque :

      Le filtre d'inclusion détermine l'ensemble de noeuds de chaque hiérarchie à comparer. Le filtre d'exclusion exclut les noeuds des résultats d'export.

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

  10. Dans l'onglet Options des colonnes, effectuez un choix parmi les options suivantes :

    • Pivot : si la propriété contient une liste de valeurs séparées par des virgules, un enregistrement séparé 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.

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

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

  12. 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 Bouton représentant des points de suspension 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 Bouton représentant des points de suspension 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.

  13. Effectuez l'une des opérations suivantes :

    • Pour enregistrer l'export, cliquez sur Bouton Enregistrer.

      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 Bouton Valider.

      Vous pouvez copier les erreurs de validation dans le presse-papiers.

    • Pour exécuter l'export, cliquez sur Bouton Exécuter.

      Si vous avez choisi d'exécuter des validations dans l'onglet Style, le fait de cliquer sur Bouton Exécuter exécute les validations et, si aucune erreur ne survient, exécute l'export. En cas d'erreur de validation, l'export s'arrête et un message d'erreur est affiché. Cliquez sur Bouton Valider pour obtenir la liste des erreurs de validation.