Elemento Field (List)

Artículo
04/08/2023

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

Define los tipos de datos internos que se usan en la infraestructura de lista de un sitio web de SharePoint. Un campo es una columna o atributo de información que un usuario puede agregar a una lista.

<Field
  Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion = "TRUE" | "FALSE"
  AllowHyperlink = "TRUE" | "FALSE"
  AllowMultiVote = "TRUE" | "FALSE"
  AppendOnly = "TRUE" | "FALSE"
  AuthoringInfo = "Text"
  BaseType = "Integer" | "Text"
  CalType = "Integer"
  CanToggleHidden = "TRUE" | "FALSE"
  ClassInfo = "Text"
  ColName = "Text"  ColName2 = "Text"
  Commas = "TRUE" | "FALSE"
  Customization = "Text"
  Decimals = "Integer"
  Description = "Text"
  Dir = "Text"
  Direction = "Text"
  DisplaceOnUpgrade = "TRUE" | "FALSE"
  DisplayImage = "Text"
  DisplayName = "Text"
  DisplayNameSrcField = "Text"
  DisplaySize = "Integer"
  Div = "Number"
  EnableLookup = "TRUE" | "FALSE"
  EnforceUniqueValues = "TRUE" | "FALSE"
  ExceptionImage = "Text"
  FieldRef = "Text"
  FillInChoice = "TRUE" | "FALSE"
  Filterable = "TRUE" | "FALSE"
  FilterableNoRecurrence = "TRUE" | "FALSE"
  ForcedDisplay = "Text"
  ForcePromoteDemote = "TRUE" | "FALSE"
  Format = "Text"
  FromBaseType = "TRUE" | "FALSE"
  Group = "Text"
  HeaderImage = "Text"
  Height = "Integer"
  Hidden = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  ID = "Text"  Id = "Text"
  IMEMode = "inactive"
  Indexed = "TRUE" | "FALSE"
  IsolateStyles = "TRUE" | "FALSE"
  IsRelationship = "TRUE" | "FALSE"
  JoinColName = "Text"
  JoinRowOrdinal = "Integer"
  JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER"
  LCID = "Integer"  LinkToItem = "TRUE" | "FALSE"
  LinkToItemAllowed = "Text"
  List = "Text"
  ListItemMenu = "TRUE" | "FALSE"
  ListItemMenuAllowed = "Text"
  Max = "Number"
  MaxLength = "Integer"
  Min = "Number"
  Mult = "TRUE" | "FALSE"
  Name = "Text"
  NegativeFormat = "MinusSign" | "Parens"
  Node = "Text"
  NoEditFormBreak = "TRUE" | "FALSE"
  NumLines = "Integer"
  Percentage = "TRUE" | "FALSE"
  PIAttribute = "Text"
  PITarget = "Text"
  PrependId = "TRUE" | "FALSE"
  Presence = "TRUE" | "FALSE"
  PrimaryKey = "TRUE" | "FALSE"
  PrimaryPIAttribute = "Text"
  PrimaryPITarget = "Text"
  ReadOnly = "TRUE" | "FALSE"
  ReadOnlyEnforced = "TRUE" | "FALSE"
  RelationshipDeleteBehavior = "Text"
  RenderXMLUsingPattern = "TRUE" | "FALSE"
  Required = "TRUE" | "FALSE"
  RestrictedMode = "TRUE" | "FALSE"
  ResultType = "Text"
  RichText = "TRUE" | "FALSE"
  RichTextMode = "Text"
  RowOrdinal = "Integer"
  Sealed = "TRUE" | "FALSE"
  SeparateLine = "TRUE" | "FALSE"
  SetAs = "Text"
  ShowAddressBookButton = "TRUE" | "FALSE"
  ShowAlways = "TRUE" | "FALSE"
  ShowField = "Text" | "Choice" | "Counter"
  ShowInDisplayForm = "TRUE" | "FALSE"
  ShowInEditForm = "TRUE" | "FALSE"
  ShowInFileDlg = "TRUE" | "FALSE"
  ShowInListSettings = "TRUE" | "FALSE"
  ShowInNewForm = "TRUE" | "FALSE"
  ShowInVersionHistory = "TRUE" | "FALSE"
  ShowInViewForms = "TRUE" | "FALSE"
  Sortable = "TRUE" | "FALSE"
  SourceID = "Text"
  StaticName = "Text"
  StorageTZ = "UTC" | "Abstract"
  StripWS = "TRUE" | "FALSE"
  SuppressNameDisplay = "TRUE" | "FALSE"
  TextOnly = "TRUE" | "FALSE"
  Title = "Text"
  Type = "Data_Type"
  UniqueId = "Text"
  UnlimitedLengthInDocumentLibrary = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsUrl = "TRUE" | "FALSE"
  UserSelectionMode = "Text"
  UserSelectionScope = "Integer"
  Version = "Text"
  Viewable = "TRUE" | "FALSE"
  WebId = "Text"
  Width = "Integer"
  WikiLinking = "TRUE" | "FALSE"
  XName = "Text">
</Field>

Elementos y atributos

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

Atributos

Atributo	Descripción
Agregación	Text opcional. Se usa en un campo agregado en un formulario XML para especificar la función que se debe implementar en una colección de valores o elementos devuelta por una expresión XPath. 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. Entre los valores posibles se encuentran: - Suma Agregue los valores. - Contar Cuente el número de valores. - Promedio Busque el promedio de los valores. - Min Busque el valor mínimo. - máximo Busque el valor máximo. - Combinar Combine los valores. - Plaintext Convierte el contenido de texto del nodo en texto sin formato. - Primero Aplique la promoción y degradación de propiedades al primer elemento de la colección. - Última Aplique 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 disminución de nivel de propiedades en documentos XML, consulte Using Content Types to Specify XML Document Properties.
AllowDeletion	Boolean opcional. TRUE si se puede eliminar el campo.
AllowHyperlink	Boolean opcional. TRUE si se pueden usar hipervínculos en el campo.
AllowMultiVote	Boolean opcional. TRUE si se permiten varias respuestas en una encuesta.
AppendOnly	Boolean opcional. Cuando el control de versiones está habilitado en la lista, TRUE si el texto solo se puede anexar a texto existente en el campo Note.
AuthoringInfo	Text opcional. Una cadena descriptiva que se muestra en el páginas de edición de campos para identificar el campo y su propósito; por ejemplo, el campo LinkTitle contiene la información de creación "(vínculo al elemento)". Este atributo suele usarse si existe un campo del mismo nombre con otro propósito.
Basetype	Opcional. El atributo BaseType se puede establecer en Integer, que almacena valores como números enteros, o en Text (predeterminado), que almacena valores como texto. No puede crear campos de opción de tipo base de números enteros.
CalType	Integer opcional. Especifica el tipo de calendario. Entre los valores posibles se incluyen los siguientes: 16 Era Saka 15 chinos lunares 14 lunares coreanos y japoneses 12 francés transliterado gregoriano 11 inglés transliterado gregoriano 10 árabe gregoriano 9 Francés gregoriano de Oriente Medio 8 Hebreo (lunar) 7 Tailandés 6 Hijri (árabe lunar) 5 Tangun era coreana 4 Era de Taiwán 3 Era emperador japonés 1 gregoriano 0 No se especificó ningún tipo
CanToggleHidden	Boolean opcional. TRUE si el campo se puede ocultar a través de la interfaz de usuario.
Classinfo	Text opcional. Especifica una clase de hoja de estilos en cascada (CSS) que se debe usar en el campo en la vista de tabla estándar. Si se establece, la clase especificada se usa en lugar de la clase ms-vb2 estándar.
ColName	Text opcional. Un atributo interno que define la asignación del campo al nombre de almacenamiento físico del campo. Debe ser un nombre válido en la base de datos subyacente y debe ser idéntico al nombre usado en la tabla de base de datos. Si no se especifica, el servidor genera un nombre de columna que no provoca un conflicto con los nombres de columna existentes y que solo contiene caracteres compatibles con Microsoft SQL Server.
ColName2	Text opcional.
Comas	Boolean opcional. TRUE si se usan comas como separador de miles.
Personalización	Text opcional.
Decimales	Integer opcional. Determina la cantidad de decimales que se deben mostrar. El valor que se muestra se redondea hacia arriba para coincidir con la precisión de presentación; por ejemplo, 1,05 se muestra como 1,1 cuando se redondea a una única posición decimal.
Descripción	Text opcional. Proporciona la descripción que se muestra en el formulario de edición de una lista si se especifica una descripción de campo. De forma predeterminada, los campos de Microsoft SharePoint Foundation no tienen descripciones.
Dir	Text opcional. Especifica la dirección del texto de un campo que admite el orden de lectura bidireccional. Los valores posibles son LTR (de izquierda a derecha) RTL (derecha a izquierda) y none.
Dirección	Text opcional.
DesplazareOnUpgrade	Boolean opcional. Si ya existe una definición de campo para el campo, TRUE para forzar las actualizaciones de las propiedades de campo con los valores especificados en esta definición.
DisplayImage	Text opcional. Especifica el nombre de un icono que se muestra para la columna.
DisplayName	Text opcional. El nombre mostrado para un campo. No hay ninguna restricción en el tamaño del texto ni en el uso de espacios. El nombre para mostrar puede ser editado por el usuario y puede cambiar tras la creación inicial del campo. El nombre se usa como un 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. La <etiqueta FieldName/> devuelve el nombre para mostrar si se proporciona; de lo contrario, el valor predeterminado es el atributo Name .
DisplayNameSrcField	Text opcional. Por lo general, se usa para un campo calculado que debe tener el mismo nombre que otro campo. Si se modifica el campo de origen y un usuario cambia el nombre para mostrar, también se cambiará el nombre para mostrar de este campo. Esta cadena hace referencia al nombre del otro campo.
DisplaySize	Integer opcional.
Div	Number opcional. Un factor de escala que se usa en una división antes de mostrar un número. El número de visualización es `N * Mult / Div` (redondeado hasta el número especificado por decimales).
EnableLookup	Boolean opcional. TRUE para permitir valores de búsqueda en el campo.
EnforceUniqueValues	Boolean opcional.
ExceptionImage	Text opcional. Se usa en un tipo de campo Recurrence para especificar el nombre de un archivo de imagen que se debe usar para las excepciones.
FieldRef	Text opcional. Especifica el nombre de otro campo al que el campo hace referencia, como un campo de búsqueda.
FillInChoice	Boolean opcional. TRUE si el campo permite a los usuarios rellenar los valores de la columna.
Filterable	Boolean opcional. TRUE si el campo se puede filtrar.
FilterableNoRecurrence	Boolean opcional. TRUE si se puede crear un filtro en el campo en una vista que no expande eventos periódicos. Si Filterable contiene TRUE, el campo se puede filtrar en todas las vistas, independientemente de la forma en que FilterableNoRecurrence se configure.
ForcedDisplay	Text opcional. Especifica el texto que se mostrará en lugar del valor real del campo. Este atributo se usa en las encuestas para evitar que aparezca el nombre de usuario.
ForcePromoteDemote	Boolean opcional.
Format	Text opcional. Especifica el formato que se usará para los valores numéricos. Para los campos de fecha y hora, los siguientes valores son posibles: - DateOnly Mostrar (y permitir modificaciones en) solo 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 al formato de hora universal coordinada (UTC): AAAA-MM-DDTHH:MM:SSZ. Este es el formato usado para las propiedades de documento en el sistema de Microsoft Office 2007, así como para el formato de intercambio estándar que se usa en 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. En los campos de opción, este atributo se puede establecer en Dropdown (predeterminado), que proporciona opciones de edición mediante una selección desplegable, o en RadioButtons, que ofrece opciones mediante 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">`.
FromBaseType	Boolean opcional. Este atributo está en desuso en favor del atributo Sealed.
Group	Text opcional. Especifica el grupo de columnas al que pertenece el campo.
HeaderImage	Text opcional. Especifica el nombre de un archivo de imagen que se debe usar como un encabezado en el campo.
Height	Integer opcional. Especifica la altura en píxeles de las imágenes que se muestran a los usuarios en la lista de información de usuarios.
Hidden	Boolean opcional. Si es TRUE, el campo está oculto por completo de la interfaz de usuario. Si ReadOnly se establece en TRUE, significa que el campo no se muestra en los formularios nuevos o de edición, pero aún se puede incluir en las vistas.
HTMLEncode	Boolean opcional. TRUE para convertir caracteres incrustados de manera que se muestren como texto en el explorador; los caracteres que se podrían confundir con etiquetas HTML se convierten en entidades.
ID	Text opcional. Especifica el GUID del campo contenido entre llaves ({}).
Id	Text opcional.
IMEMode	Text opcional. Especifica la preferencia de modo del Editor de métodos de entrada (IME) que se va a usar para el campo. El IME permite la conversión de pulsaciones de teclas entre lenguajes cuando un sistema de escritura tiene más caracteres de los que se pueden codificar para el teclado. Entre los valores posibles se encuentran: - Automático No se usa. Para especificar este modo IME, establezca el valor de la propiedad IMEMode en una cadena vacía (`""`). - Activo Todos los caracteres se escriben a través del IME, pero los usuarios todavía pueden desactivar el IME. - Inactivo Los caracteres se escriben sin el IME, aunque los usuarios todavía pueden activar el IME.
Indexed	Boolean opcional. TRUE si la columna está indizada por usarse en filtros de vista.
IsolateStyles	Boolean opcional. Para un campo Text cuyo atributo RichText es TRUE y cuyo atributo RichTextMode es FullHtml, este atributo especifica que un servidor vuelva a escribir el HTML del campo para garantizar que no interfiera con la representación de la página que lo rodea.
IsRelationship	Boolean opcional. TRUE si el campo se puede detectar en la lista en la que busca su valor.
JoinColName	Text opcional. Este atributo solo se define para los campos de búsqueda. Es muy similar a ColName, excepto que indica el nombre de la columna que se usa en la construcción JOIN de SQL entre las listas locales y externas. Normalmente, este valor no debe personalizarse. En la actualidad, se usa solo en el esquema de campo de determinados campos integrados y de tipo base para indicar las búsquedas en la tabla de direcciones URL (DocMd), que se une en la columna UrlID.
JoinRowOrdinal	Integer opcional. No está destinado para uso directo desde el código.
JoinType	Text opcional. Especifica el tipo de construcción JOIN que se usará en el campo. Entre los valores posibles se incluyen INNER, LEFTOUTER y RIGHTOUTER.
LCID	Integer opcional. El atributo LCID se puede usar para especificar el país o la región cuyo formato de moneda se usa, por ejemplo, 1033 para los Estados Unidos. Dos casos especiales existen para el formato del símbolo de euro. Si LCID = -1 (0xFFFFFFF), el símbolo del euro se agrega como un prefijo al número. Si LCID = -2 (0xFFFFFFE), el símbolo de euro se agrega como un sufijo al número. El número de dígitos decimales es 2, aunque esto puede ser reemplazado por el atributo Decimals del campo. El símbolo de moneda del euro es igual a 0x20AC en UCS-2.
LinkToItem	Boolean opcional.
LinkToItemAllowed	Text opcional.
Lista	Text opcional. Especifica el nombre interno de una lista.
ListItemMenu	Boolean opcional.
ListItemMenuAllowed	Text opcional.
Max	Number opcional. Especifica el valor máximo permitido para el campo.
MaxLength	Integer opcional. Especifica el número máximo de caracteres permitido en un valor de campo. Los formularios de edición se ajustan para aplicar este valor, que se valida en el cliente. Si el usuario intenta especificar un número de caracteres superior al número permitido establecido por MaxLength, aparece un mensaje de error.
Min	Number opcional. Especifica el valor mínimo permitido para el campo.
Mult	Boolean opcional. Un factor de escala usado en la multiplicación antes de mostrar un número.
Nombre	Text obligatorio. El nombre de un campo. Es el nombre interno de un campo y se garantiza que nunca cambiará mientras dure la definición de campo. Debe ser único con respecto al conjunto de campos de una lista. El nombre se genera de forma automática basándose en el nombre definido por el usuario para un campo.
NegativeFormat	Text opcional. Especifica cómo indicar valores negativos. Puede establecerse en uno de los siguientes valores: - Signo menos Use signo menos como prefijo. - Paréntesis Rodear con paréntesis.
Nodo	Text opcional. Se usa en los formularios XML, este atributo es obligatorio para todos los campos excepto para los vínculos de instrucción de procesamiento (PI) y especifica la expresión XPath de un nodo que se promueve.
NoEditFormBreak	Boolean opcional. TRUE para impedir que un salto de línea se agregue entre los campos en el formulario del elemento nuevo o editar el formulario del elemento. Algunos tipos de campo, como, por ejemplo, un campo de texto enriquecido, proporcionan el espaciado de manera predeterminada y este atributo permite controlar el espacio extra que se genera.
NumLines	Integer opcional. Recomienda la cantidad de líneas (filas) que se deben mostrar en un bloque TEXTAREA durante la edición. Esto es simplemente una sugerencia de la interfaz de usuario de cliente, ya que no hay un límite exigido para la cantidad de líneas de texto que se pueden editar.
Percentage	Boolean opcional. TRUE si se muestra el valor como un porcentaje, es decir, un número multiplicado por 100 con un signo de porcentaje (%).
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.
PrependId	Boolean opcional. Utilizado en las listas de seguimiento de problemas, TRUE para mostrar los identificadores de recopilación de los elementos de problemas relacionados en los formularios Edición y Nuevo elemento.
Presencia	Boolean opcional. TRUE si hay información de usuario para el campo.
PrimaryKey	Boolean opcional. TRUE si el campo es la clave principal de la relación entre la lista y otra lista.
PrimaryPIAttribute	Text opcional. Se usa para la promoción y disminución de nivel de propiedades en documentos XML. 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 . 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.
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 nuevos o de edición, pero se puede incluir en las vistas. Además, si ReadOnly se establece en TRUE, oculta el campo de las páginas de Configuración del sitio para la administración de columnas de sitio y los tipos de contenido. 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 este atributo estuviera establecido en False.
ReadOnlyEnforced	Boolean opcional. TRUE para especificar que el usuario no puede cambiar el campo por ningún medio y que únicamente el sistema puede cambiarlo.
RelationshipDeleteBehavior	Text opcional. Especifica el comportamiento de eliminación del campo. Entre los valores posibles se incluyen Cascade, Restrict y None.
RenderXMLUsingPattern	Boolean opcional. Se usa en campos calculados para determinar el formato de presentación. Si es TRUE, los valores se representan en función del modelo de presentación del campo calculado, en lugar del valor de columna de la primera referencia del campo no calculado en la que se basa el campo calculado. Por ejemplo, en una biblioteca de imágenes, la columna de tamaño de imagen se representa como ancho x altura, pero si el atributo no está establecido en TRUE, se muestra solo la primera referencia del campo: ancho. Si se establece en TRUE, se muestra el formato ancho x altura.
Required	Boolean opcional. Si es TRUE, el campo no debe tener asignado un valor vacío. Si no se especifica ningún valor de campo 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. Únicamente el cliente controla la validación (la base de datos siempre permite el valor NULL para todos los campos definidos por el usuario).
RestrictedMode	Boolean opcional. TRUE para no permitir que el campo Note tenga formato de texto enriquecido (por ejemplo, tablas, imágenes o hipervínculos) ni permitir que se pegue texto con formato en el campo.
ResultType	Text opcional. Especifica el tipo de datos de los valores devueltos por el campo.
RichText	Boolean opcional. TRUE si el campo muestra formato de texto enriquecido.
RowOrdinal	Integer opcional. Especifica la ubicación de la base de datos del campo.
Sellado	Boolean opcional. Si se establece este atributo como TRUE para un campo del archivo Schema.xml de una lista, el campo se marca como inamovible en la página Cambiar columna.
SeparateLine	Boolean opcional. Se usa internamente para admitir la representación de un campo (como notas o comentarios) en otra línea. Este atributo no está destinado para uso público.
SetAs	No está destinado para uso directo desde el código.
ShowAddressBookButton	No está destinado para uso directo desde el código.
ShowAlways	Boolean opcional.
ShowField	Opcional. El atributo ShowField se puede establecer como el nombre de campo para mostrar. 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. Para un campo Lookup, este parámetro debe establecerse como el nombre de campo interno; si se establece como el nombre para mostrar no provoca un error, pero interrumpe el campo.
ShowInDisplayForm	Boolean opcional. TRUE para mostrar el campo en el formulario para ver el elemento.
ShowInEditForm	Boolean opcional. TRUE para mostrar el campo en el formulario para editar el elemento.
ShowInFileDlg	Boolean opcional. Este atributo solo es válido para los campos de los esquemas de biblioteca de documentos. Si es FALSE, el campo no aparece en el cuadro de diálogo de propiedades para guardar los formularios que aparece cuando se guarda desde aplicaciones cliente. Por ejemplo, el campo Title tiene este atributo ya que está establecido directamente en el documento que se guarda en la biblioteca de documentos.
ShowInListSettings	Boolean opcional. TRUE para mostrar la columna en la página para personalizar la configuración de la lista.
ShowInNewForm	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. En concreto, se usa para ocultar campos en la página para cargar documentos a la biblioteca de documentos.
ShowInVersionHistory	Boolean opcional. TRUE para mostrar la columna en la página para ver las versiones del elemento de lista.
ShowInViewForms	Boolean opcional. TRUE para especificar que el campo se muestra en las páginas que se usan para ver datos de lista.
Se puede ordenar	Boolean opcional. TRUE si los valores del campo se pueden almacenar.
SourceID	Text opcional. Contiene el espacio de nombres que define el campo, como `http://schemas.microsoft.com/sharepoint/v3`, o el GUID de la lista en la que se creó el campo personalizado.
StaticName	Text opcional. Contiene el nombre interno del campo.
StorageTZ	Especifica cómo se almacenan los valores de fecha y hora. Cuando StorageTZ se establece en UTC, la fecha y hora se tratan como hora universal coordinada (UTC). Omita el atributo StorageTZ para indicar que un valor de fecha y hora se refiere a un tiempo "abstracto", que indica que la fecha y hora se almacenan en la base de datos tal y como las escribió el usuario, sin conversión o almacenamiento de la zona horaria local.
Stripws	Boolean opcional. TRUE si se eliminan los espacios en blanco del principio y final de los valores de campo.
SuppressNameDisplay	Boolean opcional. TRUE para no mostrar el nombre del usuario en un campo User.
TextOnly	Boolean opcional. Si es TRUE, el campo solo puede tener valores Text.
Title	Text opcional. Contiene el título del campo que se muestra en la interfaz de usuario.
Tipo	Text obligatorio. El tipo de datos del campo (a menos que el elemento Field sea un elemento secundario de ProjectedFields). NOTA: En la versión preliminar de tecnología de Microsoft SharePoint Foundation 2010, el atributo Type tiene un significado diferente y solo un valor posible ("Lookup") cuando es un elemento secundario de ProjectedFields. Para obtener más información sobre este uso de Type, vea ProjectedFields Element (View). SharePoint Foundation incluye los siguientes tipos de datos de forma predeterminada: - AllDayEvent Especifica un evento de todo el día. Corresponde al tipo de datos bit de SQL. - Accesorios Almacena las direcciones URL de los datos adjuntos. Corresponde al tipo de datos bit de SQL. - Booleana Se usa para almacenar un valor TRUE/ FALSE (almacenado en la base de datos como 0 o 1). Este campo se puede ordenar y agrupar. Corresponde al tipo de datos SQL de bits y se representa mediante la clase SPFieldBoolean . - Calculado Especifica un campo cuyo valor se calcula en función de otras columnas. Corresponde al tipo de datos SQL sql_variant y se representa mediante la clase SPFieldCalculated . - Elección Permite al usuario especificar un conjunto predeterminado de valores que se pueden usar para escribir datos en el campo. Los tipos Choice y Lookup son los campos más importantes para la organización y agrupación. Los atributos BaseType y Format se pueden usar en los campos de opción. Este campo se puede ordenar y agrupar. Cuando se especifica un valor para una opción de elección, ese valor se usa como valor enviado para la selección de campo. Cuando no se especifica ningún valor, esa opción se envía como el valor de texto de opción. En todos los casos, el valor de texto de la opción es lo que se muestra en la interfaz de usuario (lista desplegable o texto del botón de radio). El orden en que las opciones aparecen en la interfaz de usuario de edición es siempre el orden en que se especifican los elementos en el elemento CHOICES. Use el tipo MultiChoice para especificar un campo Choice que implemente las casillas de verificación y permita al usuario seleccionar varios valores. Corresponde al tipo de datos sql nvarchar y se representa mediante la clase SPFieldChoice . - Computada Especifica un campo que depende de otro campo para su contenido. Por ejemplo, un campo LinkTitleNoMenu equivale a rodear un valor del campo Title con un hipervínculo. Representado por la clase SPFieldComputed . - ContentTypeId Contiene un identificador de tipo de contenido. Para obtener información acerca del formato de los identificadores de tipo de contenido, vea Content Type IDs. Corresponde al tipo de datos varbinary de SQL. - Contador Por lo general, solo se usa para el campo de identificador interno. Su valor de entero se establece automáticamente para que sea único con respecto a todos los elementos de la lista actual. El tipo Counter siempre es de solo lectura y no se puede establecer a través de un envío de formulario. El campo se puede ordenar, pero no agrupar. Corresponde al tipo de datos int de SQL. - CrossProjectLink Se usa para conectar un evento en una lista de SharePoint con un sitio del área de trabajo de reunión; hace referencia específicamente al tipo de campo de la casilla que se usa en los formularios Nuevo y Editar elemento para crear un sitio de área de trabajo de reunión para el elemento. Corresponde al tipo de datos SQL de bits y se representa mediante la clase SPFieldCrossProjectLink . - Moneda Permite especificar un valor de moneda. Cada campo de moneda está vinculado a la moneda de una configuración regional específica. En todos los demás aspectos, se trata como el tipo de campo Number. Use el atributo LCID para indicar una moneda de una configuración regional específica. Los atributos Decimals, Max y Min se pueden usar en los tipos de moneda. Este campo se puede ordenar y agrupar. Corresponde al tipo de datos float SQL y se representa mediante la clase SPFieldCurrency . - Datetime Permite el almacenamiento de una fecha o hora del día completos. Use el atributo Format para especificar el formato de fecha y use el atributo StorageTZ para determinar cómo se almacenan los valores de fecha y hora. Este campo se puede ordenar y agrupar. Para el modo de visualización, el orden de formato de fecha se deriva de la configuración regional ("M/D/Y" o "D/M/Y"). En el modo de edición (o en el modo Nuevo para el valor de elemento Predeterminado ), las fechas y horas se representan en formato universal: M/D/Y hh:mm am/pm. Corresponde al tipo de datos SQL datetime y se representa mediante la clase SPFieldDateTime . - Archivo Contiene un archivo. Corresponde al tipo de datos uniqueidentifier de SQL. - GridChoice Contiene una escala de clasificación para encuestas. Corresponde al tipo de datos sql ntext y se representa mediante la clase SPFieldRatingScale . - Guid Permite identificadores únicos globales (GUID). Corresponde al tipo de datos uniqueidentifier de SQL. - Entero Permite valores enteros positivos o negativos. Los atributos Commas y NegativeFormat se usan para especificar el formato de número entero. Corresponde al tipo de datos int de SQL. - Búsqueda Se comporta de forma muy similar a un campo Choice , salvo que las opciones disponibles proceden de otra lista en lugar de ser una selección de valores codificada de forma rígida. Los atributos List y ShowField se pueden usar en los campos de búsqueda. Este campo se puede ordenar y agrupar. Para ordenar y agrupar, use el valor DisplayField (Title, de manera predeterminada) en vez de la clave externa almacenada en la lista. Corresponde al tipo de datos int SQL y se representa mediante la clase SPFieldLookup . - LookupMulti Campo De búsqueda que puede contener más de un valor. Tipo de elemento primario: Lookup. - ModStat Contiene el estado de aprobación de contenido. Los valores posibles incluyen Approved (predeterminado), Rejected y Pending (almacenados en la base de datos como 0, 1 ó 2, respectivamente). Corresponde al tipo de datos int de SQL. - MultiChoice Especifica un campo Choice que implementa casillas de verificación y permite al usuario seleccionar varios valores. Corresponde al tipo de datos sql ntext y se representa mediante la clase SPFieldMultiChoice . - MultiColumn Un campo Note que emula un campo que contiene varios valores. Para consultar un ejemplo de un tipo de campo multicolumn, vea Custom Field Type Definition. Para obtener información sobre los campos de varias columnas, vea Clases de campo multicolumna personalizadas. Tipo primario: Note. - Nota Permite a los usuarios escribir varias líneas de texto. Este campo no se puede ordenar o agrupar. Todo el texto está definido como caracteres ASCII convencionales sin formato HTML. Todo lo que se parece a formato HTML o a una dirección URL se encierra entre comillas (por ejemplo, Server.HtmlEncode) para que se parezca a texto convencional. El control de edición de este formato es un simple bloque TEXTAREA. Use el atributo NumLines para especificar la cantidad de líneas que desea mostrar. Corresponde al tipo de datos sql ntext y se representa mediante la clase SPFieldMultiLineText . - Número Permite especificar un número de punto flotante. Este campo se puede ordenar y agrupar. Los números especificados se analizan de acuerdo con la configuración actual de la configuración regional de los separadores de decimales y miles. Para indicar que un número es negativo, se puede colocar el número entre paréntesis o se puede usar un símbolo de negativo. Los siguientes atributos se pueden usar junto con el atributo Number para especificar el formato de los números: Decimals, Div, Max, Min, Mult y Percentage. Corresponde al tipo de datos float SQL y se representa mediante la clase SPFieldNumber . - PageSeparator Inserta un salto de página en una lista de encuestas. Representado por la clase SPFieldPageSeparator . - Repetición Se usa para editar y definir el patrón de periodicidad de un elemento de una lista de eventos. Corresponde al tipo de datos bit de SQL. - Texto Una sola línea de texto escrita en un cuadro de edición. Este campo se puede ordenar y agrupar. Use el atributo MaxLength para establecer la cantidad máxima de caracteres permitidos. Corresponde al tipo de datos sql nvarchar y se representa mediante la clase SPFieldText . - ThreadIndex Contiene el identificador que indica la posición relativa de un mensaje dentro de un subproceso de conversación. Corresponde al tipo de datos varbinary de SQL. - Threading El tipo de campo Threading se usa en la creación y visualización de vistas de discusión en subproceso. Cualquier lista puede contener una columna de subproceso, pero se genera una interfaz de usuario especial cuando se usa. (Nunca se muestra como un campo editable estándar en un formulario ni como una columna normal en una vista). Si se realiza una ordenación en un campo de subproceso, se devuelve un recorrido de orden previo de todos los registros de una relación primario-secundario. Para ello, se debe guardar la concatenación de la fecha de creación y el número de identificación de todos los registros primarios de un registro determinado. Corresponde al tipo de datos varchar de SQL. - URL Se usa para crear un hipervínculo de forma libre. Un campo de dirección URL se muestra como `<A HREF="URL">Description</A>`. Si no se proporciona ninguna descripción, se muestra como `<A HREF="URL">URL</A>`. El texto de la dirección URL se almacena en la tabla de direcciones URL (DocMd), que almacena todas las direcciones URL de las bases de datos de SharePoint en el servidor. Esto se hace para que las direcciones URL que son locales en el servidor se puedan actualizar a través de la corrección de vínculos cuando se mueva su destino. Cuando se elimina un registro con un campo de dirección URL contenido en él, también se elimina el registro al que se hace referencia correspondiente de la tabla de direcciones URL. Este campo se puede ordenar y agrupar. (La ordenación se define según la descripción textual en lugar del contenido de la dirección URL; si no se proporciona ninguna descripción, ordena lo mismo que en blanco). Cuando Type es URL, el atributo LinkType se puede usar para especificar el tipo de vínculo. Corresponde al tipo de datos sql nvarchar y se representa mediante la clase SPFieldUrl . - Usuario Campo de búsqueda que hace referencia a la tabla de base de datos UserInfo. Corresponde al tipo de datos int SQL y se representa mediante la clase SPFieldUser . - UserMulti Un campo User que puede contener más de un valor. Tipo de elemento primario: LookupMulti. - WorkflowEventType Especifica un tipo de evento de flujo de trabajo representado por la enumeración SPWorkflowHistoryEventType . Tipo de elemento primario: Integer. - WorkflowStatus Especifica el estado del flujo de trabajo representado por la enumeración SPWorkflowStatus . Corresponde al tipo de datos nvarchar de SQL.
UniqueId	Text opcional. No está destinado para uso directo desde el código.
UnlimitedLengthInDocumentLibrary	Boolean opcional. TRUE para permitir que la longitud del campo sea ilimitada en bibliotecas de documentos.
URLEncode	Boolean opcional. TRUE para convertir caracteres especiales, como espacios, en formato UTF-8 entre comillas, por ejemplo, `%c3%ab` para el carácter `ë`.
URLEncodeAsURL	Boolean opcional. Al igual que URLEncode, pero TRUE para especificar que la cadena que se va a codificar es un componente de ruta de acceso de una dirección URL para que las barras diagonales (`/`) no se codifican.
UserSelectionMode	Text opcional. Especifica si se pueden seleccionar solo los nombres de usuarios individuales en un campo de usuario en un formulario de elementos, o si se pueden seleccionar los nombres de personas y grupos. Los siguientes valores son posibles: 0: solo se pueden seleccionar los nombres de usuarios. 1: se pueden seleccionar los nombres de personas y grupos.
UserSelectionScope	Integer opcional. Especifica un ámbito para la selección de nombres de usuario en un campo de usuario de un formulario de elementos. Si es valor es 0, no hay ninguna restricción para un grupo de SharePoint. Si el valor es mayor que 0, la selección del usuario está restringida a los miembros del grupo de SharePoint cuyo identificador coincide con el valor especificado.
Versión	Text opcional.
Visible	Boolean opcional. Es TRUE para agregar el campo a la vista predeterminada. El valor predeterminado es TRUE.
WebId	Text opcional.
Width	Integer opcional. Especifica el ancho en píxeles de las imágenes que se muestran a los usuarios en la lista de información de usuarios.
WikiLinking	Boolean opcional. TRUE para especificar que los vínculos wiki, que aparecen en forma de corchetes dobles (`[[…]]`), se traducen en vínculos HTML, que usan la `<A>` etiqueta .
XName	Text opcional. Se usa internamente en formularios XML para identificar los campos agregados, eliminados o modificados. Este atributo no está destinado para uso público.

Elementos secundarios

Elementos principales

Repeticiones

Mínimo: 0
Máximo: sin enlazar cuando el elemento primario es Fields. Cuando el elemento primario es ProjectedFields, el máximo es la diferencia entre el número máximo de campos permitidos en la lista principal que se está consultando y el número de campos que ya están en la lista.

Comentarios

Para crear una definición de campo personalizada para una definición de lista basada en un tipo de campo predeterminado de SharePoint Foundation, use el elemento Field (Lista - Definición) dentro de un archivo Schema.xml .

Para crear una definición de campo personalizada como una característica conectable que se basa en un tipo de campo predeterminado y que se puede reutilizar entre sitios web y listas dentro de una colección de sitios, use el elemento Field (Field) para definir una columna de sitio personalizada.

Para crear un tipo de campo personalizado que implementa una clase personalizada para la validación de datos especiales y la representación de campo, utilice el elemento Campo (Tipos de campo) .

Se puede hacer referencia a campos a partir de las definiciones de vista, así como de las expresiones de los elementos de representación de campos calculados. Utilice el elemento Campo (Vista) para obtener un valor de campo con formato para mostrarlo dentro de una vista, y el elemento Columna (Vista) para obtener los datos sin formato del campo.

La sintaxis para hacer referencia a un campo es la siguiente:

<Field Name="FieldName"/>

De forma predeterminada, el campo se representa con los atributos predeterminados de la definición de dicho campo, tal como se especifica en la tabla anterior. Cualquiera de los atributos de campo se puede invalidar en el marcado CAML del atributo FieldRef , que invalida la definición dada para el propio campo (no se puede cambiar el atributo Type de un campo).

Para mostrar el nombre para mostrar definido por el usuario de un campo, puede usar <Property Select="DisplayName"/>.

Dentro de una enumeración de elementos de Fields, se puede omitir el atributo Name. Para algunas referencias de campo, se puede acceder a los datos sin procesar almacenados para el campo mediante <Column/>.

Algunas propiedades de campos de formularios y de determinados aspectos de la interfaz de usuario de creación se pueden representar a través del elemento Property , por ejemplo, <Property Select="Description"/> o <Property Select="Type"/>. Estos elementos simplemente recuperan el valor de cualquier atributo de campo o elemento secundario (Property) por su nombre.

Además de los tipos anteriores, los siguientes campos predefinidos se usan con el elemento Field :

Nombre	Descripción
Created	Un campo que contiene un valor DateTime que especifica la hora en que se creó el elemento (en UTC).
CreatedBy	Un campo que contiene un valor Lookup que hace referencia a la tabla UserInfo e indica el usuario que creó el elemento.
Edit	Un campo calculado (con ningún esquema adicional) que contiene un hipervínculo al formulario para editar un elemento. Este campo hace referencia a la página para editar el elemento y al campo Id. para identificarlo.
ID	Un tipo de campo Counter que está asociado con todos los elementos de todas las listas. El identificador identifica de forma unívoca al elemento de lista en las direcciones URL y en formularios POST durante la edición. Al especificar New como el valor del atributo ID en el comando Cmd=Save , se crea un elemento en lugar de editar un elemento actual.
Modified	Un campo que contiene un valor DateTime que especifica la hora en que el elemento se modificó por última vez (en UTC). La hora Modified también se usa como una especie de campo Version. La fecha de última modificación de un elemento siempre se registra cuando se está editando un elemento existente. Si no coincide con la fecha de modificación actual, el servidor provoca un error de edición y devuelve un error al usuario, con un vínculo a los datos actuales en el servidor (que se abre en una nueva ventana), para que los valores publicados puedan copiarse del formulario antiguo al nuevo.
ModifiedBy	Un campo que contiene un valor Lookup a la tabla UserInfo que indica el último usuario que modificó el elemento.
Title	Nombre para mostrar genérico de cada elemento. Puede tener un nombre para mostrar diferente en las distintas listas pero el mismo nombre de campo interno de Title. El título es el texto predeterminado que se muestra para campos Lookup para listas.
LinkTitle	Un campo calculado que muestra hipervínculos a elementos, que contiene los textos de los títulos y genera direcciones URL (y nuevas referencias a iconos) a los elementos. No hay ningún almacenamiento adicional para este campo; se basa en los campos de identificador y título para representar su interfaz de usuario.

Nota:

Los campos devueltos en una enumeración Fields se ven afectados por el modo de presentación. Los campos que están marcados con el atributo Hidden nunca se devuelven. Los campos que están marcados con el atributo ReadOnly no se devuelven si se va a representar un formulario (si se llama a Fields desde un elemento ListForm). Los campos que están marcados con el atributo ShowInNewForm no se devuelven en los modos de presentación NEW o PREVIEWNEW. Los campos marcados con el atributo ShowInFileDlg no se devuelven al representar el formulario de diálogo NewForm.

Ejemplo

En el ejemplo siguiente se usa el elemento Field para especificar opciones para una lista denominada Lista de áreas:

<Field Type="Choice" BaseType="Text" Name="Area">
  <CHOICES>
    <CHOICE>Views</CHOICE>
    <CHOICE>Site Design</CHOICE>
    <CHOICE>Layouts</CHOICE>
    <CHOICE>Schema Design</CHOICE>
    <CHOICE>Fields</CHOICE>
    <CHOICE>Forms</CHOICE>
    <CHOICE>Projects</CHOICE>
    <CHOICE>Inter-Team Issues</CHOICE>
    <CHOICE>Schedule</CHOICE>
    <CHOICE>Spec</CHOICE>
    <CHOICE>Headcount</CHOICE>
    <CHOICE>Misc</CHOICE>
  </CHOICES>
</Field>

Compartir a través de