> 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'**Annuaire**, ouvrez le menu **⋮** (trois points) à droite du titre **Collaborateurs**, puis cliquez sur **Importer des collaborateurs**. La page **Import** 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 ?](https://help.steeple.com/administration/collaborateur-sans-email.md).

#### Services et lieux

Les colonnes **Service** et **Lieu** acceptent un ou plusieurs noms. Pour en indiquer plusieurs, séparez-les par un point-virgule, avec ou sans espace : `Communication;Production` et `Communication; Production` sont lus de la même façon.

La virgule ne sépare pas : elle fait partie du nom, comme dans « Administratif, Finance ».

* **La cellule donne la liste complète.** Elle remplace les services, ou les lieux, du collaborateur, même si elle n'en indique qu'un. Un service ou un lieu absent de la cellule lui est retiré, même si un administrateur l'avait ajouté à la main.
* **Une cellule vide ne change rien**, pas plus qu'une colonne absente du fichier.
* **Un nom qui n'existe pas encore est créé.** Vérifiez l'orthographe pour éviter les doublons.

Avant l'exécution, l'analyse compte les collaborateurs dont les services ou les lieux changent dans la ligne « N collaborateurs verront leurs informations d'organisation modifiées », y compris ceux à qui le fichier retire une valeur ajoutée à la main.

L'[export des collaborateurs](https://help.steeple.com/administration/exporter-collaborateurs.md) sort tous les services et tous les lieux de chacun, séparés par un point-virgule : le fichier exporté se réimporte tel quel.

Pour les renseigner un par un, voir [Comment renseigner plusieurs services pour un collaborateur ?](https://help.steeple.com/administration/plusieurs-services.md) et [Comment renseigner plusieurs lieux pour un collaborateur ?](https://help.steeple.com/administration/plusieurs-lieux.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.
