Partilhar via


elemento de propriedade

O nó de propriedade define uma parte específica e configurável de dados que o componente espera do Microsoft Dataverse.

Disponível para

Aplicativos orientados a modelos e de tela

Propriedades

Nome Description Tipo Obrigatório Disponível para
valor-padrão O valor de configuração padrão fornecido ao componente. Em aplicativos controlados por modelo, essa propriedade só é permitida em entradas, uma vez que os parâmetros vinculados esperam ter uma coluna associada. cadeia (de caracteres) Opcional Aplicações condicionadas por modelos
chave-descrição Usado nas telas de personalização como cadeias de caracteres localizadas que descrevem a descrição da propriedade. cadeia (de caracteres) Opcional Aplicativos orientados a modelos e de tela
display-name-key Usado nas telas de personalização como cadeias de caracteres localizadas que descrevem o nome da propriedade. cadeia (de caracteres) Yes Aplicações condicionadas por modelos
nome Nome do imóvel cadeia (de caracteres) Yes Aplicativos orientados a modelos e de tela
do tipo-grupo Nome do grupo-tipo, tal como definido no manifesto cadeia (de caracteres) Opcional Aplicações condicionadas por modelos
do tipo Define o tipo de dados da propriedade Consulte Utilização do tipo Opcional Aplicativos orientados a modelos e de tela
pfx-default-value O valor de expressão PFX padrão fornecido ao componente. Consulte Usando pfx-default-value Opcional Aplicações de tela
required Se a propriedade é necessária ou não Booleano Opcional Aplicações condicionadas por modelos
utilização A propriedade usage identifica se a propriedade se destina a representar uma coluna que o componente pode alterar (vinculado), somente leitura (entrada) ou valores de saída ligado, entrada ou saída Yes Aplicações condicionadas por modelos

Observações

Esta seção contém orientações sobre como usar os atributos do elemento Property.

Utilização do tipo

O of-type valor da propriedade deve ser um dos seguintes:

Valor Description Disponível para
Moeda Valores monetários entre -922.337.203.685.477 e 922.337.203.685.477 podem estar nesta coluna. Aplicativos orientados a modelos e de tela
DataAndTime.DataAndHora Exibe data e hora. Aplicativos orientados a modelos e de tela
DateAndTime.DateOnly Exibe apenas a data. Aplicativos orientados a modelos e de tela
Decimal Até 10 pontos decimais de precisão podem ser usados para valores entre -100.000.000.000 e -100.000.000.000 podem estar nesta coluna. Aplicativos orientados a modelos e de tela
Enum Tipo de dados enumerados. Aplicativos orientados a modelos e de tela
PQ Até cinco casas decimais de precisão podem ser usadas para valores entre -100.000.000.000 e -100.000.000.000 podem estar nesta coluna. Aplicativos orientados a modelos e de tela
Lookup.Simple Permite uma única referência a uma tabela específica. Todas as pesquisas personalizadas são deste tipo. Aplicações condicionadas por modelos
Multiple Esta coluna pode conter até 1.048.576 caracteres de texto. Aplicativos orientados a modelos e de tela
MultiSelectOptionSet Você pode personalizar formulários (principal, criação rápida e visualização rápida) e modelos de email adicionando colunas de opções. Ao adicionar a coluna de opções, você pode especificar vários valores que estão disponíveis para os usuários selecionarem. Quando os usuários preenchem o formulário, eles podem selecionar um, vários ou todos os valores exibidos em uma lista suspensa. Aplicativos orientados a modelos e de tela
Objeto Tipo de dados do objeto. Só pode ser usado com propriedades de saída. Aplicativos orientados a modelos e de tela
OptionSet Esta coluna fornece um conjunto de opções. Cada opção tiver um valor e uma etiqueta de número. Quando adicionada a um formulário, essa coluna exibe um controle para que os usuários selecionem apenas uma opção. Aplicativos orientados a modelos e de tela
SingleLine.Email Isso armazena o tempo da cadeia de caracteres no formato válido para e-mails. Os controles de Interface Unificada prontos para uso automaticamente os tornam links clicáveis. Aplicativos orientados a modelos e de tela
Telefone SingleLine.Phone Isso armazena a hora da cadeia de caracteres no formato válido para Phone. Os controles de Interface Unificada prontos para uso automaticamente os tornam links clicáveis. Aplicativos orientados a modelos e de tela
SingleLine.Text Esta opção simplesmente exibe texto. Aplicativos orientados a modelos e de tela
SingleLine.TextArea Esta opção de formato pode ser usada para exibir várias linhas de texto. Mas com um limite de 4000 caracteres, a coluna Várias linhas de texto é uma escolha melhor se forem esperadas grandes quantidades de texto. Aplicativos orientados a modelos e de tela
SingleLine.Ticker Isso armazena o tempo da cadeia de caracteres no formato válido para o Ticker. Os controles de Interface Unificada prontos para uso automaticamente os tornam links clicáveis. Aplicativos orientados a modelos e de tela
SingleLine.URL O texto esperado para fornecer um hiperlink para abrir a página especificada. Os controles de Interface Unificada prontos para uso automaticamente anexam "https://" a valores de entrada que não começam com um protocolo válido. Apenas os protocolos HTTP, HTTPS, FTP, FTPS, OneNote e TEL são esperados nesta coluna. Aplicativos orientados a modelos e de tela
Duas Opções Esta coluna fornece duas opções. Cada opção tem um valor numérico de 0 ou 1 correspondente a um valor falso ou verdadeiro. Cada opção também tem um rótulo para que os valores verdadeiros ou falsos possam ser representados como "Sim" e "Não", "Quente" e "Frio", "Ativado" e "Desativado" ou qualquer par de rótulos que você queira exibir. Aplicativos orientados a modelos e de tela
Inteiro.Nenhum Esta opção simplesmente exibe um número. Aplicativos orientados a modelos e de tela

Advertência

Se o manifest.xml arquivo contiver pelo menos um conjunto de dados, as propriedades do tipo Lookup.Simple também deverão ser encapsuladas no elemento do conjunto de dados .

Elementos de valor que não são suportados

Os seguintes of-type valores de propriedade não são suportados atualmente:

Valor Description
Lookup.Cliente Permite uma única referência a uma conta ou a um registo de contacto. Essas pesquisas estão disponíveis para as tabelas Oportunidade, Caso, Cotação, Pedido e Fatura. Essas tabelas também têm pesquisas separadas de Conta e Contato que você pode usar se seus clientes forem sempre de um tipo. Ou você pode incluir ambos em vez de usar a pesquisa de cliente.
Lookup.Owner Permite uma única referência a um registro de equipe ou usuário. Todas as tabelas de equipe ou de propriedade do usuário têm um desses.
Lookup.PartyList Permite várias referências a várias tabelas. Essas pesquisas são encontradas nas colunas Email table To e Cc . Eles também são usados nas tabelas Telefone e Compromisso.
Pesquisa.Em relação Permite uma única referência a várias tabelas. Essas pesquisas são encontradas na coluna referente usada nas atividades.
Razão do Estado Uma coluna do sistema que tem opções que fornecem mais detalhes sobre a coluna Status. Cada opção está associada a uma das opções de Status disponíveis. Você pode adicionar e editar as opções.
Situação Uma coluna do sistema que tem opções que geralmente correspondem ao status ativo e inativo. Algumas colunas do sistema têm mais opções, mas todas as colunas personalizadas têm apenas opções de status Ativo e Inativo.
Duração.Inteira Esta opção de formato pode ser usada para exibir uma lista de opções de duração. Mas os dados armazenados no banco de dados são sempre um número de minutos. A coluna parece uma lista suspensa e fornece opções sugeridas como 1 minuto, 15 minutos, 30 minutos até três dias. As pessoas podem escolher estas opções. No entanto, as pessoas também podem apenas digitar em alguns minutos e isso resolve para esse período de tempo.
Todo.Língua Esta opção exibe uma lista dos idiomas provisionados para sua organização. Os valores são exibidos como uma lista suspensa de nomes de idiomas, mas os dados são armazenados como um número usando códigos LCID. Os códigos de idioma são IDs de localidade de quatro ou cinco dígitos. Valores válidos de ID de localidade podem ser encontrados em Gráfico de ID de localidade (LCID).
Whole.TimeZone Esta opção exibe uma lista selecionada de fusos horários, como (GMT-12:00) Linha Internacional de Data Oeste e (GMT-08:00) Hora do Pacífico (EUA & Canadá). Cada uma dessas zonas é armazenada como um número. Por exemplo, para o fuso horário (GMT-08:00) Hora do Pacífico (EUA & Canadá), o TimeZoneCode é 4.

Observação

No momento, as colunas de arquivo não são suportadas. Para obter mais informações: Colunas de arquivo

Usando pfx-default-value

Use o valor da pfx-default-value propriedade para avaliar eventos e propriedades usando expressões Power Fx em vez de valores padrão estáticos. Você pode usar isso para:

  • Dimensione responsivamente o controle
  • Aceder a conectores
  • Fornecer dados de exemplo
  • Propriedades do tema de referência
  • Eventos personalizados

Observação

  • Você pode usar qualquer expressão Power Fx, mas deve certificar-se de que a expressão é válida ao importar o controle.
  • Se você usar aspas internas ou outros caracteres especiais, envolva o valor em aspas simples, por exemplo: pfx-default-value='"Test"'
  • Você pode fazer referência a outros controles (incluindo telas) e suas propriedades. Escreva estas referências como: %ControlName.ID%.ControlProperty. Por exemplo: pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Escreva enums, como DisplayType e ScreenTransition como: %EnumName.RESERVED%.EnumValue. Por exemplo: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Se pfx-default-value estiver incluído, então tem precedência sobre default-value.

Elementos pai

Elemento Description
Controlo Define o namespace, a versão e as informações de exibição do componente.

Example

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

Referência de esquema de manifesto da estrutura do componente Power Apps
Referência da API da estrutura do componente Power Apps
Visão geral da estrutura do componente Power Apps