Reemplazo de cadena de conexión de bases de datos

Un archivo de configuración para el Servicio de Automation puede incluir comandos de reemplazo de cadenas de conexión de bases de datos.

El usuario puede configurar el servicio para reemplazar ciertas partes de la cadena de conexión mientras se ejecuta el desencadenador. Esto permite que una instancia única de Automation use la misma configuración, pero en realidad utiliza un servidor de bases de datos diferente para la funcionalidad relacionada a la base de datos. Esto permite al usuario configurar desencadenadores en los entornos de desarrollo y ejecutarlos en los entornos de producción sin ningún cambio en la configuración.

La lógica de reemplazo de la cadena de conexión está definida en el archivo llamado DatabaseConnections.Config en la carpeta del sistema de Automation.

  1. Abra la carpeta Sistema de Automation %PROGRAMDATA%\NiceLabel\NiceLabel 10

  2. Cree un archivo con el nombre DatabaseConnections.config.

  3. Abra el archivo DatabaseConnections.config recién creado en un editor de texto e introduzca el contenido de muestra:

    <?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>

    Este XML de muestra es un ejemplo, donde un desencadenador existente tiene una conexión con el servidor de Microsoft SQL llamado mySQLServer y la base de datos llamada myDatabase. Debe actualizar la cadena de conexión para usar la base de datos NEW_myDatabase en el servidor NEW_mySQLServer.

    Se deben definir dos elementos de Reemplazo, uno para cambiar el nombre del servidor y uno para cambiar el nombre de la base de datos.

  4. Verifique la cadena de conexión existente en sus etiquetas y, luego, cambie el contenido de <Replacement> usando los valores correctos.

    El archivo de configuración define los pares desde-hasta en la estructura XML. La etiqueta <Replacement> contiene un elemento <From> y un elemento <To>. Durante la ejecución de desencadenadores, la cadena "desde" se reemplaza con la cadena "hasta". Puede definir todos los elementos <Replacement> que sean necesarios.

    Nota

    Algunas cadenas de conexión utilizan Server=servername, mientras que otras utilizan Data Source=servername. Si utiliza la misma base de datos, no es necesario introducir nombres de bases de datos.

  5. Edite su archivo product.config que se encuentra en %PROGRAMDATA%\NiceLabel\NiceLabel 10. Añada el elemento /Common/General/UseLocalReplacementStrings y asigne el valor Verdadero:

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
        <Common>
            <General>
            ...
                <UseLocalReplacementStrings>True</UseLocalReplacementStrings>
            </General>
        </Common>
    ...
    </configuration>
  6. Reinicie ambos servicios de Automation después de haber agregado o editado los archivos de configuración.

  7. Repita los pasos 1 a 6 en todas las computadoras que ejecuten las configuraciones de Automation donde desee remplazar las cadenas de conexión de las bases de datos.

Nota

El reemplazo de cadenas de conexión de las bases de datos no modifica las cadenas de conexión de sus archivos de etiquetas. Este proceso simplemente anula las cadenas de conexión cuando imprime desde Automation.