URL et jetons dans SharePointURLs and tokens in SharePoint

Découvrez comment formuler des URL et utiliser des jetons d’URL dans SharePoint.Learn how to formulate URLs and how to use URL tokens in SharePoint.

Types d’URL dans SharePointTypes of URLs in SharePoint

SharePoint analyse les chaînes d'URL afin de déterminer la forme de l'URL d'après un protocole spécifié (par exemple, http:) ou d'après l'insertion d'une barre oblique (/) dans la chaîne. Selon le membre particulier, vous pouvez utiliser les formes d'URL suivantes :SharePoint parses URL strings to determine the form of URL based on a specified protocol (for example, http:) or on the placement of a forward slash (/) within the string. Depending on the particular member, you can use the following URL forms:

  • Une URL absolue spécifie un chemin d'accès complet et commence par un protocole. Par exemple, http:// Domaine_ou_Serveur/[ sites/] Site_Web/ Lists/ Titre_Liste/ AllItems.aspx.An absolute URL specifies a full path and begins with a protocol. For example, http:// domain_or_server/[ sites/] Web_Site/ Lists/ List_Title/ AllItems.aspx.

  • Une URL relative de serveur repose sur l'adresse du domaine (qui peut être le nom d'un serveur) et commence toujours par une barre oblique. Elle spécifie un chemin d'accès complet depuis le site web de niveau supérieur jusqu'au nom du fichier. Par exemple, /[ sites/] Site_Web/ Lists/ Titre_Liste/ AllItems.aspx.A domain-relative URL is based on the domain (which might be the name of a server) address and always begins with a forward slash. It specifies a complete path from top-level website to file name. For example, /[ sites/] Web_Site/ Lists/ List_Title/ AllItems.aspx.

  • Une URL relative de site web repose sur l'adresse d'un objet de site web ( SPWeb ). Elle ne commence pas par une barre oblique et spécifie un chemin d'accès complet depuis l'adresse du site web jusqu'au nom du fichier. Par exemple, Lists/ Titre_Liste/ AllItems.aspx.A website-relative URL is based on the address of a website object ( SPWeb ). It does not begin with a forward slash, and it specifies a complete path from the website address to the file name. For example, Lists/ List_Title/ AllItems.aspx.

  • Une URL relative à un fichier ou à un dossier repose sur le dossier contenant le fichier. Elle ne contient aucune barre oblique et spécifie simplement le nom du fichier. Par exemple, AllItems.aspx.A URL relative to a file or folder is based on the folder containing the file. It does not contain any forward slashes. It simply specifies the name of the file. For example, AllItems.aspx.

Note

Il n’existe pas de concept d’« URL relative à une collection de sites ». Ainsi, l’envoi d’une telle URL peut entraîner l’échec du code.There is no concept of a "site collection–relative URL"; passing such a URL may cause the code to fail.

Pratiques recommandées pour les URL d’imagesGood practice for image URLs

Lorsque vous créez une URL vers un fichier image situé dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\1033\IMAGES, spécifiez un chemin d'accès qui utilise le site web racine de la collection de sites, mais n'incluez pas de sous-site dans le chemin d'accès. Par exemple, utilisez /_layouts/images/MyImage.gif pour un fichier image, mais pas /MySubsite/_layouts/images/MyImage.gif. En effet, les URL de sous-site sont résolues de façons différentes selon leur utilisation. Pour contourner ces variations, vous devez donc toujours utiliser l'URL relative au site web racine.When you create a URL to an image file that is located in the %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\1033\IMAGES directory, specify a path that uses the root website of the site collection, but that does not include a subsite within the path. For example, use /_layouts/images/MyImage.gif for an image file, not /MySubsite/_layouts/images/MyImage.gif. This is because subsite URLs are resolved in different ways depending on where they are used. You can ignore these variations if you always use the root website-relative URL.

Jetons d'URL dans SharePointURL tokens in SharePoint

SharePoint prend en charge les jetons figurant dans les tableaux suivants pour une utilisation dans des Compléments SharePoint ou des solutions de batterie de serveurs. En outre, certains jetons sont utilisables uniquement dans les applications. Pour plus d'informations à ce sujet, consultez la rubrique Chaînes URL et jetons dans les compléments pour SharePoint.SharePoint supports the tokens listed in the following tables for use in either SharePoint Add-ins or farm solutions. In addition, some tokens are usable only in apps. For more information about them, see URL strings and tokens in SharePoint Add-ins.

Les jetons figurant dans les tableaux de cette section peuvent être utilisés dans les URL pour de nombreuses situations lors du développement SharePoint, comme dans des actions personnalisées et dans des liens sur des pages personnalisées. Parfois, certains jetons ne peuvent pas être utilisés. Les trois emplacements principaux pour lesquels seule une liste limitée de jetons peut être utilisée sont la page de démarrage d'une application, une action personnalisée sur le site web hôte et la propriété Src d'un composant d'application. Ces emplacements sont présentés dans des colonnes séparées, mais ils ne constituent pas une liste exhaustive des emplacements où les jetons peuvent être utilisés.The tokens in the tables of this section can be used in URLs in a wide variety of situations in SharePoint development, such as in custom actions and in links on custom pages. In some contexts, some of these tokens cannot be used. Three of the most important places where only a restricted list of tokens can be used are the start page of an app, a custom action on the host web, and the Src property of an app part. These are called out in separate columns, but these three are not an exhaustive list of places where tokens can be used.

La colonne StartPage indique si le jeton peut être utilisé dans l'élément StartPage d'un manifeste d'application. La colonne Action personnalisée indique si le jeton peut être utilisé dans l'URL d'une action personnalisée sur un site Web hôte. Enfin, la colonne Composant d'application indique si le jeton peut être utilisé dans la propriété Src du composant d'application.The StartPage column specifies whether the token can be used in the StartPage element of an app manifest. The Custom Action column specifies whether the token can be used in the URL of a custom action on a host web. The App Part column specifies whether the token can be used in the Src property of the app part.

Jetons pouvant être utilisés au début d'une URLTokens that can be used at the beginning of a URL

JetonToken Résolu enResolves to StartPageStartPage Action personnaliséeCustom Action Composant d'applicationApp Part RemarquesRemarks
~controlTemplates~controlTemplates
L'URL du dossier virtuel ControlTemplates pour le site web actuel.The URL of the ControlTemplates virtual folder for the current website.
NonNo
NonNo
NonNo
~layouts~layouts
L'URL du dossier virtuel Dispositions pour le site web actuel.The URL of the Layouts virtual folder for the current website.
NonNo
NonNo
NonNo
~site~site
L'URL du site web actuel.The URL of the current website.
NonNo
NonNo
OuiYes
~sitecollection~sitecollection
L'URL de la collection de sites parente du site web actuel.The URL of the parent site collection of the current website.
NonNo
NonNo
OuiYes

Sauf mention contraire, aucun des jetons figurant dans le tableau suivant ne peut être utilisé dans la partie chemin d'accès de la valeur de propriété Src du composant d'application. La colonne Composant d'application fait référence à l'utilisation des jetons dans la partie chaîne de requête de la valeur.Except where indicated otherwise, none of these tokens in the next table can be used in the path portion of the Src property value of the app part. The App Part column refers to their use in the query string portion of the value.

Jetons pouvant être utilisés dans une URLTokens that can be used inside a URL

JetonToken Résolu enResolves to StartPageStartPage Action personnaliséeCustom Action Composant d'applicationApp Part RemarquesRemarks
{ControlTemplates}{ControlTemplates}
L'URL du dossier virtuel ControlTemplates pour le site web actuel.The URL of the ControlTemplates virtual folder for the current website.
NonNo
NonNo
NonNo
{ItemId}{ItemId}
ID d'un élément d'une liste ou d'une bibliothèque (un entier).The ID of an item in a list or library (an integer).
NonNo
OuiYes
NonNo
{ItemUrl}{ItemUrl}
L'URL de l'élément traité.The URL of the item being acted upon.
NonNo
OuiYes
NonNo
{Layouts}{Layouts}
L'URL du dossier virtuel Dispositions pour le site web actuel.The URL of the Layouts virtual folder for the current website.
NonNo
NonNo
NonNo
{ListId}{ListId}
L'ID de la liste actuelle (GUID).The ID of the current list (a GUID).
NonNo
OuiYes
NonNo
{RecurrenceId}{RecurrenceId}
L'index de périodicité d'un événement périodique.The recurrence index of a recurring event.
NonNo
OuiYes
NonNo
Ce jeton n'est pas pris en charge dans les menus contextuels des éléments de liste.This token is not supported for use in the context menus of list items.
{Site}{Site}
L'URL du site web actuel.The URL of the current website.
NonNo
OuiYes
OuiYes
{SiteCollection}{SiteCollection}
L'URL du site parent du site web actuel.The URL of the parent site of the current website.
NonNo
OuiYes
OuiYes
{SiteUrl}{SiteUrl}
L'URL du site web actuel.The URL of the current website.
NonNo
OuiYes
NonNo
{Source}{Source}
URL de la requête HTTP.The HTTP Request URL.
NonNo
OuiYes
NonNo

Voir aussiSee also