Partager via

Table utilisateur Azure Active Directory

  • Article

Notes

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 renvoie 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é uniquement en ligne.

Notes

Vos résultats avec AAD User peuvent différer selon l’endroit où il est utilisé. AAD User dans Dataverse fournira la liste complète des utilisateurs du 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 renvoie pas de groupes ni de listes de distribution.

Recherches à l’aide d’AADUser

Vous pouvez facilement ajouter une recherche à cette table virtuelle depuis le portail Power Apps.

Créer une colonne de recherche avec une table associée de AADUser

Autorisations

La table AADUser fonctionne à l’aide de 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 seule et de lecture multiple sont possibles via la table virtuelle AADUser.

Exemples d’API web de table AADUser

Cette section contient des exemples HTTP GET pour accéder aux données de la table AADUser.

Récupération des données

L’exemple suivant illustre la récupération des données 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 avec 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 de la société n’a pas de valeur 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 enregistrements AADUser dont le contenu businessphones est ’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 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 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 faisant référence à un enregistrement AADUser

Ci-dessous, new_aaduser_account est le nom de la relation 1:N entre l’AADUser et l’entité Compte.

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 la référence à une ligne de la table AADUser.

Définir la valeur du champ de recherche faisant référence à 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 AADUser et l’entité Compte. Le nom de cette propriété de navigation est défini dans la propriété OneToManyRelationshipMetadata.ReferencingEntityNavigationPropertyName de la relation. Informations complémentaires : 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
aaduser EntityType reference
Sécurité et accès aux données

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).