Remplacement de la chaîne de connexion à la base de données

Un fichier de configuration du Service Automation peut comporter des commandes de remplacement de la chaîne de connexion à la base de données.

Vous pouvez configurer le service pour remplacer certaines parties de la chaîne de connexion pendant que le déclencheur s'exécute. Une seule instance de Automation peut donc utiliser la même configuration, mais utiliser différents serveurs de base de données pour les fonctionnalités relatives aux bases de données. Cela permet à l'utilisateur de configurer les déclencheurs dans les environnements de développement et de les exécuter dans des environnements de production sans rien changer à la configuration.

La logique de remplacement de la chaîne de connexion est définie dans le fichier DatabaseConnections.Config dans le dossier système de Automation.

  1. Ouvrir le dossier système Automation %PROGRAMDATA%\NiceLabel\NiceLabel 10

  2. Créer un fichier nommé DatabaseConnections.config.

  3. Ouvrir le nouveau fichier créé DatabaseConnections.config dans un éditeur de texte et saisir le contenu de l’échantillon :

    <?xml version="1.0" encoding="UTF-8"?>
    <DatabaseConnectionReplacements>
        <Replacement>
            <From>Data Source=mySQLServer</From>
            <To>Data Source=NEW_mySQLServer</To>
        </Replacement>
        <Replacement>
            <From>Initial Catalog=myDatabase</From>
            <To>Initial Catalog=NEW_myDatabase</To>
        </Replacement>
    </DatabaseConnectionReplacements>

    Cet échantillon XMLL est un exemple, où un déclencheur existant contient une connexion au serveur Microsoft SQL appelé mySQLServer et à une base de données appelée myDatabase. La chaîne de connexion doit être mise à jour pour utiliser la base de données NEW_myDatabase sur le serveur NEW_mySQLServer.

    Il faut définir deux éléments, un pour changer le nom du serveur, et l'autre pour changer le nom de la base de données.

  4. Vérifier la chaîne de connexion existante dans vos étiquettes, puis remplacer le contenu <Remplacement> par les valeurs correctes.

    Le fichier de configuration XML définit des paires source-destination. L'élément <Remplacement> contient un élément <De> et un élément <À> . Au cours de l'exécution du déclencheur, la chaîne De est remplacée par la chaîne À. Il est possible de définir autant d'éléments de <Remplacement> que nécessaire.

    Note

    Certaines chaînes de connexion utilisent Serveur=servername et d’autres Source de données=servername. Si vous utilisez la même base de données, il est inutile de saisir les noms de base de données.

  5. Modifiez votre fichier product.config situé dans %PROGRAMDATA%\NiceLabel\NiceLabel 10. Ajouter l’élément /Common/General/UseLocalReplacementStrings et attribuer la valeur True :

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
        <Common>
            <General>
            ...
                <UseLocalReplacementStrings>True</UseLocalReplacementStrings>
            </General>
        </Common>
    ...
    </configuration>
  6. Redémarrer les deux services Automation après avoir ajouté ou modifié les fichiers de configuration.

  7. Répéter les étapes 1 à 6 sur tous les ordinateurs qui exécutent les configurations Automation où vous souhaitez remplacer des chaînes de connexion de base de données.

Note

Le remplacement de chaînes de connexion de base de données ne modifie pas les chaînes de connexion dans vos fichiers d’étiquettes. Cette procédure ignore simplement les chaînes de connexion lors d’une impression depuis Automation.