Partager via

Manipulation de profil utilisateur dans le modèle de complément SharePoint

  • Article

L’approche que vous utilisez 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 complément SharePoint et dans le code de confiance totale. Dans un scénario standard de code de confiance totale (FTC) / solution de batterie de serveurs, les opérations CRUD UPS ont été effectuées avec le code de modèle objet côté serveur SharePoint ou le service web profil utilisateur et déployées via Farm Solutions.

Dans un scénario de modèle de complément SharePoint, les opérations CRUD UPS sont effectuées avec le modèle objet côté client (CSOM) ou le service web 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 SharePoint Office 365 et locaux pour les API du service web CSOM et profil utilisateur.
Opération API En local Office 365
LIRE 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
SUPPRIMER CSOM Non pris en charge Pris en charge
LIRE 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
SUPPRIMER Service web de profil utilisateur Pris en charge Non pris en charge
  • En règle générale, vous ne déployez pas de complément sur une location SharePoint pour gérer la copie ou la synchronisation des données UPS. En règle générale, le complément prend la forme d’une application console s’exécutant en tant que tâche planifiée ou d’un service cloud de longue durée tel qu’un travail web Azure.
  • L’utilisation de l’authentification AppOnly n’est pas prise en charge pour les opérations de service profil utilisateur.
  • Exécutez le code CSOM avec un compte disposant 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.

Options de copie et de synchronisation des données UPS

Vous disposez de deux options pour copier et synchroniser les données UPS.

  • Sur site
    • Copier la base de données
    • Utiliser le service web profil utilisateur pour copier des données
    • Utiliser le service web profil utilisateur pour synchroniser les données
  • Office 365
    • Utiliser CSOM pour copier des données
    • Utiliser CSOM pour synchroniser les données

Local - copier la base de données

Si vous disposez d’un environnement SharePoint local, vous pouvez copier la base de données UPS d’une batterie vers une autre pour répliquer rapidement les attributs.

Quand est-elle adaptée ?

Lorsque vous disposez d’un environnement SharePoint local et que vous effectuez une copie unidirectionnel 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 profil utilisateur pour copier des données

Si vous disposez d’un environnement SharePoint local, vous pouvez utiliser le service web profil utilisateur pour copier les données UPS d’une batterie de serveurs vers une autre.

Quand est-elle adaptée ?

Lorsque vous disposez d’un environnement SharePoint local et que vous copiez des données UPS entre plusieurs batteries de serveurs SharePoint, il s’agit d’une bonne option, car elle vous donne 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 profil utilisateur.

Local : utiliser le service web profil utilisateur pour synchroniser les données

Si vous disposez d’un environnement SharePoint local, vous pouvez utiliser le service web profil utilisateur pour synchroniser les données UPS entre les batteries de serveurs.

Quand est-elle adaptée ?

Lorsque vous disposez d’un environnement SharePoint local et que vous synchronisez les données UPS entre deux batteries de serveurs SharePoint ou plus, cette option est une bonne option, car elle vous donne la possibilité d’effectuer une véritable synchronisation et d’inclure autant de sources que vous le souhaitez.

Prise en main

Core.UserProfilePropertyUpdater (exemple PnP O365) montre comment effectuer des opérations CRUD UPS avec le service web de profil utilisateur.

Core.MMSSync (exemple PnP O365) montre comment créer un outil de synchronisation pour les données MMS (Managed Metadata Service). 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 disposez d’un environnement SharePoint Office 365, vous pouvez utiliser CSOM pour copier des données UPS d’une location à une autre.

Quand est-elle adaptée ?

Lorsque vous disposez d’un environnement Office 365 et que vous copiez des données UPS entre plusieurs locations SharePoint, il s’agit d’une bonne option, car elle vous donne la possibilité de copier les données UPS d’une location à 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 guide tout au long du userProfile.Manipulation.CSOM (exemple PnP O365).

Office 365 - Utiliser CSOM pour synchroniser les données

Lorsque vous disposez d’une Office 365 environnement SharePoint et que vous synchronisez les données UPS entre deux locations ou plus, cette option est une bonne option, car elle vous donne la possibilité d’effectuer une véritable synchronisation et d’inclure autant de sources que vous le souhaitez.

Quand est-elle adaptée ?

Lorsque vous disposez d’un environnement Office 365 et que vous synchronisez des données UPS entre plusieurs locations SharePoint, il s’agit d’une bonne option, car elle vous donne la possibilité d’effectuer une véritable synchronisation et d’inclure autant de sources que vous le souhaitez.

Prise en main

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 SharePoint locaux et Office 365 et où les informations de profil utilisateur doivent être conservées dans les deux environnements, vous pouvez utiliser une combinaison du service web profil utilisateur et du modèle CSOM pour vous permettre d’effectuer des opérations CUD sur les données UPS.

Exemples PnP

S’applique à

  • Office 365 multi-locataire (MT).
  • Office 365 dédiés (D)
  • SharePoint 2013 en local