Elemento Field (tipos de campo)
Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Representa una característica del tipo de campo.
<Field Name="Text"></Field>
Elementos y atributos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
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 de las cadenas enumeradas en la tabla en Comentarios. |
Elementos secundarios
Ninguno
Elementos principales
Comentarios
Los elementos secundarios field de los elementos FieldType se configuran en fldtypes*.xml archivos en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\XML.
Cada elemento FieldType tiene varios elementos Field obligatorios y opcionales que se distinguen por su atributo Name . En la tabla siguiente se describen estos elementos. En el modelo de objetos, un tipo de campo se representa mediante la clase SPFieldTypeDefinition . Esta última clase tiene una propiedad de solo lectura correspondiente a todas las filas de la tabla excepto a dos (las excepciones son InternalType y SQLType). Excepto donde se indique lo contrario, los nombres de propiedad coinciden con el valor del atributo Name correspondiente.
Valor del atributo del Name elemento Field |
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 denominado ParentType), si la aplicación cliente no puede determinar cómo representar 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, la aplicación cliente representa el campo como el tipo de campo primario predeterminado de SharePoint Foundation del que hereda. |
| CAMLRendering | Boolean opcional. El valor predeterminado es FALSE. Especifica si el campo se representa en vistas de lista mediante el marcado CAML en un elemento RenderPattern en otro lugar dentro del elemento FieldType primario. 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, este elemento no tiene ningún efecto en la representación de campos en los formularios Mostrar, Nuevo y Editar. Un RenderPattern seguiría siendo la forma estándar de representar el campo en un formulario de presentación). |
| FieldTypeClass | Cadena opcional, pero necesaria para todos los tipos de campo personalizados. Representa el nombre seguro de la biblioteca de clases del tipo de campo. FieldTypeClass incluye el nombre de clase y el nombre 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>Solo se incluye el nombre de clase completo para los tipos de campo integrados en SharePoint Foundation. |
| FieldEditorUserControl | String opcional. Representa la ruta de acceso relativa a un archivo FieldEditor.ascx de field_type 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 <Field Name="FieldEditorUserControl"> elemento, las propiedades especiales del tipo de campo se representan mediante el 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 de base interno. No use un <Field Name="InternalType"> elemento 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 Field (List). Si el tipo de campo no se deriva de otro tipo, el valor es una cadena vacía:<Field Name="ParentType"> </Field>. Nunca debe estar vacío en los tipos de campo 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 para que los usuarios puedan incluir el tipo de campo 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 para 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 para que los usuarios puedan incluir el tipo de campo 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 columna para que los usuarios puedan seleccionar 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 SQL que se usa para almacenar los datos en la base de datos de contenido. No use un <Field Name="SQLType"> elemento en las definiciones de tipo de campo personalizadas. |
| Se puede ordenar | 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 requerida. Representa el nombre para mostrar del tipo de campo en la interfaz de usuario. En SharePoint Foundation, aparece en la columna Tipo de la página Personalizar [lista] (listedit.aspx). También se usa en lugar de TypeShortDescription si este último no está presente. TypeDisplayName debe ser una cadena localizable. |
| TypeName | String requerida. 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 y 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 radio 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 del sitio. Si no hay ningún <Field Name="TypeShortDescription"> elemento, se usa TypeDisplayName .TypeShortDescription debe ser una cadena localizable. |
| UserCreatable | Boolean opcional. El valor predeterminado es TRUE, que permite a los usuarios agregar campos de este tipo de campo a listas. Establecer el valor en FALSE permite el uso del tipo de campo en los esquemas de lista, pero oculta el tipo de campo a los usuarios en 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 está obsoleto. Se muestra aquí únicamente para ayudar en la depuración de campos personalizados que se desarrollaron originalmente en 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>