Elemento FieldRef (ContentType)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Especifica uma coluna a ser referenciada neste tipo de conteúdo.

Definição

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
Agregação	Se você usar o atributo Node para especificar uma expressão XPath que retorna uma coleção de valores, também poderá incluir um atributo de agregação que especifica a ação a ser tomada no conjunto de valores retornado. Essa ação pode ser uma função de agregação ou uma indicação do elemento específico dentro da coleção. Os valores possíveis incluem o seguinte: Soma count Média Min Max Mesclagem plaintext Converte conteúdo de texto de nó em texto sem formatação. primeiro Aplica promoção e rebaixamento de propriedade ao primeiro elemento da coleção. last Aplica promoção e rebaixamento de propriedade ao último elemento da coleção. Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PrimaryPIAttribute e PrimaryPITarget são usados para promoção e rebaixamento de propriedade em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
Personalização	Texto opcional. Uma cadeia de caracteres em CAML (Linguagem colaborativa de marcação de aplicativo) que define propriedades de campo personalizadas.
DefaultValue	Obsoleto.
Descrição	Texto opcional. Fornece a descrição mostrada no formulário de edição de uma lista se uma descrição de coluna for especificada. Por padrão, as colunas no SharePoint Foundation não têm descrições.
DisplayName	Texto obrigatório. O nome exibido para a coluna. O comprimento máximo é de 255 caracteres. O valor desse atributo é usado como um título de coluna quando o campo é exibido em uma exibição de tabela e como um rótulo de formulário quando o campo é exibido em um formulário. Você usa o atributo DisplayName para alterar o nome de exibição para um valor diferente do nome definido no próprio campo.
Format	Texto opcional. Especifica a formatação a ser usada para valores numéricos. Para colunas de data/hora, os seguintes valores são possíveis: DateOnly Somente exibir (e permitir edições para) a parte de data (a parte de hora está definida como 12:00 da manhã para todos os valores editados). DateTime Display e editar data e hora do dia (padrão). ISO8601 Exibir data e hora no formato de hora ISO8601 convertido em UTC: YYYY-MM-DDTHH:MM:SSZ. Esse é o formato usado para propriedades de documento no sistema do Microsoft Office, bem como para o formato de intercâmbio padrão usado no Microsoft SharePoint Foundation entre novos formulários e editar e o servidor. ISO8601Basic Use a forma abreviada de formatos de data/hora 8601: YYYYYMMDDTHHMMSSZ. Este é o formato usado para vCard/iCal. Para campos Choice , esse atributo pode ser definido como Dropdown (padrão), que fornece opções de edição por meio de uma seleção suspensa ou para RadioButtons, que fornece opções por meio de um grupo de botões de rádio. Para campos de URL, esse atributo pode ser definido como Hyperlink (padrão), que exibe a URL como uma marca normal `<A>` ou para Imagem, que exibe a URL como `<IMG SRC="URL" ALT="Description">`.
Filtráveis	Booliano opcional. TRUE para definir a coluna como filtravel.
FilterableNoRecurrence	Booliano opcional. TRUE para definir a coluna como filtravel sem valores recorrentes.
FromBaseType	Booliano opcional. Esse atributo foi preterido em favor do atributo Selado .
Oculto	Booliano opcional. Se TRUE, o campo estará completamente oculto da interface do usuário. Definir ReadOnly como TRUE significa que o campo não é exibido em formulários Novos ou Editar , mas ainda pode ser incluído em exibições. Se você não incluir esse atributo, o SharePoint Foundation tratará a coluna como se o atributo estivesse definido como FALSE.
ID	Texto obrigatório. Especifica a ID do campo da coluna que esse elemento FieldRef faz referência. A ID do campo é a representação de cadeia de caracteres de um GUID, incluindo chaves. O valor é sensível a maiúsculas de minúsculas. Você pode encontrar as IDs para campos internos no arquivo `fieldswss.xml` localizado no seguinte caminho: `%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\fields`
Locked	Obsoleto.
Nome	Texto obrigatório. O nome de uma coluna. Esse é o nome interno de uma coluna e é garantido que nunca será alterado para o tempo de vida da definição do campo. Ele deve ser exclusivo em relação ao conjunto de campos em uma lista.
Nó	Texto opcional. Especifica o nó XML no documento que contém o valor da coluna. Usado para promoção e rebaixamento de propriedades em documentos XML. Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
NumLines	Inteiro opcional. Recomenda o número de linhas (linhas) a serem exibidas em um bloco TEXTAREA durante a edição. Isso é apenas uma dica de interface do usuário do cliente; não há nenhuma limitação imposta no número de linhas de texto que podem ser editadas.
PIAttribute	Texto opcional. Especifica o atributo na instrução de processamento de documento (especificada pelo atributo PITarget ) a ser usado como o valor da coluna. Usado para promoção e rebaixamento de propriedades em documentos XML. Se você especificar o atributo PIAttribute , também deverá especificar o atributo PITarget . Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
Pitarget	Texto opcional. Especifica a instrução de processamento de documento na qual o valor da coluna é armazenado em documentos desse tipo de conteúdo. Usado para promoção e rebaixamento de propriedades em documentos XML. Se você especificar o atributo PIAttribute , também deverá especificar o atributo PITarget . Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
PrimaryPIAttribute	Texto opcional. Especifica um atributo alternativo na instrução de processamento de documento, especificada pelo PrimaryPITarget, para usar como o valor da coluna. Se você especificar o atributo PrimaryPIAttribute , também deverá especificar o atributo PrimaryPITarget . Se especificado, o SharePoint Foundation usará esses valores antes dos especificados nos atributos PITarget e PIAttribute . Usado para promoção e rebaixamento de propriedades em documentos XML. Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
Primarypitarget	Texto opcional. Especifica uma instrução de processamento de documento alternativa na qual o valor da coluna é armazenado para documentos desse tipo de conteúdo. Se você especificar o atributo PrimaryPIAttribute , também deverá especificar o atributo PrimaryPITarget . Se especificado, o SharePoint Foundation usará esses valores antes dos especificados nos atributos PITarget e PIAttribute . Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
ReadOnly	Booliano opcional. Se TRUE, o campo não será exibido em Formulários Novos ou Editar , mas pode ser incluído em exibições. Definir o atributo Oculto como TRUE oculta completamente o campo da interface do usuário. Se você não incluir esse atributo, o SharePoint Foundation tratará a coluna como se o atributo estivesse definido como FALSE.
Required	Booleano obrigatório. Se TRUE, o campo deverá ter valor atribuído a ele antes que um item criado usando esse tipo de conteúdo possa ser salvo. Se um valor de campo vazio for dado em uma postagem de formulário, o texto de campo obrigatório padrão ou uma mensagem explicitamente especificada (ou seja, por meio <de marcas ErrorText> ) será exibido no formulário de erro. Essa validação é tratada somente pelo cliente (o banco de dados sempre permite NULL para todos os campos definidos pelo usuário).
Selado	Booliano opcional. TRUE para definir a coluna como selada. Você não pode editar colunas seladas por meio da interface do usuário ou modelo de objeto do SharePoint Foundation. Se você não incluir esse atributo, o SharePoint Foundation tratará a coluna como se o atributo estivesse definido como FALSE.
ShowInDisplayForm	Booliano opcional. TRUE para exibir a coluna no formulário De exibição para itens desse tipo de conteúdo.
ShowInEditForm	Booliano opcional. TRUE para exibir o campo na página Editar Item.
ShowinFileDlg	Booliano opcional. TRUE para exibir a coluna na caixa de diálogo do arquivo para itens desse tipo de conteúdo.
ShowInListSettings	Booliano opcional. Se FALSE, o campo não aparece em uma enumeração Campos quando o modo de exibição é definido como Novo. Campos com essa configuração não aparecem na página padrão Novo Item para uma determinada lista.
ShowInNewForm	Booliano opcional. TRUE para exibir a coluna no novo formulário para itens desse tipo de conteúdo.
Ordenável	Booliano opcional. TRUE se os valores no campo puderem ser classificados.

Elementos filho

Nenhum

Elementos pai

Elemento FieldRefs (ContentType)

Occurrence

Mínimo: 0
Máximo: sem limite

Comentários

O elemento FieldRef é uma referência a uma coluna definida em outro lugar, no site ou no nível da lista. Na referência de campo, você pode substituir um subconjunto das propriedades da coluna, como o seguinte:

Nome de exibição
Atributos de promoção e rebaixamento XML
Se o campo é somente leitura, necessário ou oculto

Alterar essas propriedades na referência de campo só as altera conforme elas se aplicam ao tipo de conteúdo específico que contém a referência de campo.

Importante

Os atributos ID, Name, DisplayName e Required são sempre necessários, mesmo quando o elemento FieldRef faz referência a um campo definido no mesmo manifesto de elemento.

Exemplo

O exemplo a seguir mostra dois elementos FieldRef especificando colunas a serem incluídas em um tipo de conteúdo.

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

Partilhar via