Manipulation de profil utilisateur dans le modèle de complément SharePoint
L’approche que vous prenez pour effectuer des opérations CRUD (Create, Read, Update and Delete) dans le service de profil utilisateur est différente dans le nouveau modèle de SharePoint Add-in par rapport au code de confiance totale. Dans un scénario classique de code de confiance totale/solution de batterie de serveurs, les opérations CRUD UPS étaient effectuées avec le code du modèle objet côté serveur SharePoint ou le service web de profil utilisateur et déployées via des solutions de batterie de serveurs.
Dans un SharePoint de modèle de modèle de recherche de contenu, les opérations CRUD UPS sont effectuées avec le modèle objet côté client (CSOM) ou le service web de profil utilisateur.
Conseils généraux
En règle générale, nous vous recommandons les instructions générales suivantes pour effectuer des opérations CRUD UPS.
- Le tableau suivant décrit les types d’opérations pris en charge dans les environnements Office 365 et locaux SharePoint pour les API CSOM et de service Web de profil utilisateur.
| Opération | API | Local | Office 365 |
|---|---|---|---|
| READ | CSOM | Pris en charge | Pris en charge |
| CREATE | CSOM | Non pris en charge | Pris en charge |
| METTRE À JOUR | CSOM | Non pris en charge | Pris en charge |
| DELETE | CSOM | Non pris en charge | Pris en charge |
| READ | Service Web de profil utilisateur | Pris en charge | Non pris en charge |
| CREATE | Service Web de profil utilisateur | Pris en charge | Non pris en charge |
| METTRE À JOUR | Service Web de profil utilisateur | Pris en charge | Non pris en charge |
| DELETE | Service Web de profil utilisateur | Pris en charge | Non pris en charge |
- En règle générale, vous ne déployez pas de add-in sur une location SharePoint pour gérer la copie ou la synchronisation des données UPS. En règle générale, le add-in prend la forme d’une application console s’exécutant en tant que tâche programmée ou d’un service cloud de longue durée tel qu’une tâche Web Azure.
- Pour plus d’informations sur ces technologies et sur leur utilisation dans le modèle de SharePoint, voir les travaux du SharePoint (recette de modèle de SharePoint).
- L’utilisation de l’authentification AppOnly n’est pas prise en charge pour les opérations de service de profil utilisateur.
- Exécutez le code CSOM avec un compte qui dispose des autorisations appropriées pour effectuer des opérations CRUD UPS.
- Lors de la synchronisation d’Active Directory avec le service de profil utilisateur, certains attributs sont synchronisés par défaut.
- Les mappages de propriétés de profil utilisateur par défaut dans SharePoint Server 2013 (article TechNet) contiennent une liste des attributs synchronisés par défaut.
- Si vous devez synchroniser des attributs supplémentaires, vous devrez créer un outil personnalisé à l’aide de l’une des approches décrites dans cet article.
Options de copie et de synchronisation des données UPS
Vous avez plusieurs options pour copier et synchroniser des données UPS.
- Sur site
- Copier la base de données
- Utiliser le service Web de profil utilisateur pour copier des données
- Utiliser le service Web de profil utilisateur pour synchroniser des données
- Office 365
- Utiliser CSOM pour copier des données
- Utiliser CSOM pour synchroniser des données
Local : copier la base de données
Si vous avez un environnement local SharePoint vous pouvez copier la base de données UPS d’une batterie de serveurs vers une autre pour répliquer rapidement les attributs.
Quand est-elle adaptée ?
Lorsque vous avez un environnement SharePoint local et que vous effectuez une copie à sens seul des attributs de profil, il s’agit d’une bonne option, car elle peut être implémentée rapidement et facilement sans écrire de code.
Local : utiliser le service Web de profil utilisateur pour copier des données
Si vous avez un environnement SharePoint local, vous pouvez utiliser le service web de profil utilisateur pour copier les données UPS d’une batterie de serveurs vers une autre.
Quand est-elle adaptée ?
Lorsque vous avez un environnement SharePoint local et que vous copiez des données UPS entre deux ou plusieurs batteries de serveurs SharePoint, il s’agit d’une bonne option, car elle vous offre la possibilité de copier les données UPS d’une batterie de serveurs vers une autre.
Prise en main
L’exemple suivant montre comment effectuer des opérations CRUD UPS avec le service Web de profil utilisateur.
Local : utiliser le service Web de profil utilisateur pour synchroniser des données
Si vous avez un environnement local SharePoint vous pouvez utiliser le service Web de profil utilisateur pour synchroniser les données UPS entre les batteries de serveurs.
Quand est-elle adaptée ?
Lorsque vous avez un environnement SharePoint local et que vous synchronisez des données UPS entre deux ou plusieurs batteries de serveurs SharePoint, il s’agit d’une bonne option, car elle vous permet d’effectuer une véritable synchronisation et d’inclure autant de sources que vous le souhaitez.
Prise en main
L’exemple Core.UserProfilePropertyUpdater (exemple PnP O365) montre comment effectuer des opérations CRUD UPS avec le service Web de profil utilisateur.
L’exemple Core.MMSSync (O365 PnP) montre comment créer un outil de synchronisation pour le service de métadonnées gérées (données MMS). Bien que cet exemple se concentre sur les API MMS, le modèle global utilisé pour la synchronisation peut également être appliqué aux données UPS.
Office 365 : utiliser CSOM pour copier des données
Si vous avez un environnement Office 365 SharePoint vous pouvez utiliser le CSOM pour copier des données UPS d’une location à une autre.
Quand est-elle adaptée ?
Lorsque vous avez un environnement Office 365 et que vous copiez des données UPS entre deux ou plusieurs locations SharePoint, il s’agit d’une bonne option, car elle vous offre la possibilité de copier les données UPS d’une location vers une autre.
Prise en main
L’exemple UserProfile.Manipulation.CSOM (exemple PnP O365) montre comment effectuer des opérations CRUD UPS avec CSOM.
Le modèle CSOM de profil utilisateur pour la lecture et les mises à jour (vidéo PnP O365) vous parcourt le modèle UserProfile.Manipulation.CSOM (exemple PnP O365).
Office 365 : utiliser CSOM pour synchroniser des données
Lorsque vous avez un environnement Office 365 SharePoint et que vous synchronisez des données UPS entre deux locations ou plus, il s’agit d’une bonne option, car elle vous permet d’effectuer une véritable synchronisation et d’inclure autant de sources que vous le souhaitez.
Quand est-elle adaptée ?
Lorsque vous avez un environnement Office 365 et que vous synchronisez des données UPS entre deux ou plusieurs locations SharePoint, il s’agit d’une bonne option, car elle vous permet d’effectuer une véritable synchronisation et d’inclure autant de sources que vous le souhaitez.
Prise en main
L’exemple Core.UserProfiles.Sync (exemple PnP O365) montre comment créer un outil de synchronisation pour les données de service de profil utilisateur.
Environnements hybrides
Dans un scénario où vous avez des environnements locaux et Office 365 SharePoint et des informations de profil utilisateur doivent être conservées dans les deux environnements, vous pouvez utiliser une combinaison du service Web de profil utilisateur et du CSOM pour vous fournir la possibilité d’effectuer des opérations CUD sur les données UPS.
Liens connexes
- CSOM de profil utilisateur pour la lecture et les mises à jour (vidéo PnP O365)
- Travaux du timer à distance (SharePoint recette de modèle de modèle de add-in)
- Mappages de propriétés de profil utilisateur par défaut dans SharePoint Server 2013 (article TechNet)
- Articles de référence sur la page https://aka.ms/OfficeDevPnPGuidance
- Références dans MSDN sur la page https://aka.ms/OfficeDevPnPMSDN
- Vidéos sur la page https://aka.ms/OfficeDevPnPVideos
Exemples PnP
- Core.UserProfilePropertyUpdater (exemple PnP O365)
- Core.MMSSync (exemple PnP O365)
- UserProfile.Manipulation.CSOM (exemple PnP O365)
- Core.UserProfiles.Sync (exemple PnP O365)
- Exemples et contenu dans Microsoft 365 et pratiques PnP (Patterns and Practices)
S’applique à
- Office 365 multi-locataire (MT).
- Office 365 dédiés (D)
- SharePoint 2013 en local