Come eseguire un'esportazione dati da Bravo a un documento Excel con Bravo Data Exchange

Sommario

Nel presente articolo viene spiegato come creare ed eseguire un Task di esportazione dati da Bravo a un documento Excel utilizzando il Bravo Data Exchange.

Premessa

Per una corretta consultazione delle nozioni di seguito riportate, occorre avere letto prima gli articoli:

• Che cos’è Bravo Data Exchange?
• Architettura di Bravo Data Exchange
• I formati di importazione ed esportazione dati supportati da Bravo Data Exchange

Come creare un Task di esportazione dati a un documento Excel

Si prenda ad esempio di volere esportare l'anagrafica degli articoli di Bravo in un documento di Microsoft Excel, per farlo è necessario creare e configurare opportunamente un Task di esportazione dati.
Seguire questi passaggi:

1. accedere a Bravo MES;
2. premere sulla voce "tool box";
3. premere sulla voce "DATA EXCHANGE";
4. posizionarsi sulla scheda "TASK DI ESPORTAZIONE";
5. premere sul pulsante "+ Nuovo" e poi selezionare la voce "+ Nuovo task";

6. si preme sul riquadro con il simbolo più al centro, relativo all’entità dei dati che si desiderano esportare. 
   L'entità definisce una tipologia di dati da importare o esportare su Bravo.
   Le entità possono riferirsi ad anagrafiche o documenti.
   Selezionando una entità, il sistema conosce la tipologia di dati che deve gestire e di conseguenza sa come elaborarli, quali sono i dati obbligatori, i formati e le tabelle/campi interessati.
   È possibile scorrere l'elenco delle entità o utilizzare il campo di filtro in alto per trovare l'entità desiderata. 
   In questo esempio si seleziona come entità "Articolo", per esportare i dati principali delle anagrafiche degli articoli su Bravo. In ogni Task è possibile selezionare solo una entità;

   

7. premere sul pulsante "Avanti";
8. indicare i seguenti dati:
   • "Codice", indicare un codice a libera scelta che identifica in modo univoco il Task di esportazione dati;
   • "Nome", indicare un nome a libera scelta per il Task;
   • "Descrizione", indicare una descrizione a libera scelta per il Task;
9. premere sul pulsante "Esporta su file Excel";
10. nel campo "Nome file" indicare il nome da attribuire al file di Excel generato per l'esportazione;
11. impostare la spunta sul campo "Nomi sulla prima" se si desidera che nel file di Excel generato, sulla prima riga siano riportati i nomi dei dati esportati, così da averne una definizione chiara e immediata;
12. impostando la spunta sul parametro "Sovrascrivi il contenuto di destinazione" quando viene eseguito il Task, se il file da generare è già presente nel percorso selezionato, lo strumento lo sovrascrive automaticamente, sostituendo i dati già presenti. Questo parametro si rileva molto utile, quando il Task viene eseguito più volte;
13. nel campo "In caso di troncamento" occorre indicare che comportamento la procedura deve attuare in caso di importazione di dati troncati, cioè quando un valore che viene importato ha una lunghezza maggiore rispetto al campo che deve ospitare il dato, è possibile scegliere:
    • "Applica e continua", se la procedura rileva l'esportazione di dati troncati, prosegue l'esportazione e trasferisce i dati troncati, in questo caso si potrebbero verificare delle incongruenze nei dati importati;
    • "Stop e annulla modifiche", se la procedura rileva l'esportazione di dati troncati, si interrompe e non trasferisce i dati;
      selezionare quindi il comportamento desiderato;
14. nel campo "Modalità di esecuzione" occorre indicare quale modalità di esportazione scegliere:
    • "Totale", la procedura esporta sempre tutti i dati presenti dalla fonte di origine;
    • "Incrementale", se nella tabella di origine di Bravo è presente un dato che riporta un valore di data/ora sulle righe, che rappresenta per esempio la data/ora di ultima modifica del dato, come "01/01/2026 9:00", in base a questo valore il sistema è in grado di identificare fino a dove ha eseguito l'esportazione, confrontando la data di ultima esecuzione del Task di esportazione, con la data/ora presenti sulla tabella di origine e quindi vengono esportate i soli dati he hanno una data/ora superiore alla data/ora di ultima esecuzione del Task. Per definire l'esportazione incrementale è necessario aggiungere nella griglia di associazione delle colonne, il confronto tra la colonna di data/ora sulla tabella di origine e la proprietà dell'entità "Data/Ora Ultimo Aggiornamento". Se questa mappatura non viene impostata, il sistema segnala con un messaggio di avvertimento che non è possibile configurare l'esportazione di tipo incrementale, quindi seleziona automaticamente il tipo totale e non consente la modifica del campo;
15. 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;
16. 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 viene salvato in anagrafica del Task di esportazione;
    • "Crea e lancia", il Task viene salvato nella relativa anagrafica e viene anche eseguito;
    • "Crea", il Task viene salvato nella relativa anagrafica, ma non viene eseguito;
17. premendo sul pulsante "Crea", la maschera di creazione del Task viene chiusa e il sistema si posiziona automaticamente sulla scheda dei Task di esportazione, 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 di esportazione dati a Microsoft Excel

Seguire le indicazioni sotto riportate per eseguire un Task di esportazione dati a un documento di Microsoft Excel:

1. accedere a Bravo MES;
2. premere sulla voce "tool box";
3. premere sulla voce "DATA EXCHANGE";
4. posizionarsi sulla scheda "TASK DI ESPORTAZIONE";
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.
Il file di Excel generato viene salvato nel percorso dell'installazione di Bravo sul server, cioè
"\\<Nome Server>\BRAVOSERVER\BravoShared\BravoDataExchange\".

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 di esportazione dati

L'esecuzione dei Task di esportazione dati 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 di esportazione dati 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 di esportazione dati precedentemente creato

Bravo Data Exchange consente di modificare le impostazioni di un Task di esportazione dati precedentemente creato, qualora siano 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";
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:
   1. "Lancia", il Task viene eseguito, ma non vengono salvate le modifiche apportate in anagrafica del Task di esportazione;
   2. "Aggiorna e lancia", le modifiche apportate vengono salvate nella relativa anagrafica del Task e viene anche eseguito;
   3. "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.