Elemento FieldRef (Query)

Artículo
04/08/2023

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Representa una referencia a un campo dentro de una consulta.

<FieldRef
  Alias = "Text"
  Ascending = "TRUE" | "FALSE"
  CreateURL = "Text"
  DisplayName = "Text"
  Explicit = "TRUE" | "FALSE"    Format = "Text"
  ID = "Text"
  Key = "Text"  List = "Text"
  LookupId = "TRUE" | "FALSE"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
Alias	Text opcional.
Orden ascendente	Boolean opcional. Especifica el criterio de ordenación en un elemento FieldRef que está definido en una vista. El valor predeterminado es TRUE.
CreateURL	Text opcional. Especifica la dirección URL del archivo .aspx usada para crear un sitio de área de reuniones.
DisplayName	Text opcional. Este atributo proporciona el nombre para mostrar del campo al que hace referencia.
Explicit	Boolean opcional. Este atributo sólo se admite dentro del elemento ViewFields. TRUE si el campo se declara explícitamente en la definición de la vista y no se devuelve en una enumeración de Fields dentro de una vista.
Format	Text opcional.
ID	Text opcional. Especifica el identificador GUID que identifica el campo.
Clave	Text opcional. Si se establece en Primary, especifica que el campo es la clave principal de su tabla y, por tanto, identifica de forma única cada registro de la tabla.
Lista	Text opcional. Especifica la lista externa primaria cuando el elemento FieldRef es un elemento secundario de un elemento Eq en el elemento Join . El valor es un alias para la lista definido por el atributo ListAlias del elemento Join .
LookupId	Boolean opcional. Cuando el campo es un tipo lookup, especifica que las consultas deben buscar el elemento por su identificador de elemento único en lugar del valor del campo. Esto puede ser útil, por ejemplo, cuando varios elementos tienen valores idénticos en el campo y desea consultar un elemento específico. El valor predeterminado es falso.
Nombre	Text opcional. Este atributo proporciona el nombre interno del campo al que hace referencia.
RefType	Text opcional. Especifica el tipo de referencia para un campo en una lista de eventos.
ShowField	Text opcional. El atributo ShowField se puede establecer en el campo del nombre que debe mostrarse. De forma predeterminada, se muestra un texto del hipervínculo desde el campo de título del registro en la lista externa. Sin embargo, el atributo ShowField se puede usar para invalidarlo y mostrar otro campo de la lista externa. Los siguientes tipos de datos se permiten como destinos de un atributo ShowField: Text, Choice y Counter.
TextOnly	Boolean opcional. Especifica que el campo contiene sólo los valores de texto.
Tipo	Text opcional. Especifica la función que se aplica a una columna de totales o una columna calculada. A continuación se describen los valores posibles. AVG Valor medio. Se aplica a los tipos de campo DateTimeNumber, Integer y Currency . CONTAR Número de elementos. Se aplica a todos los tipos de campos que permiten la agregación. MÁXIMO Valor máximo. Se aplica a los tipos de campo DateTimeNumber, Integer y Currency . MIN Valor mínimo. Se aplica a los tipos de campo DateTimeNumber, Integer y Currency . SUMA Suma de valores. Se aplica a los tipos de campo Number, Integer y Currency. STDEV Desviación estándar. Se aplica a los tipos de campo Number, Integer y Currency. VAR Varianza. Se aplica a los tipos de campo Number, Integer y Currency. Los valores para el atributo Type no distinguen entre mayúsculas y minúsculas.

Elementos secundarios

Ninguno

Elementos principales

Repeticiones

Mínimo: 0
Máximo: 1 (sin enlazar dentro de OrderBy)

Ejemplos

En el siguiente ejemplo, se muestran consultas de casos en los que el valor del campo Expires es null o es mayor o igual que la fecha actual.

<Query>
   <Where>
      <Or>
         <IsNull>
            <FieldRef Name="Expires" />
         </IsNull>
         <Geq>
            <FieldRef Name="Expires" />
            <Value Type="DateTime">
               <Today />
            </Value>
         </Geq>
      </Or>
   </Where>
   <OrderBy>
      <FieldRef Name="Modified" Ascending="FALSE" />
   </OrderBy>
</Query>

Este ejemplo del archivo Schema.xml para los campos de listas de contactos que se mostrarán en la barra de herramientas.

<ViewFields>
   <FieldRef Name="LinkTitleNoMenu"></FieldRef>
   <FieldRef Name="FirstName"></FieldRef>
   <FieldRef Name="WorkPhone"></FieldRef>
   <FieldRef Name="Email"></FieldRef>
</ViewFields>

Compartir a través de