Aggiornamento attributi da file system

Questa funzionalità consente di aggiornare i dati dei files archiviati in Business File con le informazioni contenute in un file CSV (Comma Separated Values).


La funzionalità può essere lanciata direttamente da interfaccia grafica mediante l'eseguibile AggiornaAttributiFileSystem.exe oppure schedulata passandogli come parametro un file .xml con le informazioni necessarie alla procedura:

  • Utente Business File
  • Codice Ditta Business File
  • Cartella contenente i files CSV da elaborare
  • Cartella dei log
  • File profilo (*)
  • File fittizio (**)
  • Flag record multipli
  • Flag record mancanti


(*) Il file profilo di configurazione è un file xml in cui specificare la mappatura fra gli attributi della categoria e le colonne del file CSV; nella mappatura saranno evidenziati quali attributi sono da considerare "chiave" per la ricerca dei record da aggiornare in Business File.

Il profilo di configurazione conterrà anche il codice della categoria da aggiornare e il carattere di separazione presente nel CSV.


(**) Nel caso in cui in corrispondenza di un record del file CSV non sia trovato nessun documento archiviato il programma può scartare la riga oppure archiviare un documento “fittizio” e associargli gli attributi presi dal file CSV (il documento fittizio è sempre lo stesso per tutti i documenti mancanti).


L'elaborazione analizzerà i files .CSV presenti nella cartella sorgente e genererà nella cartella di log un file di testo con il risultato dell'elaborazione e gli eventuali errori restituiti dal programma; al termine dell'elaborazione il file CSV verrà spostato nella cartella di log in modo tale da svuotare la cartella di partenza.


Configurazione

File Configurazione.xml


Di seguito la struttura del file xml con i parametri dell'elaborazione da passare al programma:


<?xml version="1.0" encoding="utf-8" ?>

<PARAMETRI>

  <UTENTE>admin</UTENTE>

  <CODICEDITTA>DEFAULT</CODICEDITTA>

  <CARTELLAINPUT>C:\Users\luca.giglio\Desktop\Schedulazioni\AggiornaAttributiFileSystem\Cartella_Input</CARTELLAINPUT>

  <CARTELLALOG>C:\Users\luca.giglio\Desktop\Schedulazioni\AggiornaAttributiFileSystem\Log</CARTELLALOG>

  <FILEPROFILO>C:\Users\luca.giglio\Desktop\Schedulazioni\AggiornaAttributiFileSystem\Profilo.xml</FILEPROFILO>

  <FILEFITTIZIO>C:\Users\luca.giglio\Desktop\Schedulazioni\AggiornaAttributiFileSystem\FilePDF.pdf</FILEFITTIZIO>

  <!--  A=Aggiorna  S=Scarta --> 

  <RECORDMULTIPLI>S</RECORDMULTIPLI>

  <!-- I=Inserisci S=Scarta -->

  <RECORDMANCANTI>S</RECORDMANCANTI>

</PARAMETRI>


Per i vari tag il significato è il seguente:

Nome Tag

Valori ammessi

<UTENTE>

Utente di Business File che esegue l'elaborazione

<CODICEDITTA>

Ditta di lavoro di Business File

<CARTELLAINPUT>

Percorso della cartella contenente i file CSV da elaborare

<CARTELLALOG>

Percorso della cartella utilizzata per i log e i file elaborati

<FILEPROFILO>

Percorso e nome del file .xml con le specifiche del profilo di configurazione

<FILEFITTIZIO>

Percorso e nome del file .pdf da archiviare nel caso in cui la procedura inserisca nuovi record

<RECORDMULTIPLI>

Per record multipli si intendono due o più record aventi identici attributi chiave. Può assumere uno dei seguenti valori:

  • A: aggiorna tutti i record
  • S: scarta il record

<RECORDMANCANTI>

Per record mancante si intende un record presente nel file CSV, ma assente in Business File. Può assumere uno dei seguenti valori:

  • I: inserisci il nuovo record archiviando il file fittizio
  • S: scarta il record



File Profilo.xml


Di seguito la struttura del file .xml per la configurazione del profilo (i campi di sistema non sono aggiornabili ad eccezione del barcode):


<?xml version="1.0" encoding="utf-8" ?>

<PARAMETRI_PROFILO>

<CODCATEGORIA>68</CODCATEGORIA>

<SEPARATORE>;</SEPARATORE>

<RIGAINIZIO>1</RIGAINIZIO>

<LISTA_ATTRIBUTI>

       <ITEM>

               <ATTRIBUTO>1</ATTRIBUTO>

               <COLONNA>A</COLONNA>

               <PK>N</PK>

       </ITEM>

       <ITEM>

               <ATTRIBUTO>2</ATTRIBUTO>

               <COLONNA>B</COLONNA>

               <PK>S</PK>

       </ITEM>

       <ITEM>

               <ATTRIBUTO>33</ATTRIBUTO>

               <COLONNA>C</COLONNA>

               <PK>N</PK>

       </ITEM>

       

       <ITEM>

               <ATTRIBUTO>34</ATTRIBUTO>

               <COLONNA>D</COLONNA>

               <PK>S</PK>

       </ITEM>

       

       <ITEM>

               <ATTRIBUTO>35</ATTRIBUTO>

               <COLONNA>E</COLONNA>

               <PK>N</PK>

       </ITEM>

       <ITEM>

               <ATTRIBUTO>36</ATTRIBUTO>

               <COLONNA>F</COLONNA>

               <PK>N</PK>

       </ITEM>

</LISTA_ATTRIBUTI>

</PARAMETRI_PROFILO>  



Per i vari tag il significato è il seguente:

Nome tag

Valori ammessi

<CODCATEGORIA>

Codice della categoria da aggiornare; disponibile in Business File da menù Impostazioni → Categorie → Struttura

<SEPARATORE>

Carattere utilizzato come separatore colonne nel file CSV

<RIGAINIZIO>

Numero della prima riga da analizzare

<ATTRIBUTO>

Codice del campo da aggiornare; disponibile in Business File da menù Impostazioni → Categorie → Struttura (nella griglia è il valore Num. Campo)

<COLONNA>

Nome della colonna da analizzare nel file CSV

<PK>

Indica se il campo è da considerarsi chiave nella ricerca dei record da aggiornare. Può assumere uno dei seguenti valori:

  • S: considera l'attributo come chiave per la ricerca dei record
  • N: l'attributo non è chiave per la ricerca dei record

Possono essere indicati più campi chiave contemporaneamente, la ricerca viene fatta con la condizione AND

Elaborazione

L'elaborazione analizzerà tutti i file presenti nella cartella sorgente e genererà nella cartella di log un file di testo con il risultato dell'elaborazione e gli eventuali errori restituiti dal programma; al termine della procedura il file CSV viene spostato nella cartella di log in modo da svuotare la cartella di partenza.

Nel caso di elaborazione schedulata il file di configurazione sarà passato come parametro al programma, mentre nel caso di elaborazione manuale l'utente, dopo il login, dovrà selezionare un file di configurazione da utilizzare (in questo caso sul file di configurazione possono essere omessi username, password e ditta in quanto inseriti in fase di login).



Per procedere con l'elaborazione fare click su .