Sostituzione delle stringhe di connessione al database

Il file di configurazione per il servizio Automation può includere i comandi di sostituzione della stringa di connessione al database.

È possibile configurare il servizio per sostituire alcune parti di una stringa di connessione mentre il trigger è in esecuzione. Consente a un’unica istanza di Automation di eseguire la stessa configurazione, ma in pratica di usare un server di database diverso per la funzionalità correlata al database. Ciò consente all'utente di configurare i trigger negli ambienti di sviluppo e di eseguirli negli ambienti di produzione senza apportare modifiche alla configurazione.

La logica di sostituzione della stringa di connessione è definita nel file DatabaseConnections.Config che si trova nella cartella di sistema Automation.

  1. Aprire il file di sistema Automation di %PROGRAMDATA%\NiceLabel\NiceLabel 10

  2. Creare un file con il nome DatabaseConnections.config.

  3. Aprire il nuovo creato file DatabaseConnections.config in un editore di testo e inserire il contenuto di esempio:

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

    Questo esempio di XML è un esempio, in cui un trigger esistente contiene una connessione al server Microsoft SQL denominato mySQLServer e a un database denominato myDatabase. È opportuno aggiornare la stringa di connessione per usare il database NEW_myDatabase sul server NEW_mySQLServer.

    È necessario definire due elementi di ricambio, uno per modificare il nome del server e uno per modificare il nome del database.

  4. Controllare la stringa di connessione esistente nelle etichette, quindi modificare il contenuto di <Sostituzione> con i valori corretti.

    Il file configurazione definisce le coppie di origine e di destinazione utilizzandone la struttura XML. Il tag <Replacement> contiene un elemento <From> e un elemento <To>. Durante l'esecuzione del trigger, la stringa "from" viene sostituita dalla stringa "to". È possibile definire il numero di elementi <Replacement> necessari.

    Nota

    Alcune stringhe di connessione usano Server=nomeserver mentre altre usano Data Source=nomeserver. Se si utilizza lo stesso database, non bisogna inserire i nomi dei database.

  5. Editare il file product.config localizzato in %PROGRAMDATA%\NiceLabel\NiceLabel 10. Aggiungere l’elemento /Common/General/UseLocalReplacementStrings e assegnare il valore True:

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
        <Common>
            <General>
            ...
                <UseLocalReplacementStrings>True</UseLocalReplacementStrings>
            </General>
        </Common>
    ...
    </configuration>
  6. Riavviare entrambi i servizi Automation dopo aver aggiunto o modificato i file di configurazione.

  7. Ripetere i passaggi da 1 a 6 su tutti i computer che eseguono configurazioni Automation in cui si desidera sostituire le stringhe di connessione al database.

Nota

La sostituzione della stringa di connessione al database non modifica le stringhe di connessione nei file di etichetta. Questa procedura sovrascrive semplicemente le stringhe di connessione durante la stampa da Automation.