Elementos de definição de dados
Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013
A CAML (Linguagem colaborativa de marcação de aplicativo) tem dois tipos principais de elementos: aqueles para renderização de página e aqueles para renderização de campo e definição de esquema. Os elementos de renderização do campo CAML são projetados para uso ao renderizar valores de campo individuais. Elas podem aparecer em definições de tipo de campo ou, mais comumente, em FldTypes.xml em \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XML.
Renderização de campo e definição de esquema
Um campo é uma coluna ou um atributo que contém informações que um usuário pode adicionar a uma lista. Cada lista em um site com base no Microsoft SharePoint Foundation tem metadados armazenados no banco de dados. O formato do esquema é uma estrutura XML, como o seguinte:
<Fields>
<Field Type="Counter" Name="ID"/>
...other field definitions...
</Fields>
Para simplificar a implementação dos vários tipos de campo e permitir um maior grau de flexibilidade na renderização dos vários campos, FldTypes.xml contém informações sobre a renderização e o comportamento de cada tipo de campo. O elemento Field renderiza HTML diferente dependendo do tipo de dados do campo em questão e FldTypes.xml define os tipos de dados e padrões de renderização para cada tipo de campo. A tabela a seguir apresenta o esquema usado neste arquivo.
| Nome | Tipo de dados | Descrição |
|---|---|---|
| Column2Suffix |
Texto |
Contém texto a ser acrescentado ao nome da coluna base para derivar ColumnName2 de ColumnName (para campos de duas colunas, como URL). |
| DisplayPattern |
Observação |
Contém o modelo HTML para renderizar o campo no modo de exibição de uma exibição ou de um formulário. |
| EditPattern |
Observação |
Contém o modelo HTML para gerar o controle Editar formulário para editar o campo. |
| HeaderPattern |
Observação |
Contém o modelo HTML para exibir o título de uma coluna de exibição de tabela. |
| InternalType |
Texto |
Determina o comportamento do elemento Column na renderização de dados do banco de dados do SharePoint Foundation e como os dados são postados de volta no banco de dados. Pode ser um dos seguintes valores: Texto, Observação, Número, Conversor de Moedas, Inteiro, Booleano, DateTime, Threading, Pesquisa, Escolha, URL, Contador ou DisplayOnly. Observe que um tipo de campo DisplayOnly não tem armazenamento próprio. |
| Nome |
Texto |
Contém o nome do tipo de dados interno como referenciado em um atributo Type do elemento Field: <Field Type="Name"/>. Exemplos são Texto, Observação, Número etc. |
| NewPattern |
Observação |
Contém o modelo HTML para gerar o novo formulário para editar o valor inicial de um campo. |
| PreviewDisplayPattern |
Observação |
Especifica como os campos são renderizados quando um formulário de exibição é editado no Microsoft SharePoint Designer. |
| PreviewEditPattern |
Observação |
Especifica como os campos são renderizados quando um formulário de edição é editado no Microsoft SharePoint Designer. |
| PreviewNewPattern |
Observação |
Especifica como os campos são renderizados quando um novo formulário é editado no Microsoft SharePoint Designer. |
| Ordenável |
Texto |
Especifica se um campo pode ser classificado. Pode ser TRUE ou FALSE. |
| TypeName |
Texto |
Especifica um nome na definição de um tipo de campo. |
| Sqltype |
Texto |
Determina o tipo de dados SQL subjacente para o campo determinado. Exemplos são nvarchar(255), memorando, inteiro, float. Usado para gerar o SQL apropriado (CREATE TABLE) para a criação de um campo desse tipo. |
| SQLType2 |
Texto |
Quando não estiver em branco, fornece o tipo de uma coluna secundária a ser criada para o campo atual (consulte Tipo de campo de URL, por exemplo). |
Modos de exibição e padrões de exibição
Cada um dos modos de exibição ( Exibição, Edição e Novo) contém uma definição de como renderizar cada um dos tipos de dados de campo compatíveis com o SharePoint Foundation.
Para cada modo de exibição, há um padrão de exibição ou uma expressão de renderização de CAML. Alguns elementos CAML são usados especificamente em padrões de exibição. Outros podem ser usados em qualquer contexto, para renderização de página ou para renderização de campo, mas são usados principalmente em campos de renderização. Os seguintes elementos intrínsecos de renderização de CAML são usados para criar modelos que podem incluir HTML e dados estáticos, bem como metadados do campo que está sendo renderizado.
| Elemento | Descrição |
|---|---|
| Coluna |
Retorna o valor bruto de dados para um determinado campo. |
| Column2 |
Usado na renderização de um tipo de campo Link. |
| Escapar |
Usado para escapar de determinados caracteres em cadeias de caracteres. |
| FieldFilterOptions |
Usado nas seções HeaderPattern de FldTypes.xml para exibir menus suspensos de filtro. |
| FieldPrefix |
Retorna o namespace do Microsoft Office, urn:schemas-microsoft-com:office:office#. |
| Fieldref |
Usado em campos computados para se referir aos campos constituintes e em exibições para definir quais campos estão presentes. |
| FieldSortImageURL |
Retorna a URL para o arquivo de imagem usado para indicar como uma coluna é classificada. |
| FieldSortParams |
Retorna a direção de classificação em uma lista, renderizando Asc ou Desc com base em se o campo foi classificado e na direção de classificação padrão atual para o campo. |
| IfEqual |
Permite a renderização condicional com base na comparação de duas expressões CAML. |
| IfNew |
Retorna TRUE se o item for considerado novo. |
| ImagesPath |
Retorna o caminho HTTP para o diretório de imagens do projeto. |
| Limite |
Trunca o texto para um tamanho especificado. |
| LocaleInfo |
Transfere informações de localidade do servidor para o cliente para exibir e editar datas e números corretamente. |
| PageUrl |
Usado em qualquer lugar para retornar a URL absoluta e codificada da página atual. |
| Propriedade |
Retorna a propriedade do contexto forEach atual. |
| ScriptQuote |
Usado para renderizar texto do servidor que deve ser interpretado como uma cadeia de caracteres citada. |
| TodayISO |
Renderiza a data e a hora de hoje no formato ISO. |