Elemento Field (List)
Última modificación: jueves, 13 de febrero de 2014
Hace referencia a: SharePoint Foundation 2010
En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones
Define los tipos de datos internos usados 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>
Atributos
Atributo |
Descripción |
---|---|
Aggregation |
Text opcional. Se usa en un campo de agregado en un formulario XML para especificar la función que se aplicará a una colección de valores o elementos devueltos por una expresión XPath. 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 realizará en el conjunto de valores devuelto. Esta acción puede ser bien de agregación, o bien una indicación del elemento concreto dentro de la colección. Los valores posibles son:
Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, PrimaryPIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML. |
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 se habilita en la lista el control de versiones, TRUE si solamente se puede agregar texto al 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 como Integer, que almacena valores como enteros, o como Text (predeterminado), que almacena valores como texto. No se pueden crear campos de elección con un tipo base de entero. |
CalType |
Integer opcional. Especifica el tipo de calendario. Entre los posibles valores se incluyen:
|
CanToggleHidden |
Boolean opcional. TRUE si el campo puede estar oculto a través de la interfaz de usuario. |
ClassInfo |
Text opcional. Especifica una clase de hoja de estilos en cascada (CSS) que se va a usar para el campo en la vista de tabla estándar. Si está activada, 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 para este campo. Este nombre debe ser válido en la base de datos subyacente y debe ser idéntico al nombre usado en la base de datos. Si no se especifica, el servidor genera un nombre de columna que no entra en conflicto con ninguno de los nombres de columna existentes y que sólo contiene caracteres permitidos por Microsoft SQL Server. |
ColName2 |
Text opcional. |
Commas |
Boolean opcional. TRUE si se usan comas como separador de millares. |
Customization |
Text opcional. |
Decimals |
Integer opcional. Determina el número de decimales que se muestran. El valor mostrado se redondea con la precisión de presentación; por ejemplo, 1,05 se muestra como 1,1 cuando se redondea a una posición decimal. |
Description |
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 manera predeterminada, los campos de Microsoft SharePoint Foundation no tienen descripciones. |
Dir |
Text opcional. Especifica la dirección del texto en un campo que admite la lectura bidireccional. Los posibles valores son LTR (de izquierda a derecha), RTL (de derecha a izquierda) y none. |
Direction |
Text opcional. |
DisplaceOnUpgrade |
Boolean opcional. Si ya existe una definición para el campo, TRUE para forzar actualizaciones de propiedades de campo con los valores que se especifican en esta definición de campos. |
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. Este nombre 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. La etiqueta <FieldName/> devuelve el nombre para mostrar si se da; en caso contrario, se usa de forma predeterminada el atributo Name. |
DisplayNameSrcField |
Text opcional. Generalmente se usa para un campo calculado que necesita el mismo nombre que otro campo. Si se modifica el campo de origen y un usuario cambia su nombre para mostrar, a continuación, el nombre para mostrar de este campo también cambiará. Esta cadena hace referencia al nombre del otro campo. |
DisplaySize |
Integer opcional. |
Div |
Number opcional. Un factor de escala usado en una división antes de mostrar un número. El número para mostrar es N * Mult / Div (redondeado al número especificado por Decimals). |
EnableLookup |
Boolean opcional. TRUE para habilitar valores de búsqueda en el campo. |
EnforceUniqueValues |
Boolean opcional. |
ExceptionImage |
Text opcional. Se utiliza en un tipo de campo Recurrence para especificar el nombre del archivo de imagen que se va a utilizar para 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 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 cómo está establecido FilterableNoRecurrence. |
ForcedDisplay |
Text opcional. Especifica el texto para mostrar en lugar del valor de campo real. Este atributo se usa en encuestas para evitar que se muestre el nombre de usuario. |
ForcePromoteDemote |
Boolean opcional. |
Format |
Text opcional. Especifica el formato que se va a usar para los valores numéricos. Para los campos de fecha y hora, los siguientes valores son posibles:
Para los campos de elección, este atributo se puede establecer como Dropdown (valor predeterminado), que proporciona opciones de edición mediante una selección desplegable, o como RadioButtons, que proporciona opciones mediante un grupo de botones de opción. Para los campos de direcciones URL, este atributo se puede establecer como Hyperlink (valor predeterminado), que muestra la dirección URL como una etiqueta <A> normal, o como 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 va a usar como encabezado del campo. |
Height |
Integer opcional. Especifica la altura en píxeles de las imágenes que se muestran a los usuarios en la lista Información del usuario. |
Hidden |
Boolean opcional. Si está establecido como TRUE, el campo está completamente oculto en la interfaz de usuario. Si se establece ReadOnly como TRUE, significa que el campo no se muestra en formularios nuevos o de edición pero todavía se puede incluir en 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 que se encuentra entre corchetes ({}). |
Id |
Text opcional. |
IMEMode |
Text opcional. Especifica el sesgo del modo Editor de métodos de entrada (IME) para usar en el campo. El IME permite la conversión de pulsaciones de teclas entre idiomas cuando un sistema de escritura tiene más caracteres de los que se pueden codificar para el teclado determinado. A continuación se muestran los posibles valores:
|
Indexed |
Boolean opcional. TRUE si la columna está indizada para su uso 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 a partir de la lista en la que busca su valor. |
JoinColName |
Text opcional. Este atributo se define sólo para campos de búsqueda. Es muy similar a ColName, excepto en que denota el nombre de la columna que se usan en SQL JOIN entre las listas locales y externas. Normalmente, no se debe personalizar este valor. Sólo se usa actualmente en el esquema de campo de ciertos campos integrados y de tipo base para indicar búsquedas en la tabla de direcciones URL (DocMd), que se une en la columna UrlID. |
JoinRowOrdinal |
Integer opcional. No pensado para utilizarlo directamente desde el código. |
JoinType |
Text opcional. Especifica el tipo de JOIN usado en el campo. Los posibles valores incluyen INNER, LEFTOUTER y RIGHTOUTER. |
LCID |
Integer opcional. El atributo LCID se puede usar para especificar el país o 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 la moneda de euro es igual a 0x20AC en UCS-2. |
LinkToItem |
Boolean opcional. |
LinkToItemAllowed |
Text opcional. |
List |
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 permitidos en un valor de campo. Los formularios de edición se ajustan para exigir este valor, que se valida en el cliente. Si el usuario intenta escribir un número de caracteres mayor que el 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. |
Name |
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 los valores negativos. Se puede establecer en uno de los siguientes valores:
|
Node |
Text opcional. Usado en formularios XML, este atributo es necesario para todos los campos excepto para los vínculos de instrucciones de procesamiento (PI), y especifica la expresión XPath para un nodo que se promueve. |
NoEditFormBreak |
Boolean opcional. TRUE para impedir que un salto de línea se agregue entre los campos de un formulario de nuevo elemento o de edición de elemento. Algunos tipos de campo, como el campo de texto enriquecido, proporcionan el espaciado de forma predeterminada, y este atributo permite controlar el espacio adicional resultante. |
NumLines |
Integer opcional. Recomienda el número de líneas (filas) para mostrar en un bloque TEXTAREA durante la edición. Esto es simplemente una sugerencia de la interfaz de usuario del cliente; no se impone ninguna limitación en el número de líneas de texto que se pueden editar. |
Percentage |
Boolean opcional. TRUE si el valor se muestra 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 (especificado por el atributo PITarget) que se va a utilizar como valor de la columna. Se utiliza para la promoción y degradación de propiedades en documentos XML. Si se especifica el atributo PIAttribute, también se debe especificar el PITarget. Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y degradación 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 utiliza para promoción y degradación 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 la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML. |
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. |
Presence |
Boolean opcional. TRUE si la información del usuario está presente para el campo. |
PrimaryKey |
Boolean opcional. TRUE si el campo es la clave principal en la relación entre la lista y otra lista. |
PrimaryPIAttribute |
Text opcional. Se utiliza para la promoción y degradación de propiedades en documentos XML. Especifica un atributo alternativo en la instrucción de procesamiento del documento, especificada por el PrimaryPITarget que se va a utilizar como valor de la columna. Si se especifica el atributo PrimaryPIAttribute, también se debe especificar el atributo PrimaryPITarget. Si se especifica, SharePoint Foundation utiliza estos valores antes de los especificados en los atributos PITarget y PIAttribute. Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget, para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML. |
PrimaryPITarget |
Text opcional. Especifica una instrucción de procesamiento de documentos alternativa en la que el valor de la columna se almacena 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 utiliza estos valores antes que los especificados en los atributos PITarget y PIAttribute. Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML. |
ReadOnly |
Boolean opcional. Si se establece como TRUE, el campo no se muestra en formularios nuevos o de edición pero se puede incluir en vistas. Además, si se establece ReadOnly como TRUE, el campo se oculta en las páginas de configuración del sitio para administrar columnas de sitio y tipos de contenido. Establecer el atributo Hidden como TRUE oculta completamente el campo de la interfaz de usuario. Si no se incluye este atributo, SharePoint Foundation trata la columna como si este atributo estuviera establecido como False. |
ReadOnlyEnforced |
Boolean opcional. TRUE para especificar que el usuario no puede cambiar el campo por ningún medio y que sólo lo puede cambiar el sistema. |
RelationshipDeleteBehavior |
Text opcional. Especifica el comportamiento de eliminación del campo. Los valores posibles incluyen Cascade, Restrict y None. |
RenderXMLUsingPattern |
Boolean opcional. Se usa en campos calculados para determinar el formato de presentación. Si se establece como TRUE, los valores se representan en función del modelo de presentación del campo calculado, en lugar del valor 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 alto, pero si este atributo no se establece como TRUE, solo se muestra la primera referencia del campo: ancho. Si se establece como TRUE, se muestra el formato ancho x alto. |
Required |
Boolean opcional. Si se establece como TRUE, el campo no debe tener asignado un valor vacío. Si no se proporciona un valor de campo no vacío en un envío de formulario, se muestra el texto de campo necesario estándar o un mensaje explícitamente específico (es decir, mediante etiquetas <ErrorText>) en el formulario de error. La validación es controlada sólo por el cliente (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 mejorado, como imágenes, tablas o hipervínculos, ni tampoco pegar texto con formato en el campo. |
ResultType |
Text opcional. Especifica el tipo de datos de valores que se devuelven desde 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 para el campo. |
Sealed |
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 presentación de un campo (por ejemplo, notas o comentarios) en una línea independiente. Este atributo no es de uso público. |
SetAs |
No está pensado para usarse directamente desde el código. |
ShowAddressBookButton |
No está pensado para usarse directamente desde el código. |
ShowAlways |
Boolean opcional. |
ShowField |
Opcional. El atributo ShowField se puede establecer como el nombre de campo para mostrar. De manera predeterminada se muestra un texto con hipervínculo del campo de título del registro de la lista externa. Sin embargo, el atributo ShowField se puede usar para invalidar este valor y mostrar otro campo de la lista externa. Se permiten los siguientes tipos de datos como destino de un atributo a 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 sólo es válido para campos de esquemas de biblioteca de documentos. Si se establece como FALSE, el campo no se mostrará en el cuadro de diálogo de propiedades para guardar formularios que aparece cuando se guarda desde aplicaciones cliente. Por ejemplo, el campo de título tiene este atributo porque se establece 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 las listas. |
ShowInNewForm |
Boolean opcional. Si se establece como FALSE, el campo no aparecerá en una enumeración de Fields cuando el modo de presentación está establecido como New. Los campos con esta configuración no aparecen en la página Nuevo elemento predeterminada de una lista determinada. En concreto, esto se usa para ocultar campos en la página para cargar documentos en la biblioteca de documentos. |
ShowInVersionHistory |
Boolean opcional. TRUE para mostrar la columna en la página para ver versiones de elementos de lista. |
ShowInViewForms |
Boolean opcional. TRUE para especificar que el campo se muestra en las páginas que se utilizan para ver los datos de la lista. |
Sortable |
Boolean opcional. TRUE si se pueden ordenar los valores en el campo. |
SourceID |
Text opcional. Contiene el espacio de nombres que define el campo, por ejemplo, https://schemas.microsoft.com/sharepoint/v3 o el GUID de la lista en 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 como UTC, la fecha y la hora se trata como Hora universal coordinada (UTC). Para indicar que un valor de fecha y hora hace referencia a tiempo "abstracto", lo que significa que la fecha y la hora se almacenan en la base de datos tal y como la escribe el usuario sin conversión o almacenamiento de la zona horaria local, omita el atributo StorageTZ. |
StripWS |
Boolean opcional. TRUE si se quita el espacio en blanco al principio y al 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 se establece como TRUE, el campo sólo puede contener valores Text. |
Title |
Text opcional. Contiene el título del campo que se muestra en la interfaz de usuario. |
Type |
Text obligatorio. El tipo de datos del campo (a menos que el elemento Field sea secundario de ProjectedFields).
Nota
En la versión de la vista previa técnica de Microsoft SharePoint Foundation 2010, el atributo Type tiene un significado distinto y solo un valor posible ("Lookup") cuando es elemento secundario de ProjectedFields. Vea Elemento ProjectedFields (View) para obtener más información acerca de este uso de Type.
SharePoint Foundation incluye los siguientes tipos de datos de manera predeterminada:
|
UniqueId |
Text opcional. No pensado para utilizarlo directamente desde el código. |
UnlimitedLengthInDocumentLibrary |
Boolean opcional. TRUE para permitir una longitud de campo ilimitada en las bibliotecas de documentos. |
URLEncode |
Boolean opcional. TRUE para convertir caracteres especiales, como espacios, al formato UTF-8 con comillas; por ejemplo, %c3%ab para el carácter ë. |
URLEncodeAsURL |
Boolean opcional. Igual que URLEncode, pero TRUE para especificar que la cadena que se va a codificar es un componente de la ruta de una dirección URL para que no se codifiquen las barras diagonales ("/"). |
UserSelectionMode |
Text opcional. Especifica si se pueden seleccionar sólo los nombres de usuarios individuales en un campo de usuario de un formulario de elementos, o si se pueden seleccionar los nombres de los individuos y grupos. Los valores siguientes son posibles: 0 - Solamente se pueden seleccionar los nombres de las personas. 1 - Se pueden seleccionar tanto los nombres de las personas como los de los grupos. |
UserSelectionScope |
Integer opcional. Especifica un ámbito para seleccionar los nombres de usuario en un campo de usuario de un formulario de elementos. Si el valor es 0, no hay ninguna restricción a un grupo de SharePoint. Si el valor es mayor que 0, la selección del usuario está restringida a los miembros del grupo cuyo identificador es igual al valor que se especifica de SharePoint. |
Version |
Text opcional. |
Viewable |
Boolean opcional. TRUE para especificar que el campo se agrega 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 Información del usuario. |
WikiLinking |
Boolean opcional. TRUE para especificar que vínculos wiki, que aparecen como corchetes dobles ([[…]]), se traducen en vínculos HTML, que utilizan la etiqueta <a>. |
XName |
Text opcional. Se usa internamente en formularios XML para identificar campos que se han agregado, eliminado o modificado. Este atributo no es de uso público. |
Elementos secundarios
CHOICES, Customization, Default, DefaultFormula, DisplayBidiPattern, DisplayPattern, FieldRefs, Formula, FormulaDisplayNames, MAPPINGS, Validation |
Elementos primarios
Repeticiones
Mínimo: 0 Máximo: sin límite 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 va a consultar y el número de campos que ya están en la lista. |
Comentarios
Para crear una definición de campos personalizados para una definición de lista que está basada en un tipo de campo predeterminado SharePoint Foundation, use el elementoField (List - Definition) dentro de un archivo Schema.xml. Para crear una definición de campos personalizados como una característica conectable que se basa en un tipo de campo predeterminado y que puede volver a usarse a través de sitios web y las listas dentro de una colección de sitios, use el elemento Campo (Campo) 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, use 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. Use 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 manera 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. (El atributo Type de un campo no puede modificarse).
Se puede usar <Property Select="DisplayName"/> para visualizar el nombre para mostrar definido por el usuario de un campo.
Dentro de una enumeración de elementos de Fields, se puede omitir el atributo Name. Para algunas referencias de campo, se puede tener acceso a los datos sin procesar almacenados para el campo mediante <Column/>.
Algunas propiedades de los 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"/> or <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 modificar 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 siguiente ejemplo se usa el elemento Field para especificar las opciones de una lista denominada Area list (lista de área).
<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>
Vea también
Referencia
Elemento Field (Tipos de campo)
Elemento Field (esquema de propiedades de tipos de campos)
Elemento Field (DeploymentManifest - DeploymentFieldTemplate)
Elemento Field (DeploymentManifest - FieldDataCollection)