Elementos de definición de datos
Última modificación: viernes, 26 de marzo de 2010
Hace referencia a: SharePoint Foundation 2010
El Lenguaje de marcado de la aplicación de colaboración (CAML) tiene dos tipos principales de elementos: elementos para la representación de páginas y elementos para la representación de campos y la definición de esquema. Los elementos de representación de campo de CAML están diseñados para usarse al representar valores de campo individuales. Éstos pueden aparecer en definiciones de tipo de campo o, con mayor frecuencia, en FldTypes.xml en \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XML.
Representación de campos y definición de esquema
Un campo es una columna o un atributo con información que un usuario puede agregar a una lista. Cada lista en un sitio web basado en Microsoft SharePoint Foundation tiene metadatos almacenados en la base de datos. El formato del esquema es una estructura XML, como la siguiente:
<Fields>
<Field Type="Counter" Name="ID"/>
...other field definitions...
</Fields>
Para simplificar la implementación de los distintos tipos de campo y permitir un mayor grado de flexibilidad a la hora de representar los diversos campos, FldTypes.xml incluye información sobre la representación y el comportamiento de cada tipo de campo. El elemento Field representa diferentes elementos HTML en función del tipo de datos del campo en cuestión y FldTypes.xml define los tipos de datos y patrones de representación para cada tipo de campo. La siguiente tabla presenta el esquema usado en este archivo.
Nombre |
Tipo de datos |
Descripción |
---|---|---|
Column2Suffix |
Text |
Contiene texto que se va a anexar al nombre de columna base para derivar ColumnName2 de ColumnName (para campos de dos columnas, como URL). |
DisplayPattern |
Note |
Contiene la plantilla HTML para representar el campo en el modo de presentación de una vista o un formulario. |
EditPattern |
Note |
Contiene la plantilla HTML para generar el control de edición de formulario para editar el campo. |
HeaderPattern |
Note |
Contiene la plantilla HTML para mostrar el encabezado de una columna de vista de tabla. |
InternalType |
Text |
Determina el comportamiento del elemento Column en la representación de datos de la base de datos de SharePoint Foundation y el modo en que los datos se devuelven a la base de datos. Puede ser uno de los siguientes valores: Text, Note, Number, Currency, Integer, Boolean, DateTime, Threading, Lookup, Choice, URL, Counter o DisplayOnly. Tenga en cuenta que los tipos de campo DisplayOnly no tienen almacenamiento propio. |
Name |
Text |
Contiene el nombre del tipo de datos internos según su referencia en un atributo Type del elemento Field: <Field Type="Name"/>. Por ejemplo, Text, Note, Number, etc. |
NewPattern |
Note |
Contiene la plantilla HTML para generar el formulario nuevo y editar el valor inicial de un campo. |
PreviewDisplayPattern |
Note |
Especifica cómo se representan los campos cuando se edita un formulario de presentación en Microsoft SharePoint Designer. |
PreviewEditPattern |
Note |
Especifica cómo se representan los campos cuando se edita un formulario de edición en Microsoft SharePoint Designer. |
PreviewNewPattern |
Note |
Especifica cómo se representan los campos cuando se edita un nuevo formulario en Microsoft SharePoint Designer. |
Sortable |
Text |
Especifica si se puede ordenar un campo. Puede ser TRUE o FALSE. |
TypeName |
Text |
Especifica un nombre en la definición de un tipo de campo. |
SQLType |
Text |
Determina el tipo de datos de SQL subyacente para el campo especificado. Algunos ejemplos son nvarchar(255), memo, integer y float. Se usa para generar el tipo de SQL adecuado (CREATE TABLE) para la creación de un campo de este tipo. |
SQLType2 |
Text |
Cuando no está en blanco, establece el tipo de una columna secundaria que se va a crear para el campo actual (consulte el tipo de campo de dirección URL, por ejemplo). |
Modos de presentación y patrones de presentación
Cada uno de los modos de presentación (Display, Edit y New) contiene una definición de la forma de representar cada uno de los tipos de datos de campo que admite SharePoint Foundation.
Para cada modo de presentación, existe un patrón de presentación o expresión de representación CAML. Algunos elementos CAML se usan específicamente en patrones de presentación. Otros pueden usarse en cualquier contexto, para la representación de páginas o la representación de campos, pero se usan principalmente en campos de representación. Los siguientes elementos de representación CAML intrínsecos se emplean para generar plantillas que pueden incluir HTML y datos estáticos, al igual que metadatos del campo que se representa.
Elemento |
Descripción |
---|---|
Devuelve el valor de datos sin procesar para un campo determinado. |
|
Se usa en la representación de un tipo de campo de vínculo. |
|
Se usa para excluir determinados caracteres en las cadenas. |
|
Se usa en las secciones HeaderPattern de FldTypes.xml para mostrar menús desplegables de filtro. |
|
Devuelve el espacio de nombres de Microsoft Office "urn:schemas-microsoft-com:office:office#". |
|
Se usa en los campos calculados para hacer referencia a los campos incluidos y en las vistas para definir los campos que están presentes. |
|
Devuelve la dirección URL del archivo de imagen que se usa para indicar cómo se ordena una columna. |
|
Devuelve la dirección de ordenación en una lista, con la representación Asc o Desc en función de si el campo ha sido ordenado y la dirección de ordenación predeterminada actual para el campo. |
|
Permite obtener una representación condicional basada en la comparación de dos expresiones CAML. |
|
Devuelve TRUE si el elemento se considera nuevo. |
|
Devuelve la ruta de acceso HTTP al directorio de imágenes para el proyecto. |
|
Trunca texto hasta un tamaño especificado. |
|
Transfiere la información de la configuración regional del servidor al cliente para mostrar y editar las fechas y los números correctamente. |
|
Se usa en cualquier lugar para devolver la dirección URL absoluta y codificada de la página actual. |
|
Devuelve la propiedad del contexto ForEach actual. |
|
Se usa para representar texto del servidor que se debe interpretar como una cadena entre comillas. |
|
Representa la fecha y la hora actual en formato ISO. |