Elemento FieldRef (ContentType)

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

Especifica una columna para hacer referencia a ella en este tipo de contenido.

Definición

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

Elementos y atributos

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

Atributos

Atributo	Description
Agregación	Si usa el atributo Node para especificar una expresión XPath que devuelva una colección de valores, también puede incluir un atributo Aggregation que especifique la acción que se debe realizar en el conjunto de valores devuelto. Esta acción puede ser una función de agregación o una indicación del elemento concreto dentro de la colección. Los valores posibles son: Suma count Promedio Min máximo Combinar texto sin formato Convierte el contenido de texto del nodo en texto sin formato. first Aplica la promoción y degradación de propiedades al primer elemento de la colección. last Aplica la promoción y degradación de propiedades al último elemento de la colección. Para obtener más información sobre cómo se usan los atributos Node, PIAttribute, PITarget, PrimaryPIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, vea Uso de tipos de contenido para especificar propiedades de documento XML.
Personalización	Text opcional. Cadena en lenguaje de marcado de aplicaciones de colaboración (CAML) que define propiedades de campo personalizadas.
DefaultValue	Obsoleto.
Descripción	Text opcional. Ofrece la descripción que se muestra en el formulario de edición para una lista si se especifica una descripción de columna. De forma predeterminada, las columnas de SharePoint Foundation no tienen descripciones.
DisplayName	Text obligatorio. Nombre mostrado para la columna. La longitud máxima son 255 caracteres. El valor de este atributo se usa como encabezado de columna cuando el campo se muestra en una vista de tabla y como una etiqueta de formulario cuando el campo se muestra en un formulario. El atributo DisplayName se usa para cambiar el nombre para mostrar a un valor distinto del nombre definido en el propio campo.
Format	Text opcional. Especifica el formato que debe usarse para los valores numéricos. Para las columnas de fecha y hora, los valores posibles son los siguientes: DateOnly Solo muestra (y permite modificaciones en) la parte de fecha (la parte de hora se establece en 12:00 A.M. para todos los valores editados). DateTime Mostrar y editar tanto la fecha como la hora del día (valor predeterminado). ISO8601 Mostrar fecha y hora en formato de hora ISO8601 convertido a UTC: AAAA-MM-DDTHH:MM:SSZ. Este es el formato usado para las propiedades de documento en el sistema de Microsoft Office, así como para el formato de intercambio estándar que se usa en Microsoft SharePoint Foundation entre los formularios New y Edit y el servidor. ISO8601Basic Use la forma abreviada de formatos de fecha y hora 8601: AAAAMMDDTHHMMSSZ. Este formato se usa para vCard o iCal. Para los campos Choice , este atributo se puede establecer en Dropdown (valor predeterminado), que proporciona opciones de edición a través de una selección desplegable, o en RadioButtons, que proporciona opciones a través de un grupo de botones de radio. En el caso de los campos URL, este atributo se puede establecer en Hyperlink (valor predeterminado), que muestra la dirección URL como una etiqueta normal `<A>` , o en Image, que muestra la dirección URL como `<IMG SRC="URL" ALT="Description">`.
Filterable	Boolean opcional. Es TRUE para definir la columna como filtrable.
FilterableNoRecurrence	Boolean opcional. Es TRUE para definir la columna como filtrable sin valores periódicos.
FromBaseType	Boolean opcional. Este atributo se ha degradado en favor del atributo Sealed.
Hidden	Boolean opcional. Si es TRUE, el campo está oculto por completo de la interfaz de usuario. Establecer ReadOnly en TRUE significa que el campo no se muestra en formularios Nuevos o Editar , pero se puede seguir incluyendo en las vistas. Si no incluye este atributo, SharePoint Foundation trata la columna como si el atributo se hubiera establecido en FALSE.
ID	Text obligatorio. Especifica el identificador de campo de la columna a la que hace referencia este elemento FieldRef . El identificador de campo es la representación de cadena de un GUID, incluidas las llaves. El valor distingue mayúsculas de minúsculas. Puede encontrar los identificadores de los campos integrados en el archivo `fieldswss.xml` que se encuentra en la ruta de acceso siguiente: `%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\fields`
Locked	Obsoleto.
Nombre	Text obligatorio. Nombre de una columna. Se trata del nombre interno de una columna y garantiza que nunca cambiará la duración de la definición de campo. Debe ser único con respecto al conjunto de campos de una lista.
Nodo	Text opcional. Especifica el nodo XML en el documento que contiene el valor de la columna. Se usa para aumentar o disminuir el nivel de propiedades en documentos XML. Para obtener información acerca de cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para aumentar o disminuir el nivel de propiedades en documentos XML, consulte Using Content Types to Specify XML Document Properties.
NumLines	Integer opcional. Recomienda el número de líneas (filas) que se ha de mostrar en un bloque TEXTAREA durante la edición. Esto es simplemente una sugerencia de la interfaz de usuario del cliente; no hay ninguna limitación forzada en el número de líneas de texto que se pueden editar.
PIAttribute	Text opcional. Especifica el atributo de la instrucción de procesamiento de documentos (que especifica el atributo PITarget) que se usa como el valor de la columna. Se usa para la promoción y disminución de nivel de propiedades en documentos XML. Si se especifica el atributo PIAttribute, también se debe especificar el atributo PITarget. Para obtener más información sobre cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y disminución de nivel de propiedades en documentos XML, vea Using Content Types to Specify XML Document Properties.
PITarget	Text opcional. Especifica la instrucción de procesamiento de documentos en la que se almacena el valor de la columna en los documentos de este tipo de contenido. Se usa para la promoción y disminución de nivel de propiedades en documentos XML. Si se especifica el atributo PIAttribute, también se debe especificar el atributo PITarget. Para obtener más información sobre cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y disminución de nivel de propiedades en documentos XML, vea Using Content Types to Specify XML Document Properties.
PrimaryPIAttribute	Text opcional. Especifica un atributo alternativo en la instrucción de procesamiento de documentos (que especifica el atributo PrimaryPITarget), que se usará como el valor de columna. Si se especifica el atributo PrimaryPIAttribute, también se debe especificar el atributo PrimaryPITarget. Si se especifica, SharePoint Foundation usa estos valores antes de los especificados en los atributos PITarget y PIAttribute . Se usa para la promoción y disminución de nivel de propiedades en documentos XML. Para obtener información acerca de cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para aumentar o disminuir el nivel de propiedades en documentos XML, consulte Using Content Types to Specify XML Document Properties.
PrimaryPITarget	Text opcional. Especifica una instrucción de procesamiento de documentos alternativa en la que se almacena el valor de columna para los documentos de este tipo de contenido. Si se especifica el atributo PrimaryPIAttribute, también se debe especificar el atributo PrimaryPITarget. Si se especifica, SharePoint Foundation usa estos valores antes de los especificados en los atributos PITarget y PIAttribute . Para obtener más información sobre cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y disminución de nivel de propiedades en documentos XML, vea Using Content Types to Specify XML Document Properties.
ReadOnly	Boolean opcional. Si es TRUE, el campo no se muestra en los formularios Nuevo o Editar , pero se puede incluir en las vistas. Si el atributo Hidden se establece en TRUE, oculta por completo el campo de la interfaz de usuario. Si no incluye este atributo, SharePoint Foundation trata la columna como si el atributo se hubiera establecido en FALSE.
Required	Boolean obligatorio. Si es TRUE, el campo debe tener un valor asignado antes de que se pueda guardar un elemento que se crea con este tipo de contenido. Si se especifica un valor de campo vacío en una entrada de formulario, el texto de campo obligatorio estándar o un mensaje especificado explícitamente (es decir, a través <de etiquetas ErrorText> ) se muestra en el formulario de error. Esta validación sólo la controla el cliente (la base de datos siempre permite NULL para todos los campos definidos por el usuario).
Sellado	Boolean opcional. Se establece en TRUE para definir la columna como sellada. No se pueden editar columnas selladas a través de la interfaz de usuario o el modelo de objetos de SharePoint Foundation. Si no incluye este atributo, SharePoint Foundation trata la columna como si el atributo se hubiera establecido en FALSE.
ShowInDisplayForm	Boolean opcional. Se establece en TRUE para mostrar la columna en el formulario de visualización para elementos de este tipo de contenido.
ShowInEditForm	Boolean opcional. Se establece en TRUE para mostrar el campo en la página Editar elemento.
ShowinFileDlg	Boolean opcional. Se establece en TRUE para mostrar la columna en el cuadro de diálogo de archivo para elementos de este tipo de contenido.
ShowInListSettings	Boolean opcional. Si es FALSE, el campo no aparece en una enumeración Fields cuando el modo de presentación se establece en New. Los campos con esta configuración no aparecen en la página Elemento nuevo predeterminada de una lista determinada.
ShowInNewForm	Boolean opcional. Se establece en TRUE para mostrar la columna en el formulario Nuevo para elementos de este tipo de contenido.
Se puede ordenar	Boolean opcional. TRUE si los valores del campo se pueden almacenar.

Elementos secundarios

Ninguno

Elementos principales

Elemento FieldRefs (ContentType)

Occurrence

Mínimo: 0
Máximo: sin límite

Comentarios

El elemento FieldRef es una referencia a una columna definida en otro lugar, ya sea en el nivel de lista o en el de sitio. En la referencia de campo, se puede reemplazar un subconjunto de propiedades de columna, como las siguientes:

Nombre para mostrar
Atributos de aumento y disminución de nivel de XML
Si el campo es de sólo lectura, obligatorio u oculto

Al modificar estas propiedades en la referencia de campo, sólo cambia el modo en que se aplican al tipo de contenido específico que contiene la referencia de campo.

Importante

Los atributos ID, Name, DisplayName y Required siempre son necesarios, incluso cuando el elemento FieldRef hace referencia a un campo definido en el mismo manifiesto de elemento.

Ejemplo

En el ejemplo siguiente se muestran dos elementos FieldRef que especifican columnas que se van a incluir en un tipo de contenido.

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

Vea también

Last updated on 2023-04-08

Compartir a través de