Fichier de configuration client
Un fichier de configuration client définit les divers paramètres de configuration qui affectent les comparaisons et la connectivité entre un client DiffDog Server et un DiffDog Server à distance. Vous devrez généralement éditer le fichier de configuration du client afin de pouvoir faire ceci :
•Configurez la communication entre le client et un DiffDog Server à distance. Dans ce cas, les paramètres address et port dans le fichier config client doivent pointer vers l’appareil du serveur.
•Modifiez le langage du client CLI.
•Configurez les valeurs par défaut pour les diverses options lorsque vous exécutez une comparaison. Celles-ci peuvent être écrasées sur la ligne de commande lorsque vous exécutez la commande data-differencing.
•Définissez les filtres XML, qui sont utiles lorsque vous comparez des fichiers XML. Par exemple, un filtre vous permet d'ignorer les attributs ou les éléments avec un nom spécifique lors de la comparaison.
•Définissez des filtres de répertoire, qui vous permettent d’inclure ou d’ignorer des fichiers ou répertoires qui suivent un schéma spécifique.
•Définissez des connexions vers des sources de données comme des bases de données ou des fichiers CSV.
•Autres options de configuration, telles que décrites ci-dessous.
Quelle configuration client ?
Si un client se trouve sur le même appareil que DiffDog Server, alors la configuration client par défaut est accédée sans que vous devez faire quoique ce soit. Vous pouvez voir les paramètres de la configuration client par défaut en exécutant la commande showcfg. Si vous devez modifier tout paramètre de configuration ou si vous voulez configurer un client sur un appareil à distance du serveur, alors vous devez créer un fichier de configuration client et l’enregistrer dans un emplacement idéal sur votre appareil client. Procédez comme suit :
1.Allez au dossier d’installation, puis au sous-dossier cmdlclient.
2.Copiez le modèle config file client_config.ini.sample.
3.Enregistrez-le à un emplacement idéal sur l’appareil client, en lui donnant le nom client_config.ini. Ceci sera le fichier de configuration du client.
Lorsque vous exécutez une commande avec l’exécutable client DiffDogCmdlClient.exe, alors l’exécutable recherche le client config file client_config.ini dans le même dossier que l’exécutable. Si le client config file n’est pas trouvé à cet endroit, alors l’exécutable le recherche dans le dossier spécifié avec l’option de la commande actuelle --c. Si aucun config file n’est pas non plus trouvé à cet emplacement, alors la configuration client par défaut est utilisée.
Vous pouvez toujours consulter la configuration actuelle à tout moment en exécutant la commande showcfg.
Paramètres de configuration client
Les paramètres du fichier de configuration client sont organisés en les groupes suivants.
[general]
jvm-location | Cette option vous permet de spécifier le chemin menant vers une Java VM (Machine Virtuelle) requis pour les tâches spécifiques à Java comme la connexion à une base de données par le biais de JDBC.
Veuillez noter que le fait d'ajouter un chemin Java VM personnalisé n'est généralement pas nécessaire. Par défaut, l'application tente de détecter le chemin Java VM automatiquement sur la base de la variable d'environnement JAVA_HOME. Sur Windows, le chemin Java VM est déterminé en lisant (dans cet ordre) le registre Windows dans la variable d'environnement JAVA_HOME.
Le chemin personnalisé ajouté dans l'option jvm-location prendra la priorité sur tout autre chemin Java VM détecté automatiquement. Une fois défini, le chemin doit pointer vers le fichier jvm.dll (Windows), jvm.so (Linux), ou libjvm.dylib (macOS) trouvé dans le répertoire d'installation JDK. |
|---|---|
langage | Spécifie le langage de l'interface de la ligne de commande (pour le client). Les valeurs valides sont en, de, es, fr, ja (anglais, allemand, espagnol, français et japonais). |
server.address | Spécifie l'adresse de l'hôte à distance où DiffDog Server écoute les requêtes HTTP. |
server-alias | Si l'administrateur de serveur a limité l'accès aux chemins de serveur pour des raisons de sécurité, les comparaisons ne peuvent pas utiliser les chemins de ficher du serveur, mais doivent utiliser un alias que l’administrateur du serveur a attribué. Ceci est fait en spécifiant l’alias dans l’option --alias (des commandes diff, compare et run, import, load). Voir Restreindre Alias pour Dossiers de serveur pour plus d’information sur cette fonction.
En alternative, vous pouvez configurer l'option server-alias dans le fichier de configuration client, afin que vous n'ayez pas à le saisir dans la ligne de commande. Par exemple, la configuration suivante définit un alias par défaut appelé sandbox : server-alias=sandbox
Note : Si vous définissez l’option --alias dans la ligne de commande, elle a la préséance sur la valeur du fichier de configuration. |
server.port | Spécifie le port à distance où DiffDog Server écoute les requêtes HTTP. |
zip-as-dir | Lorsque vous exécutez la commande diff sans configurer l'option --zip-as-dir, le programme d'exécution la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
whitespace-mode | Lorsque vous exécutez la commande diff sans configurer l'option --whitespace-mode, le programme d'exécution la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
[file-types]
Lorsque vous exécutez la commande diff sans spécifier un mode de comparaison à travers l’option --mode (texte, binaire ou XML), l’application décide automatiquement du mode de pour chaque fichier basé sur l’extension (à savoir --mode=auto). Dans les options ci-dessous, vous pouvez définir quel type d'extension de fichier doit être traité en tant que texte, binaire ou XML à chaque fois que le mode de comparaison n'est pas défini explicitement.
text | Une liste séparée par virgule des extensions de fichier qui sont traitées en tant que texte par défaut. |
xml | Une liste séparée par virgule des extensions de fichier qui sont traitées en tant que XML par défaut. |
binary | Une liste séparée par virgule des extensions de fichier qui sont traitées en tant que binaire par défaut. |
[xml]
ignore-namespace | Lorsque vous exécutez une commande diff sans définir l’option --xml-ignore-namespace, l’exécutable la recherchera dans le fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-prefixes | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-prefixes, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
resolve-entities | Lorsque vous exécutez la commande diff sans définir l’option --xml-resolve-entities, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-text | Lorsque vous exécutez la commande diff sans définir l’option --xml-ignore-text option, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-case-in-names | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-case-in-names, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-case-in-text | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-case-in-text, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-markup-attributes | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-markup-attributes, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-markup-cdata | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-markup-cdata, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-markup-comments | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-markup-comments, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-markup-processing-instructions | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-markup-processing-instructions, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-markup-doctype-decls | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-markup-doctype, le programme d'exécution la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-markup-xml-decls | Lorsque vous exécutez la commande diff sans configurer l'option --xml-ignore-markup-xml, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
order-by-elements | Lorsque vous exécutez la commande diff sans configurer l'option --xml-order-by-elements, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
order-by-attributes | Lorsque vous exécutez la commande diff sans configurer l'option --xml-order-by-attributes, l’exécutable la cherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
order-by-text | Lorsque vous exécutez la commande diff sans définir l’option --xml-order-by-text, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
order-by-list | Lorsque vous exécutez une commande diff sans définir l’option --xml-order-by-attribute-list, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. Il doit s'agir d'une liste nommée d'attributs définis dans le groupe [xml.orderby<name-of-my-list>] (voir ci-dessous). |
[xml.orderby:<identifier>]
Ce groupe d'options représente une liste nommée d'attributs XML. Lors d'une comparaison XML, une telle liste entraînera le classement des éléments XML par des attributs spécifiques avant la comparaison. Pour consulter un exemple, voir l'option --xml-order-by-attribute-list. Vous pouvez créer de multiples listes d’attributs, par exemple [xml.orderby :list1], [xml.orderby :list2], etc. Le nom de chaque liste d’attribut doit être unique.
attributs | Saisir ici l'attribut avec lequel les éléments XML doivent être triés ordonnés avant la comparaison, par exemple attributes = myattribute :
Vous pouvez aussi spécifier une liste séparée par virgules des attributs XML, par exemple : attributes = attr1, attr2, attr3 |
[xml.filter:<identifier>]
Ce groupe d'options représente un filtre qui vous permet d'ignorer les attributs ou les éléments avec un nom spécifique pendant la comparaison. Vous pouvez créer de multiples listes d’attributs, par exemple [xml.orderby :filter1], [xml.orderby :filter2], etc. Le nom de chaque groupe d’option doit être unique.
ignore-elements | Saisir ici une liste séparée par virgule des éléments XML qui doivent être ignorés lorsque ce filtre est utilisé. |
ignore-attributes | Saisir ici une liste séparée par virgule des attributs XML qui doivent être ignorés lorsque ce filtre est utilisé. |
ignore-both | Saisir ici une liste séparée par virgule des éléments et des attributs XML qui doivent être ignorés lorsque ce filtre est utilisé. |
Une fois que vous avez défini un filtre dans le fichier de configuration, vous pouvez le fournir dans la ligne de commande en utilisant l'option --xml-filter.
[text]
ignore-case | Lorsque vous exécutez la commande diff sans définir l’option --ignore-case , l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-blank-lines | Lorsque vous exécutez la commande diff sans configurer l’option --ignore-blank-lines, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
[dir]
ignore-case | Lorsque vous exécutez la commande diff sans configurer l'option --dir-ignore-case, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
compare-file-content | Lorsque vous exécutez la commande diff sans configurer l'option --dir-compare-contents, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
compare-sizes | Lorsque vous exécutez la commande diff sans configurer l'option --dir-compare-sizes, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
compare-modification-times | Lorsque vous exécutez la commande diff sans configurer l'option --dir-compare-mod-times, l’exécutable la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
ignore-modification-times | Lorsque vous exécutez la commande diff sans configurer l'option --dir-compare-mod-times-ignore-seconds, le programme d'exécution la recherchera dans ce fichier de configuration. Définir ici la valeur préférée par défaut pour cette option. |
[dir.filter:<identifier>]
Ce groupe d'options représente un filtre qui vous permet d'inclure ou d'ignorer des fichiers ou des répertoires qui suivent un schéma spécifique. Dans la ligne de commande, vous pouvez spécifier des filtres de répertoire en utilisant l'option --directory-filter. Dans le fichier de configuration, vous pouvez créer de multiples groupes d’options comme celles-ci, par exemple [dir.filter:filter1], [dir.filter:filter2], etc. Le nom de chaque groupe d’option doit être unique. Chaque groupe d'option peut contenir une ou plusieurs des options suivantes :
ignore-files | Une liste des extensions de fichier qui doivent être exclues de la comparaison (ignorées) lorsque ce filtre est actif. |
ignore-dirs | Une liste des noms de répertoire qui doivent être exclus de la comparaison (ignorées) lorsque ce filtre est actif. |
include-dirs | Une liste des noms de répertoire qui doivent être inclus à la comparaison lorsque ce filtre est actif. |
include-files | Une liste des extensions de fichier qui doivent être incluses dans la comparaison lorsque ce filtre est activé. |
include-archive-files | Spécifique à Windows. Réglez cette valeur comme true si des fichiers d'archives doivent être inclus dans le filtre ; sinon false. |
include-hidden-dirs | Spécifique à Windows. Réglez cette valeur comme true si des répertoires cachés doivent être inclus dans le filtre ; sinon false. |
include-hidden-files | Spécifique à Windows. Réglez cette valeur sur true si des fichiers cachés doivent être inclus dans le filtre ; sinon false. |
include-readonly-files | Spécifique à Windows. Réglez cette valeur sur true si des fichiers cachés doivent être inclus dans le filtre ; sinon false. |
include-system-dirs | Spécifique à Windows. Régler cette valeur sur true si des répertoires de système doivent être inclus dans le filtre ; sinon false. |
include-system-files | Spécifique à Windows. Régler cette valeur sur true si des fichiers de système doivent être inclus dans le filtre ; sinon false. |
Veuillez noter que l'application contient quelques filtres de répertoire intégrés (que vous n'aurez pas besoin de créer puisqu'ils seront reconnus même si vous ne les avez pas définis dans le fichier de configuration). Vous pouvez néanmoins modifier la définition de ces filtres dans le fichier de configuration, dans quel cas, votre filtre contournera la configuration intégrée. Les filtres intégrés sont les suivants :
xml | Lorsque ce filtre est actif et qu'une comparaison de répertoire est effectuée, les fichiers possédant les extensions suivantes sont inclus dans la comparaison : *.biz, *.cml, *.dcd, *.dtd, *.ent, *.fo, *.math, *.mml, *.mtx, *.rdf, *.smil, *.svg, *.tld, *.tsd, *.vml, *.vxml, *.wml, *.wsdl, *.xbrl, *.xdr, *.xhtml, *.xml, *.xsd, *.xsl, *.xslt.
Sur Windows, des fichiers de lecture seule et d'archive sont inclus dans la comparaison. |
text | Lorsque ce filtre est actif et qu'une comparaison de répertoire est effectuée, seuls les fichiers avec les extensions suivantes sont inclus dans la comparaison : *.asp, *.c, *.cc, *.cpp, *.cs, *.css, *.cxx, *.h, *.hpp, *.htm, *.html, *.java, *.jsp, *.rc, *.tlh, *.tli, *.txt.
Sur Windows, des fichiers en lecture seule et d'archive sont inclus dans la comparaison. |
nobinary | Lorsque ce filtre est actif et qu'une comparaison de répertoire est effectuée, les fichiers avec les extensions de fichier suivants sont ignorés : a.out, *.a, *.avi, *.bmp, *.chm, *.com, *.dll, *.doc, *.docm, *.docx, *.dot, *.dotm, *.dotx, *.exe, *.gif, *.gz, *.hlp, *.ico, *.ilk, *.jar, *.jpeg, *.jpg, *.lib, *.mdb, *.mid, *.mp2, *.mp3, *.mp4, *.mpeg, *.msi, *.o, *.obj, *.ogg, *.pdb, *.pdf, *.png, *.pps, *.ppt, *.pptx, *.rar, *.snd, *.so, *.tar, *.tif, *.tiff, *.tlb, *.ttf, *.wav, *.wma, *.wmf, *.wmv, *.xls, *.xlsx, *.zip |
cvs | Lorsque ce filtre est actif et qu'une comparaison de répertoire est effectuée, les fichiers avec les extensions de fichier suivants sont ignorés : .#*, .cvsignore, .cvsrc, .cvswrappers, .cvspass, .rhosts. De même, tout répertoire portant le nom CVS est ignoré.
Sur Windows, des fichiers en lecture seule et d'archive sont inclus dans la comparaison. |
svn | Lorsque ce filtre est actif et qu'une comparaison de répertoire est effectuée, tout répertoire portant le nom .svn est ignoré.
Sur Windows, des fichiers en lecture seule et d'archive sont inclus dans la comparaison. |
git | Lorsque ce filtre est actif et qu'une comparaison de répertoire est effectuée, tout répertoire portant le nom .git est ignoré. De même, tout fichier portant le nom .gitignore est ignoré.
Sur Windows, des fichiers en lecture seule et d'archive sont inclus dans la comparaison. |
[datasource:<name>]
Une section [datasource] définit les détails de connexion vers une base de données et spécifie plusieurs autres paramètres applicables lorsque vous effectuez des comparaisons de base de données. Vous pouvez créer plusieurs sources de données, le cas échéant. Pour plus d’information, voir Configurer des sources de données.
[datadiff:<name>]
Une section [datadiff] définit les paramètres d'une tâche de comparaison de données d'une base de données qui sera exécutée avec la commande data-diff. Vous pouvez créer plusieurs sections [datadiff], le cas échéant. Pour plus d'informations, voir Configurer des comparaisons CSV et de bases de données.