> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/administration/import-collaborateurs.md).

# Comment importer des collaborateurs en masse ?

### Présentation

La fonctionnalité d'import permet d'ajouter ou de synchroniser des collaborateurs en masse à partir d'un fichier, sans avoir à les ajouter un par un.

### Fonctionnement

#### Étape 1 — Historique des traitements

Depuis l'administration des collaborateurs, accédez à la page **Import** qui liste l'historique des synchronisations précédentes.

#### Étape 2 — Choisir le type d'import

Sélectionnez le type d'opération : **ajout**, **suppression** ou **synchronisation miroir**.

#### Étape 3 — Téléverser le fichier

Téléversez le fichier Excel ou CSV contenant les collaborateurs.

#### Étape 4 — Consulter les alertes

Le système analyse le fichier et affiche un rapport d'**alertes** sur les anomalies détectées (lignes invalides, champs manquants, etc.).

#### Étape 5 — Vérifier l'analyse

Un rapport d'**analyse** détaille les opérations qui seront exécutées (créations, mises à jour, suppressions).

#### Étape 6 — Lancer l'exécution

Validez pour lancer le **runner** qui applique les opérations. Le statut est mis à jour en direct.

#### Types d'opérations

* **Ajout** (upsert) : créer de nouveaux collaborateurs ou mettre à jour les existants
* **Suppression** (delete) : retirer des collaborateurs
* **Synchronisation miroir** (mirror) : remplacer la liste complète — les collaborateurs absents du fichier sont retirés

#### Mode test (dry run)

Il est possible de lancer une simulation avant d'exécuter réellement les modifications. Le mode test affiche un rapport des opérations prévues sans les appliquer.

La simulation devient **obligatoire** pour un fichier qui attribue ou modifie un identifiant de connexion : c'est le seul endroit où vous voyez, avant exécution, combien d'adresses email cessent d'être des identifiants.

#### Collaborateurs sans adresse email

Le gabarit comporte une colonne **Identifiant** et une colonne **Code PIN TV**, à côté de la colonne **Email**. Elles permettent d'importer des collaborateurs qui n'ont pas d'adresse email professionnelle.

* Chaque ligne doit porter au moins un identifiant : une adresse email ou un identifiant de connexion.
* Une ligne qui attribue un identifiant de connexion sans adresse email doit porter un code à 4 chiffres, sans quoi le collaborateur n'aurait aucun moyen d'activer son compte.
* Un même identifiant ne peut pas figurer deux fois dans le fichier.

Les lignes qui ne respectent pas ces règles sont signalées dans le rapport des alertes, avant toute écriture : le fichier n'est pas exécuté tant qu'elles n'ont pas été corrigées. Voir [Comment ajouter un collaborateur sans adresse e-mail ?](/administration/collaborateur-sans-email.md).

#### Suivi des messages

Chaque opération de synchronisation génère des messages de suivi indiquant le résultat pour chaque collaborateur (succès, erreur, etc.).

### Alternative : provisioning SCIM

Pour une synchronisation automatique et continue avec un annuaire d'entreprise (Azure Active Directory, Okta, etc.), voir l'article "Approvisionnement automatique des collaborateurs (Provisioning / SCIM)".

### Ce que l'assistant peut faire

L'assistant ne peut pas lancer un import en masse. Il peut expliquer le fonctionnement et guider vers l'interface d'administration. Avec le périmètre Administration, l'assistant peut ajouter des collaborateurs un par un.