Primi passi

12 min di lettura Pubblicato il 06/01/2026

Importazione iniziale dei dati

Migra i tuoi asset, dipendenti e contratti esistenti su KaliaOps

In breve

KaliaOps fornisce strumenti di importazione CSV per migrare rapidamente i dati esistenti. Importa asset, applicazioni, dipendenti, organizzazioni e contratti in pochi clic. Il sistema valida automaticamente i dati, rileva i duplicati e fornisce un report dettagliato degli errori. Mantieni uno storico completo delle importazioni per audit e tracciamento.

Entità importabili

KaliaOps consente di importare le seguenti entità tramite file CSV:

CMDB

Asset: Server, workstation, apparecchiature di rete, stampanti, periferiche. Include informazioni di inventario, indirizzi IP, numeri di serie e ubicazione.
Applicazioni: Software aziendale, servizi cloud, database. Con versione, criticità, responsabile tecnico e dipendenze.
Contratti: Contratti di manutenzione, licenze software, SLA fornitori. Include date, importi e condizioni di rinnovo.
Fornitori: Fornitori e prestatori di servizi con dati di contatto, referenti e informazioni legali.

Organizzazione

Organizzazioni: Entità legali, filiali, dipartimenti, divisioni. Struttura gerarchica con responsabili.
Sedi: Ubicazioni fisiche: uffici, datacenter, magazzini. Con indirizzi e fusi orari.
Team: Team funzionali o di progetto, assegnati a un'organizzazione.
Dipendenti: Collaboratori con posizione, responsabile, team e dati di contatto.

Preparare i file

Formato CSV richiesto

I file devono rispettare le seguenti specifiche:

Codifica: UTF-8 (obbligatoria per i caratteri accentati)
Separatore: Virgola (,) predefinito (RFC 4180)
Intestazioni: Prima riga contenente i nomi delle colonne
Virgolette: Valori contenenti il separatore tra virgolette doppie
Dimensione massima: 10 MB per file

Esempio di file asset

name;asset_type;serial_number;ip_address;site_code;status
"SRV-PROD-01";server;"ABC123456";192.168.1.10;"MILANO-DC";active
"PC-CONTABILITA-001";desktop;"DEF789012";192.168.2.50;"MILANO-HQ";active

Campi obbligatori per entità

Entità	Campi obbligatori
Asset	name, type, organization_id
Applicazioni	name, organization_id
Dipendenti	code, first_name, last_name, email
Organizzazioni	name
Sedi	name, city, country
Team	name, organization_id
Contratti	name, supplier_id, type, start_date, end_date
Fornitori	name

Consiglio: Prima esporta alcuni record da KaliaOps per ottenere un modello CSV con le intestazioni di colonna corrette.

Processo di importazione

Accedi allo strumento di importazione

Nel menu laterale, clicca su Amministrazione → Importazioni. Seleziona il tipo di entità che vuoi importare.

Carica il file

Clicca su «Seleziona file» o trascina il CSV. Il sistema rileva automaticamente codifica e separatore. Viene visualizzata un'anteprima delle prime 5 righe.

Configura la mappatura

KaliaOps offre mappatura automatica basata sui nomi delle colonne. Verifica e regola se necessario:

Associa ogni colonna CSV a un campo KaliaOps
Contrassegna le colonne da ignorare
Definisci valori predefiniti per i campi mancanti

Valida e avvia l'importazione

Clicca su «Valida» per controllare i dati. Il sistema mostra un riepilogo:

Numero di righe da creare
Numero di righe da aggiornare (se esiste la chiave)
Righe con errori (dettagli disponibili)

Se il risultato è soddisfacente, clicca su «Importa».

Consulta il report

Al termine dell'importazione, un report dettagliato mostra:

Righe create con successo
Righe aggiornate
Righe saltate (duplicati)
Righe con errori e il motivo

Mappatura dei campi

Mappatura automatica

KaliaOps riconosce automaticamente le intestazioni comuni e le associa ai campi corrispondenti:

Intestazioni riconosciute	Campo KaliaOps
name, nome, denominazione	name
code, codice, riferimento, ref	code
serial, serial_number, numero_serie	serial_number
ip, ip_address, indirizzo_ip	ip_address
email, mail, posta	email
status, stato	status

Riferimenti tra entità

Per collegare le entità tra loro, usa il codice dell'entità di destinazione:

Dipendente → Team: colonna team_code con il codice del team
Asset → Sede: colonna site_code con il codice della sede
Applicazione → Organizzazione: organization_code

Se il codice referenziato non esiste, la riga verrà segnalata come errore.

Importante: I codici sono sensibili alle maiuscole/minuscole. «MILANO-HQ» e «milano-hq» sono considerati diversi.

Validazione ed errori

Validazioni automatiche

Prima dell'importazione, KaliaOps verifica:

Formato dei dati: Date in formato ISO (AAAA-MM-GG), email valide, indirizzi IP corretti, valori numerici.
Campi obbligatori: I campi richiesti devono essere presenti e non vuoti.
Riferimenti esistenti: I codici referenziati (site_code, team_code, ecc.) devono esistere in KaliaOps.
Unicità: I codici e gli identificatori univoci non devono essere duplicati.
Valori consentiti: I campi enum (status, type, criticality) devono contenere valori validi.

Tipi di errore comuni

Errore	Causa	Soluzione
Reference not found	Codice referenziato non esiste	Importare prima l'entità di destinazione
Duplicate entry	Il codice esiste già	Modificare il codice o aggiornare
Invalid format	Formato dati errato	Correggere il formato (data, email, IP)
Required field missing	Campo obbligatorio vuoto	Completare il valore

Storico delle importazioni

Ogni importazione viene registrata nello storico con le seguenti informazioni:

Data e ora dell'importazione
Utente che ha eseguito l'importazione
Tipo di entità importata
Nome del file sorgente
Statistiche: creati, aggiornati, saltati, errori
Durata dell'importazione
Log degli errori dettagliato (scaricabile)

Accesso allo storico

Lo storico è accessibile tramite Amministrazione → Importazioni → Storico. Puoi filtrare per tipo di entità, periodo o utente.

Ordine di importazione consigliato

Affinché i riferimenti tra entità funzionino correttamente, segui questo ordine di importazione:

Sedi - Ubicazioni fisiche (nessuna dipendenza)
Organizzazioni - Possono referenziare una sede principale
Team - Referenziano un'organizzazione
Dipendenti - Referenziano team, responsabile, organizzazione
Fornitori - Possono referenziare un dipendente (referente account)
Applicazioni - Referenziano organizzazione, fornitore, responsabile tecnico
Asset - Referenziano sede, applicazione, VLAN
Contratti - Referenziano fornitore

Suggerimento: Inizia importando le entità senza dipendenze (sedi), poi procedi verso le entità che le referenziano.

Best practice

Preparare la migrazione

Pulisci i dati prima dell'importazione: rimuovi duplicati, correggi i formati
Testa su un campione: importa 10-20 righe per validare la mappatura
Documenta i tuoi codici: stabilisci una convenzione di denominazione coerente

Durante l'importazione

Importa in più lotti anziché un file enorme (max 5000 righe consigliato)
Controlla i report degli errori prima di continuare
Conserva i file sorgente come riferimento

Dopo l'importazione

Verifica un campione di record importati
Testa le relazioni: un asset punta alla sede corretta?
Completa manualmente dati mancanti o specifici

Gestione degli aggiornamenti

Per aggiornare record esistenti tramite importazione:

Usa lo stesso codice del record esistente
Il sistema rileva automaticamente che è un aggiornamento
Vengono modificati solo i campi presenti nel CSV

Punti chiave

Importazione CSV per asset, applicazioni, dipendenti, organizzazioni, team, sedi e contratti
Mappatura automatica delle colonne con opzione di regolazione manuale
Validazione in tempo reale: formati, riferimenti, duplicati
Report dettagliato: righe create, aggiornate, saltate ed errori
Storico completo delle importazioni con possibilità di rollback