Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Interroger Office Graph à l'aide des API REST GQL et SharePoint Online Recherche

S'applique à : Office 365 | programme Office 365 First Release | SharePoint Online

Les API seront arrêtées le 31 août 2017

Depuis quelques temps, les développeurs ont pu expérimenter la préversion des API REST GQL et SharePoint Online Recherche pour interroger Office Graph. L' API Analyses, ainsi que d'autres API présentées dans Microsoft Graph, telles que API Contacts, devraient être utilisées à la place.

Nous encourageons les développeurs qui ont créé des applications sur la préversion de l'API à migrer vers API Microsoft Graph avant cette date. Voir ci-dessous des exemples d'appels d'API Microsoft Graph qui renvoient des données similaires aux API Office Graph GQL.

Étapes requises d'ici le 19 juin 2017

Comme première étape d'arrêt, nous introduisons un paramètre de requête EnableLegacySPOGraph. Vous devez le mettre à true dans vos appels aux API GQL à partir du 19 juin 2017.

  • D'ici le 19 juin 2017, les API cesseront de fonctionner sans le paramètre.
  • Les API cesseront de fonctionner complètement le 31 août 2017.

Exemple d'appel sans le paramètre requis :

https://<tenant_address>/_api/search/query?querytext='QUERY'&properties='GraphQuery:and(ACTOR(ME\,action\:1020)'

Exemple d'appel avec le paramètre requis :

https://<tenant_address>/_api/search/query?querytext='QUERY'&properties='GraphQuery:and(ACTOR(ME\,action\:1020),EnableLegacySPOGraph:true'

Migration vers les API Microsoft Graph

Types d'actions individuelles avec des résultats similaires renvoyés par API Microsoft Graph.

OrgManager (1013)

Remplacé par l'appel à l'API Get Manager.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1013)'
  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR({ActorId}\,action\:1013)'

Microsoft Graph

  • GET https://graph.microsoft.com/v1.0/me/manager
  • GET https://graph.microsoft.com/v1.0/users/{user id/user principal name}/manager

Résultats plus détaillés :

  • GET https://graph.microsoft.com/beta/me/manager
  • GET https://graph.microsoft.com/beta/users/{user id/user principal name}/manager

Vous pouvez également renvoyer l'utilisateur dans son intégralité et développer la propriété de navigation manager :

  • GET https://graph.microsoft.com/beta/users/{user id/user principal name}?$expand=manager

Plus d'informations sur l'utilisation de l'API Manager

OrgDirect (1014)

Remplacé par l'appel à l'API Liste DirectReports.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1014)'
  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR({ActorId}\,action\:1014)'

Microsoft Graph

  • GET https://graph.microsoft.com/v1.0/me/directReports
  • GET https://graph.microsoft.com/v1.0/users/{user id/user principal name}/directReports

Résultats plus détaillés :

  • GET https://graph.microsoft.com/beta/me/directReports
  • GET https://graph.microsoft.com/beta/users/{user id/user principal name}/directReports

Vous pouvez également renvoyer une requête pour un utilisateur et développer la propriété de navigation directReports :

  • GET https://graph.microsoft.com/beta/users/{user id/user principal name}?$expand=directReports

Plus d'informations sur l'utilisation de l'API Manager

Plus d'informations sur l'utilisation de l'API DirectReports

OrgColleague (1015)

Remplacé par un appel aux API Get Manager et List DirectReports.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1015)'
  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR({ActorId}\,action\:1015)'

Microsoft Graph

Renvoi de manager et ensuite des rapports directs du manager.

  1. GET https://graph.microsoft.com/v1.0/users/{user id/user principal name}/manager
  2. GET https://graph.microsoft.com/v1.0/users/{user id/user principal name}/directReports

Plus d'informations sur l'utilisation de l'API Manager

Plus d'informations sur l'utilisation de l'API DirectReports

OrgSkipLevelManager (1016)

Remplacé par les deux appels à l'API Get Manager.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1016)'
  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR({ActorId}\,action\:1016)'

Microsoft Graph

  1. GET https://graph.microsoft.com/v1.0/users/{user id/user principal name}/manager

Plus d'informations sur l'utilisation de l'API

WorkingWith (1019)

Remplacé par l'API Contacts.

Trié par défaut par pertinence. Rank propriété exposée dans le cadre du type de ressource rankedEmailAddress dans la réponse. Une valeur de rang supérieure correspond à un résultat plus pertinent. La pertinence est déterminée par les signaux de communication, de collaboration et de relation d'affaires.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1019)'

Microsoft Graph

  • GET https://graph.microsoft.com/beta/me/people/

Plus d'informations sur l'API Contacts

WorkingWithPublic (1033)

Remplacé par l'API Contacts.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR({ActorId}\,action\:1033)'

Microsoft Graph

  • GET https://graph.microsoft.com/beta/users/{user id/user principal name}/people/

Plus d'informations sur l'API Contacts

RecentlyViewed (1001)

Remplacé par l'API Utilisé.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1001)'

Microsoft Graph

Remplacé par l'API Utilisé.

  • GET https://graph.microsoft.com/beta/me/insights/used

Plus d'informations sur l'API Utilisé

Modifié (1003)

Remplacé par l'API Utilisé.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1003)'
  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR({ActorId}\,action\:1003)'

Microsoft Graph

Remplacé par l'API Utilisé.

  • GET https://graph.microsoft.com/beta/me/insights/used?$orderby=LastUsed/LastModifiedDateTime
  • GET https://graph.microsoft.com/beta/users/{user id/user principal name}/insights/used?$orderby=LastUsed/LastModifiedDateTime

Plus d'informations sur l'API Utilisé

TrendingAround (1020)

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1020)'
  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR({ActorId}\,action\:1020)'

Microsoft Graph

Remplacé par l'API Tendances.

  • GET https://graph.microsoft.com/beta/me/insights/trending
  • GET https://graph.microsoft.com/beta/users/{user id/user principal name}/insights/trending

Plus d'informations sur l'API Tendances

PersonalFeed (1021)

Remplacé par l'API Tendances.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1021)'

Microsoft Graph

Remplacé par la nouvelle API Tendances.

  • GET https://graph.microsoft.com/beta/me/insights/trending

Plus d'informations sur l'API Tendances

Received (1049)

Remplacé par l'API Partagé.

GQL

  • https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1049)'

Microsoft Graph

  • GET https://graph.microsoft.com/beta/me/insights/shared

Plus d'informations sur l'API Partagé

Contenu de la préversion

Utilisez plutôt les API Microsoft Graph. Voir Microsoft Graph. Le contenu ci-dessous s'applique à Office Graph, qui est actuellement en préversion. Cette API sera interrompue le 31 août 2017.

Office Graph calcule les informations dans Office 365 et les présente via Microsoft Graph, le seul point terminal que vous pouvez utiliser pour accéder à un certain nombre de technologies cloud de Microsoft. Actuellement, vous pouvez interroger les analyses suivantes à partir d'Office Graph :

Le langage de requête représentée sous forme de graphique (GQL) est un langage de requête préliminaire conçu pour interroger Office Graph via l'API REST de SharePoint Online Recherche. En utilisant GQL, vous pouvez interroger Office Graph pour obtenir les éléments d'un acteur qui satisfait à un filtre particulier.

Remarque Les fonctionnalités et les API documentées dans cet article sont en préversion et sont susceptibles d'être modifiées. Les ajouts actuels à l'API REST Recherche constituent une solution préliminaire permettant d'interroger Office Graph, principalement destinés à l'expérience Office Delve. N'hésitez pas à essayer d'interroger Office Graph, mais n'utilisez pas ces fonctionnalités ou d'autres fonctionnalités et API documentées dans cet article qui sont en production. Votre avis sur ces fonctionnalités et API est important. Dites-nous ce que vous en pensez. Communiquez avec nous sur Stack Overflow. Marquer vos questions avec [office365].

Office Graph représente les relations entre les objets d'entreprise par des connexions

Office Graph contient des informations sur les objets d'entreprise, tels que les contacts et les documents, ainsi que sur les relations et les interactions entre ces objets. Les relations et les interactions sont représentées par des connexions.

Certaines connexions représentent une interaction simple :

  • Modified - Carl a modifié un document.
  • Viewed - Jarvis a vu une présentation.

Certaines connexions sont calculées sur base de plusieurs interactions :

  • Travailler avec - Les contacts avec qui vous interagissez fréquemment.
  • TrendingAround - Les éléments qui sont populaires dans votre cercle de collègues.

Certaines connexions sont des relations entre des objets d'entreprise :

  • OrgManager, OrgColleague, et ainsi de suite - Connexions de la structure organisationnelle.

Voir Types d'actions disponibles pour obtenir une liste des connexions Office Graph actuelle et leur description.

La figure 1 illustre le volet Recherche d'Office Graph, où les informations sont collectées via l'activité à travers les services d'Office 365 et traitées pour créer des connexions. Actuellement, les informations contenues dans Office Graph sont collectées à partir de SharePoint Online, OneDrive Entreprise, Exchange Online, Microsoft Azure Active Directory et Delve.

Figure 1. Une vue simplifiée du volet Recherche d'Office Graph et Delve, sa fonctionnalité principale

Le volet Recherche d'Office Graph et Delve, sa fonctionnalité principale.

Le modèle de données Office Graph et les propriétés de connexion

Comme pour n'importe quel graphique, chaque connexion d'Office Graph possède un nœud source et un nœud cible. Le nœud source est appelé l' acteur et le nœud cible est appelé l' objet.

Figure 2. La relation entre acteur, connexion et objet

Chaque connexion possède un nœud source (l’acteur) et un nœud cible (l’objet)

Les connexions ont les propriétés énumérées dans le tableau 1.

Tableau 1. Descriptions des propriétés des connexions et leur type

PropriétéTypeDescription
ActorIdEntierL'identifiant de l'acteur.
ObjectIdEntierL'identifiant de l'objet.
Action typeEntierUn identifiant qui caractérise l'action ou le type de relation représenté par la connexion. Les types d'actions importants sont répertoriés dans Types d'actions disponibles.
TimeChaîneUn timestamp de la connexion ; basé sur la norme ISO 8601. La sémantique du timestamp dépend du type de la connexion. Voir Types d'actions disponibles.
PoidsEntierUn nombre qui indique l'importance de la connexion. La sémantique du poids dépend du type de connexion. Voir Types d'actions disponibles.
BlobBlobRéservé à un usage interne.
BlobContentChaîneRéservé à un usage interne.
ObjectSourceEntierRéservé à un usage interne.

Les nœuds dans Office Graph possèdent les mêmes propriétés que celles définies dans SharePoint Online schéma de recherche. Vous pouvez récupérer les propriétés Retrievable en utilisant la propriété de requête SelectProperties.

Extensions de requête représentée sous forme de graphique dans l'API REST SharePoint Online Recherche

Vous pouvez interroger Office Graph via SharePoint Online API REST SharePoint Recherche en mettant deux nouvelles propriétés dans le conteneur des propriétés de la requête : GraphQuery et GraphRankingModel. Le GraphQuery est écrit en GQL.

Vous pouvez combiner GraphQuery et GraphRankingModel avec les autres paramètres de requête que vous connaissez dans Recherche de SharePoint Online, à l'exclusion des raffineurs et des modèles de requête.

Généralement, lorsque vous interrogez Office Graph, vous souhaitez trouver des éléments liés à d'autres, et récupérer des informations sur ces éléments et leurs relations. Par exemple, vous souhaitez interroger le graphe pour « tout ce qui concerne Carl Steadman » ou « tous les éléments modifiés par Jarvis Ferro ».

Figure 2. Un appel de requête représentée sous forme de graphique typique via REST

Dans une requête graphique, vous pouvez utiliser une partie contenu (Querytext) et une partie graphique (GraphQuery). La propriété GraphQuery est spécifiée dans le cadre de Propriétés.

Une requête représentée sous forme de graphique peut contenir à la fois une partie de contenu (Querytext) et une partie graphique (GraphQuery). Vous pouvez les utiliser pour effectuer une recherche combinée sur le contenu d'un élément entier et sur les interactions que les contacts ont eues avec cet élément particulier. La propriété Querytext est obligatoire. Si vous souhaitez faire correspondre tous les éléments sans filtrer aucune partie du contenu, vous pouvez utiliser une astérisque (*).

GQL a un opérateur principal : ACTEUR. L'opérateur ACTEUR trouve toutes les actions de l'acteur donné qui satisfait à un filtre. Ensuite il renvoie tous les objets pour ces actions. Par exemple, pour renvoyer les documents modifiés par Carl Steadman (en supposant que ActorId = 1234 pour Carl Steadman) vous pouvez diviser cette information en :

  • Carl Steadman est l' ACTEUR.

  • Modifier est l' action avec ID = 1003.

  • Le document est l' objet, qui est renvoyé dans le résultat.

Ensuite, vous pouvez écrire la requête suivante.

ACTOR(1234, action:1003)

Voici la syntaxe pour l'opérateur ACTEUR.

ACTOR(<ActorId> [, filter])

ActorId est l'identifiant du nœud pour lequel vous voulez rechercher les actions. Le filtre est un prédicat appliqué à toutes les connexions sortantes de l'acteur. Le filtre est construit en utilisant l' Action, Time, et Poids du tableau 1 en combinaison avec des opérateurs booléens : ET, NE PAS, et OU. Les résultats de la requête sont les objets de toutes les connexions qui correspondent au filtre.

Vous pouvez combiner les opérateurs ACTEUR en utilisant les opérateurs ET et OU. Par exemple, pour renvoyer tous les éléments modifiés par Jarvis Ferro ( ActorId = 1234) et Austin Ingalls ( ActorId = 5678), vous écrivez ce qui suit.

AND(ACTOR(1234, action:1003), ACTOR(5678, action:1003))

Écrivez ce qui suit pour renvoyer tous les éléments modifiés par Jarvis Ferro ou Austin Ingalls.

OR(ACTOR(1234, action:1003), ACTOR(5678, action:1003))

Lorsque vous écrivez des requêtes représentées sous forme de graphique qui nécessitent l'utilisation de ActorId de l'utilisateur authentifié, vous pouvez utiliser la macro MOI comme substitut équivalent. Par exemple, pour renvoyer des documents modifiés par l'utilisateur authentifié, écrivez ce qui suit.

ACTOR(ME, action:1003)

Types d'actions disponibles

Tableau 2. Types d'action et leur description

Type d'actionDescriptionVisibilitéIDPoidsTimestamp
PersonalFeedLe flux personnel de l'acteur comme indiqué sur leur vue Accueil dans Delve.Privé1021Un numéro de séquence.Lorsque l'élément a été ajouté au flux sur la vue Accueil dans Delve.
ModifiéLes éléments que l'acteur a modifiés au cours des trois derniers mois.Public1003Le nombre de modifications.Modifié en dernier.
OrgColleagueTous ceux qui rapportent au même manager que l'acteur.Public1015Toujours 1.-
OrgDirectLes rapports directs de l'acteur.Public1014Toujours 1.-
OrgManagerLa personne à qui l'acteur rapporte.Public1013Toujours 1.-
OrgSkipLevelManagerLe manager de saut de niveau de l'acteur.Public1016Toujours 1.-
WorkingWithLes personnes avec lesquelles l'acteur communique ou travaille fréquemment.Privé1019Note de pertinence.-
TrendingAroundÉléments populaires auprès des contacts avec lesquelles l'acteur travaille ou communique fréquemment.Public1020Note de pertinence.-
ConsultésEléments consultés par l'acteur au cours des trois derniers mois.Privé1001Le nombre d'affichages.Consultés en dernier.
WorkingWithPublicUne version publique de la connexion WorkingWith.Public1033Un numéro de séquence.-

Exécution de requêtes représentées sous forme de graphique dans SharePoint 2013

Pour interroger Office Graph, vous devez ajouter GraphQuery au conteneur de la propriété de la classe KeywordQuery. La valeur de cette propriété doit être la chaîne de requête représentée sous forme de graphique au format GQL. Pour interroger l'ID d'une personne (ActorId), comme Carl Steadman (username:carls), vous pouvez écrire la requête REST suivante.

https://<tenant_address>/_api/search/query?Querytext='Username:carls'&amp;SourceId='b09a7990-05ea-4af9-81ef-edfab16c4e31'&amp;SelectProperties='UserName,DocId'

Remarque L'origine des résultats à utiliser pour exécuter une requête particulière est le SourceId ; b09a7990-05ea-4af9-81ef-edfab16c4e31 est l'ID de l'origine des résultats de recherche de contacts.

Le résultat contient l'ID de la personne (DocID=21865248), comme indiqué.

<d:element m:type="SP.KeyValue">
    <d:Key>DocId</d:Key>
    <d:Value>21865248</d:Value>
    <d:ValueType>Edm.Int64</d:ValueType>
</d:element>

Exemples

Les exemples suivants montrent comment écrire des requêtes d'acteur simple et d'acteurs multiples pour interroger Office Graph. Ces exemples utilisent Carl en tant qu'acteur avec ActorId : 2962.

Les résultats renvoyés par ces requêtes peuvent contenir un maximum de dix éléments car il s'agit du nombre par défaut. Vous pouvez augmenter le nombre de résultats en utilisant la propriété RowLimit (), comme indiqué dans cet exemple.

Requêtes d'acteur simple

  • Les dix premiers éléments relatifs à vous.

    Syntaxe : ACTOR(ME)

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME)'
  • Les dix premiers éléments relatifs à Carl.

    Syntaxe : ACTOR(2962)

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(2962)'
  • Votre manager.

    Syntaxe : ACTOR(ME, action:1013)

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1013)'
  • Les dix premiers éléments que vous avez récemment modifiés ou consultés.

    Syntaxe : ACTOR(ME, OR(action:1001,action:1003))

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,OR(action\:1001\,action\:1003))'
  • Les dix premiers éléments que vous avez modifiés le 15 août 2014.

    Syntaxe : ACTOR(ME, AND(action:1003, time:datetime(2014-08-15)))

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,AND(action\:1003\,time\:datetime(2014-08-15)))'
  • Les dix premiers éléments que vous avez modifiés le 26 juin 2014 ou plus tard.

    Syntaxe : ACTOR(ME, AND(action:1003, time:range(datetime(2014-06-26),max)))

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,AND(action\:1003\,time\:range(datetime(2014-06-26)\,max)))'

Requêtes d'acteurs multiples

  • Les dix premiers éléments relatifs à vous et à Carl.

    Syntaxe : AND(ACTOR(ME), ACTOR(2962))

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:AND(ACTOR(ME)\,ACTOR(2962))'
  • Les dix premiers éléments relatifs à vous ou à Carl.

    Syntaxe : OR(ACTOR(ME), ACTOR(2962))

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:OR(ACTOR(ME)\,ACTOR(2962))'
  • Les dix premiers éléments que vous avez récemment consultés, et que Carl a récemment modifiés.

    Syntaxe : AND(ACTOR(ME, action:1001), ACTOR(2962, action:1003))

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:AND(ACTOR(ME\,action\:1001)\,ACTOR(2962\,action\:1003))'

Comprendre le format de résultat de la requête représentée sous forme de graphique

Le format de résultat pour les requêtes représentées sous forme de graphique est similaire au résultat pour les requêtes de recherche, avec une colonne supplémentaire, Connexions, en tant que membre de RelevantResultResultTable renvoyé par l' API de requête de recherche de SharePoint 2013. Le format de Connexions est un tableau de connexions sérialisé en JSON.

Par exemple, la requête suivante demande la liste des contacts à un acteur particulier (ActorId : 21894957) travaille avec (ActionId : 1033).

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='Graphquery:ACTOR(21894957\,action\:1033)'&amp;SelectProperties='Docid,Title'

La sortie est la structure XML suivante, contenant Connexions et d'autres éléments. Dans cet exemple, seul un élément Connexions est renvoyé.

<d:element m:type="SP.KeyValue">
    <d:Key>Edges</d:Key>
    <d:Value>[{"ActorId":21894957,"ObjectId":21900499,
        "Properties":{"Action":1033,"Blob":[],
        "ObjectSource":1,"Time":"2013-12-02T13:56:25.5979646Z",
        "Weight":61}}]
    </d:Value>
    <d:ValueType>Edm.String</d:ValueType>
</d:element>

Contrôle d'accès à la requête représentée sous forme de graphique

Les requêtes représentées sous forme de graphique utilisent les mêmes mécanismes de contrôle d'accès que les requêtes de recherche. Une requête représentée sous forme de graphique renvoie uniquement les éléments auxquels l'utilisateur a accès.

Office Graph fournit également un mécanisme de contrôle d'accès pour toutes ses connexions. Chaque type d'action d'une connexion dans le graphe peut être privé ou public. Les connexions publiques sont visibles pour tous les utilisateurs de l'organisation. Les connexions privées sont visibles uniquement par l'acteur. Elles sont ignorées lorsqu'un autre utilisateur effectue une requête sous forme de graphique. Par exemple, Carl Steadman peut interroger Office Graph pour les éléments qu'il a consultés. Si un autre utilisateur effectue cette requête avec l'ActorId de Carl Steadman, il obtient un résultat vide. La colonne Visibilité du tableau 2 répertorie les types d'action publiques et privées.

Exemples avancés de requête

Vous pouvez écrire des requêtes représentées sous forme de graphique de différentes manières pour accomplir différentes tâches. Les exemples suivants sont destinés à fournir un repère simple sur la façon dont vous pouvez écrire ces requêtes avancées.

Combiner la propriété GraphQuery avec d'autres propriétés de requête

Exemple 1 : Les dix premiers éléments relatifs à vous ou à Carl, et incluant les propriétés DocId et Edges dans les résultats.

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:OR(ACTOR(ME)\,ACTOR(2962))'&amp;SelectProperties='DocId,Edges'

Remarque Vous recevrez plus de propriétés dans la sortie que juste DocId et Edges ; par exemple, RankId et PartitionId. La raison est qu'il s'agit des propriétés par défaut renvoyées par le service de recherche.

Exemple 2 : 100 premiers éléments relatifs à vous ou à Carl.

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:OR(ACTOR(ME)\,ACTOR(2962))'&amp;RowLimit=100

Les connexions que vous obtenez à la suite de la requête présentée sous forme de graphique sont celles que vous avez spécifiquement demandées dans la requête. Toutefois, dans certains cas, vous souhaiterez peut-être récupérer des types de connexions supplémentaires sans affecter les documents renvoyés dans le résultat de la requête.

Exemple 3 : Récupérez tous les documents tendances qui vous entourent (ActionId : 1020), et renvoyez également des informations indiquant si vous avez consulté et modifié ces documents. Vous pouvez le faire en utilisant la construction booléenne ci-dessous.

Syntaxe : AND( ACTOR(ME, action:1020), ACTOR(ME, OR(action:1020,action:1001,action:1003)))

https://<tenant_address>/_api/search/query?Querytext='*'&Properties='GraphQuery:AND(ACTOR(ME\,action\:1020)\,ACTOR(ME\,OR(action\:1020\,action\:1001\,action\:1003)))'&SelectProperties='Docid,Title'

Utilisez la propriété GraphRankingModel pour trier les résultats

Vous pouvez trier le résultat renvoyé pour les requêtes représentées sous forme de graphique de deux manières : par le Timestamp de la connexion ou le Poids de la connexion.

  • Pour trier en fonction du timestamp de la connexion, spécifiez la propriété GraphRankingModel égale à {"features"\:[{"function"\:"EdgeTime"}]}.

  • Pour trier en fonction du poids de la connexion, spécifiez la propriété GraphRankingModel égale à {"features"\:[{"function"\:"EdgeWeight"}]}.

Dans les deux cas, vous devez également spécifier la propriété RankingModelId à '0c77ded8-c3ef-466d-929d-905670ea1d72'. Si un élément du résultat est l'objet de plusieurs connexions correspondant à la requête représentée sous forme de graphique, le Timestamp ou le Poids est utilisé.

Exemple 1 : Triez les éléments que vous avez modifiés récemment en fonction du moment où ils ont été modifiés pour la dernière fois.

Syntaxe : GraphQuery:ACTOR(ME, action:1003) GraphRankingModel:{"features"\:[{"function"\:"EdgeTime"}]} RankingModelId='0c77ded8-c3ef-466d-929d-905670ea1d72'

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1003),GraphRankingModel:{"features"\:[{"function"\:"EdgeTime"}]}'
&amp;RankingModelId='0c77ded8-c3ef-466d-929d-905670ea1d72'

Exemple 2 : Triez les contacts avec lesquelles vous travaillez (WorkingWith) par leur proximité avec vous.

Syntaxe : GraphQuery:ACTOR(ME, action:1019) GraphRankingModel:{"features"\:[{"function"\:"EdgeWeight"}]} RankingModelId='0c77ded8-c3ef-466d-929d-905670ea1d72'

https://<tenant_address>/_api/search/query?Querytext='*'&amp;Properties='GraphQuery:ACTOR(ME\,action\:1019),GraphRankingModel:{"features"\:"function"\:"EdgeWeight"}]}'
&amp;RankingModelId='0c77ded8-c3ef-466d-929d-905670ea1d72'

Pour les requêtes d'acteurs multiples, vous pouvez utiliser un paramètre appelé actorCombination dans le GraphRankingModel pour choisir comment combiner les scores de rang pour les différents acteurs.

Exemple 3 : Trouvez des documents tendances qui tournent autour de vous et de Carl, et les trier par la somme de leur poids tendances.

Syntaxe : AND(ACTOR(ME, action:1020), ACTOR(2962, action:1020)) GraphRankingModel:{"actorCombination"\:"sum"\,"features"\:[{"function"\:"EdgeWeight"}]} RankingModelId='0c77ded8-c3ef-466d-929d-905670ea1d72'

https://<tenant_address>/_api/search/query?Querytext='*'&Properties='GraphQuery:AND(ACTOR(ME\, action\:1020)\,ACTOR(2962\,action\:1020)),
GraphRankingModel:{ "actorCombination"\:"sum"\,"features"\:[{"function"\:"EdgeWeight"}]}'
&RankingModelId='0c77ded8-c3ef-466d-929d-905670ea1d72'

Le paramètre actorCombination prend en charge les valeurs « min », « max » et « somme » ; la valeur par défaut est « max ».

Combinez la propriété GraphQuery avec des requêtes de contenu ou des requêtes de texte intégral

Exemple : Combinez GraphQuery avec Querytext= 'Titre:design' pour rechercher tous les éléments que vous avez récemment consultés avec « design » dans leur titre.

Syntaxe : GraphQuery:ACTOR(ME, action:1001) Querytext='Title:design'

https://<tenant_address>/_api/search/query?Querytext='Title:design'&amp;Properties='GraphQuery:ACTOR(ME)\,action\:1001))

Pour modifier la requête, vous pouvez utiliser n'importe quelle requête Querytext.

Utilisation de la propriété de requête GraphRestrictionMode pour modifier le résultat

Lorsque vous exécutez une requête représentée sous forme de graphique, l'ensemble des éléments par défaut que vous obtenez en retour est l'intersection du résultat du graphe et du résultat du contenu. Mais, si vous voulez qu'Office Graph renvoie uniquement le résultat du contenu, vous pouvez définir la propriété GraphRestrictionMode comme false. Toutes les connexions correspondant à la requête représentée sous forme de graphique sont également renvoyées en tant que partie de ce résultat.

Exemple : Combinez GraphQuery avec Querytext= 'Titre:design' pour rechercher tous les éléments que vous avez récemment consultés avec « design » dans leur titre.

Syntaxe : GraphQuery:ACTOR(ME, action:1001) Querytext='design' GraphRestrictionMode:false

https://<tenant_address>/_api/search/query?Querytext='design'&amp;Properties='GraphQuery:ACTOR(ME)\,action\:1001),GraphRestrictionMode:false'&SelectProperties='Docid,Title'
© 2018 Microsoft