Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- guide:suapsue:tracciato_importazione_excel [2025/05/20 10:42] – l.liberati
+++ guide:suapsue:tracciato_importazione_excel [2025/09/18 10:58] (versione attuale) – l.torregiani
@@ Linea 1: / Linea 1: @@
-====== Tracciato (metadati) per l'importazione da Excel ======
+====== Importazione da Excel ======
-===== Compilazione metadati Excel =====
+E' possibile importare Fascicoli Elettronici e relativi allegati da un file Excel in due modalità:
+  * **Una riga di Excel per pratica**\\ Ogni riga rappresenta una pratica. Specificando la colonna PATH verranno importati anche tutti gli allegati associati alla pratica.
+  * **Una riga di Excel per allegato**\\ Ogni riga rappresenta un allegato. In questa seconda modalità, tutte le colonne valorizzate (dati da recuperare) vanno ripetute in tutte le righe della stessa pratica.
-E' possibile creare dei Fascicoli Elettronici partendo da un file Excel (__una riga di Excel per ogni pratica__); è possibile inoltre acquisire tutti i file (allegati scansionati o altro) che si riferiscono ad ogni pratica (riga di Excel) occorre però che quest'ultima sia rintracciare tramite la **"PATH"**.
+===== Tracciato file Excel =====
+La prima riga del file, conterrà i nomi delle colonne (come mostrato in seguito) e __**non va modificata**__.\\
+Per ogni colonna è indicato se è **Obbligatoria** o **Alternativa** ad un'altra.
+Le altre colonne sono opzionali e possono essere lasciate vuote.
-Esiste anche una seconda opzione di acquisizione, quella di riconoscere __una riga di Excel per ogni allegato__ (**opzione sconsigliata ma gestibile**).
+Scarica una copia del tracciato cliccando qui: {{ :guide:suapsue:importazione_excel:tracciato_importazione_excel.xlsx |}}\\
+(cancella il foglio non usato in base alla modalità di importazione)
-In questa seconda modalità, tutte le colonne valorizzate (dati da recuperare) si devono ripetere in tutte le righe della stessa pratica.
-**Tracciato Excel**\\
-I nomi delle colonne sono vincolanti, __**si devono chiamare come illustrato di seguito**__.\\
-La prima riga del file Excel con i dati da recuperare, deve contenere le stesse descrizioni riportate di seguito (Nome colonna Excel).\\
-In grassetto le colonne **"obbligatorie"**, con la dicitura **"Alternativo a "** le colonne alternative ad altre.
-Le colonne che non si valorizzeranno possono essere omesse.\\
-Altre colonne, altri dati non codificati in questo documento possono comunque essere liberamente aggiunte con l'accortezza che il nome della colonna deve essere in MAIUSCOLO e senza spazi (come lo sono tutte quelle codificate). Le informazioni mappate in questo modo si potranno consultare e gestire nella tab [Dati aggiuntivi] di ogni pratica recuperata.
-Scarica una copia del tracciato cliccando qui: {{ :guide:suapsue:importazione_excel:tracciato_importazione_excel.xlsx |}}
 ^ Nome colonna Excel       ^ Note                  ^ Controllo                              ^
@@ Linea 30: / Linea 25: @@
 |CF_PIVA_RICHIEDENTE       |Alfanumerico da 16     |                                        |
 |OGGETTO                   |Alfanumerico da 255    |                                        |
-|UBICAZIONE                |Alfanumerico da 80     |v. specifiche                           |
+|UBICAZIONE                |Alfanumerico da 80     |[[#Ubicazione|Vedi specifiche]]                         |
 |N_CIVICO                  |Alfanumerico da 10     |                                        |
 |SEZ                       |Alfanumerico da 3      |                                        |
@@ Linea 53: / Linea 48: @@
 |CODICE_EVENTO             |Alfanumerico da 6      |Palitalsoft                             |
 |NOME_ALLEGATO             |                       |Solo se si crea una riga per ogni allegato della pratica|
-|PATH                      |Percorso relativo della cartella con i file da allegare: Es. 1985-0521_pratica di test|Obbligatorio: SE **NOME_ALLEGATO** <> da vuoto|
+|DESCRIZIONE_ALLEGATO      |Alfanumerico da 500    |                                        |
+|PATH                      |Percorso relativo della cartella con i file da allegare: Es. 1985-0521_pratica di test|Obbligatorio: se //NOME_ALLEGATO// <> da vuoto o se si crea una riga per ogni allegato|
 |**TIPO_PRATICA**          |**Alfanumerico da 255**|**Obbligatorio Esempio: Permesso di Costruire; SCIA; Abitabilità, ecc.**|
 ===== Specifiche dei campi =====
-Una possibilità fondamentale è quella di riconoscere se la pratica (riga) che si sta per importare possa già esistere nel gestionale CWOL – Palitalsoft e quindi si potrà decidere di skippare la riga o integrare i dati, in particolare importare gli allegati senza creare la pratica proprio perché già esistente.\\
+Il programma di importazione riconosce se la pratica (riga) che si sta per importare esiste già nel gestionale CWOL - Palitalsoft e consente quindi di integrare nuovi dati alle pratiche già esistenti.\\
-Per poter riconoscere in modo univoco le pratiche, si devono valorizzare le prime due colonne (ANNO e NUMERO) le quali saranno controllate con il numero pratica attualmente presente sui Fascicoli Elettronici già esistenti (esempio di un nostro numero pratica: SUE/154/2010).
+Questa caratteristica risulta particolarmente utile per importare allegati per pratiche già esistenti.
+Per poter riconoscere le pratiche in modo univoco, è necessario valorizzare le prime due colonne (ANNO e NUMERO) che saranno confrontate con il numero pratica attualmente presente sui Fascicoli Elettronici già esistenti.
+Esempio di un nostro numero pratica: SUE/154/2010.
 SUE = sigla che deriva dal CODICE_SPORTELLO (assegnazione fatta da Palitalsoft)
-= NUMERO_PRATICA
+= NUMERO_PRATICA\\
 = ANNO_PRATICA\\
-Questa coppia di numeri risulta quindi fondamentale per riconoscere le pratiche e anche per crearle dal file Excel.
+Questa coppia di numeri risulta quindi fondamentale per riconoscere le pratiche e anche per crearle dal file Excel.\\
+__Se si sceglie la modalità //Una riga per allegato// ripetere NUMERO e ANNO per ogni riga dello stessa pratica.__
-==== NOMINATIVO_RICHIEDENTE ====
+==== NOMINATIVO_RICHIEDENTE e CF_PIVA_RICHIEDENTE ====
-Nella colonna **"NOMINATIVO_RICHIEDENTE"** possono essere valorizzati anche più di un nominativo, basta utilizzare un carattere separatore, esempio:
+Questi due campi possono contentere più valori separati da un carattere separatore.
-MARIO COSSI #@ MATTEO COSSI #@ ROSSI VINCENZO
-Risultato 3 anagrafiche distinte, senza distinzione tra cognome e nome o viceversa; è opportuno adottare un metodo omogeneo di inserire i dati (sempre cognome nome o nome cognome).
+Alcuni esempi utilizzando il carattere separatore **#@**
-Il carattere separatore usato in esempio (#@) è a libera scelta dell’operatore che compila il file Excel;**è necessario che in tutte le anagrafiche (in tutte le righe) si usi lo stesso carattere separatore**.
+^ NOMINATIVO_RICHIEDENTE  ^ CF_PIVA_RICHIEDENTE ^
+|ROSSI MARIO#@ROSSI LUIGI |RSSMRA12A34B567C     |
+Verranno create due anagrafiche di cui **solo la prima** contiene un valore di codice fiscale / partita IVA.
+^ ANAGRAFICA ^CODICE FISCALE / P.IVA ^
+|ROSSI MARIO |RSSMRA12A34B567C       |
+|ROSSI LUIGI |                       |
+----
+^ NOMINATIVO_RICHIEDENTE  ^ CF_PIVA_RICHIEDENTE ^
+|ROSSI MARIO#@ROSSI LUIGI |#@RSSLGU98A76B543C   |
+Verranno create due anagrafiche di cui **solo la seconda** contiene un valore di codice fiscale / partita IVA.
+^ ANAGRAFICA ^CODICE FISCALE / P.IVA ^
+|ROSSI MARIO |                       |
+|ROSSI LUIGI |RSSLGU98A76B543        |
+----
+^ NOMINATIVO_RICHIEDENTE  ^ CF_PIVA_RICHIEDENTE              ^
+|ROSSI MARIO#@ROSSI LUIGI |RSSMRA12A34B567C#@RSSLGU98A76B543C|
+Verranno create due anagrafiche ed entrambe hanno valorizzato il codice fiscale / partita IVA.
+^ ANAGRAFICA ^CODICE FISCALE / P.IVA ^
+|ROSSI MARIO |RSSMRA12A34B567C       |
+|ROSSI LUIGI |RSSLGU98A76B543C       |
+----
+Per il //NOMINATIVO_RICHIEDENTE// è opportuno adottare un metodo omogeneo di inserimento dati (sempre "COGNOME NOME" o sempre "NOME COGNOME").\\
+Il carattere separatore (negli esempi **#@**) è a libera scelta dell’operatore che compila il file Excel e deve essere lo stesso per tutte le righe della colonna NOMINATIVO_RICHIEDENTE.\\
 **ATTENZIONE: Ampiezza massima 255 caratteri spazi inclusi**
 ==== UBICAZIONE ====
-Nella colonna **"UBICAZIONE"** può contenere anche il numero civico, in questo caso va separato da un carattere separatore, esempio utilizzando la virgola "," come carattere separatore:
+La colonna **"UBICAZIONE"** può contenere anche il numero civico, che va preceduto da un carattere separatore.\\
+Esempio utilizzando la virgola "," come carattere separatore:
   * VIA ROMA, 15/A = ok
   * VIA TORINO, 2 = ok
@@ Linea 84: / Linea 118: @@
   * Separare i valori dello stesso tipo
-Tramite la configurazione di determinati caratteri, è possibile riconoscere la sintassi utilizzate e sistemare il dato di conseguenza, ad esempio inserendo come caratteri separatori/identificativi:
+Tramite la configurazione di determinati caratteri, è possibile riconoscere le sintassi utilizzate e sistemare il dato di conseguenza, ad esempio inserendo come caratteri separatori/identificativi:
   * **SEZ**: Carattere identificativo tra sezioni
   * **FGL**: Carattere identificativo tra fogli
@@ Linea 107: / Linea 141: @@
 ==== PATH ====
-Nella colonna **"PATH"** deve essere presente il nome della "cartella" contenente i file allegati che fanno riferimento alle scansioni di questa riga.
+La colonna **"PATH"** di ogni riga deve contenere il nome della "cartella" contenente i file allegati che fanno riferimento alla pratica di quella riga.\\
-Esempio: [2010-14] in questa cartella poi si potranno trovare tutti i file che si vuole importare.\\
+Il PATH di ogni riga viene concatenato al PATH specificato nel form di importazione.
-Al momento di effettuare l’importazione è necessario che tutte le cartelle elencate nella colonna [PATH] siano poste in un percorso di rete raggiungibile che potrà essere indicato nel programma di importazione.
+Esempio:\\
+PATH nel form: //C:\nuovi-allegati//\\
+PATH nella colonna: 2010-14
+I file vanno posizionati in C:\nuovi-allegati\2010-14\\
-Se all’interno della cartella (da esempio [2010-14]) si mettono altre cartelle con al loro interno altri file, il sistema crea dei "passi" con il nome delle sotto cartelle mettendo i file al loro interno (Fig. 1).
+__**In modalità //Una riga per allegato// è necessario valorizzare anche la colonna NOME_ALLEGATO.**__
+Se all'interno del PATH di colonna (ad esempio [2010-14]) si mettono altre cartelle con al loro interno altri file, il sistema creerà dei "passi" con il nome delle sotto cartelle mettendo i file al loro interno (Fig. 1).
 {{ :guide:suapsue:importazione_excel:fig1.png |}}
@@ Linea 121: / Linea 160: @@
 I 3 file (pdf) si troveranno recuperati nella tab [Allegati] come allegati generali __**con la visibilità di pubblicazione, sì. **__
+==== Colonne aggiuntive ====
+È possibile aggiungere ulteriori colonne per dati non codificati alla destra di quelle esistenti.\\
+Il nome della colonna deve essere in MAIUSCOLO e senza_spazi (come tutte le altre colonne).\\
+Le informazioni mappate in questo modo si potranno consultare nella tab [Dati aggiuntivi] di ogni pratica recuperata se si usa la modalità //Una riga di Excel per pratica// o nelle Note degli allegati importati se si usa la modalità //Una riga di Excel per allegato//.
 ==== Esporta ====
-Nella form del programma di importazione si ha il comando **[Esporta]** che consente di estrarre i dati (pratiche) esistenti, dopo aver indicato un offset in base all'anno che si può indicare. Il file excel che viene prodotto e messo sul download del proprio pc, ha già le colonne previste e necessarie poi per un eventuale importazione con il grande vantaggio che le pratiche saranno riconosciute più facilmente e il lavoro necessario da fare sarà quello di valorizzare la colonna [PATH] per importare le scansioni.
+Il comando **[Esporta]** nella form del programma di importazione estrae i dati (pratiche) esistenti, dopo aver indicato un offset in base all'anno che si può indicare. Il file excel prodotto ha già le colonne previste per un eventuale importazione con il grande vantaggio che le pratiche saranno riconosciute più facilmente e il lavoro necessario da fare sarà quello di valorizzare la colonna [PATH] per importare le scansioni.