AWBDOC Documentazione tecnica AWBNET
Accedi
PDF

Update Clienti da Excel

Ana_Cli_UpdateFromXlsx Ana_Cli_UpdateFromXlsx.aspx Aggiornato il 17/03/2026
Descrizione generale overview

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.
Dettaglio campi fields

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