URL et jetons dans SharePoint

  • Article

Découvrez comment formuler des URL et utiliser des jetons d’URL dans SharePoint.

Types d’URL dans 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 :

  • Une URL absolue spécifie un chemin d'accès complet et commence par un protocole. Par exemple, 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.

  • 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/List_Title/ AllItems.aspx.

  • Une URL relative à un fichier ou dossier est basée sur le dossier contenant le fichier. Il ne contient pas de barres obliques. Il spécifie simplement le nom du fichier. Par exemple : AllItems.aspx.

Remarque

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.

Pratiques recommandées pour les URL d’images

Lorsque vous créez une URL vers un fichier image qui se trouve dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\1033\IMAGES, spécifiez un chemin qui utilise le site web racine de la collection de sites, mais qui n’inclut 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.

Jetons d'URL dans 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 à leur sujet, voir Chaînes d’URL et jetons dans les compléments SharePoint.

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. Dans certains contextes, certains de ces jetons ne peuvent pas être utilisés. Trois des emplacements les plus importants où seule une liste restreinte 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.

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.

Jetons pouvant être utilisés au début d'une URL

Jeton Résolu en StartPage Action personnalisée Composant d'application Remarques
~controlTemplates
 L'URL du dossier virtuel ControlTemplates pour le site web actuel.
Non
 Non
 Non
~layouts
 L'URL du dossier virtuel Dispositions pour le site web actuel.
Non
 Non
 Non
~site
 L'URL du site web actuel.
Non
 Non
 Oui
~sitecollection
 L'URL de la collection de sites parente du site web actuel.
Non
 Non
 Oui

Sauf indication contraire, aucun de ces jetons de la table suivante 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.

Jetons pouvant être utilisés dans une URL

Jeton Résolu en StartPage Action personnalisée Composant d'application Remarques
{ControlTemplates}
 L'URL du dossier virtuel ControlTemplates pour le site web actuel.
Non
 Non
 Non
{ItemId}
 ID d'un élément d'une liste ou d'une bibliothèque (un entier).
Non
 Oui
 Non
{ItemUrl}
 L'URL de l'élément traité.
Non
 Oui
 Non
{Layouts}
 L'URL du dossier virtuel Dispositions pour le site web actuel.
Non
 Non
 Non
{ListId}
 L'ID de la liste actuelle (GUID).
Non
 Oui
 Non
{RecurrenceId}
 L'index de périodicité d'un événement périodique.
Non
 Oui
 Non
 Ce jeton n'est pas pris en charge dans les menus contextuels des éléments de liste.
{Site}
 L'URL du site web actuel.
Non
 Oui
 Oui
{SiteCollection}
 L'URL du site parent du site web actuel.
Non
 Oui
 Oui
{SiteUrl}
 L'URL du site web actuel.
Non
 Oui
 Non
{Source}
 URL de la requête HTTP.
Non
 Oui
 Non

Voir aussi