Tipos de colunas

Os nomes dos tipos dependem do designer que você usa. Power Apps usa uma convenção que inclui a forma como os dados são formatados. O tipo do gerenciador de soluções usa um nome alinhado ao tipo de dados do banco de dados com um modificador de formato.

Para obter uma visão geral rápida dos tipos de dados no Dataverse, assista a este vídeo:

A tabela a seguir inclui o tipo de API AttributeTypeDisplayName correspondente.

Para obter mais descrições de cada tipo que você pode adicionar ou editar, consulte o artigo do designer correspondente:

• Criar e editar colunas para Microsoft Dataverse usando Power Apps portal: tipos de dados de coluna
• Criar e editar colunas para o Dataverse usando Power Apps gerenciador de soluções: tipos de dados de coluna

Para obter mais informações sobre como os tipos de dados de coluna são definidos na API, consulte metadados de atributo.

Tipos de coluna usados pelo sistema

O sistema usa algumas colunas que você não pode adicionar usando o designer.

Colunas de texto

As colunas de texto podem conter caracteres de texto. Esse tipo de coluna tem várias opções de formatação que alteram a apresentação do texto.

Assista a este vídeo para uma visão geral rápida sobre os tipos de coluna de texto:

Há três tipos básicos de colunas de texto. Todos os valores indicados aqui estão em número de caracteres.

Se você reduzir o número máximo de caracteres para a coluna, os dados existentes não serão truncados. O limite se aplica a novas linhas.

Opções

Você pode personalizar formulários (principal, criação rápida e exibição rápida) e modelos de email adicionando colunas multimarcas chamadas Opções. Ao adicionar uma coluna de opções, você pode especificar vários valores que os usuários podem selecionar. Quando os usuários preenchem o formulário, eles podem selecionar um, vários ou todos os valores exibidos em uma lista suspensa.

Por exemplo, se uma organização opera em várias áreas ou países/regiões, você pode incluir vários locais ou países/regiões em uma coluna "Área de operação". Um usuário então poderá selecionar um ou mais locais da lista de valores disponíveis.

Use opções em grades somente leitura, grades editáveis e na maioria dos formulários. Você não pode usar opções de seleção múltipla com:

• Fluxos de trabalho, fluxos do processo empresarial, ações, caixas de diálogo, regras de negócios, gráficos, colunas cumulativas ou colunas calculadas.
• Relatórios, SLA¹ e regras de roteamento¹.

¹A tabela requer o Dynamics 365 Customer Service.

Forms

Os seguintes tipos de formulários oferecem suporte a colunas de opções de múltipla seleção:

Use as opções globais definidas em sua organização para configurar valores para as opções de seleção múltipla.

Usando o tipo certo de número

Quando você escolhe o tipo correto de coluna numérica a ser usada, a decisão de usar um tipo de Número Inteiro ou Moeda é simples. A escolha entre o uso de números de Ponto Flutuante ou Decimal exige maior consideração.

Assista a este vídeo para ajudar você a decidir que tipo de coluna de número usar:

Os números decimais são armazenados no banco de dados exatamente como especificado. Os números de ponto flutuante armazenam uma aproximação extremamente próxima do valor. Por que escolher uma aproximação extremamente próxima quando você pode ter o valor exato? A resposta é que você obtém um desempenho do sistema diferente.

Use decimais quando for necessário fornecer relatórios que exigem cálculos muito exatos ou se você geralmente usa consultas que procuram valores que são iguais ou diferentes de outro valor.

Use números de ponto flutuante ao armazenar dados que representam frações ou valores que você normalmente consulta comparando com outro valor usando operadores maiores ou menores que. Na maioria dos casos, a diferença entre decimal e flutuante não é visível. A menos que você precise dos cálculos mais exatos possíveis, os números de ponto flutuante deverão funcionar.

Inteiros grandes (Big ou BigInt) são números grandes com um valor máximo de 9.223.372.036.854.775.807.. Use-os para armazenar números muito grandes que excedem os recursos de Número Inteiro e Decimal. Alguns usos para esse tipo incluem armazenamento de valores de carimbo de data/hora e IDs exclusivas, bem como números maiores que 100 bilhões.

Usando colunas de moeda

As colunas de moeda permitem que uma organização configure várias moedas para uso em linhas dentro da organização. Quando uma organização usa várias moedas, normalmente deseja executar cálculos que fornecem valores na moeda base da organização. Quando você adiciona uma coluna de moeda a uma tabela que não tem outras colunas de moeda, você adiciona duas colunas extras:

• Uma coluna de pesquisa chamada Moeda que você definiu como qualquer moeda ativa configurada para sua organização. Você pode configurar várias moedas ativas para sua organização em Configurações>Gerenciamento de Negócios>Moedas. Lá, você especifica a moeda e uma taxa de câmbio com a moeda base definida para sua organização. Se você tiver várias moedas ativas, poderá adicionar a coluna de moeda ao formulário e permitir que as pessoas especifiquem qual moeda se aplica a valores monetários para essa linha. Essa opção altera o símbolo de moeda que aparece para as colunas de moeda no formulário.

  Os usuários também podem alterar suas opções pessoais para selecionar uma moeda padrão para as linhas que criarem.

• Uma coluna decimal chamada taxa de Exchange que fornece a taxa de exchange para uma moeda selecionada associada à tabela em relação à moeda base. Se você adicionar essa coluna ao formulário, as pessoas poderão ver o valor, mas não poderão editá-lo. A taxa de câmbio é armazenada com a moeda.

Para cada coluna de moeda adicionada, você também adiciona outra coluna de moeda com o sufixo _Base no nome. Essa coluna armazena o cálculo do valor da coluna de moeda adicionada e da moeda base. Novamente, se você adicionar essa coluna ao formulário, ela não poderá ser editada.

Ao definir uma coluna de moeda, é possível escolher o valor de precisão. Escolha entre três opções, conforme mostrado na tabela a seguir.

Diferentes tipos de pesquisas

Ao criar uma nova coluna de pesquisa, você cria uma nova relação de tabela de muitos para um (N:1) entre a tabela com a qual você está trabalhando e o Tipo de Linha de Destino definido para a pesquisa. Para obter mais informações sobre essas relações, consulte Criar e editar relações entre tabelas.

Existem vários tipos diferentes de pesquisas, conforme mostrado na tabela a seguir.

Colunas de imagem

Use colunas de imagem para exibir imagens nos aplicativos. As colunas de imagem são otimizadas para o armazenamento de dados binários. O Dataverse não salva esses dados no armazenamento de dados relacional, o que melhora o desempenho e reduz o uso da capacidade. Saiba mais sobre a capacidade de armazenamento.

Cada tabela pode ter uma coluna de imagem primária. Com aplicativos baseados em modelo, você pode exibir essa imagem no canto superior direito do formulário. Embora uma tabela tenha uma coluna de imagem, exibir essa imagem em um aplicativo baseado em modelo exige que você habilite duas configurações.

• Defina o valor da propriedade Primary Image da definição da tabela padrão como Default Image. Tabelas personalizadas exigem uma coluna personalizada de imagem. Em seguida, selecione essa coluna de imagem para o valor da Imagem Primária na definição da tabela personalizada.
• Habilite a propriedade Mostrar imagem no formulário do formulário de tabela no qual a imagem deve ser exibida.

As pessoas escolhem a imagem para carregar uma imagem do computador. As imagens devem ter menos de 30 MB e devem estar em um dos seguintes formatos:

• jpg
• jpeg
• gif
• bmp
• png

Quando você carrega a imagem, ela é convertida em um formato .jpg e todas as imagens baixadas também usam esse formato. Se você fizer upload de um GIF animado, apenas o primeiro quadro é salvo.

Quando você carrega uma imagem, ela é redimensionada como uma imagem "miniatura" para um tamanho máximo de 144 pixels por 144 pixels. Os usuários devem redimensionar ou cortar as imagens antes de carregar para que sejam bem exibidas usando este tamanho. Todas as imagens são cortadas para serem quadradas. Se os dois lados de uma imagem forem menores que 144 pixels, a imagem é cortada para um quadrado com as dimensões do lado menor.

Aprenda a trabalhar com definições de colunas de imagem usando código

Criar uma coluna de imagens e adicioná-la a um formulário

1. Acesse https://make.powerapps.com, selecione Soluções e abra a solução não gerenciada que contém o formulário de tabela ao qual você deseja adicionar uma coluna de imagem.

2. Abra a tabela e selecione a área Colunas.

3. Na barra de comandos, selecione Adicionar coluna.

4. Insira ou selecione valores para as propriedades a seguir e, em seguida, selecione Concluído.

   • Nome de exibição, como Imagem da receita.
   • Nome. Este é o nome exclusivo que inclui o prefixo do fornecedor de soluções e não pode ser alterado depois de salvo.
   • Tipo de Dados. Selecione Imagem.
   • Imagem principal. As colunas de imagem definidas como a imagem principal são exibidas no canto superior direito do formulário. Você só pode ter uma imagem principal para cada tabela.
   • Habilitar segurança de coluna. Use para controlar o acesso a colunas específicas. Mais informações: Segurança em nível de campo para controlar o acesso
   • Habilitar auditoria. Habilita o registro em log de alterações feitas em registros de tabelas e no acesso do usuário para que você possa revisar a atividade mais tarde. Mais informações: Guia dos administradores: Gerenciar auditoria do Dataverse
   • Classificável no painel de experiência interativa. Especifica a coluna que será usada para configurar painéis interativos. Mais informações: Configurar colunas de filtro e direitos de acesso para os painéis interativos
   • Tamanho máximo da imagem. O valor padrão é 10.240 KB. O tamanho mínimo é 1 KB, e o máximo é 30.720 KB.

5. Selecione Salvar tabela.

6. Selecione a guia Formulários e abra o formulário para edição, como o formulário principal da tabela.

7. Adicione a coluna de imagem à tela do formulário.

8. Na barra de comandos do editor de formulários, selecione Salvar e selecione Publicar para disponibilizar a coluna de imagens para os usuários.

Os usuários do aplicativo agora podem selecionar a imagem a exibir no formulário. Quando um usuário de aplicativo abre o formulário de um registro, eles podem selecionar Escolher arquivo, selecionar a imagem e salvar o registro. Em seguida, a imagem é exibida no formulário onde está localizada a coluna da imagem.

A coluna de imagem neste exemplo é a imagem principal, portanto, a imagem também aparece no canto superior esquerdo do formulário.

Os usuários podem selecionar Aberta para exibir a imagem em tamanho real em uma nova guia do navegador ou Excluir para remover a imagem do registro e do Dataverse.

Mais informações para desenvolvedores que trabalham com dados de imagem:

• metadados da tabela > imagens da tabela
• Atributos de imagem

Colunas de arquivo

A coluna Arquivo armazena dados binários. Ele é otimizado para esse tipo de dados, portanto, o Dataverse não os salva no armazenamento de dados relacional. Essa abordagem melhora o desempenho e reduz o uso da capacidade. Saiba mais sobre a capacidade de armazenamento.

Use esta coluna para armazenar uma única imagem, anotação ou anexo. No entanto, você também pode armazenar outras formas de dados binários. Você pode adicionar uma ou mais colunas desse tipo de dados a uma tabela personalizável padrão existente ou a uma tabela personalizada.

O tamanho de arquivo máximo padrão é de 32 MB e o maior tamanho que você pode definir usando o designer é de 131.072 KB (131 MB). Você pode definir o limite de tamanho do arquivo individualmente para cada coluna do tipo de arquivo que você adiciona a uma tabela.

Para criar uma coluna de arquivo, selecione Soluções no painel esquerdo do Power Apps, abra a solução desejada, abra a tabela desejada, selecione a área Colunas, selecione Adicionar Coluna e, no painel Propriedades da Coluna, selecione Arquivo como o tipo de Dados.

Aprenda a trabalhar com definições de coluna de arquivo usando código.

Colunas de fórmula FX

Criado no Power Fx, use uma coluna de fórmula para executar operações que retornam valores durante operações de busca. As colunas de fórmula usam a sintaxe do Power Fx semelhante à Excel do Office. Para obter mais informações, consulte Trabalhar com colunas de fórmula (versão prévia).

Colunas de prompt

As colunas de prompts permitem que você defina prompts de IA e armazene os resultados da IA generativa na coluna da tabela. Para obter mais informações, consulte colunas de prompt.

Pesquisa e classificação de colunas

A maioria das colunas tem opções para habilitar a pesquisa ou classificação do conteúdo da coluna.

Pesquisável

Quase todos os tipos de dados de coluna são criados com o valor Pesquisável habilitado. Você pode desabilitar esse valor durante a criação ou posterior após a criação da coluna. Os seguintes tipos de dados não podem ser habilitados para pesquisa:

• Fórmulas. As fórmulas são usadas para criar uma saída calculada dinamicamente e, por isso, não podem ser pesquisadas.
• Imagem. As imagens são armazenadas e recuperadas usando URLs de referência e, por isso, não podem ser pesquisadas.
• Consulta de múltiplos valores (PartyList). Algumas colunas de pesquisa do sistema podem conter vários valores. Por exemplo, a coluna de consulta Para das linhas Email pode conter vários destinatários. A pesquisa em colunas de pesquisa multivalor não é suportada.

O tipo de dados Cliente está habilitado para pesquisa por padrão e não pode ser desabilitado. O sistema exige que ele seja pesquisável.

Classificável

Quase todos os tipos de dados são criados com o valor Classificável desabilitado. Você pode alterar esse valor durante a criação ou após a criação da coluna. Os seguintes tipos de dados não permitem habilitar um atributo classificável:

• Opções. A classificação de colunas com vários valores não é suportada.
• Cliente. Cliente é uma coluna de busca padrão e não pode ser classificada porque é recuperada dinamicamente.
• Arquivo. Os arquivos são armazenados por meio de URLs de referência, e classificá-los não é útil.
• Fórmulas. As fórmulas são usadas para criar uma saída calculada dinamicamente e, por isso, não podem ser classificadas.
• Imagem. Não há maneira significativa de classificar imagens.
• Consulta de múltiplos valores (PartyList). Algumas colunas de pesquisa do sistema podem conter vários valores. Por exemplo, a coluna de consulta Para das linhas Email pode conter vários destinatários. A classificação de colunas com vários valores não é suportada.