Elemento RenderPattern (tipos de campo)
Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Importante
En este tema se describe el marcado que se usó en un método ahora obsoleto para representar tipos de campos personalizados en vistas de lista y en los formularios Mostrar, Editar y Nuevo. Se proporciona únicamente para ayudar a las personas que depuran un tipo de campo personalizado que se desarrolló originalmente en una versión anterior de SharePoint Foundation. Para obtener información sobre los métodos recomendados, vea Plantillas y patrones derepresentación de campos personalizados.
Los campos personalizados cuya representación se define con el marcado RenderPattern todavía se representan correctamente en formularios. Sin embargo, SharePoint Foundation, de forma predeterminada, usa hojas de estilos XSLT para representar campos en vistas de lista, incluso para campos personalizados heredados cuya representación de vista de lista se define con un RenderPattern. Para habilitar la representación de este tipo de campo, se debe agregar un <Field Name="CAMLRendering">TRUE</Field> elemento al elemento FieldTypes contenedor en el archivo de definición de tipo de campo (fldtype*.xml).
RenderPattern define el lenguaje de marcado de aplicaciones de colaboración (CAML), HTML y script reales que SharePoint Foundation puede usar para representar el tipo de campo en la interfaz de usuario. Además, en las vistas de listas, este elemento representa los encabezados de columna en función del tipo de campo seleccionado.
<RenderPattern Name="Text">
</RenderPattern>
Elementos y atributos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
| Name |
String requerida. Representa el nombre del patrón de representación que se define en este elemento RenderPattern. Los valores admitidos son: - HeaderPattern. Define la representación del encabezado de columna en las páginas de vista de lista cuando la representación CAML está activada (incluido <Field Name="CAMLRendering">TRUE</Field> en el elemento FieldTypes que contiene el fldtypes*.xml archivo).- DisplayPattern. Define la representación del campo para el formulario Mostrar (elemento de lista). Cuando la representación CAML está activada (incluyendo <Field Name="CAMLRendering">TRUE</Field> en el elemento FieldTypes contenedor del fldtypes*.xml archivo), DisplayPattern también define la representación del campo en las páginas de vista de lista.- EditPattern. Define la representación del campo para el formulario Editar (elemento de lista). - NewPattern. Define la representación del campo para el formulario Nuevo (elemento de lista). - PreviewDisplayPattern. Define, para su uso en un diseñador de sitios WYSIWYG ("lo que ves es lo que obtienes"), como SharePoint Designer, una vista previa de cómo se verá el campo en modo de visualización mediante datos ficticios. - PreviewEditPattern. Define, para su uso en un diseñador de sitios WYSIWYG como SharePoint Designer, una vista previa de cómo se verá el campo en modo de edición mediante datos ficticios. - PreviewNewPattern. Define, para su uso en un diseñador de sitios WYSIWYG como SharePoint Designer, una vista previa de cómo se verá el campo en el modo Nuevo mediante datos ficticios. |
Elementos secundarios
Ninguno definido explícitamente, pero este elemento es un contenedor de marcado CAML del esquema view.
Elementos principales
Comentarios
Herencia de RenderPatterns
Si no se proporciona un RenderPattern con un valor Name determinado para un tipo de campo, el tipo de campo hereda el RenderPattern con el nombre de su tipo de campo principal.
HeaderPattern
Si la representación CAML está habilitada, el tipo de campo debe tener un tipo HeaderPattern del elemento RenderPattern , ya sea directamente o por herencia, o el encabezado de columna del campo en las vistas de lista no se representa. El marcado de headerPattern puede ser bastante sencillo cuando el tipo de campo no se puede ordenar ni filtrar. Sin embargo, si el tipo de campo se puede ordenar o filtrar, el marcado puede ser bastante complejo porque el encabezado no solo sirve como título de la columna, sino también como un control de menú desplegable para ordenar y filtrar. Además, dado que la capacidad de ordenación y filtrado se puede deshabilitar para columnas concretas (incluso cuando el tipo de campo en el que se basa la columna las admite), el marcado debe usar elementos Switch para probar si la ordenación o el filtrado están habilitados para la columna. Para obtener ejemplos, vea %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\XML\FLDTYPES.XML.
DisplayPattern
Si la representación CAML está habilitada, un tipo de campo debe tener un tipo DisplayPattern del elemento RenderPattern (por herencia, si no directamente) para que el campo se pueda representar en vistas de lista. Esto no es necesario para representar el campo en modo de visualización, como en la página Mostrar (elemento de lista), ya que un campo también se puede representar en modo de presentación mediante un control de representación (archivo .ascx). Ninguno de los tipos de campo heredados que se incluyen con SharePoint Foundation usan un control de representación en lugar de un tipo DisplayPattern del elemento RenderPattern para representar el campo en modo de presentación.
El tipo DisplayPattern de RenderPattern también se puede usar para representar el campo en cada fila de una vista de lista. De forma predeterminada, SharePoint Foundation usa el marcado XSLT en un fldtypes*.xsl archivo ubicado en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\XSL para representar campos en vistas de lista. Pero el fldtypes*.xml archivo de %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\XML se comprueba para la presencia de <Field Name="CAMLRendering">TRUE</Field> en el elemento FieldTypes contenedor para el campo. Si está presente, displayPattern se usa para representar el campo en vistas de lista.
Nota:
Dos tipos de campos heredados que se incluyen con SharePoint Foundation no tienen un tipo DisplayPattern de RenderPattern en FLDTYPES.XML: (1) Los campos ContentTypeId nunca son visibles. (2) los campos Computed se representan en las vistas de listas y en modo de presentación mediante un elemento DisplayPattern en los elementos Field dentro del archivo schema.xml de cada lista donde aparecen.
NewPattern y EditPattern
Los tipos NewPattern y EditPattern de RenderPattern se usaron para representar un campo en modo Nuevo y Modo de edición, respectivamente, cuando el campo no requería un procesamiento de datos significativo ni validación de datos cuando se creaba o editaba un elemento de lista que contenía el campo. Los campos de notas de formato libre, por ejemplo, no se pueden validar porque cualquier texto es un valor válido. De modo parecido, los campos de selección y de búsqueda, por definición, limitan las opciones del usuario sólo a valores válidos. Otros campos, como la moneda y fecha y hora, sólo necesitan una validación mínima que se puede asignar mediante una secuencia de comandos.
Para obtener ejemplos de los tipos NewPattern y EditPattern de RenderPatterns, vea %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\XML\FLDTYPES.XML.
RenderPatterns para tipos de campo personalizados derivados de varias columnas
En el marcado RenderPattern de un campo MultiColumn personalizado, el atributo SubcolumnNumber de un elemento Column se usa para especificar una columna individual en un tipo de campo multicolumna. Para obtener más información acerca de los tipos de campo de varias columnas, consulte Custom Multicolumn Field Classes.
Ejemplo
En el siguiente ejemplo se define un modelo de representación de presentación para un tipo de campo personalizado que se hereda del tipo de varias columnas. El campo se usa para almacenar direcciones de EE.UU. La primera subcolumna almacena la dirección de la calle seguida de un salto de línea HTML. La siguiente subcolumna almacena el nombre de la ciudad seguido de una coma y un espacio. En la tercera subcolumna se almacena el estado y, seguido de un espacio, la última subcolumna almacena el código postal.
<RenderPattern Name="DisplayPattern">
<Switch>
<Expr><Column/></Expr>
<Case Value="">
</Case>
<Default>
<Column SubColumnNumber="0" HTMLEncode="TRUE"/>
<HTML><![CDATA[<BR>]]></HTML>
<Column SubColumnNumber="1" HTMLEncode="TRUE"/>
<HTML><![CDATA[, &nbsp;]]></HTML>
<Column SubColumnNumber="2" HTMLEncode="TRUE"/>
<HTML><![CDATA[ &nbsp;]]></HTML>
<Column SubColumnNumber="3" HTMLEncode="TRUE"/>
</Default>
</Switch>
</RenderPattern>