Elemento FieldRef (ContentType)

Artículo
09/24/2014

Última modificación: lunes, 29 de marzo de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

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

<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>

Atributos

Atributo	Descripción
Aggregation	Si usa el atributo Node para especificar una expresión XPath que devuelve una colección de valores, también puede incluir un atributo Aggregation que especifica la acción que se ha de realizar en el conjunto de valores que se devuelve. 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: sum count average min max merge plaintext Convierte el contenido de texto del nodo en texto sin formato. first Aplica el aumento y disminución de nivel de propiedad al primer elemento de la colección. last Aplica el aumento y disminución de nivel de propiedad al último elemento de la colección. Para obtener información acerca de cómo se usan los atributos Node, PIAttribute, PITarget, PrimaryPIAttribute y PrimaryPITarget para el aumento y la disminución de nivel de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML.
Customization	Text opcional. Una cadena en Lenguaje de marcado de la aplicación de colaboración (CAML) que define las propiedades de campo personalizadas.
DefaultValue	Obsoleto.
Description	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. Las columnas de SharePoint Foundation no poseen descripciones de manera predeterminada.
DisplayName	Text obligatorio. Nombre mostrado para la columna. La longitud máxima es de 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 etiqueta de formulario cuando el campo se muestra en un formulario. Se usa el atributo DisplayName para cambiar el nombre para mostrar de un valor que es distinto del nombre definido en el campo propiamente dicho.
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 Sólo muestra (y permite modificar) la parte de la fecha (la parte de la fecha se establece en 12:00 a.m. para todos los valores editados). DateTime Muestra y edita la fecha y la hora (valor predeterminado). ISO8601 Muestra la fecha y la hora en el formato de tiempo ISO8601 convertido a UTC: YYYY-MM-DDTHH:MM:SSZ. Este es el formato usado para las propiedades de documento en Microsoft Office system y para el formato de intercambio estándar usado en Microsoft SharePoint Foundation entre los formularios nuevo y de edición, y el servidor. ISO8601Basic Usa el formato abreviado de los formatos de fecha/hora 8601: YYYYMMDDTHHMMSSZ. Éste es el formato usado para vCard/iCal. Para los campos Choice, este atributo se puede establecer en Dropdown (valor predeterminado), lo que proporciona opciones de edición a través de una selección desplegable, o en RadioButtons, lo que ofrece opciones a través de un grupo de botones de opción. Para los campos de dirección URL, este atributo se puede establecer en Hyperlink (valor predeterminado), lo que muestra la dirección URL como una etiqueta <A> normal, o en Image, lo que muestra la dirección URL como <IMG SRC=”URL” ALT=”Descripción”>.
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 se establece en TRUE, el campo queda totalmente oculto de la interfaz del usuario. Si ReadOnly se establece en TRUE, significa que el campo no se muestra en los formularios New o Edit pero se puede seguir incluyendo en las vistas. Si no se incluye este atributo, SharePoint Foundation trata a la columna como si este atributo estuviera 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 para los campos integrados en el archivo fieldswss.xml ubicado en la siguiente ruta de acceso: %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES\fields.
Locked	Obsoleto.
Name	Text obligatorio. Nombre de una columna. Se trata del nombre interno de una columna y garantiza que nunca cambiará durante la vigencia de la definición de campo. Debe ser único con respecto al conjunto de campos de una lista.
Node	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 Uso de tipos de contenido para especificar propiedades de documentos XML.
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 en la instrucción de procesamiento del documento (que especifica el atributo PITarget) que se ha de usar como valor de columna. Se usa para aumentar y disminuir el nivel de propiedades en documentos XML. Si especifica el atributo PIAttribute, también debe especificar el atributo PITarget. 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 Uso de tipos de contenido para especificar propiedades de documentos XML.
PITarget	Text opcional. Especifica la instrucción de procesamiento de documentos en la que el valor de la columna se almacena en documentos de este tipo de contenido. Se usa para aumentar y disminuir el nivel de propiedades en documentos XML. Si especifica el atributo PIAttribute, también debe especificar el atributo PITarget. 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 Uso de tipos de contenido para especificar propiedades de documentos XML.
PrimaryPIAttribute	Text opcional. Especifica un atributo alternativo en la instrucción de procesamiento del documento, que especifica el atributo PrimaryPITarget, que se ha de usar como valor de columna. Si especifica el atributo PrimaryPIAttribute, también debe especificar el atributo PrimaryPITarget. Si especifica SharePoint Foundation, usa estos valores antes que los especificados en los atributos PITarget y PIAttribute. Se usa para aumentar y 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 Uso de tipos de contenido para especificar propiedades de documentos XML.
PrimaryPITarget	Text opcional. Especifica una instrucción alternativa de procesamiento de documentos en la que el valor de la columna se almacena en documentos de este tipo de contenido. Si especifica el atributo PrimaryPIAttribute, también debe especificar el atributo PrimaryPITarget. Si especifica SharePoint Foundation, usa estos valores antes que los especificados en los atributos PITarget y PIAttribute. 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 Uso de tipos de contenido para especificar propiedades de documentos XML.
ReadOnly	Boolean opcional. Si se establece en TRUE, el campo no se muestra en el formulario New o Edit pero se puede incluir en las vistas. Si el atributo Hidden se establece en TRUE, el campo queda totalmente oculto en la interfaz de usuario. Si no se incluye este atributo, SharePoint Foundation trata a la columna como si este atributo estuviera establecido en FALSE.
Required	Boolean obligatorio. Si se establece en TRUE, el campo debe tener un valor asignado para que se pueda guardar un elemento creado mediante este tipo de contenido. Si se proporciona un valor de campo vacío en una publicación de formulario, en el formulario de error se muestra el texto de campo obligatorio estándar o un mensaje especificado explícitamente (es decir, mediante las etiquetas <ErrorText>). Esta validación solo la controla el cliente (la base de datos siempre permite NULL para todos los campos definidos por el usuario).
Sealed	Boolean opcional. Se establece en TRUE para definir la columna como sellada. No es posible editar columnas selladas a través de la interfaz de usuario ni el modelo de objetos de SharePoint Foundation. Si no se incluye este atributo, SharePoint Foundation trata a la columna como si este atributo estuviera 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 se establece en FALSE, el campo no se muestra en una enumeración Fields cuando el modo de visualización está establecido en New. Los campos con esta configuración no aparecen en la página predeterminada de elementos nuevos de una determinada lista.
ShowInNewForm	Boolean opcional. Se establece en TRUE para mostrar la columna en el formulario Nuevo para elementos de este tipo de contenido.
Sortable	Boolean opcional. Se establece en TRUE si se pueden ordenar los valores del campo.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento FieldRefs (ContentType)

Repeticiones

Mínimo: 0

Máximo: sin límite

Comentarios

El elemento FieldRef es una referencia a una columna definida en otro lugar, bien en el nivel de sitio o de lista. En la referencia de campo, puede invalidar un subconjunto de las propiedades de columna, por ejemplo:

Nombre para mostrar
Atributos de aumento y disminución de nivel en 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 obligatorios, 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 las columnas que se incluirán 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

Referencia

SPFieldLink

Conceptos

Definiciones de tipo de contenido

Campos y referencias a campos

Compartir a través de