Configurar metadados de formulários multietapas para o Power Pages

Artigo
01/22/2025

Os metadados de formulário de várias etapas adicionam lógica de modificação de comportamento para aprimorar ou substituir a funcionalidade de campo de formulário além dos recursos básicos nativos de edição de formulários.

Adicionar um novo registro

Na etapa de Formulário de várias etapas com campos a serem modificados, vá para Metadados>Relacionados
Selecione Novos Metadados do Formulário de Várias Etapas.

Propriedades de metadados do formulário de várias etapas

Os seguintes atributos fornecem estilos e recursos adicionais para elementos em um formulário.

Name	Description
Etapa de formulário multietapas	A etapa de formulário multietapas associada ao registro de metadados do formulário multietapas.
Type	Opções: Atributo Seção Tabulação A seleção de Atributo exibe opções para modificar campos no formulário atual. A seleção da Seção exibe opções para modificar uma seção do formulário. A seleção da Guia exibe opções para modificar uma guia do formulário.

Tipo de metadados do formulário de várias etapas = Atributo

As seguintes propriedades são exibidas quando o Tipo selecionado é Atributo.

Name	Description
Nome Lógico de Atributo	O nome lógico do campo de atributo a ser modificado.

Observação: as colunas do tipo escolhas não aparecerão na lista suspensa de colunas. Informe o nome lógico da coluna de opções diretamente na caixa de texto Nome Lógico do Atributo. | | Rótulo | Substitui o rótulo padrão atribuído ao atributo na tabela como o texto especificado. Para cada pacote de idiomas instalado e habilitado para o ambiente do Microsoft Dataverse, haverá um campo disponível para inserir a mensagem no idioma associado. |

Estilo do controle

Estas opções modificam o estilo e a funcionalidade de um campo de atributo.

Name	Description
Estilo	Opções: Conjunto de Opções como Lista de Botão do Rádio Vertical Conjunto de Opções como Lista de Botão do Rádio Horizontal Linha Única de Texto como Validador de Pesquisa por Geolocalização (necessita das configurações do Bing Mapas - detalhes encontrados aqui) Agrupar número inteiro como soma de constante (requer nome de grupo) Agrupar número inteiro como ordem de classificação, nenhum vínculo (requer nome de grupo) Agrupar número inteiro como ordem de classificação, permitir vínculo (requer nome de grupo) Matriz de múltipla escolha (requer nome de grupo) Múltipla escolha (requer nome de grupo) Agrupar número inteiro como pilha de classificação (requer nome de grupo) Componente de código Renderizar Pesquisa como Suspensa
Nome de Grupo	Um nome usado para controles de grupos juntos como um controle composto.
Contagem de Múltipla Escolha Mínima Necessária Selecionada	Os valores mínimos necessários selecionados na questão de múltipla escolha. Necessários somente se o estilo de controle "Múltipla escolha" for selecionado.
Contagem de Múltipla Escolha Máxima Selecionada	O número máximo de valores permitido a ser selecionado na questão de múltipla escolha. Necessários somente se o estilo de controle "Múltipla escolha" for selecionado.
Total Mínimo da Soma de Constante	O valor mínimo necessário aplicado a um campo de resposta de soma de constante. Necessário somente se o controle de estilo "Agrupar números inteiros como uma soma de constante" for selecionado.
Total Máximo da Soma de Constante	O número máximo de valores permitidos a serem aplicados a um campo de resposta de soma de constante. Necessário somente se o controle de estilo "Agrupar números inteiros como uma soma de constante" for selecionado.
Randomizar Valores do Conjunto de Opções	Especificar "Sim" resulta em opções ordenadas aleatoriamente e listadas para um controle de configuração de opções. Aplicável somente a atributos que são do tipo Conjunto de opções.
Classe CSS	Adiciona um nome de classe CSS ao controle.

Campo de pré-popular

As seguintes opções fornecem um valor padrão para campos no formulário.

Nome	Descrição
Ignorar Valor Padrão	Ignora o valor padrão do campo do atributo especificado. Útil para atributos que são campos de Duas Opções processados como botões de opção Sim e Não. Como um valor sim ou não é atribuído automaticamente por padrão, essa opção possibilita exibir perguntas Sim/Não sem uma resposta predefinida.
Type	Opções: Valor Data de Hoje Contato do usuário atual A seleção de Valor exige que um valor a ser especificado no campo Valor que é atribuído ao campo quando o formulário for carregado. Selecionar Data de Hoje atribui a data e o horário atuais a campo do atributo. Para selecionar Contato do usuário atual, é preciso um atributo Do atributo na tabela de contato que é recuperado do registro do contato do usuário atual e definido no campo de atributo especificado.
Valor	Um valor atribuído ao campo quando o formulário for carregado.
Do Atributo	Um atributo na tabela de contato que é recuperado do registro do usuário do site atual e atribuído ao campo quando o formulário for carregado.

Definir Valor ao Salvar

As seguintes opções especificam um valor a ser definido quando o formulário for salvo.

Nome	Descrição
Definir Valor ao Salvar	"Sim" indica que um valor deve ser atribuído ao atributo usando a entrada fornecida no campo Valor. Observação: todos os tipos de atributos são compatíveis, exceto os seguintes tipos: Identificador Exclusivo.
Type	Opções: Valor Data de Hoje Contato do usuário atual A seleção de Valor exige que um valor a ser especificado no campo Valor que é atribuído ao campo quando o formulário for carregado. Selecionar Data de Hoje atribui a data e o horário atuais a campo do atributo. Para selecionar Contato do usuário atual, é preciso um atributo Do atributo na tabela de contato que é recuperado do registro do contato do usuário atual e definido no campo de atributo especificado.
Valor	Valor atribuído ao atributo quando o formulário estiver sendo salvo. Para os campos (Boolianos) com Duas Opções, use verdadeiro ou falso. Para o campo Conjunto de Opções, use o valor inteiro para a opção. Para os campos Pesquisa (TableReference), use o GUID. Observação: se o atributo também estiver no formulário, o valor do usuário é substituído por esse valor.
Do Atributo	Um atributo na tabela de contato que é recuperado do registro do usuário do site atual e atribuído ao campo ao ser salvo.

Configurações de Pesquisa

A configuração de pesquisa Formulário básico para Criar é usado para preencher o Formulário Básico para criar um novo registro da pesquisa quando os metadados criados para um atributo são do tipo pesquisa.

Validação

A seguinte seção contém propriedades que modificam vários parâmetros de validação e mensagens de erro.

Para cada pacote de idiomas instalado e habilitado para o ambiente do Dataverse, haverá um campo disponível para inserir a mensagem no idioma associado.

Nome	Descrição
Mensagem de Erro de Validação	Substitui a mensagem de erro de validação padrão do campo.
Expressão Regular	Uma expressão regular que será adicionada para validar o campo.
Mensagem de Erro de Validação de Expressão Regular	A mensagem de erro de validação para mostrar quando a expressão regular validada falha.
Campo obrigatório	Selecione para fazer com que o campo de atributo necessário contenha um valor.
Mensagem de erro de validação de campo obrigatório	Substitui a mensagem de erro do campo necessária padrão se o campo não contiver um valor.
Mensagem de Erro da Validação de Intervalo	Substitui a mensagem de erro de validação de intervalo padrão exibida se o valor do campo estiver fora dos valores mínimos e máximos especificados para os tipos de Número Inteiro, Número Decimal, Número de Ponto Flutuante e Moeda.
Mensagem de Erro do Validador de Geolocalização	Se o atributo for uma única linha de texto e o estilo de controle for especificado como Validador de Pesquisa de Geolocalização; isso substitui a mensagem de erro padrão exibida se a validação de entrada falhar.
Mensagem de Erro de Validação de Soma de Constante	Se o atributo for um tipo de número inteiro e o estilo de controle for um Número Inteiro de Grupo como Soma de Constante; isso substitui a mensagem de erro padrão exibida se a validação de entrada falhar.
Mensagem de Erro de Validação de Múltipla Escolha	Se o atributo for um tipo de Duas Opções e o Estilo de Controle for Múltipla escolha; isso substitui a mensagem de erro padrão exibida se a validação de entrada falhar.
Mensagem de Erro de Validação de Ordem de Classificação sem Valores Equivalentes	Se o atributo for um tipo de número inteiro e o estilo de controle for um Número Inteiro de Grupo como Ordem de Classificação sem Valores Equivalentes, esta opção substitui a mensagem de erro padrão exibida, se a validação de entrada falhar.

Descrição e Instruções

As seguintes propriedades especificam o local e conteúdo da descrição ou das instruções personalizadas.

Nome	Descrição
Adicionar Descrição	"Sim" resulta em texto personalizado sendo exibido no formulário na posição especificada.
Position	Opções: Acima do campo Abaixo do campo Acima do rótulo
Usar Propriedade da Descrição do Atributo	Selecione "Sim" para usar a descrição atribuída aos metadados do atributo na tabela. Selecione "Não" para fornecer uma descrição personalizada. O padrão é "Não".
Descrição	Texto personalizado que será exibido no formulário. Usado em conjunto quando a propriedade Usar descrição do atributo estiver definida como "Não". Para cada pacote de idiomas instalado e habilitado para o ambiente do Dataverse, haverá um campo disponível para inserir a mensagem no idioma associado.

Tipo de metadados do formulário de várias etapas = Seção

As seguintes propriedades são exibidas quando o tipo selecionado é igual a "Seção".

Nome	Descrição
Nome da Seção	O nome da seção no formulário da tabela que será modificado.
Rótulo	Substitui o rótulo padrão atribuído à seção na tabela como o texto especificado. Para cada pacote de idiomas instalado e habilitado para o ambiente do Dataverse, haverá um campo disponível para inserir a mensagem no idioma associado.

Tipo de metadados do formulário de várias etapas = Guia

As seguintes propriedades são exibidas quando o tipo selecionado é igual a "Guia".

Nome	Descrição
Nome da Guia	O nome da guia no formulário da tabela que será modificado.
Rótulo	Substitui o rótulo padrão atribuído à guia na tabela como o texto especificado. Para cada pacote de idiomas instalado e habilitado para o ambiente do Dataverse, haverá um campo disponível para inserir a mensagem no idioma associado.

Compartilhar via