Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Note
Azure Active Directory est désormais Microsoft Entra ID. En savoir plus
Microsoft Dataverse inclut une table virtuelle nommée utilisateur AAD (aaduser). Cette table virtuelle fournit une connexion à Azure Active Directory (AAD) et retourne des données sur les utilisateurs au sein de votre organisation AAD. Aucune configuration de table virtuelle n’est requise pour utiliser la fonctionnalité. Il s’agit d’une fonctionnalité en ligne uniquement.
Note
Vos résultats avec l’utilisateur AAD peuvent différer selon l’emplacement où il est utilisé. L’utilisateur AAD dans Dataverse fournit la liste complète des utilisateurs sur Azure AD pour l’organisation. AAD User dans Dataverse for Teams se limite à renvoyer tous les utilisateurs AAD qui sont également membres de l’équipe.
L’utilisateur AAD ne retourne pas de groupes ni de listes de distribution.
Recherches à l’aide d’AADUser
Vous pouvez facilement ajouter une recherche à cette table virtuelle à partir du portail Power Apps.
Permissions
La table AADUser fonctionne en utilisant Microsoft Graph. Les utilisateurs de votre organisation doivent disposer d’autorisations Graph pour afficher et utiliser la table virtuelle AADUser.
Opérations autorisées
Seules les opérations de lecture et de lecture multiple sont possibles via la table virtuelle AADUser.
Exemples de la Web API de la table AADUser
Cette section contient des HTTPGET exemples d’accès aux données à partir de la table AADUser.
Récupération de données
L’exemple suivant illustre la récupération de données à partir de la table AADUser.
Récupérer toutes les lignes de la table AADUser
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers
Récupérer les enregistrements AADUser avec le nom de famille 'admin'
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=surname eq 'admin'
Récupérer les enregistrements AADUser portant le nom de famille « admin » ou « admin02 »
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=(surname eq 'Admin02') or (surname eq 'Admin')
Récupérer les enregistrements AADUser dont le nom d’entreprise n’est pas null
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=companyname ne null
Récupérer les enregistrements AADUser dont le type d’utilisateur est « Member »
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=usertype eq 'Member'
Récupérer les fiches AADUser dont les téléphones professionnels contiennent « 123-555-1212 »
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=contains(businessphones, '123-555-1212')
Récupérer les enregistrements AADUser dont le nom donné commence par « test »
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=startswith(givenname, 'test')
Récupérer les enregistrements AADUser dont le nom donné ne commence pas par « test »
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=not startswith(givenname, 'test')
Récupérer les enregistrements de compte associés qui font référence à un enregistrement AADUser
new_aaduser_account Vous trouverez ci-dessous le nom de la relation 1 :N entre AADUser et l’entité Account.
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers(<user ID>)?$expand=new_aaduser_account($select=accountid,name)
Référencer une ligne AADUser
L’exemple suivant illustre le référencement d’une ligne de table AADUser.
Définir la valeur d'un champ de recherche en se référant à une ligne AADUser
Dans cet exemple, new_testaaduserId est la propriété de navigation à valeur unique créée avec une relation 1:N personnalisée entre l'entité AADUser et l'entité Account. Le nom de cette propriété de navigation est défini dans la propriété OneToManyRelationshipMetadata.ReferenceingEntityNavigationPropertyName de la relation. Plus d’informations : propriétés de navigation à valeur unique
PATCH
https://[Organization URI].crm.dynamics.com/api/data/v9.0/accounts(<account ID>)
{
new_testaaduserId@odata.bind : "/aadusers(user ID)"
}
Voir aussi
Référence d’entité/de table aaduser
référence de type d'entité aaduser
Sécurité et accès aux données