Tipos de colunas

Observação

A partir de novembro de 2020:

  • O Common Data Service foi renomeado para Microsoft Dataverse. Saiba mais
  • A terminologia do Microsoft Dataverse foi atualizada. Por exemplo, entidade agora é tabela e campo agora é coluna. Saiba mais

Este artigo será atualizado em breve para refletir a terminologia mais recente.

Os nomes usados para tipos dependem do designer usado. O Power Apps usa uma convenção que inclui a maneira que 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.

Assista a este vídeo para uma obter visão geral rápida sobre tipos de dados no Dataverse:

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

Tipo de dados do portal Tipo do gerenciador de soluções Tipo de API
Número Inteiro Grande Carimbo de Data/Hora BigIntType
Moeda Moeda MoneyType
Cliente Cliente CustomerType
Data e Hora Data e Hora
Formato Data e Hora
DateTimeType
Somente Data Data e Hora
Formato Somente Data
DateTimeType
Número Decimal Número Decimal DecimalType
Duração Número Inteiro
Formato Duração
IntegerType
Email Linha Única de Texto
Formato Email
StringType
Arquivo Arquivo FileType
Número de Ponto Flutuante Número de Ponto Flutuante DoubleType
Imagem Image ImageType
Idioma Número Inteiro
Formato Idioma
IntegerType
Pesquisa Pesquisa LookupType
Choices Campo de Seleção Múltipla MultiSelectPicklistType
Texto com Várias Linhas Várias Linhas de Texto MemoType
Opção Conjunto de Opções PicklistType
Proprietário Proprietário OwnerType
Telefone Linha Única de Texto
Formato Telefone
StringType
Razão do Status Razão do Status StatusType
Status Status StateType
Área de texto Linha Única de Texto
Formato Área de Texto
StringType
Texto Linha Única de Texto
Formato Texto
StringType
Símbolo de Ação Linha Única de Texto
Formato símbolo de ação
StringType
Fuso horário Número Inteiro
Formato Fuso Horário
IntegerType
Sim/Não Duas Opções BooleanType
Identificador Exclusivo Identificador Exclusivo ou Chave Primária UniqueidentifierType
URL Linha Única de Texto
Formato URL
StringType
Número Inteiro Número Inteiro
Formato Nenhum
IntegerType

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

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

Tipos de coluna usados pelo sistema

Há algumas colunas usadas pelo sistema que não podem ser adicionadas por meio do designer.

Digitar Descrição
Número Inteiro Grande ou Carimbo de Data/Hora Usado pelo sistema para capturar um número de versão e gerenciar atualizações para uma tabela.
Cliente Uma coluna de pesquisa que você pode usar para especificar um cliente, que pode ser uma conta ou um contato.
Observação: esse atributo pode ser adicionado usando o designer do gerenciador de soluções.
Proprietário Uma coluna de pesquisa do sistema que faz referência ao usuário ou à equipe atribuída a um usuário ou equipe proprietária do registro da entidade.
Razão do Status Uma coluna do sistema com as opções que fornecem detalhes adicionais sobre a coluna Status. Cada opção está associada com uma das opções de Status disponíveis. Você pode adicionar e editar as opções.

Você também pode incluir as transações de estado personalizadas par controlar quais opções de status estão disponíveis para determinadas tabelas. Mais informações: Definir as transições de razão do status para tabelas personalizadas
Status Uma coluna do sistema com opções que geralmente correspondem ao status ativo e inativo. Alguns atributos do sistema incluem opções adicionais, mas todos os atributos personalizados têm apenas opções de status Ativo e Inativo.
Identificador Exclusivo Uma coluna do sistema armazena um valor de identificador global exclusivo (GUID) para cada linha.

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 alterarão a apresentação do texto.

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

Opções

Você pode personalizar formulários (principal, criação rápida e visualização rápida) e modelos de email adicionando colunas de seleção múltipla chamadas Opções. Ao adicionar uma coluna de opções, você pode especificar vários valores que ficarão disponíveis para os usuários selecionarem. Quando os usuários preencherem o formulário, eles poderão 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, você poderá incluir vários locais ou países em uma coluna "Área de operação". Um usuário então poderá selecionar um ou mais locais da lista de valores disponíveis.

É possível usar opções com grades somente leitura, grades editáveis e a maioria dos formulários. Não é possível 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, SLA1 e regras de roteamento1.

1A tabela requer o Dynamics 365 Customer Service.

Formulários

Há suporte às colunas de múltipla escolha nos seguintes tipos de formulários:

Tipo de Formulário Disponibilidade
Formulário turbo Sim
Formulário de atualização Somente leitura (a coluna ficará disponível, mas não poderá ser editada)
Formulário herdado Não
Formulário de edição em massa Não

Você pode usar 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

Ao escolher o tipo correto de coluna numérica a ser usado, a opção de usar um tipo Número Inteiro ou Moeda deve ser 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 especificados. Os números de ponto flutuante armazenam uma aproximação do valor. Por que escolher a aproximação quando você tem 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 dados de ponto flutuante ao armazenar dados que representam frações ou valores que você geralmente consultará comparando com outro valor usando os operadores maior que ou menor que. Na maioria dos casos, a diferença entre decimal e flutuante não é visível. A menos que você precise de cálculos o mais exatos possíveis, os números de ponto flutuante deverão funcionar.

Usando colunas de moeda

As colunas de moeda permitem que uma organização configure várias moedas que podem ser usadas para linhas na organização. Quando as organizações têm várias moedas, normalmente desejam que seja possível realizar cálculos para fornecer valores usando a moeda base. Ao adicionar uma coluna de moeda a uma tabela que não tenha nenhuma outra coluna de moeda, duas colunas adicionais serão inseridas:

  • Uma coluna de consulta chamada Moeda que pode ser definida para 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ê pode especificar a moeda e a taxa de câmbio com a moeda base definida para sua organização. Se houver várias moedas ativas, você poderá adicionar a coluna de moeda ao formulário e permitir que as pessoas especifiquem qual moeda deverá ser aplicada aos valores monetários para a linha. Isso alterará o símbolo da moeda exibido para as colunas da 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 Câmbio que fornece a taxa de conversão para uma moeda selecionada associada à tabela em relação à moeda base. Se esta coluna for adicionada ao formulário, os usuários poderão ver o valor, mas não poderão editá-lo. A taxa de câmbio é armazenada com a moeda base.

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

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

Opção Descrição
Número de Decimais de Preços Esta é uma única precisão da organização a ser usada para os preços encontrados em Configurações > Administração > Configurações do Sistema > Guia Geral.
Número de Decimais da Moeda Esta opção se aplica à precisão definida para a moeda na linha.
Valores de precisão específicos Essas configurações permitem definir uma precisão definida específica usando valores entre 0 e 4.

Diferentes tipos de pesquisas

Ao criar uma nova coluna de pesquisa, você estará criando um novo relacionamento de tabelas 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. Há opções de configuração adicionais para esse relacionamento descritas em Criar e editar relacionamentos entre tabelas. Mas todas as pesquisas personalizadas podem permitir apenas uma referência para uma única linha de um único tipo de linha de destino.

No entanto, você deve estar ciente que nem todas as pesquisas se comportam dessa maneira. Há vários tipos diferentes de pesquisas do sistema como ilustrado a seguir.

Tipo de pesquisa Descrição
Simples Permite uma referência única a uma tabela específica. Todos os campos personalizados são desse tipo.
Cliente Permite uma referência única a uma conta ou uma linha de contato.
Proprietário Permite uma referência única a uma linha da equipe ou do usuário. Todas as tabelas de propriedade do usuário ou da equipe têm um deles. Mais informações: Adicionar uma tabela como uma opção de pesquisa em seu aplicativo
PartyList Permite várias referências a várias tabelas. Estas pesquisas são encontradas nas colunas Para e Cc da tabela Email. Elas também são usadas nas tabelas Telefone e Compromisso.
Referente a Permite uma única referência para várias tabelas. Essas pesquisas são encontradas na coluna relacionada usada nas atividades.

Colunas de imagem

Use colunas de imagem para exibir uma única imagem por linha no aplicativo. Cada tabela pode ter uma coluna de imagem. Você pode adicionar uma coluna de imagem a tabelas personalizadas, mas não a tabelas padrão. Algumas tabelas padrão têm colunas de imagem definidas.

Embora uma tabela tenha uma coluna de imagem, exibir essa imagem em um aplicativo baseado em modelo exige que você habilite duas configurações.

  • O valor da propriedade da Imagem principal da definição da tabela padrão deve ser definido como Imagem padrão. Tabelas personalizadas exigem uma coluna personalizada de imagem. Em seguida, você pode selecionar essa coluna de imagem para o valor de Imagem Principal na definição da tabela personalizada.
  • O formulário da tabela em que a imagem será exibida deve ter a propriedade Mostrar imagem no formulário habilitada.

Quando a exibição de imagem estiver habilitada para uma tabela, todas as linhas que não tenham uma imagem exibirão uma imagem de espaço reservado. Por exemplo:

Exemplo de imagem de tabela para uma linha de conta.

As pessoas podem selecionar a imagem padrão para carregar uma imagem do computador. As imagens devem ter menos de 10 MB e devem estar em um dos seguintes formatos:

  • jpg
  • jpeg
  • gif
  • tif
  • tiff
  • bmp
  • png

Quando a imagem for carregada, será convertida para um formato .jpg e todas as imagens baixadas também usarão esse formato. Se um .gif animado for carregado, somente o primeiro frame será salvo.

Quando uma imagem for carregada, será 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 são menores que 144 pixels, a imagem será cortada para um quadrado com as dimensões de tamanho menor.

Adicione suporte de imagem a um formulário em uma tabela personalizada usando o gerenciador de soluções

  1. Abra o gerenciador de soluções.

  2. No painel de navegação à esquerda, expanda Tabelas, expanda a tabela personalizada que deseja, e selecione Colunas.

  3. Na barra de ferramentas, selecione Novo.

  4. Na seção Tipo na lista suspensa Tipo de dados, selecione Imagem.

  5. Insira um Nome de exibição, como Imagem de tabela personalizada.

  6. Preencha as colunas restantes conforme apropriado. Observe que as colunas Nome, Requisito da Coluna e Pesquisável não podem ser alterados. Selecione Salvar e Fechar.

  7. A definição da tabela próxima à propriedade Imagem Principal garante que o valor seja definido na imagem principal criada na etapa anterior. Se não estiver selecionado, selecione-o.

    Propriedade de imagem principal selecionada.

  8. Abra o formulário onde deseja que o suporte de imagem esteja, como no formulário principal da tabela.

  9. Na faixa de opções do editor de formulários, selecione Propriedades do Formulário.

  10. Na página Propriedades do formulário, selecione a guia Exibição, selecione Mostrar imagem no formulário e, em seguida, selecione OK.

    Mostrar imagem na configuração de formulário.

  11. Na faixa de opções do editor de formulários, selecione Salvar e, em seguida, selecione Publicar. Feche o editor de formulários.

Observação

Depois que o tamanho máximo do arquivo for salvo, ele não poderá ser alterado.

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 uma linha, ele pode escolher a imagem que desejam exibir no formulário.

Importante

Se a linha for um novo tipo de linha que não foi salvo, o erro Argumento Inválido é retornado quando você tenta alterar a imagem.

Alterar a imagem de um registro

Assim que um formulário de tabela tiver uma coluna de imagem, os usuários do aplicativo poderão alterar a imagem de um determinado registro.

  1. Abra o aplicativo que inclui um formulário de tabela e selecione a imagem no formulário.

    Imagem padrão da tabela.

  2. Selecione Carregar imagem, busque e selecione a imagem que deseja exibir no formulário de tabela e, em seguida, selecione Alterar. A imagem é exibida no registro.

    Imagem alterada salva em uma linha.

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

Colunas de arquivo

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

A coluna Arquivo é usada para armazenar dados binários. O principal uso pretendido desta coluna é armazenar uma única imagem, observação ou anexo. No entanto, o armazenamento de outras formas de dados binários também é possível. Uma ou mais colunas deste tipo de dados podem ser adicionadas a uma tabela personalizável padrão existente ou a uma tabela personalizada.

O Tamanho máximo do arquivo padrão é de 32 MB e o maior tamanho a ser definido é de 10 GB. O limite de tamanho do arquivo pode ser definido individualmente para cada coluna do tipo de arquivo adicionado a uma tabela.

Observação

Depois que o tamanho máximo do arquivo for salvo, ele não poderá ser alterado.

Para criar uma coluna de arquivo, no painel esquerdo do Power Apps, selecione Soluções, abra a solução que deseja, abra a tabela que deseja, na guia Colunas, selecione Adicionar Coluna e, no painel Propriedades da coluna, selecione Arquivo como o Tipo de dados.

Tipo de dados do arquivo.

Para obter mais informações para desenvolvedores que trabalham com dados de arquivos: Atributos do arquivo