Afficher le contenu de la page récupérable à l’aide de l’API Microsoft SharePoint Online REST

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Examinez les éléments du contenu d’une Microsoft SharePoint Online page qui peuvent être récupérés par le connecteur de Microsoft SharePoint Online contenu externe.

    Avant de commencer

    Vous avez besoin des détails suivants sur chaque Microsoft SharePoint Online page pour laquelle vous souhaitez afficher le contenu récupérable :
    • L’URL de votre site. Il est généralement au format https://<nom-de-locataire>.sharepoint.com/sites/<nom-du-site>, où <nom-de-locataire> est le nom d’hôte de votre locataire et <nom-du-site> est le nom du site dans lequel se trouve la page. Par exemple, l’URL de votre site peut être https://example.sharepoint.com/sites/my-site.
    • Nom de fichier de la page .aspx, sans l’extension. Par exemple, si l’URL de votre page est https://example.sharepoint.com/sites/my-site/SitePages/sample-page.aspx, le nom de fichier de la page est sample-age.
      Remarque :
      Microsoft SharePoint Online Les noms de fichiers des pages sont sensibles à la casse, alors copiez le nom de fichier exactement comme il apparaît dans le champ URL de votre navigateur Web.

    Rôle requis : aucun

    Pourquoi et quand exécuter cette tâche

    Effectuez cette procédure pour examiner le contenu des champs de métadonnées CanvasContent1 et WikiFields d’une Microsoft SharePoint Online page. Ces champs contiennent le contenu statique que le connecteur récupère et rend possible la recherche dans vos Recherche IA applications.

    Microsoft SharePoint Online Les pages sont stockées sous forme de fichiers .aspx dans la bibliothèque Site Pages d’un site. Ces fichiers incluent du contenu statique dans leurs champs de métadonnées CanvasContent1 et WikiFields, mais ils incluent également des scripts qui appellent un moteur côté serveur pour rendre dynamiquement le contenu consultable au moment de la demande. Le contenu exact restitué dépend du contexte utilisateur, des autorisations et des composants WebPart chargés dans le cadre de la demande de page.

    Le rendu du contenu entièrement visible d’une page nécessite une session utilisateur authentifiée. Le Microsoft SharePoint Online connecteur ne peut pas emprunter l’identité d’un utilisateur pour déclencher ce processus de rendu. Par conséquent, le connecteur ne peut pas capturer la sortie HTML finale qu’un navigateur Web affiche.

    Pour chaque page récupérée, le Microsoft SharePoint Online connecteur interroge l’API REST SharePoint pour accéder à l’élément de liste sous-jacent de la page. Le point de terminaison d’API utilisé est _api/web/lists('<list-id>')/items(<item-id>), où <list-id> et <item-id> sont des valeurs substituées dynamiquement. Le connecteur récupère le contenu principalement à partir des champs de métadonnées CanvasContent1 et WikiFields de la page, et capture également les autres champs de métadonnées de la page tels que le titre, l’auteur et la date de modification, le cas échéant. Le contenu de la page stocké exclusivement dans des composants WebPart dynamiques peut n’être récupéré que partiellement ou pas du tout, car ce contenu n’existe pas dans les métadonnées de l’élément de liste.

    Le résultat de cette limitation est que les pages construites principalement avec du contenu textuel statique créé dans l’éditeur Microsoft SharePoint Online produisent un contenu consultable qui correspond plus étroitement à ce que les utilisateurs voient dans un navigateur Web. En revanche, les pages qui reposent sur des composants WebPart dynamiques peuvent ne pas contenir tout le contenu que les utilisateurs voient dans un navigateur Web.

    Procédure

    1. Récupérez l’ID de la liste des pages du site de votre site.
      1. Dans un navigateur Web, accédez à votre Microsoft SharePoint Online locataire et connectez-vous.
      2. Dans le navigateur, accédez à <site-url>/_api/web/lists ?$select=ID,Title&$filter=Title %20eq %20%27Site %20Pages %27, en remplaçant <site-url> par l’URL de votreMicrosoft SharePoint Online site.
        Si cette demande ne renvoie pas de réponse XML décrivant la liste des pages du site, accédez plutôt à <site-url>/_api/web/lists ?$select=ID,Title , puis recherchez l’entrée pour la liste des pages du site dans la réponse non filtrée.
      3. Dans la réponse XML, localisez l’élément <d :Id> et copiez le GUID de liste indiqué comme valeur.
        Par exemple, le GUID de liste peut être 4acc128d-166d-441d-a7a6-d96ae2e8b46f.
    2. Affichez le contenu statique de la page sélectionnée.
      1. Dans votre navigateur Web, accédez à <site-url>/_api/web/lists('<list-id>')/items ?$filter=FileLeafRef %20eq %20%27<filename>.aspx %27, en remplaçant <site-url> par l’URL de votre site, <list-id> par le GUID que vous avez copié à l’étape 1.c et <filename> par le nom de fichier de la page pour laquelle vous souhaitez afficher le contenu pouvant être recherché.
      2. Dans la réponse XML, localisez les champs de métadonnées CanvasContent1 et WikiField et examinez leurs valeurs.
        Ces champs contiennent le contenu statique que le Microsoft SharePoint Online connecteur rend consultable lorsque la page est récupérée.
        Remarque :
        Si les champs de métadonnées CanvasContent1 et WikiField sont manquants ou vides, la page est probablement entièrement restituée via des composants WebPart dynamiques et ne contient pas de contenu statique pouvant être récupéré par le connecteur de Microsoft SharePoint Online contenu externe.