Tipos de colunas no Microsoft Dataverse

Concluído

As tabelas contêm colunas. Ao criar uma coluna, você seleciona o tipo de dados da coluna. O tipo de dados determina os valores que podem ser armazenados nessa coluna. Todas as colunas têm um e apenas um tipo de dados.

O Dataverse tem vários tipos de dados para colunas em uma tabela. Alguns tipos de dados têm formatos que afetam a forma como a coluna é exibida nos aplicativos. Cada tipo de dados tem seus próprios atributos que podem ser configurados para fornecer mais personalização à coluna.

Os tipos de colunas disponíveis no Microsoft Dataverse são categorizados aqui:

Texto

As colunas de texto contêm cadeias de texto alfanuméricas e também fornecem formatação específica.

Linha única de texto

Um valor de texto que deve ser exibido em uma caixa de texto de linha única. Uma única linha de texto tem vários formatos:

  • Texto simples ou Texto: cadeia de texto de formato livre exibida em uma caixa de texto de linha única.

  • Área de texto: um valor de texto que deve ser exibido em uma caixa de texto com várias linhas. Se você precisar de mais de 4.000 caracteres, use a opção Várias linhas de texto.

  • Rich text: um valor de texto formatado destinado a ser exibido em uma caixa de texto com várias linhas. Se você precisar de mais de 4.000 caracteres, use o tipo de dados Várias linhas de texto.

  • Email: um valor de texto que é validado como um endereço de email e renderizado como um link mailto na coluna.

  • Número de telefone: um valor de texto que é validado como um número de telefone processado como um link para iniciar um telefonema usando o Skype.

  • Símbolo de ação: um valor de texto para um símbolo de ação que exibe um link aberto para mostrar uma cotação para o símbolo de ação.

  • URL: um valor de texto que é validado como uma URL e renderizado como um link para abrir a URL.

O comprimento máximo de uma única linha de coluna de texto é de 4.000 caracteres. O comprimento padrão é de 100 caracteres. O comprimento de uma única linha de coluna de texto pode ser alterado antes e depois da criação da coluna.

Observação

Você pode editar uma única linha de coluna de texto e alterar seu tipo de dados para uma coluna de numeração automática.

Várias linhas de texto

Um valor de texto destinado a ser exibido em uma caixa de texto de várias linhas. Várias linhas de texto têm dois formatos:

  • Texto simples ou Texto: cadeia de texto de formato livre exibida em uma caixa de texto com várias linhas.

  • Rich text: um valor de texto formatado destinado a ser exibido em uma caixa de texto com várias linhas.

O comprimento máximo de várias linhas de coluna de texto é de 1.048.576 caracteres. O comprimento padrão é de 2.000 caracteres. O comprimento de uma coluna de texto com várias linhas pode ser alterado antes e depois da criação da coluna.

Número

Colunas numéricas armazenam valores numéricos. Há vários tipos de dados numéricos. Para obter mais informações, consulte Usar o tipo certo de número.

Número inteiro

Colunas de números inteiros armazenam valores inteiros. O número inteiro tem várias opções de formato:

  • Nenhum (padrão): um valor numérico sem formatação especial.

  • Duração: um valor numérico apresentado como uma lista suspensa que contém intervalos de tempo. Um usuário pode selecionar um valor da lista ou digitar um valor inteiro que representa o número de minutos.

  • Fuso Horário: um valor numérico apresentado como uma lista suspensa que contém uma lista de fusos horários.

  • Código de idioma: um valor numérico apresentado como uma lista suspensa que contém uma lista de idiomas habilitados para o ambiente. Se nenhum outro idioma tiver sido habilitado, o idioma base será a única opção. O valor salvo é o valor do identificador de localidade (LCID) do idioma.

Por padrão, uma coluna de número inteiro tem um valor mínimo de -2.147.483.648 e um valor máximo de 2.147.483.647. Os valores mínimo e máximo podem ser configurados. Você pode definir a propriedade Tamanho do número para uma coluna de número inteiro como Grande e permite valores entre -9.223.372.036.854.775.808 e 9.223.372.036.854.775.807.

Decimal

Um valor decimal com até 10 casas decimais. Os números decimais são armazenados no banco de dados exatamente como especificado.

Por padrão, uma coluna decimal tem um valor mínimo de -100.000.000.000, e um valor máximo de 100.000.000.000. Os valores mínimo e máximo podem ser configurados.

Flutuante

Um número de ponto flutuante com até cinco casas decimais. Você só deve usar float quando necessário, pois os números de ponto flutuante armazenam uma grande aproximação do valor, e vários recursos do Dataverse não dão suporte a float, como colunas calculadas.

Por padrão, uma coluna flutuante tem um valor mínimo de 0 e um valor máximo de 1.000.000.000. Os valores mínimo e máximo podem ser configurados.

Código de Idioma

Esse Código de idioma é um número inteiro usado para armazenar identificadores de idioma, conhecidos como LCIDs (Identificadores de Código de Idioma).

Duração

A Duração é um valor de Número Inteiro que representa uma duração em minutos.

Fuso horário

O Fuso horário também é um valor de Número Inteiro que representa fusos horários especificados. O Dataverse usa UTC para armazenar valores de data e hora, mas pode usar um valor de fuso horário para ajustar a um fuso horário especificado.

Moeda

O tipo de dados moeda armazena valores monetários para quaisquer moedas configuradas para o ambiente.

Ao adicionar uma coluna de moeda, quatro colunas são adicionadas à tabela:

  • Moeda: uma coluna numérica contendo o valor monetário da moeda selecionada.

  • Currency(Base): uma coluna somente leitura contém o valor monetário convertido para a moeda base definida ao criar o ambiente.

  • Moeda: uma coluna de pesquisa que os usuários podem definir para qualquer moeda ativa configurada para seu ambiente.

  • Taxa de câmbio: uma coluna decimal que fornece a taxa de câmbio usada para a moeda selecionada.

Você pode definir um nível de precisão ou optar por basear a precisão em uma moeda específica ou em uma única precisão padrão usada pela organização.

Por padrão, uma coluna de moeda tem um valor mínimo de -922.337.203.685.477, e um valor máximo de 922.337.203.685.477. Os valores mínimo e máximo podem ser configurados.

Data e hora

A coluna Data e hora armazena valores de data e hora. No Microsoft Dataverse, você pode especificar como os valores de data e hora são mostrados aos usuários e como são ajustados para fusos horários.

Duas opções estão disponíveis para colunas de data e hora.

  • Formato: se a parte de tempo do valor deve ser exibida.

  • Ajuste de fuso horário: a configuração padrão é Local do usuário, mas você também pode defini-la como Independente de fuso horário.

Formato

Todas as colunas de data e hora têm uma parte de hora. O formato determina se a parte de hora do valor deve ser exibida.

  • Data e hora: exibe a data e hora do valor.

  • Somente data: exibe apenas a parte da data do valor. O valor de hora não exibido é 12:00, dependendo do Ajuste de fuso horário.

Pesquisa

Há dois tipos de coluna de pesquisa que você pode criar:

  • Pesquisa: uma coluna que vincula duas tabelas em um relacionamento muitos para um. Uma coluna de pesquisa cria uma referência a uma única linha na tabela relacionada.

  • Cliente: uma coluna de pesquisa que você pode usar para especificar um cliente, que pode ser uma conta ou um contato. Adicionar uma coluna de pesquisa a uma tabela cria dois relacionamentos muitos para um da tabela para as tabelas de conta e contato

Escolha

Uma escolha é um tipo de coluna que define um conjunto de opções. Quando uma opção é exibida em um formulário, ela usa um controle de lista suspensa. As colunas de escolha também são conhecidas como listas de opções e conjuntos de opções.

Colunas de escolha são pares chave/valor que contêm itens com um valor inteiro e um rótulo.

Coluna de opção

Uma coluna de escolha exibe uma lista de opções em que apenas uma opção pode ser selecionada.

Ao criar uma coluna de escolha, você pode especificar Sincronizar com escolha global. Tem duas opções:

  • Global: uma escolha global é um componente separado e pode ser reutilizada para diversas colunas em diversas tabelas. A lista de opções é compartilhada para as colunas da tabela que usam a escolha global

  • Local: há apenas uma opção local para a coluna da tabela.

Sim/não

Uma coluna Sim/não é um booliano que tem apenas duas opções. Você pode escolher quais rótulos são exibidos para cada opção. Os rótulos padrão são Sim e Não.

Observação

Os rótulos nas colunas escolha e sim/não têm suporte para localização quando os pacotes de idiomas estão habilitados para o ambiente.

Arquivo

O Dataverse fornece dois tipos de dados para armazenar documentos e imagens:

  • Arquivo: uma coluna que pode armazenar arquivos até um tamanho máximo especificado. O tamanho máximo de arquivo padrão é 32.768. O tamanho máximo deve estar entre 1 KB e 131.072 KB.

  • Imagem: exibe uma única imagem para cada registro no aplicativo. Opcionalmente, você pode selecionar uma coluna de imagem para ser a imagem principal da tabela e essa imagem será exibida no canto superior esquerdo de um formulário de aplicativo baseado em modelo. O tamanho máximo padrão da imagem é 10240. O tamanho máximo deve estar entre 1 KB e 30.720 KB.

Numeração automática

As colunas de numeração automática geram automaticamente cadeias alfanuméricas sempre que são criadas. Você pode personalizar o formato dessas colunas e, depois, contar com o sistema para gerar valores correspondentes que os preenchem automaticamente.

As colunas de numeração automática serão abordadas posteriormente neste módulo.

Fórmula (PowerFx)

As colunas de fórmula usaram a linguagem Power Fx para calcular o valor da coluna. Elas usam uma sintaxe semelhante ao Office Excel. As colunas de fórmula são somente leitura.

Captura de tela da edição da coluna primária.

Tipos de dados do sistema

Há vários tipos de dados para colunas de tabela, mas que você não pode usar ao criar colunas.

  • Identificador Exclusivo: uma coluna do sistema armazena um valor de GUID (identificador global exclusivo) para cada linha.

  • Proprietário: uma coluna de pesquisa do sistema que faz referência ao usuário ou à equipe e que é atribuído a uma linha de tabela de propriedade do usuário ou da equipe.

  • PartyList: permite várias referências a várias tabelas. Essas pesquisas são encontradas nas colunas Para e Cc da tabela Email. Eles também são usados nas tabelas Telefone e Compromisso.

  • Referente a: permite uma única referência de pesquisa para várias tabelas. Essas pesquisas são encontradas na coluna referente usada nas atividades

  • Status: uma coluna do sistema com opções que geralmente correspondem ao status ativo e inativo. Algumas tabelas de sistema têm mais opções, mas todas as tabelas personalizadas têm apenas opções de status Ativo e Inativo.

  • Razão do Status: uma coluna do sistema com opções que mostram mais detalhes sobre a coluna Status. Cada opção é associada a uma das opções de Status disponíveis. Você pode adicionar e editar as opções de razão do status.

Dica

Você pode adicionar qualquer combinação de colunas a uma tabela personalizada ou padrão para atender às suas necessidades, mas não pode excluir uma coluna padrão de uma tabela padrão.