Contacts externes
Identifiez les contacts partenaires, sous-traitants ou clients exportés depuis un CRM ou un système partenaire.
“Quel contact partenaire doit recevoir cette escalade ?”
Roster pour CSV
Importez utilisateurs, groupes et appartenances dans Roster à partir de fichiers CSV contrôlés.
Utilisez CSV lorsque vos données organisationnelles proviennent d'un export RH, d'un système hérité, d'une base clients, d'un annuaire partenaire ou d'une autre source dépourvue de connecteur Roster natif. Roster lit des utilisateurs, groupes et relations d'appartenance normalisés depuis un stockage local, un stockage objet compatible S3 ou du SFTP.
Dernière vérification : 13 juillet 2026
Résolution de participants sans API d'annuaire en direct
Toutes les organisations ou workflows n'utilisent pas Entra ID, Okta, Google Workspace, Workday ou LDAP comme source directe.
Les participants pertinents peuvent provenir d'une application RH hérité, d'un export ERP, d'une base de sous-traitants, d'un annuaire partenaire, d'une liste de comptes clients, d'un système opérationnel régional, d'un processus reposant sur un tableur maîtrisé ou d'une base interne personnalisée.
“D'où proviennent ces données ?”
Il demande :
“Qui gère l'implémentation Acme ?”
“Quel contact partenaire doit recevoir cette escalade ?”
“Qui doit approuver cette demande pour la région Est ?”
“Quelle équipe projet temporaire est responsable de cette tâche ?”
Le connecteur CSV fournit un contrat d'ingestion stable pour ces environnements — afin que Roster puisse déterminer qui doit agir sans intégrer des emails de partenaires ou de sous-traitants dans le code applicatif.
Comment Roster lit les données CSV
Les fichiers peuvent être montés localement, lus depuis un stockage objet compatible S3 ou récupérés via SFTP.
En mode local, montez les fichiers CSV sous ${ROSTER_DATA_DIR}/connectors/csv. Dans Docker, montez le répertoire via le volume /data de Roster.
Les mappings de champs permettent à Roster de consommer un export contrôlé existant sans exiger que le système source renomme chaque colonne.
Les enregistrements sélectionnés sont matérialisés dans Roster. Le rafraîchissement planifié met à jour les enregistrements et appartenances utilisés par la résolution de participants.
Ce que Roster permet d'identifier
Équipes régionales et temporaires
Routez la responsabilité vers des équipes situées hors de votre annuaire d'identité principal.
“Quelle équipe projet temporaire est responsable de cette tâche ?”
Responsabilité des systèmes hérités
Reliez les exports ERP ou RH hérités à la résolution de participants sans API en direct.
“Qui gère l'implémentation Acme ?”
Approbateurs d'unité métier
Mappez les unités métier exportées vers des participants approbateurs.
“Qui doit approuver cette demande pour la région Est ?”
Couverture déléguée
Superposez les délégations Roster à l'appartenance issue du CSV.
“Qui couvre la file d'escalade partenaires aujourd'hui ?”
D'un export à la résolution de participants
Le CSV fournit les enregistrements d'annuaire. Roster fournit le modèle de projet, participant, métadonnées et délégation.
Utilisez des identifiants externes stables qui ne changent pas lorsque les noms ou emails changent.
Concevez soigneusement les IDs externes et les associations aux participants pour qu'un connecteur natif puisse plus tard remplacer le CSV via une migration contrôlée.
Utilisez le contexte issu du CSV depuis toutes les surfaces Roster
Une fois que les enregistrements CSV soutiennent les participants Roster, le même contexte organisationnel est disponible partout.
MCP
Laissez un client IA compatible MCP déterminer qui doit agir externe ou sous-traitante.
API REST
Ajoutez la résolution issue du CSV aux applications internes et moteurs de workflow.
CLI et CI
Identifiez le responsable depuis le terminal ou une pipeline sans API d'annuaire en direct.
Plateforme Roster
Les administrateurs associent les enregistrements CSV aux participants, configurent les mappings et gèrent les délégations.
Ce que Roster lit
| Données CSV | Utilisé par Roster | Matérialisé dans Roster |
|---|---|---|
| ID utilisateur stable | Oui | Pour les utilisateurs sélectionnés |
| Nom d'utilisateur | Oui | Pour les utilisateurs sélectionnés |
| Oui | Pour les utilisateurs sélectionnés | |
| Nom affiché | Oui | Pour les utilisateurs sélectionnés |
| ID groupe stable | Oui | Pour les groupes sélectionnés |
| Nom du groupe | Oui | Pour les groupes sélectionnés |
| Email du groupe | Lorsque fourni | Pour les groupes sélectionnés |
| Appartenance utilisateur-groupe | Oui | Oui |
| Mots de passe | Non | Non |
| Secrets d'authentification | Non | Non |
Fichier requis — users.csv :
external_id,user_name,primary_email,display_name
user-001,user001,user001@example.com,User 001Fichier requis — groups.csv :
external_id,display_name,mail
group-001,Engineering,engineering@example.comFichier requis — user-groups.csv :
user_external_id,group_external_id
user-001,group-001Vos fichiers source n'ont pas besoin d'utiliser les noms de colonnes par défaut de Roster — configurez des mappings de champs à la place :
{
"field_mappings": {
"users": {
"external_id": "employee_id",
"user_name": "login",
"primary_email": "email",
"display_name": "name"
},
"groups": {
"external_id": "team_id",
"display_name": "team_name",
"mail": "team_email"
}
}
}N'incluez que les colonnes requises par le cas d'usage de routage.
Modes de stockage et rafraîchissement planifié
Le connecteur CSV prend en charge trois modes de stockage et se rafraîchit sur un planning configuré.
Modes de stockage
local — fichiers montés dans le volume de données Roster. s3 — fichiers lus via stockage objet. sftp — fichiers lus via une source SFTP.
Rafraîchissement planifié
Les fichiers sont lus selon le planning du connecteur. Les enregistrements et appartenances sélectionnés sont mis à jour dans l'état Roster matérialisé utilisé par REST, MCP, CLI et Resolve.
Exigences opérationnelles
Traitez le flux CSV comme une interface de données de production plutôt qu'un tableur ad hoc.
- 01Utilisez des IDs externes stables
- 02Maintenez un schéma documenté
- 03Validez les colonnes requises avant publication
- 04Générez les fichiers via un processus reproductible
- 05Rafraîchissez sur un planning prévisible
- 06Utilisez un remplacement de fichier atomique
- 07Gardez les exports sous contrôle de changement
- 08Restreignez l'accès au stockage
- 09Chiffrez le transport et le stockage S3 ou SFTP
- 10Surveillez les rafraîchissements échoués ou incomplets
- 11Conservez une version précédente récupérable
Évitez de changer les IDs externes lorsque le nom, l'email ou l'équipe d'une personne change.
Pour le mode local, montez les fichiers sous :
${ROSTER_DATA_DIR}/connectors/csvDans Docker, montez le répertoire via le volume /data de Roster. Utilisez un stockage durable pour que les fichiers restent disponibles entre redémarrages et mises à niveau.
Exemple : router le travail vers des contacts projet externes
Une entreprise maintient ses partenaires d'implémentation dans un système de gestion client qui exporte des fichiers CSV chaque nuit. L'export contient contacts partenaires, groupes d'implémentation clients et relations contact-groupe.
Un workflow demande :
“Qui doit recevoir l'escalade d'implémentation pour Acme ?”
Roster évalue :
- Le projet Acme
- Le participant Implementation Escalation
- L'utilisateur ou groupe issu du CSV
- Les métadonnées client pertinentes
- Toute délégation Roster active
Le workflow reçoit le contact approprié sans intégrer d'emails partenaires dans le code applicatif.