Partager via

Protocole de l'URL

  • Article

Dernière modification : vendredi 9 avril 2010

S’applique à : SharePoint Foundation 2010

Le tableau suivant répertorie les méthodes SharePoint Foundation, protocole RPC qui peuvent être utilisées dans le protocole d’URL pour les demandes HTTP GET. Pour plus d’informations sur une méthode spécifique, cliquez sur la commande pour afficher la rubrique correspondant à la méthode RPC concernée.

Notes

La possibilité pour les commandes URL de retourner du HTML, telles que Display dans le tableau suivant, est désormais limitée par les modifications apportées à la sécurité dans Microsoft SharePoint Foundation. Si une gestion des fichiers par les navigateurs stricte est activée, les données retournées sont marquées en tant que pièce jointe et téléchargées d’office. Cela s’applique aux commandes URL en général, mais particulièrement aux commandes destinées à restituer les résultats directement dans le navigateur.

Commande (Cmd=)

Description

Paramètres

dialogview

Paramètre spécial utilisé dans la commande Cmd=Display qui ouvre une vue des bibliothèques de documents dans un site, une vue d’une bibliothèque de documents spécifique ou une vue d’un dossier dans une bibliothèque de documents qui est utilisé dans une boîte de dialogue pour ouvrir ou enregistrer des fichiers ; ou bien ouvre le formulaire de propriétés utilisé lors de l’enregistrement d’un fichier.

dialogview, location, FileDialogFilterValue

Display

Exécute une requête de base de données dans une liste spécifiée par un GUID et renvoie du XML ou du HTML.

List, XMLDATA, View, Query, Using, CacheControl, ID

ExportList

Exporte au format CAML (Collaborative Application Markup Language) le schéma de la liste spécifiée par un GUID.

List

GetProjSchema

Demande le schéma XML pour un site Web.

SiteTemplate

GetUsageBlob

Renvoie des informations sur l'utilisation d'un site Web.

BlobType

HitCounter

Génère un accès sur une page qui contient un compteur d’accès.

Page, Image, Custom, Digits

RenderView

Demande le contenu d'une vue pour la liste spécifiée par un GUID.

List, View, URLBase

Les paramètres suivants peuvent également être utilisés dans le protocole :

  • FileDialogFilterValue pour définir les filtres d'une vue et renvoyer la liste de tous les fichiers d'un type spécifié à partir d'une bibliothèque de documents en fonction de l'extension de nom de fichier (par exemple, *.doc, *.ppt ou *.xls).

  • FilterFieldn pour spécifier le nom d’un champ dans la base de données, où n est un entier qui est limité uniquement par le nombre de champs autorisés dans la table de base de données ou par la longueur autorisée pour le champ d’URL.

  • FilterValuen pour spécifier la valeur de chaîne sur laquelle filtrer un champ, où n est un entier qui est limité uniquement par la longueur autorisée pour le champ d’URL.

  • SortField pour spécifier le nom du champ sur lequel appliquer le tri.

  • SortDir pour indiquer un tri croissant (asc) ou décroissant (desc).

  • Using pour spécifier l’URL relative d’un fichier virtuel utilisé dans l’exportation d’un élément ou d’une liste, et qui peut prendre l’une des valeurs suivantes : vcard.vcf, event.ics, query.iqy ou query.bqy.

Utilisation du protocole de l'URL

L’intégration d’une demande dans une URL est un système de base qui permet d’émettre une méthode et ses paramètres sur un serveur qui exécute SharePoint Foundation. La syntaxe permettant d’utiliser ce système est la suivante :

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?Cmd=
   Method_name[&Parameter1=Value1&Parameter2=Value2...]

Ce code exemple exporte le schéma de la liste spécifiée par un GUID.

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?Cmd=
   ExportList&List=GUID

Cet exemple affiche la liste des discussions sous forme de fichier CAML.

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?Cmd=
   Display&List=GUID&XMLDATA=TRUE

Le code exemple suivant exporte la liste des discussions dans une feuille de calcul Microsoft Excel. Notez que le GUID de la vue associée doit être affecté au paramètre View.

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?CS=
   109&Using=_layouts/query.iqy&List=GUID&View=GUID&CacheControl=1

Pour plus d'informations sur la façon d'utiliser le protocole de l'URL pour publier des demandes, voir Procédure : publier des méthodes RPC SharePoint Foundation.