Definições de coluna

As tabelas incluem uma coleção de colunas que representam os dados que podem ser incluídos em cada registro. Os desenvolvedores precisam entender os diferentes tipos de colunas e como trabalhar com elas.

Nomes de colunas

Assim como as tabelas, cada coluna tem um nome exclusivo definido quando é criada. Esse nome é apresentado de várias maneiras:

Quando você cria uma coluna personalizada, o nome escolhido é precedido pelo prefixo de personalização do editor de solução associado à solução na qual a coluna foi criada.

Você não pode alterar os nomes de uma coluna depois que ela é criada.

Cada coluna também tem duas propriedades que podem exibir valores localizados. Os valores dessas propriedades são usados para se referir às colunas em um aplicativo.

Esses são valores localizáveis que são usados para se referir às colunas em um aplicativo. Esses valores podem ser alterados a qualquer momento. Para adicionar ou editar valores localizados , consulte Traduzir texto de tabela, formulário e coluna personalizados em outros idiomas.

Tipos de coluna

A AttributeTypeName propriedade descreve o tipo de uma coluna. Essa propriedade contém um valor de tipo AttributeTypeDisplayName, que fornece um rótulo para cada um dos diferentes tipos de colunas existentes.

Na tabela a seguir:

• Esses tipos são agrupados por categoria para comparação.
• Para cada AttributeTypeDisplayName valor, a classe derivada do assembly AttributeMetadata .NET correspondente é incluída quando disponível. Não há uma relação 1:1 entre esses tipos e o AttributeTypeDisplayName rótulo.
• Esses tipos de coluna que podem ser criados como colunas personalizadas incluem o rótulo correspondente exibido na interface do usuário.

Operações suportadas e uso de formulários para colunas

Cada coluna inclui propriedades boolianas que descrevem os tipos de operações em que ela pode participar e como ela pode estar em um formulário.

Se você tentar definir um valor em uma operação de criação ou atualização para uma coluna que não seja válida para essa operação, o valor será ignorado. Se você tentar recuperar uma coluna que não é válida para leitura, um valor nulo será retornado.

Nível de requisito de coluna

A RequiredLevel propriedade é uma propriedade gerenciada booliana que descreve se um valor de coluna é necessário.

Essa propriedade pode ter os seguintes valores definidos:

O Dataverse impõe apenas a opção SystemRequired para colunas criadas pelo sistema. Colunas personalizadas não podem ser definidas para usar a opção SystemRequired . O Dataverse não retorna um erro quando uma coluna com ApplicationRequired aplicado não tem um valor.

Aplicativos controlados por modelo impõem a opção ApplicationRequired e usam uma apresentação diferente para a opção Recommended . Os criadores de clientes personalizados podem usar essas informações para exigir opções de validação ou apresentação semelhantes.

Como RequiredLevel é uma propriedade gerenciada, enquanto editor de uma solução gerenciada, você pode decidir se os consumidores da sua solução são capazes de alterar essas configurações nas colunas da sua solução.

Mais informações: Propriedades Gerenciadas

Colunas especializadas

Fórmulas, agregações e colunas de cálculo liberam o usuário de realizar cálculos manualmente, permitindo que se concentre em seu trabalho. Os administradores do sistema podem definir uma coluna para conter o valor de muitos cálculos comuns sem precisar trabalhar com um desenvolvedor. Os desenvolvedores também podem usar os recursos da plataforma para executar esses cálculos em vez de dentro de seu próprio código.

Uma coluna de prompt é um tipo de dado alimentado por IA no Microsoft Dataverse que permite definir prompts de linguagem natural vinculados a outras colunas na tabela.

Mais informações:

• Definir colunas de rollup que agreguem valores
• Definir colunas calculadas para automatizar cálculos
• Colunas de prompt (versão prévia)
• Colunas especializadas usando código

Formato de coluna

Os valores de formato da coluna controlam como ela é exibida em aplicativos controlados por modelos. O desenvolvedor de aplicativos personalizados pode usar essas informações para criar experiências semelhantes.

Formatos inteiros

, Use a propriedade Format com colunas inteiras para exibir experiências alternativas para este tipo.

Formatos de cadeia de caracteres

Use a FormatName propriedade com colunas de texto para definir valores a partir do StringFormatName para controlar como a coluna de texto é formatada.

Formatos de data e hora

A DateTimeBehavior propriedade controla o comportamento das colunas Data e Hora. Existem três opções:

Use a propriedade Format para controlar como o valor deve ser exibido em um aplicativo controlado por modelo, independentemente do DateTimeBehavior.

Mais informações: Comportamento e formato da coluna de data e hora

Colunas de numeração automática

Você pode adicionar uma coluna de número automático para qualquer tabela. Atualmente, você pode adicionar a coluna programaticamente. Não há nenhuma interface do usuário para adicionar esse tipo de coluna. Mais informações: Criar colunas de numeração automática

Opção

As colunas que exibem um conjunto de opções podem referenciar um conjunto de opções definido pela coluna ou podem referenciar um conjunto separado de opções que podem ser compartilhadas por mais de uma coluna. Isso é útil quando os valores em uma coluna também se aplicam a outras colunas. Ao referenciar um conjunto comum de opções, as opções podem ser mantidas em um só lugar. Essas opções que podem ser compartilhadas são escolhas globais. Aqueles definidos na coluna são de opção local .

Recuperar dados de opções

O SDK para .NET fornece classes de solicitação que você pode usar para recuperar as opções usadas por uma coluna.

Usar o SDK para .NET para recuperar opções

Cada uma das colunas com opções que herdam de EnumAttributeMetadata inclui uma Propriedade OptionSet. Esta propriedade contém o OptionSetMetadata que inclui as opções dentro da propriedade Options.

Com o SDK para .NET, você pode usar as seguintes classes de solicitação para recuperar informações sobre a escolha:

Mais informações:

• Criar e editar a visão geral das opções globais
• Exemplo: Exportar opções/informações de lista de opções para um arquivo
• Personalizar opções

Usar a API Web para recuperar valores de escolha

A API Web fornece um estilo RESTful para consultar valores de escolha. Você pode recuperar a opção local ou global recuperando a coluna dentro de uma tabela. O exemplo a seguir retorna o OptionSetMetadata correspondente à escolha incluída na propriedade Account.AccountCategoryCode.

GET <organization url>/api/data/v9.2/EntityDefinitions(LogicalName='account')/Attributes(LogicalName='accountcategorycode')/Microsoft.Dynamics.CRM.PicklistAttributeMetadata?$select=LogicalName&$expand=OptionSet

Com a API Web, você também pode usar a função RetrieveMetadataChanges.

Mais informações: Consultar definições de tabela usando a API da Web para recuperar atributos>

Mapeamento de coluna

Ao criar um novo registro de tabela no contexto de um registro de tabela existente, você pode transferir automaticamente determinados valores do registro de tabela existente como valores padrão para o novo registro de tabela. Isso simplifica a entrada de dados para pessoas que usam aplicativos controlados por modelos. Os usuários do aplicativo veem os valores mapeados e podem editá-los antes de salvar a entidade.

Para desenvolvedores que criam clientes personalizados, o mesmo comportamento pode ser alcançado usando a InitializeFrom mensagem (classe SDK InitializeFromRequest ou função API Web InitializeFrom) para obter os dados da entidade com os valores padrão configurados definidos.

Mais informações

• Mapear colunas da tabela
• Personalizar mapeamentos de tabela e coluna

Colunas lógicas

As colunas lógicas contêm valores armazenados em tabelas de banco de dados diferentes de outras colunas na tabela. Na maioria dos casos, essa implementação interna não é relevante para trabalhar com o Dataverse. Quando você usa colunas lógicas como fontes para um campo calculado, os valores no campo calculado não podem ser classificados. Use a propriedade AttributeMetadata.IsLogical para detectar se um atributo é um atributo lógico.

Consulte também

Tabelas do Dataverse