Compartir a través de


Variables de consulta en SharePoint Server

SE APLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition yes-img-sopSharePoint in Microsoft 365

Nota: Este artículo no se aplica a las API y experiencias modernas de Microsoft Search. Para obtener información sobre la búsqueda moderna, consulte Variables de consulta de perfil.

Variables de consulta

En las tablas siguientes se muestran las variables de consulta para SharePoint Server y SharePoint en Microsoft 365 y ejemplos sobre cómo se pueden usar.

Propiedades de sitios y de colecciones de sitios

Variable de consulta Definición
{Site} o {Site.URL}
Dirección URL del sitio desde el que se emitió la consulta. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada Path.
{Site.ID}
GUID del sitio desde el que se emitió la consulta. Este valor corresponde al valor de la propiedad administrada WebId.
{Site.LCID}
Valor numérico de la configuración regional, según se especifica en Configuración regional, dentro de Configuración del sitio, en el sitio desde el que se emitió la consulta.
{Site.Locale}
Idioma del sitio desde el que se emitió la consulta, en formato ii-pp (por ejemplo, es-es para español de España).
{Sitio.<propiedad>}
Cualquier propiedad del contenedor de propiedades del sitio (SPWeb) desde el que se emitió la consulta, incluidas las propiedades personalizadas.
{SiteCollection} o {SiteCollection.URL}
Dirección URL de la colección de sitios desde la que se emitió la consulta. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada Path.
{SiteCollection.ID}
GUID de la colección de sitios desde la que se emitió la consulta. Este valor corresponde al valor de la propiedad administrada SiteID.
{SiteCollection.LCID}
Valor numérico de la configuración regional, según se especifica en Configuración regional, dentro de Configuración del sitio, en la colección de sitios desde la que se emitió la consulta.
{SiteCollection.Locale}
Idioma de la colección de sitios desde la que se emitió la consulta, en formato ii-pp (por ejemplo, es-es para español de España).
{SiteCollection.<propiedad>}
Cualquier propiedad del contenedor de propiedades del sitio raíz (SPWeb) de la colección de sitios (SPSite) desde la que se emitió la consulta, incluidas las propiedades personalizadas.

Propiedades de páginas, tokens de URL, cadenas de consulta y solicitudes

Variable de consulta Definición
{Page} o {Page.URL}
Dirección URL de la página desde la que se emitió la consulta. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada Path.
{Page.UsageAnalyticsId}
Identificador del elemento para los análisis de uso.
{Página.<FieldName>}
El valor de un campo de la página desde donde se emitió la consulta. Por ejemplo, si la página desde la que se emitió la consulta contenía una columna de sitio con el nombre "propietarioDelContenido", al especificar {Page.propietarioDelContenido}, podría realizar consultas del valor de "propietarioDelContenido".
{URLToken.<integer>}
El valor de la dirección URL de una página. El número entero representa la posición del valor dentro de la dirección URL, contando de derecha a izquierda. Por ejemplo, con la página http://www.contoso/audio/mp3/1010101, la variable de consulta {URLToken.1} realiza una consulta del último valor de la dirección URL, 1010101. La variable de consulta {URLToken.3} realiza una consulta de la tercera propiedad de la URL contando desde el final, audio. Puede efectuar consultas de valores que se encuentren, como máximo, en la novena posición de una dirección URL contando desde el final.
{QueryString.<ParameterName>}
Un valor de una cadena de consulta que se encuentra en la dirección URL de la página actual. Por ejemplo, si la URL de la página actual contiene una cadena de consulta como numeroDeElemento=567, puede obtener el valor 567 especificando {QueryString.numeroDeElemento}.
{Solicitud.<PropertyName>}
Un valor de la solicitud HTTP actual: por ejemplo, {Request.Url}.

Propiedades de usuarios

Variable de consulta Definición
{User} o {User.Name}
Nombre para mostrar del usuario que emitió la consulta. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada Author.
{User.Email}
Dirección de correo electrónico del usuario que emitió la consulta. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada WorkEmail.
{User.SID}
SID del usuario que emitió la consulta.
{User.LCID}
Valor numérico de la configuración regional, definido en el perfil del usuario que emitió la consulta.
{User.PreferredContentLanguage}
Idioma especificado como Idioma de contenido preferido en el perfil del usuario que emitió la consulta.
{User.PreferredDisplayLanguage}
Idioma especificado como Idioma de presentación preferido en el perfil del usuario que emitió la consulta.
{Usuario.<propiedad>}
Cualquier propiedad del perfil de usuario correspondiente al usuario que emitió la consulta como, por ejemplo, SPS-Interests, incluidas las propiedades personalizadas.
{User.Audiences}

(Solo SharePoint)
Se usa con el filtrado de destino de público de SharePoint moderno en la propiedad ModernAudienceAadObjectIdsadministrada . Ejemplo: ModernAudienceAadObjectIds:{User.Audiences}.

Propiedades de términos y conjuntos de términos

Variable de consulta Definición
{Term}, {Term.ID} o {Term.IDNoChildren}
GUID del nodo de navegación del sitio actual con el prefijo #0: por ejemplo, #083e99dcb-7907-4dc9-abc8-b5614a284f1c. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada owstaxIdMetadataAllTagsInfo u owstaxIdProductCatalogItemCategory en una colección de sitios de Catálogo de productos.
{Term.IDWithChildren}
GUID del nodo de navegación del sitio actual con el prefijo #: por ejemplo, #83e99dcb-7907-4dc9-abc8-b5614a284f1c. Devuelve todos los elementos etiquetados con el término de navegación del sitio actual, o elementos secundarios del término de navegación del sitio actual. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada owstaxIdProductCatalogItemCategory en una colección de sitios de un Catálogo de productos. Este valor no se puede usar para realizar consultas del contenido de la propiedad administrada owstaxidmetadataalltagsinfo.
{Term.Name}
Etiqueta del nodo de navegación del sitio: por ejemplo, Audio.
{Término.<propiedad>}
Cualquier propiedad del contenedor de propiedades del término, incluidas las propiedades personalizadas.
{TermSet} o {TermSet.ID}
GUID del conjunto de términos que se usa para la navegación del sitio actual.
{TermSet.Name}
Etiqueta del conjunto de términos que se usa para la navegación del sitio actual.

Propiedades de listas y de elementos de lista

Variable de consulta Definición
{List}
Dirección URL de la lista actual.
{Lista.<propiedad>}
Cualquier propiedad de la lista actual.
{ListItem}
Dirección URL del elemento de lista actual.
{ListItem.<propiedad>}
Cualquier propiedad del elemento de lista actual.

Otras propiedades

Variable de consulta Definición
{Today+/- <valor entero del número de días>}
Una fecha que se calcula sumando o restando el número de días especificado a la fecha en la que se emite la consulta. El formato de la fecha es AAAA-MM-DD. Por ejemplo, este valor se puede usar para realizar consultas del contenido de la propiedad administrada LastModifiedTime.
{SearchBoxQuery}
El valor de consulta que se escribe en un cuadro de búsqueda de una página.
{CurrentDisplayLanguage}
El idioma de presentación actual; se basa en la MUI, en formato ii-pp.
{CurrentDisplayLCID}
Valor numérico del idioma de presentación actual; se basa en la MUI, en formato ii-pp.

Espacios en los valores

Las consultas de búsqueda usan el carácter de espacio para segmentar valores de consulta emitidos por los usuarios. Cuando una variable de consulta se expande y se convierte en un valor que contiene un espacio, el valor completo se delimita con comillas dobles. Por ejemplo, en la consulta author:{User}, el valor expandido pasa a ser author:"Antonio Bermejo".

Si no desea que el valor se delimite con comillas dobles (por ejemplo, al concatenar varios valores), puede usar el carácter de escape en la variable de consulta. Por ejemplo: propiedadPersonalizada:"{\User.Name};{\User.ZipCode}" pasaría a ser propiedadPersonalizada:"Antonio Bermejo;98109".

Variables de consulta con varios valores

Algunas variables de consulta pueden devolver varios valores. Para las variables de consulta que devuelven varios valores, se debe usar la siguiente sintaxis: {|propiedadAdministrada:{variableDeConsulta}}. Todos los valores de variables de consulta se combinarán utilizando la operación bit a bit OR. Por ejemplo, imaginemos que tiene un conjunto de términos que se usa para clasificar los intereses de los usuarios. Todos los usuarios están configurados de modo que tengan uno o varios intereses mediante la propiedad multivalor SPS-Interests en la aplicación del Servicio de perfiles de usuario. Para emitir una consulta de cualquiera de los intereses del usuario actual, se podría usar la siguiente sintaxis: {|owstaxIdMetadataAllTagsInfo:{User.SPS-Interests}}. Si el usuario actual está configurado para tener dos intereses: fútbol (#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) y baloncesto (#0c2cff933-9377-4692-aa98-ce59768aa38b), la consulta se transformará en (owstaxIdMetadataAllTagsInfo:#0f95d1fdf-781f-42f4-99f9-c656c1341b2e) OR (owstaxIdMetadataAllTagsInfo:#0c2cff933-9377-4692-aa98-ce59768aa38b).

Existen ciertas restricciones al usar varios valores. Solo el operador OR ({|) es compatible con varios valores. El operador AND no es compatible. Por otra parte, solo las columnas del tipo Metadatos administrados funcionan correctamente en los casos de varios valores. Con los otros tipos de columnas que pueden usar varios valores, como las columnas de tipo Persona, Grupo u Opción, los elementos se expanden a una cadena delimitada.