Tipos de coluna

Os nomes utilizados para tipos dependem do desenhador utilizado. O Power Apps utiliza uma convenção que inclui a forma como os dados são formatados. O tipo de explorador de soluções utiliza um nome alinhado com o tipo de dados da base de dados com um modificador de formato.

Veja este vídeo para uma descrição geral rápida sobre os tipos de dados no Dataverse:

A tabela seguinte inclui o tipo de API correspondente AttributeTypeDisplayName.

Tipo de dados do Power Apps	Tipo de explorador de soluções	Tipo de API
Número Inteiro Grande	Carimbo de Data/Hora	BigIntType
Opção	Conjunto de Opções	PicklistType
Escolhas	Campo Seleção Múltipla	MultiSelectPicklistType
Moeda	Moeda	MoneyType
Cliente	Cliente	CustomerType
Data e Hora	Data e Hora Formato Data e Hora	DateTimeType
Apenas Data	Data e Hora Formato Apenas Data	DateTimeType
Número Decimal	Número Decimal	DecimalType
Duração	Número Inteiro Formato Duração	IntegerType
Correio Eletrónico	Uma Linha de Texto Formato E-mail	StringType
Ficheiro	Ficheiro	FileType
Número de Vírgula Flutuante	Número de Vírgula Flutuante	DoubleType
Imagem	Imagem	ImageType
Linguagem	Número Inteiro Formato Idioma	IntegerType
Pesquisa	Pesquisa	LookupType
Texto Multilinha	Várias Linhas de Texto	MemoType
Proprietário	Proprietário	OwnerType
Telemóvel	Uma Linha de Texto Formato Telefone	StringType
Estado	Estado	StateType
Razão do Estado	Razão do Estado	StatusType
Texto	Uma Linha de Texto Formato Texto	StringType
Área Texto	Uma Linha de Texto Formato Área de Texto	StringType
Sigla de Ticker	Uma Linha de Texto Formato Sigla de Ticker	StringType
Fuso horário	Número Inteiro Formato Fuso Horário	IntegerType
Identificador Exclusivo	Identificador Exclusivo ou Chave Primária	UniqueidentifierType
URL	Uma Linha de Texto Formato URL	StringType
Número Inteiro	Número Inteiro Formato Nenhum	IntegerType
Sim/Não	Duas Opções	BooleanType

Para obter mais descrições para cada tipo que pode adicionar ou editar, consulte o artigo do desenhador correspondente:

• Criar e editar colunas para o Microsoft Dataverse utilizando o portal do Power Apps: tipos de Dados de Colunas
• Criar e editar colunas para o Dataverse através do explorador de soluções do Power Apps: Tipos de Dados de Colunas

Para mais informações sobre como os tipos de dados de colunas são definidos na API, consulte Metadados do Atributo

Tipos de coluna utilizados pelo sistema

Existem algumas colunas utilizadas pelo sistema que não é possível adicionar utilizando o estruturador.

Type	Description
Carimbo de Data/Hora	Um Número Inteiro Grande utilizado pelo sistema para capturar um número da versão para gerir atualizações a uma tabela.
Cliente	Uma coluna de pesquisa que pode utilizar para especificar um cliente, que pode ser uma conta ou um contacto. Nota: este atributo pode ser adicionado utilizando o estruturador do explorador de soluções.
Proprietário	Uma coluna pesquisa de sistema que provesse o utilizador ou equipa que recebem um utilizador ou equipa proprietário da linha de tabela.
Razão do Estado	Uma coluna sistema que tenha as opções que especificam o detalhes adicionais sobre a coluna estado. Cada opção está associada a uma das opções de estado disponíveis. Pode adicionar e editar as opções. Também pode incluir transições de estado personalizadas para controlar as opções do estado disponíveis em determinadas tabelas. Mais informações: Definir transições de razão do estado para tabelas personalizadas
Status	Uma coluna sistema que tenha as opções que correspondem normalmente ao estado inativo e ativo. Alguns atributos de sistema tem opções adicionais, mas todos os atributos personalizados têm apenas Ativo e opções do estado de Inativo.
Identificador Exclusivo	Uma coluna sistema armazena um valor GUID (identificador exclusivo global) para cada linha.

Colunas de texto

As colunas de texto podem conter carateres de texto. Este tipo de coluna tem várias opções de formatação que irão alterar a apresentação do texto.

Veja este vídeo para obter uma descrição geral rápida sobre as colunas de texto:

Existem três tipos básicos de colunas de texto. Todos os valores indicados abaixo estão em número de carateres.

Nome de tipo de coluna	Valor predefinido	Valor máximo	Description
Texto	100	4000	Aceita uma única linha de texto.
Área de Texto	100	4000	Aceita várias linhas de texto. O número de linhas apresentadas para a coluna pode ser configurado. Utilize para quantidades de texto inferiores.
Texto Multilinha	150	1048576	Aceita várias linhas de texto. O número de linhas apresentadas para a coluna pode ser configurado. Utilize quando forem necessárias grandes quantidades de texto.

Choices

Pode personalizar formulários (principal, criação rápida e vista rápida) e modelos de e-mail ao adicionar colunas de seleção múltipla que são chamadas de Escolhas. Quando adiciona uma coluna de escolhas, pode especificar vários valores que estarão disponíveis para os utilizadores selecionarem. Quando os utilizadores preenchem o formulário, podem selecionar um, vários ou todos os valores apresentados numa lista pendente.

Por exemplo, se uma organização operar em várias áreas ou países/regiões, pode incluir várias localizações ou países/regiões numa coluna "Área de operação". Em seguida, um utilizador pode selecionar uma ou mais localizações a partir da lista de valores disponíveis.

As escolhas podem ser usadas com grelhas só de leitura, grelhas editáveis e a maioria dos formulários. As opções de seleção múltipla não podem ser utilizadas com:

• Fluxos de trabalho, fluxos do processo de negócio, ações, diálogos, regras de negócio, gráficos, colunas de rollup ou colunas calculadas.
• Relatórios, SLA¹ e regras de encaminhamento¹.

¹A tabela requer o Dynamics 365 Customer Service.

Formulários

São suportados campos de seleção múltipla nos seguintes tipos de formulários:

Tipo de Formulário	Disponibilidade
Formulário turbo	Sim
Formulário de atualização	Só de leitura (o coluna estará disponível, mas não poderá ser editada)
Formulário legado	Não
Formulário de Edição em Massa	Não

Pode utilizar opções globais que são definidas na sua organização para configurar os valores para as opções de seleção múltipla.

Utilizar o tipo de direito número

Ao escolher o tipo correto de coluna de número a utilizar, a decisão de utilizar Número inteiro ou tipo de Moeda deve ser bastante direta. A escolher entre a utilização de Vírgula flutuante ou de números de Decimal necessita de mais pensamento.

Veja este vídeo para o ajudar a decidir que tipo de coluna de numero utilizar:

Os valores decimais são armazenados na base de dados exatamente como especificados. Os números de vírgula flutuante armazenam bastante fechar uma abordagem de valor. A abordagem que selecionar a próxima bastante quando poderá ter o valor exato? A resposta é que obtenha o desempenho do sistema diferente.

Utilize decimais quando necessitar de fornecer relatórios que necessitam de muito cálculos corretos, ou se utiliza normalmente consultas que procuram os valores que não é igual ou igual a outro valor.

Utilize um número de vírgula flutuante quando guarda os dados que representam os valores ou frações do perguntará normalmente a comparação para outro valor de utilização mais do que ou menos de operadores. Na maioria dos casos, a diferença entre o e vírgula flutuante não estão visíveis. A menos que necessite cálculos possíveis corretos, mais os números de vírgula flutuante tem de trabalhar para si.

Os Números Inteiros Grandes (ou BigInt) são números grandes com um valor máximo de 9.223.372.036.854.775.807. É utilizado para armazenar números muito grandes que excedem as capacidades de Número Inteiro e Decimal. Algumas utilizações para isso incluem o armazenamento de valores de carimbo de data/hora e IDs exclusivos, bem como números maiores do que 100 biliões.

Nota

Atualmente, o BigInt só está disponível para utilização através de API. Isto inclui a criação de colunas, criação de dados e a gestão de dados.

Usar colunas de moeda

As colunas de moeda permitem que uma organização configure as várias moedas que podem ser utilizadas para linhas na organização. Quando as organizações têm várias moedas, normalmente pretender conseguir efetuar cálculos para fornecer valores utilizando a moeda base. Quando adiciona uma coluna a uma tabela que não tem nenhuma outra coluna de moeda, são adicionadas mais duas colunas:

• Uma coluna pesquisa por Moeda que poderá definir qualquer moeda ativa configurada para a sua organização. Pode configurar várias moedas ativas da organização em Definições > Gestão de Negócio > Moedas. Aí pode especificar a uma moeda e câmbio relativamente à moeda base definido para a sua organização. Se tiver várias moedas ativas, pode adicionar a coluna moeda ao formulário e permitir que as pessoas que especifiquem moeda deve ser aplicada aos valores de moeda para esta linha. Isto irá alterar o símbolo de moeda que é apresentado para as colunas de moeda no formulário.

  Os utilizadores podem também alterar as opções pessoais para selecionar uma moeda predefinida para a criação de linhas.

• Uma coluna decimal denominada Taxa de Câmbio com que o câmbio para a moeda selecionada associada à tabela relativamente à moeda base. Se esta coluna for adicionada ao formulário, as pessoas podem ver o valor mas não o podem editar. O câmbio é armazenado com a moeda.

Para cada coluna moeda que adicionar, será adicionada outra coluna moeda com o sufixo _Base no nome. Esta coluna armazena o valor de cálculo da coluna moeda que adicionou e a moeda base. Além deste, se esta coluna é adicionado ao formulário, não pode ser editada.

Quando configura uma coluna moeda pode escolher o valor de precisão. Existem três opções tal como é mostrado na tabela.

Opção	Descrição
Precisão Decimal na Definição de Preços	Trata-se de uma única precisão da organização a utilizar para os preços existentes em Definições > Administração > Definições do Sistema > separador Geral.
Precisão Monetária	Esta opção aplica a precisão definida para moeda na linha.
Valores de precisão específicos	Estas definições permitem definir um conjunto específico de precisão utilizando valores entre 0 e 4.

Diferentes tipos de consultas

Quando cria uma nova coluna pesquisa está a criar um novo muitos-para-um (N: 1) relação entre tabelas para a tabela que está a trabalhar e Tipo de linha de destino definido para a consulta. Existem opções de configuração adicionais para esta relação descritas em Criar e editar relações entre tabelas. Mas as consultas personalizadas só podem permitir uma referência a uma única linha para um único tipo de linha de destino.

Contudo, deverá estar ciente as organizações procedem consulta comportamento se este modo. Existem vários tipos diferentes de consultas de sistema conforme apresentado aqui.

Tipo de pesquisa	Descrição
Simples	Permite uma referência a uma tabela específica. Todas as consultas personalizadas são este tipo.
Cliente	Permite uma referência a uma conta ou a uma linha de contacto.
Proprietário	Permite uma referência a uma linha de equipa ou utilizador. Equipa ou todas as tabelas que são propriedade têm um destes. Mais informações: Adicione uma tabela equipa como uma opção de pesquisa na sua aplicação
PartyList	Permite que várias referências com várias tabelas. Estas consultas podem ser encontradas nas tabelas Para e Cc da coluna E-mail. Também são utilizados em tabelas Telefone e Compromisso.
Relativa a	Permite uma única referência a várias tabelas. Estas consultas podem ser encontradas na coluna relativa utilizada em atividades.

Colunas de imagem

Use colunas de imagem para apresentar imagens nas suas aplicações. As colunas de imagem são otimizadas para armazenar dados binários. O Dataverse não guarda estes dados no arquivo de dados relacional, o que melhora o desempenho e reduz a utilização da capacidade. Mais informações sobre a capacidade de armazenamento

Cada tabela só pode ter uma coluna de imagem primária. Com aplicações condicionadas por modelo, pode apresentar esta imagem no canto superior direito do formulário. Mesmo que uma tabela tenha uma coluna imagem, a apresentação dessa imagem numa aplicação condicionada por modelo requer que ative duas definições.

• O valor da propriedade Imagem Primária da definição da tabela padrão tem de ser definido como Imagem Predefinida. As tabelas personalizadas requerem uma coluna de imagem personalizada. Em seguida, pode selecionar essa coluna de imagem para o valor Imagem Primária na definição da tabela personalizada.
• O formulário de tabela em que a imagem deve ser apresentada tem de ter a propriedade Show image in the form ativada.

Os utilizadores escolhem a imagem para carregar uma imagem a partir do computador. As imagens têm de ser inferiores a 30 MB e ter um dos seguintes formatos:

• jpg
• jpeg
• gif
• bmp
• png

Quando a imagem for carregada, será convertido num formato .jpg e as imagens transferidas também utilizarão este formato. Se.gif animado é carregado, só o primeiro guarde frames.

Quando uma imagem é carregada, será redimensionada como uma imagem "miniatura" para um tamanho máximo de 144 pixels por 144 pixels. Os utilizadores têm de colher redimensionar as imagens ou antes que as transfiram carregar para que sejam apresentados corretamente utilizando este tamanho. Todas as imagens são colhidas para ser quadrado. Se ambos os lados de uma imagem são menos de 144 pixels, a imagem ficará colhida esteja as dimensões lateral inferior.

Nota

As colunas de imagem não funcionam com fluxos do processo de negócio, regras de negócio, gráficos, colunas de rollup ou colunas calculadas.

Saiba como trabalhar com definições de coluna de Imagem com código

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

1. Vá para https://make.powerapps.com, selecione Soluções e, depois, abra a solução não gerida que contém a tabela a partir da qual pretende adicionar uma coluna de imagem.

2. Abra a tabela pretendida e, em seguida, selecione a área Colunas.

3. Na barra de comandos, selecione Adicionar coluna.

4. Introduza ou selecione valores para as seguintes propriedades e, em seguida, selecione Concluído.

   • Nome a Apresentar, tal como Imagem de receita.
   • Name. Este é o nome exclusivo que inclui o prefixo do fabricante de soluções e não pode ser alterado depois de guardado.
   • Tipo de Dados. Selecione Imagem.
   • Imagem Primária. As colunas de imagem que são definidas como a imagem principal são apresentadas no canto superior direito do formulário. Só pode ter uma imagem principal para cada tabela.
   • Ativar segurança de coluna. Utilize para controlar o acesso a colunas específicas. Mais informações: Segurança de nível de campo para controlar o acesso
   • Ativar auditoria. Ativa o registo das alterações efetuadas aos registos de tabela e o acesso dos utilizadores para poder rever a atividade posteriormente. Mais informações: Guia para Administradores: Gerir auditoria do Dataverse
   • Ordenável no dashboard de experiência de utilização interativa. Especifica que a coluna será utilizada para configurar dashboards interativos. Mais informações: Configurar colunas de filtros e direitos de acesso para os dashboards interativos
   • Tamanho máximo da imagem. O valor predefinido é 10.240 KB. O tamanho mínimo é de 1 KB e o máximo é de 30.720 KB.

5. Selecione Guardar tabela.

6. Selecionar o separador Formulário e, em seguida, abra o formulário para edição, tal como o formulário principal de tabela.

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

8. Na barra de comandos do editor do formulário, selecione Guardar e, depois, selecione Publicar para disponibilizar a coluna da imagem aos utilizadores.

Os utilizadores da aplicação agora podem selecionar a imagem a apresentar no formulário. Quando um utilizador da aplicação abre o formulário de um registo, pode selecionar Escolher ficheiro, selecione a imagem e, em seguida, guarde o registo. Em seguida, a imagem é apresentada no formulário onde a coluna de imagem está localizada.

A coluna de imagem neste exemplo é a imagem principal para a imagem também aparecer na parte superior esquerda do formulário.

Os utilizadores podem selecionar Abrir para apresentar a imagem em tamanho integral num novo separador de browser ou selecionar Eliminar para remover a imagem do registo e do Dataverse.

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

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

Colunas de ficheiro

A coluna Ficheiro é utilizada para armazenar dados binários. As colunas de ficheiro são otimizadas para armazenar dados binários. O Dataverse não guarda estes dados no arquivo de dados relacional, o que melhora o desempenho e reduz a utilização da capacidade. Mais informações sobre a capacidade de armazenamento

A utilização principal desta coluna destina-se a armazenar uma única imagem, nota ou anexo. No entanto, o armazenamento de outros tipos 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 de ficheiro máximo predefinido é 32 MB e o maior tamanho que pode definir com o estruturador é 131.072 KB (131 MB). O limite de tamanho do ficheiro pode ser definido individualmente para cada coluna de tipo de ficheiro adicionada a uma tabela.

Nota

• Uma vez guardado o tamanho máximo do ficheiro, não pode ser alterado.
• As colunas de ficheiro não funcionam com fluxos do processo de negócio, regras de negócio, gráficos, colunas de rollup ou colunas calculadas.

Para criar uma coluna de ficheiros, no painel esquerdo em Power Apps selecione Soluções, abra a solução desejada, abra a tabela desejada, selecione a área Colunas, selecione Adicionar coluna e, em seguida, no painel de propriedades da Coluna, selecione Ficheiro como o Tipo de Dados.

Saiba como trabalhar com definições de coluna de ficheiro com código

Colunas de Fórmula Fx

Criada no Power Fx, utilize uma coluna de fórmula Fx para efetuar operações que obtenham valores durante operações fetch. As colunas de fórmulas utilizam uma sintaxe do Power Fx semelhante ao Office Excel. Mais informações: Trabalhar com colunas de fórmula (pré-visualização)

Pesquisar e ordenar colunas

A maior parte das colunas tem opções para ativar a pesquisa ou a ordenação dos conteúdos da coluna.

Pesquisável

Praticamente, todos os tipos de dados de coluna são criados com o valor Pesquisável ativado. Isto pode ser desativado na altura da criação ou posteriormente, após a coluna ser criada. Os seguintes tipos de dados não podem ser ativados para pesquisa:

• Ficheiro. Os ficheiros são armazenados e obtidos utilizando URLs de referência e, devido a isto, não é possível pesquisar neles.
• Fórmulas. As fórmulas são utilizadas para criar uma saída calculada dinamicamente e, devido a isto, não é possível pesquisar nelas.
• Imagem. As imagens são armazenadas e obtidas utilizando URLs de referência e, devido a isto, não é possível pesquisar nelas.
• Pesquisa de valores múltiplos (PartyList). Algumas colunas de procura de sistema podem conter vários valores. Por exemplo, a coluna de procura Para das linhas de E-mail pode conter vários destinatários. A pesquisa em colunas de procura de valores múltiplos não é suportada.

O tipo de dados Cliente está ativado por predefinição e não pode ser desativado. É obrigatório que seja pesquisável pelo sistema.

Ordenável

Praticamente, todos os tipos de dados são criados com o valor Ordenável desativado. O valor pode ser alterado na altura da criação ou posteriormente, após a coluna ser criada. Os seguintes tipos de dados não fornecem a capacidade de ativar um atributo ordenável:

• Escolhas. A ordenação de colunas com vários valores não é suportada.
• Cliente. O cliente é uma coluna de procura padrão e não pode ser ordenada porque é obtida dinamicamente.
• Ficheiro. Os ficheiros são armazenados utilizando URL de referência e a ordenação destes não é útil.
• Fórmulas. As fórmulas são utilizadas para criar uma saída calculada dinamicamente e, devido a isto, não é possível ordená-las.
• Imagem. Não existe nenhuma forma significativa de ordenar imagens.
• Pesquisa de valores múltiplos (PartyList). Algumas colunas de procura de sistema podem conter vários valores. Por exemplo, a coluna de procura Para das linhas de E-mail pode conter vários destinatários. A ordenação de colunas com vários valores não é suportada.

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).