Premiers pas

12 min de lecture Publié le 06/01/2026

Import initial des données

Migrez vos assets, employés et contrats existants vers KaliaOps

En bref

KaliaOps propose des outils d'import CSV pour migrer rapidement vos données existantes. Importez vos assets, applications, employés, organisations et contrats en quelques clics. Le système valide automatiquement les données, détecte les doublons et fournit un rapport détaillé des erreurs. Conservez l'historique complet de vos imports pour l'audit et le suivi.

Entités importables

KaliaOps permet d'importer les entités suivantes via des fichiers CSV :

CMDB

Assets: Serveurs, postes de travail, équipements réseau, imprimantes, périphériques. Inclut les informations d'inventaire, adresses IP, numéros de série et emplacement.
Applications: Logiciels métier, services cloud, bases de données. Avec version, criticité, propriétaire technique et dépendances.
Contrats: Contrats de maintenance, licences logicielles, SLA fournisseurs. Inclut dates, montants et conditions de renouvellement.
Fournisseurs: Fournisseurs et prestataires avec coordonnées, contacts et informations légales.

Organisation

Organisations: Entités juridiques, filiales, départements, divisions. Structure hiérarchique avec responsables.
Sites: Emplacements physiques : bureaux, datacenters, entrepôts. Avec adresses et fuseaux horaires.
Équipes: Équipes fonctionnelles ou projets, rattachées à une organisation.
Employés: Collaborateurs avec poste, manager, équipe et coordonnées.

Préparer vos fichiers

Format CSV requis

Vos fichiers doivent respecter les spécifications suivantes :

Encodage : UTF-8 (obligatoire pour les caractères accentués)
Séparateur : Virgule (,) par défaut (RFC 4180)
En-têtes : Première ligne contenant les noms de colonnes
Guillemets : Valeurs contenant le séparateur entre guillemets doubles
Taille maximale : 10 Mo par fichier

Exemple de fichier assets

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

Champs obligatoires par entité

Entité	Champs obligatoires
Assets	name, type, organization_id
Applications	name, organization_id
Employés	code, first_name, last_name, email
Organisations	name
Sites	name, city, country
Équipes	name, organization_id
Contrats	name, supplier_id, type, start_date, end_date
Fournisseurs	name

Conseil : Exportez d'abord quelques enregistrements depuis KaliaOps pour obtenir un modèle CSV avec les bons en-têtes de colonnes.

Processus d'import

Accédez à l'outil d'import

Dans le menu latéral, cliquez sur Administration → Imports. Sélectionnez le type d'entité que vous souhaitez importer.

Téléversez votre fichier

Cliquez sur «Sélectionner un fichier» ou glissez-déposez votre CSV. Le système détecte automatiquement l'encodage et le séparateur. Un aperçu des 5 premières lignes s'affiche.

Configurez le mapping

KaliaOps propose un mapping automatique basé sur les noms de colonnes. Vérifiez et ajustez si nécessaire :

Associez chaque colonne du CSV à un champ KaliaOps
Marquez les colonnes à ignorer
Définissez les valeurs par défaut pour les champs manquants

Validez et lancez l'import

Cliquez sur «Valider» pour vérifier les données. Le système affiche un résumé :

Nombre de lignes à créer
Nombre de lignes à mettre à jour (si clé existante)
Lignes avec erreurs (détail accessible)

Si le résultat est satisfaisant, cliquez sur «Importer».

Consultez le rapport

À la fin de l'import, un rapport détaillé indique :

Lignes créées avec succès
Lignes mises à jour
Lignes ignorées (doublons)
Lignes en erreur avec le motif

Mapping des champs

Mapping automatique

KaliaOps reconnaît automatiquement les en-têtes courants et les associe aux champs correspondants :

En-têtes reconnus	Champ KaliaOps
name, nom, designation	name
code, reference, ref	code
serial, serial_number, numero_serie	serial_number
ip, ip_address, adresse_ip	ip_address
email, mail, courriel	email
status, statut, etat	status

Références entre entités

Pour lier des entités entre elles, utilisez le code de l'entité cible :

Employé → Équipe : colonne team_code avec le code de l'équipe
Asset → Site : colonne site_code avec le code du site
Application → Organisation : colonne organization_code

Si le code référencé n'existe pas, la ligne sera signalée en erreur.

Important : Les codes sont sensibles à la casse. «PARIS-HQ» et «paris-hq» sont considérés comme différents.

Validation et erreurs

Validations automatiques

Avant l'import, KaliaOps vérifie :

Format des données: Dates au format ISO (YYYY-MM-DD), emails valides, adresses IP correctes, valeurs numériques.
Champs obligatoires: Les champs requis doivent être présents et non vides.
Références existantes: Les codes référencés (site_code, team_code, etc.) doivent exister dans KaliaOps.
Unicité: Les codes et identifiants uniques ne doivent pas être dupliqués.
Valeurs autorisées: Les champs enum (status, type, criticality) doivent contenir des valeurs valides.

Types d'erreurs courantes

Erreur	Cause	Solution
Reference not found	Code référencé inexistant	Importer d'abord l'entité cible
Duplicate entry	Code déjà existant	Modifier le code ou mettre à jour
Invalid format	Format de donnée incorrect	Corriger le format (date, email, IP)
Required field missing	Champ obligatoire vide	Compléter la valeur

Historique des imports

Chaque import est enregistré dans l'historique avec les informations suivantes :

Date et heure de l'import
Utilisateur ayant effectué l'import
Type d'entité importée
Nom du fichier source
Statistiques : créés, mis à jour, ignorés, erreurs
Durée de l'import
Journal des erreurs détaillé (téléchargeable)

Accès à l'historique

L'historique est accessible via Administration → Imports → Historique. Vous pouvez filtrer par type d'entité, période ou utilisateur.

Ordre d'import recommandé

Pour que les références entre entités fonctionnent correctement, respectez l'ordre d'import suivant :

Sites - Emplacements physiques (aucune dépendance)
Organisations - Peuvent référencer un site principal
Équipes - Référencent une organisation
Employés - Référencent une équipe, un manager, une organisation
Fournisseurs - Peuvent référencer un employé (responsable compte)
Applications - Référencent organisation, fournisseur, propriétaire technique
Assets - Référencent site, application, VLAN
Contrats - Référencent fournisseur

Astuce : Commencez par importer les entités sans dépendances (sites), puis remontez progressivement vers les entités qui les référencent.

Bonnes pratiques

Préparer la migration

Nettoyez vos données avant l'import : supprimez les doublons, corrigez les formats
Testez sur un échantillon : importez 10-20 lignes pour valider le mapping
Documentez vos codes : établissez une convention de nommage cohérente

Pendant l'import

Importez en plusieurs lots plutôt qu'un fichier énorme (max 5000 lignes recommandé)
Vérifiez les rapports d'erreurs avant de continuer
Conservez les fichiers sources pour référence

Après l'import

Vérifiez un échantillon d'enregistrements importés
Testez les relations : un asset pointe-t-il vers le bon site ?
Complétez manuellement les données manquantes ou spécifiques

Gestion des mises à jour

Pour mettre à jour des enregistrements existants via import :

Utilisez le même code que l'enregistrement existant
Le système détecte automatiquement qu'il s'agit d'une mise à jour
Seuls les champs présents dans le CSV sont modifiés

Points clés

Import CSV pour assets, applications, employés, organisations, équipes, sites et contrats
Mapping automatique des colonnes avec possibilité d'ajustement manuel
Validation en temps réel : formats, références, doublons
Rapport détaillé : lignes créées, mises à jour, ignorées et erreurs
Historique complet des imports avec possibilité de rollback