Configurar subgrades de formulários de várias etapas para portais

Artigo
03/15/2023

Observação

Desde o dia 12 de outubro de 2022, os portais do Power Apps passaram a ser Power Pages. Mais Informações: O Microsoft Power Pages já está disponível para todos (blog)
Em breve, migraremos e mesclaremos a documentação dos portais do Power Apps com a documentação do Power Pages.

Subgrades de formulários de várias etapas estão configuradas de uma maneira idêntica para subgrades de formulários básicos: primeiro, crie um registro de metadados para a etapa de formulários de várias etapas que têm uma subgrade e depois, adicione metadados de configuração.

Adicionar subgrades em seus formulários gerenciados no portal é fácil — basta adicionar a subgrade ao formulário que você está gerenciando usando o designer de formulários predefinido e pronto. A grade usará a exibição especificada no designer de formulário do Microsoft Dataverse, mostrará somente os registros relacionados se essa opção tiver sido escolhida, opcionalmente mostrará uma barra de pesquisa e até mesmo respeitará as permissões de entidade para portais. Não fica mais simples exibir uma lista somente leitura de registros. Para habilitar as ações da grade (Criar, Atualizar, Excluir e assim por diante) você deverá configurar essas ações usando configurações de metadados.

Adicionar metadados de subgrade ao seu formulário

Para adicionar metadados de subgrade a um formulário básico, vá para Metadados do Formulário Básico, usando a lista suspensa superior ou a subgrade no formulário principal do registro com o qual você está trabalhando. Mais informações: Definir formulários básicos.

Para adicionar um novo registro, selecione Adicionar Novos Metadados do Formulário Básico.

Para editar um registro existente, selecione-o na grade. Selecionar Subgrade como o valor do Tipo exibe outro atributo, Nome da Subgrade.

Nome	Descrição
Nome de Subgrade	O nome exclusivo da subgrade no formulário relacionado da tabela.

Selecionar a subgrade no editor de formulários mostrará uma janela de propriedades. Contém um campo Nome que deve ser usado para atribuir ao campo Nome da Subgrade no registro Metadados do Formulário Básico.

Adicionar metadados da subgrade.

Especificar um nome de subgrade válido mostrará as definições de configuração da subgrade. Por padrão, apenas Configurações básicas são mostradas. Selecione Configurações Avançadas para mostrar configurações adicionais.

Por padrão, a maioria das configurações é mostrada recolhida para economizar espaço. Selecione **** para expandir uma seção e ver mais opções. Selecione **** para recolher a seção.

Atributos

Nome	Descrição
Configurações Básicas
Exibir Ações	Use para adicionar os botões de ação para as ações que são aplicáveis para o conjunto de tabelas e que aparecerão acima da subgrade. As ações disponíveis são: Criar Baixar Associar Selecionar uma dessas opções mostra uma área de configuração para essa ação. Veja abaixo para obter mais detalhes sobre cada ação.
Ações de Item	Use para adicionar botões de ação para ações que são aplicáveis para um registro individual e que aparecerão em cada linha na subgrade, contanto que o privilégio associado tenha sido concedido por Permissões de Tabela. As ações disponíveis são: Detalhes Editar Delete Fluxo de trabalho Desassociar A seleção de uma dessas opções mostra uma área de configuração para essa ação. Veja abaixo para obter mais detalhes sobre cada ação.
Substituir Atributos da Coluna	Use para substituir as configurações de exibição de colunas individuais na grade. Atributo: o nome lógico da coluna que você deseja substituir. Display Name: o título da nova coluna que substituirá o padrão Width - a largura (em porcentagem ou pixels) da coluna que substituirá a padrão. Consulte também Estilo da Largura da Coluna da Grade. Para substituir as configurações em uma coluna, selecione Coluna e preencha os detalhes.
Configurações Avançadas
Mensagem de Carregamento	Substitui a mensagem HTML padrão que aparece enquanto a subgrade está sendo carregada.
Mensagem de Erro	Substitui a mensagem HTML padrão que aparece quando ocorre um erro no carregamento da subgrade.
Mensagem de Acesso Negado	Substitui a mensagem HTML padrão que aparece quando um usuário não tem permissões suficientes para ler o tipo de tabela associado à subgrade.
Mensagem Vazia	Substitui a mensagem HTML padrão que aparece quando a subgrade associada não contém dados.
Caixa de Diálogo Pesquisar	Controla as configurações da caixa de diálogo que aparece quando um usuário ativa a ação Associar.
Caixa de Diálogo Formulário de Detalhes	Controla as configurações da caixa de diálogo que aparece quando um usuário ativa a ação Detalhes.
Caixa de Diálogo Editar Formulário	Controla as configurações da caixa de diálogo que aparece quando um usuário ativa a ação Editar.
Caixa de Diálogo Criar Formulário	Controla as configurações da caixa de diálogo que aparece quando um usuário ativa a ação Criar.
Caixa de Diálogo Excluir	Controla as configurações da caixa de diálogo que aparece quando um usuário ativa a ação Excluir.
Caixa de Diálogo de Erro	Controla as configurações da caixa de diálogo que aparece quando um erro ocorre durante qualquer ação.
Classe CSS	Especifique uma classe ou classes de CSS que serão aplicadas ao elemento HTML que contém toda a área da subgrade, incluindo a grade e os botões de ação.
Classe CSS da Grade	Especifique uma classe ou classes CSS que serão aplicadas ao elemento <table> de HTML da subgrade.
Estilo da Largura da Coluna da Grade	Configure se os valores Largura em Substituir Atributos de Coluna são especificados Pixels ou Porcentagem.

Ação Criar

A habilitação de uma ação Criar renderiza um botão acima da subgrade que, quando selecionado, abre uma caixa de diálogo com um formulário básico que permite que um usuário crie um novo registro.

Configurações da ação Criar

Nome	Descrição
Configurações Básicas
Formulário Básico	Especifica os formulários básicos e a lógica personalizada que serão usados para criar o novo registro. A lista suspensa incluir todos os formulários básicos configurados para o tipo de tabela da subgrade. Observação: se o tipo de tabela da subgrade não tiver formulários básicos, a lista suspensa ficará vazia. Se nenhum formulário básico for fornecido para a ação Criar, ela será ignorada e o botão não aparecerá no formulário básico da subgrade.
Configurações Avançadas
Rótulo de Botão	Substitui o rótulo HTML exibido no botão Criar ação acima da subgrade.
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão Criar ação.

Configurações avançadas da caixa de diálogo Criar Formulário

Nome	Descrição
Mensagem de Carregamento	Substitui a mensagem que aparece enquanto a caixa de diálogo está sendo carregada.
Cargo	Substitui o HTML que aparece na barra de título da caixa de diálogo.
Texto do Leitor de Tela do Botão Desassociar	Substitui o texto do leitor de tela associado ao botão Desassociar da caixa de diálogo.
Tamanho	Especifica o tamanho da caixa de diálogo Criar Formulário. As opções são "padrão", "grande" e "pequeno". O tamanho de página padrão Grande.
Classe CSS	Especifique uma classe ou classes CSS que serão aplicadas à caixa de diálogo resultante.
Classe CSS do Título	Especifique uma classe ou classes CSS que serão aplicadas à barra de título da caixa de diálogo resultante.

Ação Baixar

A habilitação de uma ação Baixar renderiza um botão acima da subgrade que, quando selecionado, baixa os dados da subgrade para um arquivo do Excel (.xlsx).

Configurações da ação Baixar

Nome	Descrição
Configurações Básicas
Nenhum(a)
Configurações Avançadas
Rótulo de Botão	Substitui o rótulo HTML exibido no botão da ação Baixar acima da subgrade.
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão da ação Baixar.

Ação Associar

Ao habilitar uma Ação Associar, aparecerá um botão acima da subgrade que, quando selecionado, abre uma lista de tabelas que o usuário pode associar ao registro de tabela sendo exibido atualmente pelo formulário básico, contanto que os privilégios Acrescentar e Acrescentar a tenham sido fornecidos por Permissões da Tabela para os tipos de tabela aplicáveis.

Configurações da ação Associar

Nome	Descrição
Configurações Básicas
Exibição	Especifica a exibição (Consulta Salva) que será usada para encontrar e mostrar a lista de tabelas elegíveis. Observação: se o tipo de tabela da subgrade não apresentar Consultas Salvas, a lista suspensa aparecerá vazia. Se nenhuma exibição for fornecida para a ação Associar, ela será ignorada e o botão não aparecerá no formulário básico da subgrade.
Configurações Avançadas
Rótulo de Botão	Substitui o rótulo HTML exibido na ação Associar acima da subgrade.
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão da ação Associar.

Configurações avançadas da caixa de diálogo Pesquisa

Nome	Descrição
Cargo	Substitui o HTML que aparece na barra de título da caixa de diálogo.
Texto do Botão Primário	Substitui o HTML que aparece no botão Primário (Adicionar) na caixa de diálogo.
Texto do Botão Fechar	Substitui o HTML que aparece no botão Fechar (Cancelar) na caixa de diálogo.
Texto do Leitor de Tela do Botão Desassociar	Substitui o texto do leitor de tela associado ao botão Desassociar da caixa de diálogo.
Tamanho	Especifica o tamanho da caixa de diálogo Associar. As opções são "padrão", "grande" e "pequeno". O tamanho de página padrão Grande.
Classe CSS	Especifique uma classe ou classes CSS que serão aplicadas à caixa de diálogo resultante.
Classe CSS do Título	Especifique uma classe ou classes CSS que serão aplicadas à barra de título da caixa de diálogo resultante.
Classe CSS do Botão Primário	Especifique a classe ou as classes CSS que serão aplicadas ao botão Primário (Adicionar) da caixa de diálogo.
Classe CSS do Botão Fechar	Especifique uma classe ou classes CSS que serão aplicadas ao botão Fechar (Cancelar) da caixa de diálogo.
Selecionar Título de Registros	Substitui o HTML que aparece na barra de título da área Seleção de Registro.
Mensagem de Erro Padrão	Substitui a mensagem que aparece quando um erro ocorre na associação da(s) tabela(s) selecionada(s).
Opções de Grade	Especifique as configurações da aparência da grade da tabela. Consulte as opções abaixo.

Configurações de opções de grade avançadas da caixa de diálogo Pesquisa

Nome	Descrição
Mensagem de Carregamento	Substitui a mensagem que aparece enquanto a grade das tabelas está sendo carregada.
Mensagem de Erro	Substitui a mensagem que aparece quando ocorre um erro no carregamento da grade de tabelas.
Mensagem de Acesso Negado	Substitui a mensagem que aparece quando um usuário não tem permissões de tabela suficientes para mostrar a grade de tabelas.
Mensagem Vazia	Substitui a mensagem que aparece quando não há tabelas que possam ser associadas ao formulário básico atual.
Classe CSS	Especifique uma classe ou classes CSS que serão aplicadas à área de grade associada.
Classe CSS da Grade	Especifique uma classe ou classes CSS que serão aplicadas ao elemento <table> da grade associada.

Ação Detalhes

A habilitação de uma ação Detalhes permite que um usuário exiba um formulário básico somente leitura que seja associado por dados ao registro da linha selecionada na subgrade.

Configurações da ação Detalhes

Nome	Descrição
Configurações Básicas
Formulário Básico	Especifica o formulário básico que será usado para exibir os detalhes do registro selecionado. A lista suspensa incluirá todos os formulários básicos configurados para o tipo de tabela da subgrade. Observação: se o tipo de tabela da subgrade não tiver formulários básicos, a lista suspensa ficará vazia. Se nenhum formulário básico for fornecido para a ação Detalhes, ela será ignorada e o botão não aparecerá na subgrade.
Configurações Avançadas
Nome do Parâmetro da ID do Registro	Especifica o nome do parâmetro de cadeia de consulta que será usado para selecionar a tabela a ser exibida no formulário básico. Ele deve corresponder ao valor no Nome do parâmetro da ID do registro do formulário básico. O valor padrão desse campo, aqui e na configuração do Formulário Básico, é id.
Rótulo de Botão	Substitui o rótulo HTML dessa ação exibido na linha da subgrade.
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão dessa ação exibido na linha subgrade.

Configurações avançadas da caixa de diálogo do formulário Detalhes

Nome	Descrição
Mensagem de Carregamento	Substitui o HTML que aparece quando a caixa de diálogo está sendo carregado.
Cargo	Substitui o HTML que aparece na barra de título da caixa de diálogo.
Texto do Leitor de Tela do Botão Desassociar	Substitui o texto do leitor de tela associado ao botão Desassociar da caixa de diálogo.
Tamanho	Especifica o tamanho da caixa de diálogo Detalhes. As opções são "padrão", "grande" e "pequeno". O tamanho de página padrão Grande.
Classe CSS	Especifique uma classe ou classes CSS que serão aplicadas à caixa de diálogo resultante.
Classe CSS do Título	Especifique uma classe ou classes CSS que serão aplicadas à barra de título da caixa de diálogo resultante.

Editar ação

A habilitação de uma ação Editar permite que um usuário exiba um formulário básico editável que esteja associado ao registro da linha selecionada na subgrade, se o privilégio de Gravação tiver sido concedido por Permissões de Tabela.

Configurações da ação Editar

Nome	Descrição
Configurações Básicas
Formulário Básico	Especifica o formulário básico que será usado para editar o registro selecionado. A lista suspensa incluirá todos os formulários básicos configurados para o tipo de tabela da subgrade. Observação: se o tipo de tabela da subgrade não tiver formulários básicos, a lista suspensa ficará vazia. Se nenhum formulário básico for fornecido para a ação Editar, ela será ignorada e o botão não aparecerá na subgrade.
Configurações Avançadas
Nome do Parâmetro da ID do Registro	Especifica o nome do parâmetro de cadeia de consulta que será usado para selecionar a tabela a ser editada no formulário básico. Ele deve corresponder ao valor no Nome do parâmetro da ID do registro do formulário básico. O valor padrão desse campo, aqui e na configuração do formulário básico, é id.
Rótulo de Botão	Substitui o rótulo HTML dessa ação exibido na linha da subgrade.
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão dessa ação exibido na linha subgrade.

Configurações avançadas da caixa de diálogo do formulário Editar

Nome	Descrição
Mensagem de Carregamento	Substitui o HTML que aparece quando a caixa de diálogo está sendo carregado.
Cargo	Substitui o HTML que aparece na barra de título da caixa de diálogo.
Texto do Leitor de Tela do Botão Desassociar	Substitui o texto do leitor de tela associado ao botão Desassociar da caixa de diálogo.
Tamanho	Especifica o tamanho da caixa de diálogo Editar. As opções são "padrão", "grande" e "pequeno". O tamanho de página padrão Grande.
Classe CSS	Especifique uma classe ou classes CSS que serão aplicadas à caixa de diálogo resultante.
Classe CSS do Título	Especifique uma classe ou classes CSS que serão aplicadas à barra de título da caixa de diálogo resultante.

Ação Excluir

A habilitação de uma ação Excluir permite que um usuário exclua permanentemente a tabela representada por uma linha na subgrade, contanto que o privilégio Excluir tenha sido concedido por Permissões de Tabela.

Configurações da ação Excluir

Nome	Descrição
Configurações Básicas
Nenhum(a)
Configurações Avançadas
Confirmação	Substitui a mensagem HTML de confirmação exibida quando o usuário ativa a ação Excluir.
Rótulo de Botão	Substitui o rótulo HTML dessa ação exibido na linha da subgrade.
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão dessa ação exibido na linha subgrade.

Configurações avançadas da caixa de diálogo Excluir

Nome	Descrição
Cargo	Substitui o HTML que aparece na barra de título da caixa de diálogo.
Texto do Botão Primário	Substitui o HTML que aparece no botão Primário (Excluir) na caixa de diálogo.
Texto do Botão Fechar	Substitui o HTML que aparece no botão Fechar (Cancelar) na caixa de diálogo.
Texto do Leitor de Tela do Botão Desassociar	Substitui o texto do leitor de tela associado ao botão Desassociar da caixa de diálogo.
Tamanho	Especifica o tamanho da caixa de diálogo Excluir. As opções são "padrão", "grande" e "pequeno". O tamanho de página padrão é Padrão.
Classe CSS	Especifique uma classe ou classes CSS que serão aplicadas à caixa de diálogo resultante.
Classe CSS do Título	Especifique uma classe ou classes CSS que serão aplicadas à barra de título da caixa de diálogo resultante.
Classe CSS do Botão Primário	Especifique uma classe ou classes CSS que serão aplicadas ao botão Primário (Excluir) da caixa de diálogo.
Classe CSS do Botão Fechar	Especifique uma classe ou classes CSS que serão aplicadas ao botão Fechar (Cancelar) da caixa de diálogo.

Ação de fluxo de trabalho

Habilitar uma Ação de fluxo de trabalho permite que o usuário execute um fluxo de trabalho sob demanda em relação ao registro selecionado na subgrade. Você pode adicionar qualquer número de ações de Fluxo de trabalho aos metadados da subgrade.

Configurações da ação de fluxo de trabalho

Nome	Descrição
Configurações Básicas
Fluxo de trabalho	Especifica o fluxo de trabalho sob demanda que será executado quando o usuário ativar essa ação. Observação: se o tipo de tabela da subgrade não apresentar fluxos de trabalho, a lista suspensa aparecerá vazia. Se nenhum fluxo de trabalho for fornecido para a ação Fluxo de trabalho, ela será ignorada e o botão não aparecerá na subgrade.
Rótulo de Botão	Define o rótulo HTML dessa ação exibido na linha da subgrade. Esta configuração é obrigatória.
Configurações Avançadas
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão dessa ação exibido na linha subgrade.

Ação Desassociar

Habilitar uma ação Desassociar permite que o usuário remova o vínculo entre o registro representado pela configuração formulário básico e o registro representado pela linha selecionada na subgrade, contanto que os privilégios "Acrescentar" e "Acrescentar a" tenham sido concedidos por Permissões de Tabela para os tipos de tabelas aplicáveis.

Configurações da ação Desassociar

Nome	Descrição
Configurações Básicas
Nenhum(a)
Configurações Avançadas
Rótulo de Botão	Substitui o rótulo HTML dessa ação exibido na linha da subgrade.
Dica de Ferramenta do Botão	Substitui o texto da dica de ferramenta que aparece quando o usuário aponta para o botão dessa ação exibido na linha subgrade.

Confira também

Configurar um portal
Definir formulários básicos
Propriedades de Formulário de várias etapas para portais
Etapas do Formulário de Várias Etapas para portais
Metadados de formulários de várias etapas para portais
Configuração de notas dos Formulários de várias etapas para portais