Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O nó de propriedade define um dado específico e configurável que o componente espera do Microsoft Dataverse.
Disponível para
Aplicativos baseados em modelo e 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 modelos, essa propriedade só é permitida em entradas, pois os parâmetros associados esperam ter uma coluna associada. | cadeia | Opcional | Aplicativos baseados em modelos |
| description-key | Usado nas telas de personalização como cadeias de caracteres localizadas que descrevem a descrição da propriedade. | cadeia | Opcional | Aplicativos baseados em modelo e tela |
| display-name-key | Usado nas telas de personalização como cadeias de caracteres localizadas que descrevem o nome da propriedade. | cadeia | Yes | Aplicativos baseados em modelos |
| nome | Nome da propriedade | cadeia | Yes | Aplicativos baseados em modelo e tela |
| de tipo de grupo | Nome do grupo de tipos conforme definido no manifesto | cadeia | Opcional | Aplicativos baseados em modelos |
| do tipo | Define o tipo de dados da propriedade | Consulte o uso do tipo | Opcional | Aplicativos baseados em modelo e tela |
| pfx-default-value | O valor de expressão PFX padrão fornecido ao componente. | Consulte Usando pfx-default-value | Opcional | Aplicativos de tela |
| required | Se a propriedade é necessária ou não | boolean | Opcional | Aplicativos baseados em modelos |
| uso | A propriedade de uso identifica se a propriedade deve representar uma coluna que o componente pode alterar (associado), somente leitura (entrada) ou valores de saída | bound, input ou output | Yes | Aplicativos baseados em modelos |
Observações
Esta seção contém diretrizes sobre como usar os atributos do elemento Property.
Uso do tipo
O of-type valor da propriedade deve ser um dos seguintes:
| Value | Description | Disponível para |
|---|---|---|
| Moeda | Os valores monetários entre -922.337.203.685.477 e 922.337.203.685.477 podem estar nesta coluna. | Aplicativos baseados em modelo e tela |
| DateAndTime.DateAndTime | Exibe data e hora. | Aplicativos baseados em modelo e tela |
| DateAndTime.DateOnly | Exibe apenas a data. | Aplicativos baseados em modelo e 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 baseados em modelo e tela |
| Enum | Tipo de dados enumerado. | Aplicativos baseados em modelo e tela |
| FP | Até cinco 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 baseados em modelo e tela |
| Lookup.Simple | Permite uma referência única a uma tabela específica. Todos os campos personalizados são desse tipo. | Aplicativos baseados em modelos |
| Múltiplo | Esta coluna pode conter até 1.048.576 caracteres de texto. | Aplicativos baseados em modelo e tela |
| MultiSelectOptionSet | Você pode personalizar formulários (principal, criação rápida e exibiçã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 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. | Aplicativos baseados em modelo e tela |
| Object | Tipo de dados de objeto. Só pode ser usado com propriedades de saída. | Aplicativos baseados em modelo e tela |
| OptionSet | Esta coluna fornece um conjunto de opções. Cada opção tem um valor numérico e um rótulo. Quando adicionada a um formulário, essa coluna exibe um controle para os usuários selecionarem apenas uma opção. | Aplicativos baseados em modelo e tela |
| SingleLine.Email | Isso armazena o tempo de cadeia de caracteres no formato válido para Emails. Os controles de Interface Unificada prontos para uso automaticamente os tornam links clicáveis. | Aplicativos baseados em modelo e tela |
| SingleLine.Phone | Isso armazena o tempo de cadeia de caracteres no formato válido para Telefone. Os controles de Interface Unificada prontos para uso automaticamente os tornam links clicáveis. | Aplicativos baseados em modelo e tela |
| SingleLine.Text | Essa opção simplesmente exibe texto. | Aplicativos baseados em modelo e tela |
| SingleLine.TextArea | Essa opção de formato pode ser usada para exibir várias linhas de texto. Mas com um limite de 4.000 caracteres, a coluna Várias Linhas de Texto é uma opção melhor se grandes quantidades de texto forem esperadas. | Aplicativos baseados em modelo e 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 baseados em modelo e tela |
| SingleLine.URL | O texto esperado para fornecer um hiperlink para abrir a página especificada. Os controles de Interface Unificada prontos para uso anexam automaticamente "https://" a valores de entrada que não começam com um protocolo válido. Somente protocolos HTTP, HTTPS, FTP, FTPS, OneNote e TEL são esperados nesta coluna. | Aplicativos baseados em modelo e tela |
| TwoOptions | 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 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ê deseja exibir. | Aplicativos baseados em modelo e tela |
| Whole.None | Essa opção simplesmente exibe um número. | Aplicativos baseados em modelo e tela |
Aviso
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 de conjunto de dados .
Elementos de valor que não têm suporte
No momento, não há suporte para os seguintes of-type valores de propriedade:
| Value | Description |
|---|---|
| Lookup.Customer | Permite uma referência única a uma conta ou um registro de contato. Essas pesquisas estão disponíveis para as tabelas Oportunidade, Caso, Cotação, Pedido e Fatura. Essas tabelas também têm pesquisas de conta e contato separadas que você pode usar se seus clientes forem sempre um tipo. Ou você pode incluir ambos em vez de usar a pesquisa cliente. |
| Lookup.Owner | Permite uma única referência a uma equipe ou um registro de usuário. Todas as tabelas de propriedade do usuário ou da equipe têm um deles. |
| Lookup.PartyList | Permite várias referências a várias tabelas. Essas pesquisas são encontradas nas colunas Para e Cc da tabela Email. Elas também são usadas nas tabelas Telefone e Compromisso. |
| Lookup.Regarding | Permite uma única referência para várias tabelas. Essas pesquisas são encontradas na coluna relacionada usada nas atividades. |
| Razão do status | Uma coluna do sistema que tem opções que fornecem mais detalhes 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. |
| Situação | Uma coluna do sistema com 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. |
| Whole.Duration | Essa 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 se parece com uma lista suspensa e fornece opções sugeridas como 1 minuto, 15 minutos, 30 minutos até três dias. As pessoas podem escolher essas opções. No entanto, as pessoas também podem apenas digitar em um número de minutos e isso resolve para esse período de tempo. |
| Whole.Language | Essa opção exibe uma lista dos idiomas provisionados para sua organização. Os valores são exibidos como uma lista suspensa de nomes de idioma, 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. Os valores de ID de localidade válidos podem ser encontrados em Gráfico de LCID (ID de localidade). |
| Whole.TimeZone | Esta opção exibe uma lista selecionada de fusos horários, como (GMT-12:00) International Date Line West e (GMT-08:00) Horário 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, não há suporte para colunas de arquivo. 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:
- Dimensionar o controle de maneira responsiva
- Acessar conectores
- Fornecer dados de exemplo
- Propriedades do tema de referência
- Eventos personalizados
Observação
- Você pode usar qualquer expressão do Power Fx, mas deve verificar se a expressão é válida ao importar o controle.
- Se você usar aspas internas ou outros caracteres especiais, encapsule o valor entre aspas simples, por exemplo:
pfx-default-value='"Test"' - Você pode referenciar outros controles (incluindo telas) e suas propriedades. Escreva estas referências como:
%ControlName.ID%.ControlProperty. Por exemplo:pfx-default-value='SubmitForm(%MyFormName.ID%)' - Escreva enumerações, como
DisplayTypeScreenTransition:%EnumName.RESERVED%.EnumValue. Por exemplo:pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)' - Se
pfx-default-valueestiver incluído, ele terá precedência sobredefault-value.
Elementos pai
| Elemento | Description |
|---|---|
| Controle | 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" />
Artigos relacionados
Referência de esquema de manifesto da estrutura de componentes do Power Apps
Referência da API da estrutura de componentes do Power Apps
Visão geral da estrutura de componentes do Power Apps