Update Clienti da Excel
Ana_Cli_UpdateFromXlsx
Ana_Cli_UpdateFromXlsx.aspx
Aggiornato il 17/03/2026
Aggiornamento Clienti da Excel
Questa funzione consente di aggiornare in modo massivo le anagrafiche dei clienti presenti in AWBNET attraverso il caricamento di un file Excel (formato .xlsx). È particolarmente utile quando è necessario modificare contemporaneamente i dati di un elevato numero di clienti, evitando di intervenire manualmente su ogni singola scheda.
Come accedere dalla navigazione AWBNET
La funzione è accessibile dal menu Anagrafiche, nella sezione dedicata alla gestione dei clienti. Si apre in una finestra dedicata denominata Aggiornamento Clienti da XLSX.
Operazioni principali disponibili
La pagina si compone di un elenco riepilogativo dei file già elaborati in precedenza e di una serie di pannelli operativi per gestire il caricamento di nuovi aggiornamenti.
- Elenco file già lavorati: nella schermata principale è visibile la lista di tutti i file Excel già importati, con indicazione del numero progressivo, della data e ora di elaborazione, del nome del file, dell'utente che ha effettuato l'operazione e del numero di righe trattate.
- Caricamento di un nuovo file Excel (pulsante "Nuovo"): avvia la procedura di importazione. Viene richiesto di selezionare dal proprio computer il file .xlsx da caricare. Il file deve obbligatoriamente essere in formato Excel (.xlsx); altri formati non sono accettati.
- Anteprima e verifica delle righe caricate: dopo il caricamento, il contenuto del file viene visualizzato in una griglia. È possibile filtrare le righe per visualizzare: tutti i record, solo quelli con errori o solo quelli validi, utilizzando il selettore Controllo (Tutti / Errati / Validi).
- Abbinamento colonne Excel (pulsante "Colonne Excel"): permette di verificare e configurare la corrispondenza tra le colonne presenti nel file Excel caricato e i campi standard dell'anagrafica cliente. Le colonne già correttamente abbinate vengono evidenziate in verde nell'intestazione della griglia. È possibile modificare manualmente l'abbinamento qualora le intestazioni del file Excel non corrispondano esattamente ai nomi attesi.
- Controllo dati (pulsante "Controllo"): esegue una verifica preventiva su tutte le righe del file. In presenza di errori, il sistema segnala le righe problematiche con un'icona dedicata e mostra un messaggio che invita a correggere i dati prima di procedere. Solo a controllo superato senza errori viene abilitato il pulsante di aggiornamento definitivo.
- Aggiornamento definitivo (pulsante "Aggiornamento"): visibile e attivabile solo dopo un controllo senza errori. Avvia l'aggiornamento effettivo delle anagrafiche clienti nel sistema. Al termine, la griglia principale si aggiorna mostrando il nuovo file nella lista delle elaborazioni completate.
- Annullamento (pulsante "Annulla"): interrompe la procedura di importazione in corso senza apportare alcuna modifica. Viene richiesta una conferma prima di procedere con l'annullamento.
Campi aggiornabili tramite Excel
Il file Excel può contenere le seguenti informazioni relative ai clienti. La colonna Codice è obbligatoria per identificare il cliente da aggiornare:
- Codice: codice identificativo del cliente (obbligatorio, non modificabile)
- Indirizzo: indirizzo di residenza o sede
- Cap: codice di avviamento postale
- Comune: comune di residenza o sede
- Prov: provincia
- Tel: numero di telefono
- Email: indirizzo di posta elettronica
- F/G: tipo persona (fisica o giuridica)
- CF: codice fiscale
- Piva: partita IVA
- Unit: unità organizzativa di riferimento (Account/Executive)
- GruStat: gruppo statistico
- GruFin: gruppo finanziario
- Prod1, Prod2, Prod3: produttori associati al cliente (fino a tre)
- Indotto: canale di indotto
- Filiale: filiale di riferimento
- Zona: zona commerciale
- Specialist: specialist polizze assegnato
- SpecialistSX: specialist sinistri assegnato
Note operative importanti
- Il file deve essere esclusivamente in formato .xlsx. File in altri formati (es. .xls, .csv) non vengono accettati.
- Il numero massimo di righe elaborabili in un singolo file è definito dalla configurazione di sistema (generalmente 300 righe). Il superamento di questo limite impedisce il caricamento.
- Per cancellare il valore di un campo nell'anagrafica, è sufficiente inserire il testo N/A nella corrispondente cella del file Excel. Lasciare la cella vuota, invece, significa non apportare alcuna modifica a quel campo.
- I campi che fanno riferimento a tabelle di decodifica (come Unità, GruStat, GruFin, Indotto, Filiale, Zona, Produttori, SpecialistSX) devono contenere la descrizione esatta così come presente nelle tabelle di sistema, altrimenti la riga risulterà in errore.
- È obbligatorio eseguire il Controllo prima di poter avviare l'aggiornamento. Il pulsante "Aggiornamento" diventa attivo solo in assenza di errori.
- Ogni importazione viene registrata nello storico con data, ora, nome file e utente, garantendo la tracciabilità completa di tutte le operazioni effettuate.
- Durante l'elaborazione viene mostrato un indicatore di avanzamento. Si consiglia di attendere il completamento senza chiudere o ricaricare la pagina.
Aggiornamento Clienti da XLSX
Questa pagina consente di aggiornare i dati anagrafici dei clienti tramite l'importazione di file in formato Excel (XLSX). La schermata principale mostra lo storico dei file già elaborati e permette di avviare nuovi caricamenti.
Elenco File Excel già Lavorati
Griglia riepilogativa di tutti i file Excel precedentemente importati nel sistema. Ogni riga rappresenta un'elaborazione effettuata.
| Campo | Tipo | Descrizione | Note |
|---|---|---|---|
| Progressivo | Numero | Identificativo numerico progressivo dell'importazione | Cod. DB: XFILE — Chiave primaria del record di importazione |
| Data | Data | Data in cui è stato caricato il file Excel | Cod. DB: XDATA — Formato visualizzato: gg/MM/aaaa |
| Ora | Ora | Orario esatto del caricamento del file | Cod. DB: XDATA — Formato visualizzato: HH:mm:ss |
| Nome Excel | Testo | Nome del file Excel caricato | Cod. DB: XNFIL |
| Utente | Testo | Nome dell'utente che ha effettuato il caricamento | Cod. DB: XUSER |
| Num Righe | Numero | Numero totale di righe contenute nel file Excel importato | Cod. DB: XRIGA — Valore calcolato tramite conteggio (COUNT) |
Popup: Upload File Excel
Finestra di dialogo che si apre selezionando il pulsante Nuovo. Permette di scegliere e caricare un nuovo file Excel dal proprio computer.
| Campo | Tipo | Descrizione | Note |
|---|---|---|---|
| Nome File | File | Selettore per scegliere il file Excel da importare dal proprio computer | Cod. DB: lodFile — Sono accettati solo file con estensione .xlsx |
Popup: Importazione File Excel – Filtro e Anteprima
Finestra di dialogo che mostra il contenuto del file Excel caricato, con la possibilità di filtrare le righe in base al risultato del controllo di validità prima di procedere con l'aggiornamento definitivo.
| Campo | Tipo | Descrizione | Note |
|---|---|---|---|
| Controllo | Selezione (radio) | Filtra le righe della griglia di anteprima in base al loro stato di validità: Tutti mostra tutte le righe, Errati mostra solo le righe con errori, Validi mostra solo le righe corrette | Cod. DB: FERROR — Valori: T = Tutti, E = Errati, V = Validi; valore predefinito: T |
Popup: Abbinamento Colonne Excel
Finestra di dialogo accessibile tramite il pulsante Colonne Excel. Consente di associare le colonne presenti nel file Excel ai corrispondenti campi del sistema, in modo da garantire un'importazione corretta dei dati.
| Campo | Tipo | Descrizione | Note |
|---|---|---|---|
| Campo | Testo (sola lettura) | Nome del campo del sistema a cui abbinare una colonna del file Excel | Cod. DB: Campo — Non modificabile; identifica il campo anagrafico del cliente |
| Excel | Testo / Lista a discesa | Nome della colonna del file Excel da associare al campo di sistema. In visualizzazione è mostrato come campo di testo; in modifica diventa una lista a discesa con le colonne disponibili nel file caricato | Cod. DB: EXCEL — Il colore di sfondo varia in base allo stato dell'abbinamento; obbligatorio per procedere con l'importazione |