Elemento Field (Tipos de campo)

Artículo
09/24/2014

Última modificación: viernes, 09 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios

Representa una característica del tipo de campo.

<Field
  Name="Text">
</Field>

Atributos

Atributo	Descripción
Name	Text obligatorio. Una cadena que representa el nombre del aspecto específico del tipo de campo que representa el elemento Field. El valor debe ser una cadena de las que se enumeran en la tabla siguiente.

Elementos secundarios

Ninguno

Elementos primarios

Elemento FieldType (Tipos de campo)

Comentarios

Los elementos secundarios de campo de los elementos FieldType se configuran en archivos fldtypes*.xml en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML.

Cada elemento FieldType tiene varios elementos Field obligatorios y opcionales distinguidos por su atributo Name. En la tabla siguiente se describen estos elementos. En el modelo de objetos de , un tipo de campo lo representa la clase SPFieldTypeDefinition. Esta clase tiene una propiedad de sólo-lectura que corresponde a todas las filas de la tabla salvo a dos (las excepciones son InternalType y SQLType). Salvo que se indique lo contrario, los nombres de las propiedades coinciden con el valor del atributo Name correspondiente.

Valor del atributo Name del elemento campo	Descripción
AllowBaseTypeRendering	Boolean opcional. El valor predeterminado es FALSE. Especifica si una aplicación cliente representa el campo como su tipo base (también llamado ParentType), si la aplicación cliente no puede determinar la forma de procesar correctamente el tipo de campo personalizado. Si se establece en TRUE y la aplicación cliente no puede representar correctamente el tipo de campo personalizado, lo representa como el tipo de campo primario de SharePoint Foundation predeterminado del que hereda.
CAMLRendering	Opcional Boolean. El valor predeterminado es FALSE. Especifica si el campo se representa en vistas de lista con marcado CAML en un elemento RenderPattern en otra parte del elemento primario FieldType. El valor predeterminado FALSE significa que el campo se representa en vistas de lista mediante una transformación XSL en un archivo fldtypes*.xsl, que es el sistema estándar para la representación de campos en vistas de lista. (Sin embargo, el elemento no tiene efecto en la representación de campos en los formularios de presentación, edición y creación. Un elemento RenderPattern seguiría siendo la forma estándar para representar el campo en un formulario de presentación).
FieldTypeClass	String opcional, pero obligatoria para todos los tipos de campos personalizados. Representa el nombre seguro de la biblioteca de clases del tipo de campo. "FieldTypeClass" incluye el nombre de la clase y del ensamblado con Version, Culture y PublicKeyToken, por ejemplo, <Field Name="FieldTypeClass">CustomFieldTypes.RegularExpression.RegularExpressionField, CustomFieldTypes.RegularExpression, Version=1.0.0.0, Culture=neutral, PublicKeyToken=57e55365ec0ce80a</Field> (Sólo se incluye el nombre completo de clase para los tipos de campos integrados en SharePoint Foundation).
FieldEditorUserControl		String opcional. Representa la ruta de acceso relativa de un archivo field_typeFieldEditor.ascx que define un control que aparece, en SharePoint Foundation, en la sección Configuración de columna adicional de la página Nueva columna de sitio. El control permite establecer, con cualquier columna, las propiedades de la variable del tipo de campo. Por ejemplo, "/_controltemplates/RegularExpressionFieldEditor.ascx". Si no hay ningún elemento <Field Name="FieldEditorUserControl">, las propiedades especiales del tipo de campo las representa el elemento Elemento PropertySchema (Tipos de campo). FieldEditorUserControl debe ser una cadena fija, no localizable.
Filterable		Boolean obligatorio. Representa si una lista que se basa en este tipo de campo puede filtrarse según el valor de la columna que usa este tipo. Si se establece en TRUE, el encabezado de la columna es un control que los usuarios pueden usar para filtrar la lista.
InternalType	String opcional. Representa un tipo base interno. No use un elemento <Field Name="InternalType"> en las definiciones de tipo de campo personalizadas.
ParentType	String obligatorio (pero puede ser una cadena vacía). Representa el nombre del tipo del que se deriva la clase de campo. Los valores posibles son exactamente los mismos que los valores posibles para el atributo Type del elemento Elemento Field (List). Si el tipo de campo no deriva de otro tipo, entonces el valor es una cadena vacía: Elemento <Field Name="ParentType"></Field>. Nunca debe estar vacío en los tipos de campos personalizados. Todos los tipos personalizados heredan de otro tipo. En el modelo de objetos de SharePoint Foundation, ParentType se denomina BaseRenderingTypeName.
ShowOnListAuthoringPages	Boolean opcional. El valor predeterminado es TRUE. Representa si este tipo de campo se muestra para su inclusión en listas. Si se establece en TRUE, SharePoint Foundation muestra este tipo de campo en las páginas de creación de listas de modo que los usuarios puedan incluirlo en sus listas. En el modelo de objetos de SharePoint Foundation, ShowOnListAuthoringPages se denomina ShowOnListCreate.
ShowOnDocumentLibraryAuthoringPages	Boolean opcional. El valor predeterminado es TRUE. Representa si este tipo de campo se muestra para su inclusión en las bibliotecas de documentos. Si se establece en TRUE, SharePoint Foundation muestra este tipo de campo en las páginas de creación de bibliotecas de documentos de modo que los usuarios puedan incluir el tipo de campo en sus bibliotecas de documentos. En el modelo de objetos de SharePoint Foundation, ShowOnDocumentLibraryAuthoringPages se denomina ShowOnDocumentLibraryCreate.
ShowOnSurveyAuthoringPages	Boolean opcional. El valor predeterminado es TRUE. Representa si este tipo de campo se muestra para su inclusión en encuestas. Si se establece en TRUE, SharePoint Foundation muestra este tipo de campo en las páginas de creación de encuestas de modo que los usuarios puedan incluirlo en sus encuestas. En el modelo de objetos de SharePoint Foundation, ShowOnSurveyAuthoringPages se denomina ShowOnSurveyCreate.
ShowOnColumnTemplateAuthoringPages	Boolean opcional. El valor predeterminado es TRUE. Representa si este tipo de campo debe mostrarse como un tipo de campo de plantilla de columna. Si se establece en TRUE, SharePoint Foundation muestra este tipo de campo en las páginas de creación de plantillas, de modo que los usuarios puedan crear una plantilla de columna de este tipo de campo. En el modelo de objetos de SharePoint Foundation, ShowOnColumnTemplateAuthoringPages se denomina ShowOnColumnTemplateCreate.
SQLType	String opcional. Representa el tipo de datos de SQL que se usará para almacenar los datos en la base de datos de contenido. No use un <Field Name="SQLType"> en las definiciones de tipo de campo personalizadas.
Sortable	Boolean obligatorio. Representa si una lista con una columna que se basa en una este tipo de campo puede ordenarse según la columna que usa este tipo. Si se establece en TRUE, el encabezado de la columna es un control que los usuarios pueden usar para ordenar la lista.
TypeDisplayName	String obligatorio. Representa el nombre para mostrar del tipo de campo en la interfaz de usuario. En SharePoint Foundation, aparece en la columna Tipo en la página Personalizar [lista] (listedit.aspx). También se utiliza en lugar de "TypeShortDescription" si el último no está presente. "TypeDisplayName" debe ser una cadena localizable.
TypeName	String obligatorio. Representa el nombre del tipo de campo. Debe ser único entre todos los nombres de tipo de campo en el conjunto de servidores de SharePoint. "TypeName" debe ser una cadena fija, no localizable.
TypeShortDescription	String opcional. Representa la descripción breve del tipo de campo que se muestra en la interfaz de usuario. En SharePoint Foundation aparece con un botón de opción en la sección Nombre y tipo de las páginas Nueva columna de sitio y Crear columna, y en la columna Tipo de la Galería de columnas de sitio. Si no hay elemento <Field Name="TypeShortDescription">, se utiliza "TypeDisplayName". "TypeDisplayName" debe ser una cadena localizable.
UserCreatable	Boolean opcional. El valor predeterminado es TRUE, lo que permite a los usuarios agregar campos de este tipo a las listas. Establecer el valor en FALSE permite el uso del tipo de campo en los esquemas de lista, pero oculta el tipo de campo de la sección Nombre y tipo de las páginas Nueva columna de sitio y Crear columna.

Ejemplo

El ejemplo siguiente define un tipo de campo personalizado.

Importante
RenderPattern es obsoleto. Se muestra aquí únicamente para ayudar en la depuración de los campos personalizados que se desarrollaron originalmente con versiones anteriores de SharePoint Foundation.

  <FieldType>
    <Field Name="TypeName">SocialSecurityNumber</Field>
    <Field Name="ParentType">Text</Field>
    <Field Name="TypeDisplayName">Social Security Number</Field>
    <Field Name="TypeShortDescription">Social Security Number (123456789, 123-45-6789)</Field>
    <Field Name="AllowBaseTypeRendering">TRUE</Field>
    <Field Name="FieldTypeClass">
      AdventureWorks.FieldTypes.SPFieldSSN, AdventureWorks.FieldTypes.SPFieldSSN,
      Version=1.0.0.0,Culture=neutral,PublicKeyToken=90734cc53324b79c
    </Field>
    <RenderPattern Name="DisplayPattern">
        <Column HTMLEncode="TRUE" /> 
        <Column HTMLEncode="TRUE" UseRelatedField="TRUE"/> 
    </RenderPattern>
  </FieldType>