Comparaison de Traitements ou de Transformers personnalisés

L'outil de comparaison permet de :

• Visualiser les différences entre deux traitements ou deux Transformers personnalisés exportés, composant par composant.
• Incorporer des composants qui diffèrent d'une version (en lecture seule) à une autre (en écriture).

La comparaison est un outil utile lorsque plusieurs personnes participent à la création d'un traitement ou un Transformer personnalisé, avec chaque personne faisant ses propres changements et contribuant à son propre fichier, ou sa propre version.

Optionnellement, il est possible de configurer un outil git (comme Git Bash, TortoiseGit et Sourcetree) pour interfacer directement l'outil de comparaison et résoudre les conflits lors de la fusion de versions. Pour plus d'information, voir Intégration d'un workflow git avec l'outil de comparaison..

Quels sont les éléments comparés ?

L'outil de Comparaison met en évidence les différences qui affectent la manière dont un traitement ou un Transformer personnalisé s'exécute. Il ne surligne pas les différences n'ayant aucun impact à l'exécution, comme les annotations ou signets, ou encore la disposition des éléments sur l'espace de travail.

Commencer

1. Pour ouvrir l'outil de comparaison, effectuer l'une des actions suivantes :
• Sélectionner Outils  > Comparaison.
• Cliquer sur l'icône de comparaison dans Barre d'outils.
2. Dans la fenêtre de comparaison, spécifier les deux traitements ou les deux Transformers personnalisés que vous souhaitez comparer :
• Modifiable : Ce fichier s'ouvre sur le côté gauche de l'outil et peut être modifié. C'est la version dans laquelle vous pouvez incorporer les modifications de l'autre fichier (en lecture seule).
• Lecture seule : Ce fichier s'ouvre sur la droite de l'outil et est en lecture seule. Il ne peut pas être modifié.
3. Si vous comparez des Transformers personnalisés, une fenêtre permet de sélectionner la version. Spécifier :
   • Créer une nouvelle version : demande à l'outil de comparaison d'enregistrer les modifications dans une nouvelle version du Transformer personnalisé.
   • Modifier une version existante : demande à l'outil de comparaison de sauvegarder les changements dans la version spécifiée du Transformer personnalisé.

   Pour plus d'informations, voir Travailler avec plusieurs versions de Transformers personnalisés

4. Cliquer sur OK. L'outil de comparaison ouvre les fichiers spécifiés.

Visualiser les différences : aperçu

Les deux fichiers, Editable et en Lecture seule, affichent les différences de deux façons :

• Sur leur espace de travail respectif. Notez que cet affichage ne montre pas les différences entre les données source, données destinations, paramètres publiés, paramètres FME Flow et les paramètres de traitement puisque ceux-ci ne sont pas affichés sur l'espace de travail.
• Sous l'espace de travail, sous forme de liste. Cet affichage montre les différences entre tous les composants comparés, dont ceux qui ne sont pas représentés sur l'espace de travail.

Les différences respectent le code couleur suivant :

Clair	Sombre (affichage de l'espace de travail)	Sombre (affichage de liste)	Définition
			Le composant n'existe que sur le côté gauche.
			La composante existe des deux côtés, mais elle diffère de l'une à l'autre.
			Le composant n'existe que sur le côté droit.

A prendre en compte

Lors de l'affichage des différences, garder à l'esprit les éléments suivants :

• Les comparaisons sont basées sur les composants de chaque côté qui ont les mêmes noms, y compris les suffixes.
• Les différences ne sont pas mises en évidence dans les volets du navigateur. Si le volet Navigateur vous empêche de visualiser les différences, vous pouvez le fermer. Pour plus d'informations, voir Affichage des différences dans l'espace de travail, ci-dessous.
• L'outil de comparaison met en évidence les différences qui affectent le comportement du traitement ou du Transformer personnalisé lors de son exécution. Il ne met pas en évidence les différences qui n'ont pas d'impact lors de l'exécution, notamment les différences entre les transformateurs :
  • Signets
    Note   Les signets dans le fichier en lecture seule qui sont repliés ne peuvent pas être développés. Cependant, il est toujours possible de voir la différence entre les composants qu'ils contiennent lors de Affichage des différences sous forme de liste. Pour développer un signet dans le fichier en lecture seule, il est nécessaire de l'ouvrir et de l'enregistrer en dehors de l'outil de comparaison. Il est aussi possible d'alterner les versions Editable et En lecture seule, effectuer la modification et alterner à nouveau.
  • Commentaires
  • Position des objets dans l'espace de travail
  • Groupement et agencement des paramètres publiés dans la saisie lors de l'exécution.
• Si un fichier contient plusieurs onglets, à l'instar d'un Transformer personnalisé ouvert dans un traitement, la comparaison correspond à l'onglet actif.
  Attention Si l'outil de comparaison ouvre des traitements avec des Transformers personnalisés dont le dernier enregistrement a été effectué avec leurs onglets correspondants fermés, il vous sera demandé de les déployer pour pouvoir les inclure dans la comparaison. Si vous choisissez de ne pas les déployer, l'outil de comparaison pourra ne pas donner une comparaison exacte entre les onglets de Transformers personnalisés (ou Transformers personnalisés imbriqués). Pour plus d'informations, voir Comparaison de Traitements contenant des Transformers personnalisés.
• Vous pouvez continuer d'éditer et exécuter d'autres fonctions dans le fichier Editable. Quand vous enregistrer une modification, ou lors d'une Copie des différences vers la version Editable. (plus bas), la comparaison s'ajuste en fonction. Le fichier sur la droite reste en lecture seule.
• Vous pouvez alterner les versions Editable et En lecture seule. Sur la barre d'outils centrale, cliquer sur Alterner. 
  Attention Si vous avez des modifications non enregistrées dans le fichier Editable, il vous sera demandé de les enregistrer ou les abandonner.

Affichage des différences dans l'espace de travail

L'affichage des différences dans l'espace de travail du traitement ou des Transformers personnalisés ne montre que les différences des éléments affichés par FME Workbench. Il ne montre pas les différences entre les données source, les données destination, les paramètres publiés, les paramètres FME Flow ou les paramètres de traitement.

Survoler pour afficher la capture d'écran :

Vous pouvez utiliser les icônes suivantes dans la barre d'outils centrale (entre les deux fichiers) pour changer la manière dont les espaces de travail s'affichent :

• Nav : Affiche ou masque les Navigateurs de traitement.
Note  Les différences ne sont pas indiquées dans les volets Navigateurs.
• Sync. : Si activé, les interactions de navigation dans un espace de travail, tel que le défilement ou le zoom, seront synchronisées sur l'autre espace de travail.

Affichage des détails

Vous pouvez afficher les détails des différences entre les composants, y compris leurs attributs ou leurs paramètres. Pour afficher les détails des différences, double-cliquez sur le composant. Vous pouvez également cliquer sur son icône en forme d'engrenage.

Affichage des différences sous forme de liste

Les différences entre les fichiers Editables et les fichiers en lecture seule sont présentées sous forme de liste sous la vue de l'espace de travail. Cette liste comprend également des éléments qui ne s'affichent pas sur le canevas, tels que les Readers, les Writers, les paramètres publiés, les paramètres FME Flow et les paramètres de traitement.

Survoler avec la souris pour afficher une capture d'écran :

Filtre des différences

Vous pouvez filtrer cette liste pour limiter votre visualisation des différences. Dans la barre d'outils centrale, cliquer sur Filtrer :

• Par type de composant : liste seulement les différence qui s'appliquent aux composants sélectionnés.
• Par nom de composant : filtre davantage la liste en saisissant une chaîne de caractères qui agit sur le(s) nom(s) des composants concernés.

Affichage des détails

Pour visualiser un élément de la liste plus en détail, double-cliquez dessus ou cliquez une seule fois sur le descripteur correspondant à droite. Une fenêtre de comparaison gauche-droite s'ouvre et indique l'état du composant correspondant aux fichiers Editable et en Lecture seule, respectivement.

Copie des différences vers la version Editable.

Vous pouvez choisir les différences du fichier en Lecture seule que vous voulez incorporer dans le fichier Editable.

Depuis la vue de l'espace de travail ou liste, sélectionnez un composant et, depuis la barre d'outils centrale, cliquez sur Copier vers la gauche. Pour sélectionner plusieurs composants, utilisez les raccourcis claviers de votre système d'exploitation (par exemple, Ctrl + clic ou Shift + clic sur Windows).

• Si vous sélectionner un composant qui existe uniquement dans le fichier en Lecture Seule, il est ajouté au fichier Editable.
• Si vous sélectionnez un composant qui existe à la fois dans les fichiers en Lecture seule et Editable, le composant du fichier en Lecture seule remplace celui dans le Editable.
• Si vous sélectionnez un composant qui n'existe que dans le fichier Editable, il est supprimé.