Cosa sono e come usare i Task script SQL

Sommario

In questo articolo viene data la definizione dei Task script SQL e come si creano su Bravo Data Exchange.

Premessa

Per una corretta consultazione del presente articolo, occorre avere prima letto gli articoli:

• Come eseguire un'esportazione dati da Bravo a un documento Excel con Bravo Data Exchange
• Come eseguire un'esportazione dati da Bravo a un database di Microsoft SQL Server con Bravo Data Exchange
• Come eseguire un'importazione dati da un documento Excel a Bravo con Bravo Data Exchange
• Come eseguire un'importazione dati da un database di Microsoft SQL Server a Bravo con Bravo Data Exchange

Cosa sono i Task script SQL?

I Task script SQL sono dei Task di Bravo Data Exchange che possono essere predisposti per eseguire query di Microsoft SQL Server sul database di Bravo o altro database.
Questa tipologia di Task conferisce una elevata flessibilità e personalizzazione ai processi di importazione ed esportazione dati.
Durante l'esecuzione di Task di importazione o esportazione dati è possibile impostare di eseguire query di modifica, aggiornamento o eliminazione che agiscono su uno dei database interessati dai processi di trasferimento dati.
I Task script SQL offrono quindi una grande possibilità di personalizzazione nel trasferimento dati, andando ad affiancarsi alle funzionalità dei Task di importazione ed esportazione dati, facendo divenire Bravo Data Exchange uno strumento ottimale nei processi di trasferimento dati.

Nota bene

Si indica di prestare molta attenzione nell'utilizzo dei Task script SQL, in quanto lo strumento non pone limiti al tipo di query che si possono eseguire, quindi si possono eseguire query di modifica, aggiornamento ed eliminazione dati su un database e una volta eseguite le query non è possibile annullarle.

Come creare un Task script SQL?

Per creare un Task script SQL da usare in importazione o esportazione dati seguire queste indicazioni:

1. accedere a Bravo MES;
2. premere sulla voce "tool box";
3. premere sulla voce "DATA EXCHANGE";
4. posizionarsi sulla scheda "TASK DI ESPORTAZIONE" o sulla scheda "TASK DI IMPORTAZIONE";
5. premere sul pulsante "+ Nuovo" e poi selezionare la voce "+ Nuovo script SQL";
6. indicare i seguenti dati:
   • "Codice", indicare un codice a libera scelta che identifica in modo univoco il Task script SQL;
   • "Nome", indicare un nome a libera scelta per il Task;
   • "Descrizione", indicare una descrizione a libera scelta per il Task;
7. premere sul pulsante "Avanti";
8. selezionare la connessione dati desiderata, utilizzando il campo a tendina del relativo campo.
   Per approfondimenti su cosa sono e come configurare delle connessioni dati consultare l'articolo Come creare una Connessione dati su Bravo Data Exchange. È possibile selezionare una connessione dati precedentemente creata o premere sulla voce "+ Crea una nuova connessione" e compilare la scheda mostrata;
9. premere sul pulsante "Controlla connessione" per validare la connessione dati selezionata;
10. la connessione dati selezionata è il database di destinazione dei dati esportati;
11. premere sul pulsante "Avanti";
12. nel riquadro "Script" è possibile digitare o incollare la query che deve essere eseguita dal Task;
13. premendo sul pulsante "Controllo Script" per eseguire una verifica della sintassi della query; questa funzione consente di eseguire un controllo di validità per la corretta esecuzione della query. Viene visualizzato un messaggio che indica se la sintassi è corretta o meno, in caso di errore, la query deve essere sistemata fino a quando l'esito della verifica non è positivo; altrimenti non è possibile proseguire con la creazione del Task;
14. il parametro "Esegui questo task solo se è incluso in un job" se abilitato, consente di vincolare l'esecuzione del Task solo se è stato indicato all'interno di un Job, non può essere quindi eseguito singolarmente. Un Job è un aggregato di Task della stessa tipologia che possono essere eseguiti insieme massivamente;
15. completata la configurazione dei parametri ai punti precedenti, premere su uno di questi pulsanti per eseguire l'azione desiderata:
    1. "Lancia", il Task viene eseguito, ma non viene salvato in anagrafica dei Task;
    2. "Crea e lancia", il Task viene salvato nella relativa anagrafica e viene anche eseguito;
    3. "Crea", il Task viene salvato nella relativa anagrafica, ma non viene eseguito;
16. premendo sul pulsante "Crea", la maschera di creazione del Task viene chiusa e il sistema si posiziona automaticamente sulla scheda dei Task, dove è presente il Task appena creato.

Il pulsante "Indietro" consente di ritornare allo step precedente del wizard rispetto a quello dove si è posizionati e il pulsante "X" consente di annullare la creazione del Task di esportazione e viene visualizzato un'ulteriore messaggio di conferma per annullare la creazione del Task.

Come eseguire un Task script SQL

Seguire le indicazioni sotto riportate per eseguire un Task script SQL:

1. accedere a Bravo MES;
2. premere sulla voce "tool box";
3. premere sulla voce "DATA EXCHANGE";
4. posizionarsi sulla scheda "TASK DI ESPORTAZIONE" o sulla scheda "TASK DI IMPORTAZIONE";
5. sulla riga relativa al Task che si desidera eseguire sono presenti tre pulsanti, ognuno con uno specifico scopo:
   • premendo il pulsante il Task viene eseguito;
   • premendo il pulsante il Task viene simulato, cioè l'esportazione non viene effettivamente eseguita, ma viene eseguita una verifica di convalida di configurazione del Task, per avere conferma che è stato creato correttamente;
   • premendo il pulsante è possibile visionare una scheda con il log generati a seguito dell'esecuzione effettiva o simulata del Task.

Durante l'esecuzione di un Task, che sia in effettivo o che sia in simulato, nella colonna "PROGRESSO" viene visualizzata una barra di avanzamento dell'elaborazione e al termine, nella colonna "RISULTATO ULTIMA ESECUZIONE" viene mostrato l'esito dell'esecuzione del Task, se eseguito con successo o se con errori.
Nella colonna "ULTIMA ESECUZIONE" viene indicata la data/ora di ultima esecuzione del Task, sia in effettivo che in simulato.

Premendo sul pulsante è possibile visualizzare la scheda con le informazioni dei log relativi all'esito delle elaborazioni di un Task, in merito è possibile consultare l'articolo Come gestire i log dei Task.

Come pianificare l'esecuzione dei Task script SQL

L'esecuzione dei Task script SQL può essere pianificata ad orari o intervalli di tempo prestabiliti, in modo che non sia necessario che un utente si ricordi ogni volta di eseguirla manualmente.
Questa funzionalità rappresenta un valido aiuto nell'automatizzare il processo di trasferimento dati ed agevolare gli utenti nell'utilizzo del software.
Per schedulare l'esecuzione automatica dei Task script SQL di Bravo Data Exchange è sufficiente seguire le indicazioni riportate in questo articolo La schedulazione dei processi di Bravo.
La funzione di pianificazione consente anche di attivare delle notifiche a mezzo email, così da avvisare uno o più utenti se il trasferimento dati è completato correttamente o con errori, così se necessario si può intervenire per gestire i casi di errori e sistemarli e monitorare i trasferimenti dati eseguiti.
Se ad una esecuzione pianificata o anche manuale, non vi sono dati da trasferire, questa viene eseguita comunque.

Come modificare un Task script SQL

Bravo Data Exchange consente di modificare le impostazioni di un Task script SQL precedentemente creato, qualora sia necessario apportare delle variazioni.
Per farlo è sufficiente seguire queste azioni:

1. accedere a Bravo MES;
2. premere sulla voce "tool box";
3. premere sulla voce "DATA EXCHANGE";
4. posizionarsi sulla scheda "TASK DI ESPORTAZIONE" o sulla scheda "TASK DI IMPORTAZIONE";
5. premere sul codice del Task;
6. viene visualizzato il wizard di creazione Task, in questo caso però trattandosi di un Task già creato, gli step del wizard vengono proposti già configurati e l'utente può variare i parametri che desidera e premere sul pulsante "Avanti" fino ad arrivare allo step finale;
7. completata la configurazione dei parametri ai punti precedenti, premere su uno di questi pulsanti per eseguire l'azione desiderata:
   • "Lancia", il Task viene eseguito, ma non vengono salvate le modifiche apportate in anagrafica del Task di esportazione;
   • "Aggiorna e lancia", le modifiche apportate vengono salvate nella relativa anagrafica del Task e viene anche eseguito;
   • "Aggiorna", le modifiche apportate vengono salvate nella relativa anagrafica del Task, ma non viene eseguito.

Sulla maschera è presente anche il campo "Ultima esecuzione" che riporta la data/ora di ultima esecuzione del Task.
Nel caso sia necessario rilanciare l'esecuzione del Task con una data/ora precedenti all'ultima, per esempio l'ultima esecuzione del Task era andata in errore, è possibile variare questo dato premendo sul pulsante ed utilizzando l'apposito menù per selezionare giorno ed orario e poi premere sul pulsante "OK" per confermare.
Il pulsante "Ripristina precedente" se premuto, consente di reimpostare la data/ora che erano presenti sul campo "Ultima esecuzione" prima della data/ora che sono attualmente impostati.
Si indica di porre attenzione nel variare la data/ora di ultima esecuzione per evitare incongruenze di esecuzione nell'esportazione dati, la modifica deve essere eseguita in specifici casi e valutando bene la modifica.

Approfondimenti 

Un Task script SQL può contenere più query in sequenza.

Anche l'esecuzione dei Task script SQL genera dei log, che sono consultabili come descritto in questo articolo Come gestire i log dei Task di Bravo Data Exchange, ma si consideri che nei log dei Task script SQL viene riportato solo se l'esecuzione del Task è completata correttamente oppure no. Nel log non sono riportate informazioni di dettaglio sulle query eseguite.

Quanto riportato in questo articolo La gestione dei Task di importazione ed esportazione dati è valido anche per i Task script SQL.