formContext.ui.formSelector (Referencia da API do cliente)

A propiedade formContext.ui.formSelector permítelle traballar con elementos de formulario nos que un elemento de formulario representa un formulario que está dispoñible para un usuario porque está asociado a un rol de seguridade ao que o usuario tamén está asociado. Moitas veces só haberá unha forma. Cando hai máis dun formulario dispoñible, pódense usar métodos para un elemento de formulario para cambiar o formulario que o usuario está a ver.

Nota

Non formContext.ui.formSelectorestá soportado para formularios de creación rápida.

Nota

O selector de formularios non é visible se o usuario só ten acceso a un formulario principal

Os elementos de formulario están dispoñibles a través de calquera dos seguintes:

• formselector.items collection: Colección de todos os elementos do formulario accesibles para o usuario actual. Só están dispoñibles nesta colección aqueles formularios que comparten unha asociación cun dos roles de seguridade do usuario. Exemplo:

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

  Vexa Coleccións para obter información sobre os métodos de recollida.

  Nota

  Esta colección non está dispoñible para clientes móbiles de Dynamics 365 (teléfonos e tabletas).

• formselector.getCurrentItem método: Devolve unha referencia ao formulario que se está a mostrar actualmente. Cando só hai un formulario dispoñible, este método devolverá nulo. Exemplo:

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

Métodos do elemento do formulario

Despois de recuperar un elemento de formulario usando unha das formas anteriores, use os seguintes métodos para traballar co elemento de formulario.

Nome	Descrición
getId	Devolve o ID do formulario.
getLabel	Devolve a etiqueta do formulario.
obtén visible	Devolve un valor que indica se o formulario está actualmente visible.
navegar	Abre o formulario especificado.
establecer Visible	Establece un valor que indica se o formulario é visible.