Compartilhar via


Acesse e configure as propriedades da subgrade de um formulário

Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Visão geral das propriedades da subgrade para formulários principais de aplicativos baseados em modelo

Você pode configurar uma subgrade em um formulário para exibir uma lista de registros ou um gráfico. Selecione Mostrar Somente Gráfico na guia Exibir para mostrar um gráfico em vez de uma lista.

Você pode acessar as Propriedades da subgrade no gerenciador de soluções. Em Componentes, expanda Entidades e a entidade desejada e depois selecione Formulários. Na lista de formulários, abra o formulário do tipo Principal. Em seguida, na guia Inserir, selecione Subgrade para exibir propriedades da subgrade.

propriedades da subgrade.

Tabulação Propriedade Descrição
Tela Nome Necessário: O nome exclusivo da subgrade usado ao fazer referências em scripts. O nome pode conter somente caracteres alfanuméricos e sublinhados.
Rótulo Necessário: A etiqueta localizável da subgrade visível para os usuários.
Exibir etiqueta no formulário Se a etiqueta deve ser exibida no formulário. Ela é necessária se você habilitar Exibir Caixa de Pesquisa. Você também pode optar por ter cor no título do painel.
Records Escolha entre duas opções:

- Apenas Registros Relacionados: a subgrade exibirá somente os registros relacionados ao registro atual.
- Todos os Tipos de Registro: a subgrade exibirá os registros filtrados apenas pela exibição padrão ou, se o seletor da exibição estiver habilitado, qualquer exibição que o usuário selecionar.

A opção que você escolher afetará o comportamento do controle da lista de exibição. Mais informações: Mostrar comportamento da lista
Entidade Dependendo da opção escolhida para Registros, essa lista exibe:

- Somente Registros Relacionados: uma lista de entidades relacionadas à entidade com o nome do campo de pesquisa na entidade que define o relacionamento entre parênteses.
- Todos os Tipos de Registro: uma lista de todas as entidades.
Exibição Padrão Escolha a exibição que será aplicada por padrão. Se você não permitir nenhuma outra exibição usando a propriedade Exibir Seletor. Essa será a única exibição.

Use o botão Editar para abrir a exibição padrão para edição. Use o botão Novo para criar uma nova exibição para usar na subgrade.
Exibir a Caixa de Pesquisa Exibir a caixa de pesquisa. Quando essa opção é escolhida, a opção Exibir Etiqueta no Formulário é obrigatória.
Exibir Índice Apenas os formulários que usam os Formulários clássicos dão suporte ao índice de exibição.

Marque esta caixa de seleção se quiser que o índice alfabético fique disponível com a lista. Isso permite saltar para registros que comecem com uma letra ou um número específico.
Exibir selecionador Você tem três opções:

- Desativado: somente a exibição padrão pode ser usada.
- Mostrar Todas as Exibições: permita que os usuários escolham qualquer exibição.
- Mostrar Exibições Selecionadas: use a tecla Ctrl com seu cursor para selecionar quais exibições disponíveis mostrar.
Gráfico Padrão Selecione qual gráfico mostrar se Mostrar Somente Gráfico estiver selecionado.
Mostrar Somente Gráfico Em vez de uma lista de registros, um gráfico será exibido.
Exibir Seleção de Gráfico Se Mostrar Somente Gráfico estiver selecionado, permite que os usuários escolham diferentes gráficos.
Disponibilidade Especifique se a seção deve ficar disponível no telefone.
Formatação Layout Selecione o número de colunas ocupadas pelo controle.

Quando a seção que contém subgrades tiver mais de uma coluna, é possível definir o campo para ocupar o número de colunas da seção.
Número de linhas Determina quantos registros são mostrados em uma página de uma subgrade.
Usar espaço disponível Observação: esta propriedade só funciona com o cliente Web herdado. Isso não impacta a Interface Unificada.

Se Expandir automaticamente para usar o espaço disponível for escolhido, o formulário permitirá espaço para dois registros e expandirá o espaço conforme o número de registros aumenta. Se o número exceder o Número de Registros, os usuários poderão navegar até as páginas adicionais para exibir registros.

Se Expandir automaticamente para usar o espaço disponível não for escolhido, o formulário fornecerá espaço para o número de registros definido pelo Número de Linhas, e os usuários poderão navegar até as páginas adicionais para qualquer registros adicional.
Controles Controles Opte por adicionar controles e marque o botão de opção para tê-los na Web, no Telefone ou no Tablet.

Em formulários que usam a Formulários clássicos, as ações executadas em uma subgrade são disponibilizadas na faixa de opções. Os desenvolvedores podem personalizar o comportamento dessas ações ou adicionar ações personalizando a faixa de opções.

Em formulários que usam os Formulários atualizados, as ações para subgrades são posicionadas próximas à subgrade, facilitando seu acesso. Sempre que a barra de comandos não permitir a adição de ações personalizadas. Os desenvolvedores podem editar a faixa de opções para alterar as ações das três ações restantes: mostrar a lista, adicionar registro e excluir registro.

Mostrar o comportamento da lista

Ao exibir uma lista em formulários com os Formulários atualizados, cada subgrade exibe o botão Abrir Exibição Botão Abrir modo de exibição. no canto superior direito quando a entidade também for exibida como uma das entidades incluídas na área de navegação do editor de formulários. Selecionar este botão abrirá a exibição. O comportamento será alterado dependendo da opção escolhida para a propriedade Registros.

Ao selecionar Somente Registros Relacionados, a exibição será aberta usando uma das exibições associadas na mesma janela. Para voltar ao formulário, use o botão voltar ou selecione o valor do nome do registro principal atual na barra de navegação.

Ao selecionar Todos os Tipos de Registro, a exibição será aberta em uma nova janela.

Adicionar o comportamento do registro

Ao exibir uma lista nos formulários com os Formulários atualizados, cada subgrade exibirá o botão Adicionar registro Botão Adicionar. no canto superior direito da subgrade. Selecione esse botão permite adicionar um registro. Esse comportamento será alterado dependendo da opção escolhida para a propriedade Registros e se a pesquisa for para registros da atividade.

Ao seleciona Somente Registros Relacionados, o comportamento padrão é o comportamento para adicionar registros existentes. Os usuários veem uma pesquisa embutida para procurar por um registro existente primeiro. Isso ajuda a evitar a criação de registros duplicados. Se não pode localizar um registro existente, podem escolher a opção Novo. Quando um novo registro é criado, qualquer um dos mapeamentos de campos definidos no relacionamento será aplicado. Mais informações: Mapear campos de entidades.

Ao selecionar Todos os Tipos de Registro, o comportamento padrão é adicionar um novo registro. O formulário de criação rápida será exibido se a entidade de destino tiver um. Caso contrário, o formulário principal da entidade padrão será mostrado.

Se a subgrade exibir atividades, os usuários precisarão primeiro selecionar o tipo de atividade e verão o comportamento “adicionar novo registro” comportamento.

Excluir o comportamento do registro

Ao selecionar um registro em uma subgrade, o botão Excluir Ícone de exclusão da sublista. aparecerá do lado direito da linha. O comportamento da ação de exclusão é diferente dependendo do tipo de relacionamento com a entidade atual.

Quando a subgrade usa um relacionamento 1:N (um-para-muitos), o comportamento de exclusão de um registro normal é exibir uma caixa de diálogo de confirmação antes de excluir o registro.

Quando a subgrade usa um relacionamento N:N (muitos-para-muitos), o registro na entidade de relacionamento (ou interseção) relacionado aos dois registros é excluído sem uma confirmação e o registro não será mais exibido na subgrade. Mas o registro exibido não será excluído.

Consulte também

Usar o formulário principal e seus componentes