Compartir vía

Direcciones URL y tokens en SharePoint

  • Artículo

Obtenga información sobre cómo formular direcciones URL y cómo usar tokens URL en SharePoint.

Tipos de direcciones URL en SharePoint

SharePoint analiza las cadenas URL para determinar el formato de dirección URL en función de un protocolo especificado (por ejemplo, http:) o de la colocación de una barra inclinada (/) en la cadena. Según el miembro específico, puede usar los siguientes formatos de dirección URL:

  • Una dirección URL absoluta especifica una ruta de acceso completa y comienza con un protocolo. Por ejemplo, http://domain_or_server/[ sites/] Web_Site/ Lists/ List_Title/ AllItems.aspx.

  • Una dirección URL relativa al dominio se basa en la dirección del dominio (que puede ser el nombre de un servidor) y siempre comienza por una barra inclinada. Especifica la ruta de acceso completa desde el sitio de nivel superior a un nombre de archivo. Por ejemplo, /[ sites/] sitio_web/ Lists/ título_lista/ AllItems.aspx.

  • Una dirección URL relativa al sitio web se basa en la dirección de un objeto de sitio web ( SPWeb ). No comienza por una barra inclinada y especifica una ruta de acceso completa desde la dirección del sitio web al nombre de archivo. Por ejemplo, Lists/List_Title/ AllItems.aspx.

  • Una dirección URL relativa a un archivo o carpeta se basa en la carpeta que contiene el archivo. No contiene ninguna barra inclinada. Simplemente especifica el nombre del archivo. Por ejemplo, AllItems.aspx.

Nota:

No existe el concepto de "URL relativa a una colección de sitios". Pasar una dirección URL de este tipo podría provocar un error del código.

Práctica recomendable para URL de imagen

Al crear una dirección URL para un archivo de imagen que se encuentra en el directorio %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\1033\IMAGES, especifique una ruta de acceso que use el sitio web raíz de la colección de sitios, pero que no incluya un subsitio dentro de la ruta de acceso. Por ejemplo, use /_layouts/images/MyImage.gif para un archivo de imagen, no /MySubsite/_layouts/images/MyImage.gif. El motivo es que las direcciones URL de subsitio se resuelven de diferentes maneras según donde se usen. Puede pasar por alto estas variaciones usando siempre la dirección URL relativa al sitio web raíz.

Tokens de URL en SharePoint

SharePoint admite el uso de los tokens que se indican en las tablas siguientes en Complementos de SharePoint o granjas de servidores. Además, algunos tokens solo se pueden usar en aplicaciones. Para obtener más información sobre ellos, vea Cadenas y tokens de dirección URL en complementos de SharePoint.

Los tokens en las tablas de esta sección pueden utilizarse en las direcciones URL en una amplia variedad de situaciones de desarrollo de SharePoint, como en las acciones personalizadas y de vínculos en páginas personalizadas. En algunos contextos, algunos de estos tokens no se pueden usar. Tres de los lugares más importantes donde solo se puede usar una lista restringida de tokens son la página de inicio de una aplicación, una acción personalizada en la web host y la propiedad Src de un elemento de aplicación. Se denominan en columnas independientes, pero estos tres no son una lista exhaustiva de los lugares donde se puede utilizar símbolos (token).

La columna StartPage especifica si el token se puede utilizar en el elemento StartPage de un manifiesto de la aplicación. La columna Acción personalizada especifica si el token se puede utilizar en la dirección URL de una acción personalizada en una web de host. La columna Elemento de aplicación especifica si el token se puede utilizar en la propiedad Src del elemento de aplicación.

Tokens que se pueden usar al principio de una dirección URL

Token Da como resultado StartPage Acción personalizada Elemento de aplicación Comentarios
~controlTemplates
 Dirección URL de la carpeta virtual ControlTemplates para el sitio web actual.
No
 No
 No
~layouts
 Dirección URL de la carpeta virtual Layouts para el sitio web actual.
No
 No
 No
~site
 Dirección URL del sitio web actual.
No
 No
 Sí
~sitecollection
 Dirección URL de la colección del sitio primario del sitio web actual.
No
 No
 Sí

Excepto cuando se indique lo contrario, ninguno de estos tokens de la tabla siguiente se puede usar en la parte de ruta de acceso del valor de propiedad Src de la parte de la aplicación. La columna Elemento de aplicación hace referencia a su uso en la parte de cadena de consulta del valor.

Tokens que se pueden usar dentro de una dirección URL

Token Da como resultado StartPage Acción personalizada Elemento de aplicación Comentarios
{ControlTemplates}
 Dirección URL de la carpeta virtual ControlTemplates para el sitio web actual.
No
 No
 No
{ItemId}
 Identificador de un elemento en una lista o biblioteca (entero).
No
 Sí
 No
{ItemUrl}
 Dirección URL de un elemento sobre el que se realiza una acción.
No
 Sí
 No
Diseños
 Dirección URL de la carpeta virtual Layouts para el sitio web actual.
No
 No
 No
{ListId}
 Identificador de la lista actual (un GUID).
No
 Sí
 No
{RecurrenceId}
 Índice de recurrencia de un evento recurrente.
No
 Sí
 No
 Este token no se admite para usarlo en los menús contextuales de los elementos de lista.
{Site}
 Dirección URL del sitio web actual.
No
 Sí
 Sí
{SiteCollection}
 Dirección URL del sitio primario del sitio web actual.
No
 Sí
 Sí
{SiteUrl}
 Dirección URL del sitio web actual.
No
 Sí
 No
{Source}
 Dirección URL de la solicitud HTTP.
No
 Sí
 No

Consulte también