Lier ou importer des données à partir de Microsoft Graph

Qu’est-ce que Microsoft Graph ?

Microsoft Graph connecte les points entre de nombreuses applications et services Microsoft 365 en collectant et en organisant des données disparates (utilisateurs, groupes, messages, contacts, conversations, tâches, fichiers, etc.) dans un ensemble de relations. Voici quelques exemples de relations : un utilisateur est membre d’un groupe, le responsable actuel de l’utilisateur, l’utilisateur est mentionné dans plusieurs conversations ou le document de cet utilisateur a été collaboré par plusieurs collègues au cours des dernières heures.

Le mot « graphe » est un terme utilisé pour désigner un réseau social d’informations. Microsoft Graph est un réseau de connexions sociales et de données dans Microsoft 365. La valeur d’un réseau augmente de façon exponentielle avec le nombre de connexions. Dans Microsoft Graph, ces connexions sont basées sur ce sur quoi vous travaillez, avec qui vous travaillez et ce qui est important pour vous.

Vous pouvez rapidement obtenir des insights d’apprentissage automatique à jour à partir de tables Microsoft Graph, effectuer d’autres actions sur celles-ci et augmenter l’intelligence et la productivité de votre solution de base de données Access. Par exemple, vous pouvez trouver les personnes les plus pertinentes pour un utilisateur et les ajouter sous forme de liens vers un rapport par e-mail ou envoyer un rapport par e-mail à un groupe dont l’utilisateur est membre.

Avant de commencer

Vous voulez que tout se passe mieux ? Préparez-vous avant de lier ou d’importer des données :

• Les données Microsoft Graph sont basées sur votre compte professionnel ou scolaire. La première fois que vous utilisez Microsoft Graph, vous devrez peut-être vous connecter à Microsoft 365.

• Prenez en compte le nombre de colonnes dans chaque table ou vue. Access ne prenant pas en charge plus de 255 champs par table, il lie ou importe uniquement les 255 premières colonnes.

• Déterminez la quantité totale de données importées. La taille maximale d’une base de données Access est de 2 gigaoctets, dont il faut retrancher l’espace nécessaire pour les objets système. Microsoft Graph contient des tables volumineuses, qui peuvent prendre beaucoup de temps, et vous ne pourrez peut-être pas toutes les importer dans une base de données Access unique. Utilisez les paramètres de requête Microsoft Graph pour réduire la quantité de données liées.

• Sécurisez votre base de données Access et les informations de connexion qu’elle contient en utilisant un emplacement approuvé et un mot de passe de base de données Access. Pour plus d’informations, voir Décider d’approuver ou non une base de données et Chiffrer une base de données à l’aide d’un mot de passe de base de données.

• Planifiez l’établissement de relations supplémentaires. Accédez à des liens ou importe des tables sélectionnées et des sous-ensembles filtrés dans le modèle de données Microsoft Graph. Vous pouvez créer manuellement des relations supplémentaires entre les tables nouvelles et existantes à l’aide de la fenêtre Relations. Pour plus d’informations, voir Qu’est-ce que la fenêtre Relations ? et Créer, modifier ou supprimer une relation.

Prise en main

1. Sélectionnez Données externes > Nouvelle source de données > à partir des services en ligne > à partir de Microsoft Graph.

2. Si vous y êtes invité, connectez-vous à votre Compte professionnel ou scolaire Microsoft 365.

3. Effectuez l’une des opérations suivantes :

   • Pour importer des données, sélectionnez Importer les données sources dans une nouvelle table de la base de données active.

   • Pour lier les données, sélectionnez Lier les données sources en créant une table liée.

4. Sélectionnez OK.

5. Dans la boîte de dialogue Lier des tables ou Importer des objets , sous Tables, sélectionnez chaque table à laquelle vous souhaitez établir un lien ou à partir de laquelle vous souhaitez importer, puis cliquez sur OK.

   

Filtrer les résultats des liens à l’aide d’un paramètre de requête Microsoft Graph

Les opérations de création de liens et d’importation impliquant Microsoft Graph peuvent renvoyer une grande quantité de données, en particulier pour les filtres Groupes et Utilisateurs au sein d’une grande organisation. Lorsque vous établissez des liens, vous pouvez utiliser les paramètres de requête Microsoft Graph suivants pour filtrer les données sur le serveur avant de les récupérer :

• $top    Recherche un ensemble d’enregistrements limité par un nombre (par exemple, 25 premières lignes).

  Remarque    Nous vous recommandons de commencer par utiliser le paramètre de requête $top=n pour renvoyer une petite quantité de données et vous familiariser avec les champs et valeurs.

• $filter    Filtre le nombre de lignes sur la base d’une expression.

• $select   Renvoie uniquement les colonnes que vous spécifiez. Access renvoie toutefois le champ Réf systématiquement.

Access Microsoft Graph ne prend en charge qu’un sous-ensemble des expressions, de la syntaxe et des colonnes. Pour consulter des informations sur les éléments pris en charge et les dernières mises à jour, voir Utiliser des paramètres de requête pour personnaliser les réponses, le type ressource utilisateur et le type ressource de groupe.

1. Dans la boîte de dialogue Filtrer les résultats, entrez un paramètre de requête Microsoft Graph. Les exemples suivants montrent les filtres Groupes et Utilisateurs, mais vous pouvez créer des filtres similaires pour les autres tables.

   GroupesUtilisateurs

   $top=10

   $filter=securityEnabled eq false

   $filter=startswith(displayName, 'M')

   $filter=startswith(mailNickname, 'S')

   $filter=startswith(mail,'S') or startswith(mail,'T')

   $filter=startswith(mail, 'B') & $select=mail

   $select=mail,mailEnabled,mailNickname

   $select=classification,displayName

2. Sélectionnez OK.

Résultats

Lorsqu’une opération de liaison ou d’importation se termine, les tables s’affichent dans le volet de navigation avec le même nom que la table Microsoft Graph. Durant une opération d’importation, si ce nom est déjà utilisé, Access ajoute « 1 » au nom de la nouvelle table. Pendant une opération de liaison, si ce nom est déjà utilisé, Access ajoute « 1 » au nouveau nom de table, mais uniquement si un filtre différent est appliqué. Vous pouvez toujours renommer les tables en quelque chose de plus significatif.

Les tables avec un préfixe « My » retournent des données en fonction de l’utilisateur actuellement connecté.

Vous pouvez mettre à jour Mes contacts Outlook, mais toutes les autres tables Microsoft Graph sont en lecture seule.

Dans une opération d’importation, Access ne remplace jamais de table dans la base de données. Bien que vous ne puissiez pas ajouter directement Microsoft Graph à une table existante, vous pouvez créer une requête d’ajout pour ajouter des données après avoir importé des données à partir de tables similaires.

Dans une opération de liaison, si les colonnes sont en lecture seule dans la table Microsoft Graph, elles sont également en lecture seule dans Access.

Conseil    Pour afficher l’URL Microsoft Graph, y compris tout paramètre de requête, pointez sur la table dans le volet de navigation Access.

Modifier un paramètre de requête Microsoft Graph existant

Si vous avez une table liée existante avec un paramètre de requête, vous pouvez la modifier.

1. Dans le volet de navigation, cliquez avec le bouton droit sur la table liée, puis sélectionnez Gestionnaire de tables liées.

2. Dans la boîte de dialogue Gestionnaire de tables liées, cliquez sur le signe plus (+) pour développer le Nom de la source de données Microsoft Graph, puis sélectionnez la zone case activée en regard du nom de la source de données spécifique que vous souhaitez modifier.

3. Sélectionnez Relink.

4. Mettez à jour la chaîne du paramètre de requête dans la boîte de dialogue>lier <nom de table liée .

   Par exemple, remplacez $top=100 par $filter=userType eq 'Member'.

   Assurez-vous qu’il existe un point d’interrogation ( ?) entre le nom de la table et le paramètre de requête.

5. Sélectionnez OK.

6. Sélectionnez la zone case activée en regard du nom de la source de données spécifique que vous avez modifié.

7. SélectionnezActualiser.