Partilhar via

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

A propriedade formContext.ui.formSelector permite trabalhar 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 uma forma. 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

O formContext.ui.formSelectornão é suportado para formulários de criação rápida.

Observação

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

Os Itens de Formulário estão disponíveis através 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 coleta.

    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á null. 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 seguintes métodos para trabalhar com o item de formulário.

Nome Decripção
getId Retorna a ID do formulário.
getLabel Devolve a etiqueta 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