URL et jetons dans SharePoint
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.
Notes
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 situé 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 |