Elemento PropertySchema (tipos de campo)
Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Representa el esquema de ciertas propiedades variables especiales de un tipo de campo personalizado, con cada propiedad definida como un elemento Field.
<PropertySchema>
</PropertySchema>
Importante
En este tema se describe el marcado que se usó en un método obsoleto de representación de propiedades de tipo de campo personalizadas. Se proporciona únicamente para ayudar con la depuración de propiedades de tipo de campo personalizadas desarrolladas en versiones anteriores de SharePoint Foundation. Para obtener información sobre el método recomendado, vea Custom Field Type Property Rendering.
Elementos y atributos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
Ninguno
Elementos secundarios
Elementos principales
Comentarios
Los tipos de campos personalizados pueden tener propiedades especiales cuyo valor variará de una columna basada en el tipo de campo a otra columna basada en el mismo tipo de campo. Considere la posibilidad de usar un tipo de campo de expresión regular personalizado diseñado para contener valores string que coincidan con una expresión regular determinada, como ^(\d{3})\d{3}-\d{4}$ para números de teléfono estadounidenses.
En lugar de crear tipos de campo de expresión regular personalizados independientes para números de matrícula británicos, números de seguridad social estadounidenses, números de teléfono chinos, etc., es más eficaz crear un único tipo de campo de expresión regular y permitir que los usuarios que crean columnas basadas en el tipo de campo establezcan la expresión regular que debe coincidir columna por columna. Por ejemplo, un usuario que cree una columna "Número de teléfono de EE.UU." establecería la expresión regular de la columna a la cadena anterior. Otro usuario, al crear una columna "Cuadro de publicación brasileño", establecería la expresión regular de su columna en ^\d{5}\-\d{3}$.
Para ello, el campo personalizado necesita una propiedad RegularExpression que se represente en un control editable en la interfaz de usuario cuando se crea una nueva columna. En SharePoint Foundation, se encuentra en la sección Configuración de columna adicional de la página Nueva columna de sitio y en la página Crear columna . El elemento PropertySchema del fldtypes*.xml archivo es donde se declaran estas propiedades de variable y se le asigna un esquema de representación predeterminado. Opcionalmente, pueden también proporcionar valores predeterminados.
Nota:
Si define las propiedades de variable del tipo de campo personalizado en el elemento PropertySchema , SharePoint Foundation representa automáticamente esas propiedades en función del esquema.
Ejemplo
En el ejemplo siguiente se define un esquema de propiedad para un tipo de campo personalizado denominado RegularExpressionMatch. El esquema declara un campo que pueden usar los creadores de las columnas al basar una columna en el tipo de campo. La finalidad del campo es permitir al creador de las columnas establecer una expresión regular diferente para cada columna basada en el tipo de campo RegularExpressionMatch.
El displayname y un campo de texto editable aparecerán en la sección Configuración de columna adicional en la página Nueva columna de sitio y en la página Crear columna . El atributo MaxLength establece la longitud máxima, en caracteres, de la expresión regular y DisplaySize establece el tamaño del campo que lo contiene. Los usuarios pueden desplazarse por el campo para ver el resto de la expresión regular si tiene una longitud superior a la mostrada en el campo DisplaySize.
No se ha establecido ningún valor predeterminado en este ejemplo, pero si el desarrollador del tipo de campo sabía que, en la mayoría de los casos, se usaría para crear columnas que contengan números de teléfono estadounidenses, el desarrollador podría establecer el valor predeterminado como <Default>^(\d{3})\d{3}-\d{4}$</Default>.
El ejemplo de código siguiente se ha editado para mayor claridad.
<FieldType>
<Field Name="TypeName">RegularExpressionMatch</Field>
…
<PropertySchema>
<Fields>
<Field Name="RegularExpression"
DisplayName="Regular Expression To Match"
MaxLength="500"
DisplaySize="100"
Type="Text">
<Default></Default>
</Field>
</Fields>
</PropertySchema>
…
</FieldType>