Compartilhar via

formContext.ui.formSelector (referência da API do cliente)

A propriedade formContext.ui.formSelector permite que você trabalhe com itens de formulário em que um item de formulário representa um formulário que está disponível para um usuário porque está associado a uma função de segurança à qual o usuário também está associado. Muitas vezes haverá apenas um formulário. Quando mais de um formulário está disponível, os métodos para um item de formulário podem ser usados para alterar o formulário que o usuário está exibindo.

Observação

Não formContext.ui.formSelectorhá suporte para formulários de criação rápida.

Observação

O seletor de formulário não ficará visível se o usuário tiver acesso apenas a um formulário principal

Os Itens de Formulário estão disponíveis por meio de qualquer um dos seguintes:

  • coleção formselector.items: uma coleção de todos os itens de formulário acessíveis ao usuário atual. Somente os formulários que compartilham uma associação com uma das funções de segurança do usuário estão disponíveis nesta coleção. Exemplo:

    formItem = formContext.ui.formSelector.items.get(arg);

    Consulte Coleções para obter informações sobre os métodos de coleção.

    Observação

    Esta coleção não está disponível para clientes móveis do Dynamics 365 (telefones e tablets).

  • Método formselector.getCurrentItem: retorna uma referência ao formulário que está sendo mostrado no momento. Quando apenas um formulário estiver disponível, esse método retornará nulo. Exemplo:

    formItem = formContext.ui.formSelector.getCurrentItem();

Métodos de Item de Formulário

Depois de recuperar um item de formulário usando uma das maneiras acima, use os métodos a seguir para trabalhar com o item de formulário.

Nome Descrição
Getid Retorna a ID do formulário.
getLabel Retorna o rótulo do formulário.
getVisible Retorna um valor que indica se o formulário está visível no momento.
navegar Abre o formulário especificado.
setVisible Define um valor que indica se o formulário está visível.
  • Last updated on