Si vous utilisiez auparavant une intégration d'API personnalisée pour l'approvisionnement des utilisateurs, vous devez mettre à jour vos fichiers de script CSV afin de les aligner avec le nouveau format de l'API d'approvisionnement. Cette mise à jour garantit que vos synchronisations d'approvisionnement API restent fonctionnelles et que les nouveaux utilisateurs et équipes sont mis à jour comme prévu.
Remarque : l’API reste rétrocompatible avec les anciens fichiers API. Toutefois, la mise à jour est simple et rapide, et elle vous permet d’accéder aux nouvelles fonctionnalités.
Mettre à jour vos anciens fichiers API pour l'API d'approvisionnement
Utilisez les tableaux ci-dessous pour convertir vos fichiers existants et vos en-têtes de colonnes vers le format actuel de l'API d'approvisionnement :
users.csv
Ancien fichier | Nouveau fichier |
users.csv | members.csv |
Ancien nom de colonne | Nouveau nom de colonne | Notes |
id | externalMemberId |
|
language | languagePreferences | Utiliser des codes de langue (ex. : fr, en). |
productAssignations | Nouvelle colonne | Par défaut sur Officevibe si aucun produit n'est spécifié. |
groups.csv
Ancien fichier | Nouveau fichier |
groups.csv | teams.csv |
Ancien nom de colonne | Nouveau nom de colonne |
id | externalTeamId |
name | teamName |
groups-mapping.csv
Ancien fichier | Nouveau fichier |
groups-mapping.csv | teams-mappings.csv |
Ancien nom de colonne | Nouveau nom de colonne |
groupId | externalTeamId |
userId | externalMemberId |
subGroupId | externalSubteamId |
Après avoir mis à jour vos fichiers
Générez une nouvelle clé API.
Définissez vos seuils de risque.
Assurez-vous que votre script de provisionnement est à jour (voir ci-dessous).
Mettre à jour votre script de provisionnement
Important : le provisionnement via l’API Workleap est uniquement compatible avec le script de provisionnement à jour fourni ci-dessous. Si vous exécutez un script ancien avec des fichiers API mis à jour, la synchronisation du provisionnement des utilisateurs échouera.
Téléchargez le script de provisionnement de l’API Workleap ici : provisioning.zip
Ajustez les chemins d’accès aux fichiers API de provisionnement mis à jour, puis exécutez la commande ci-dessous dans Microsoft PowerShell :
.\api-provisioning-script.ps1 `
-apiKey "<YOUR_API_KEY>" `
-membersCsvPath "C:\Workleap_Sync\SampleData\members.csv" `
-teamsCsvPath "C:\Workleap_Sync\SampleData\teams.csv" `
-teamsMappingsCsvPath "C:\Workleap_Sync\SampleData\teams-mappings.csv"
Remarque : PowerShell 7 ou une version ultérieure est requis pour exécuter ce script.