Comparteix via


formContext.ui.formSelector (referència de l'API del client)

La propietat formContext.ui.formSelector us permet treballar amb elements de formulari en què un element de formulari representa un formulari disponible per a un usuari perquè està associat a una funció de seguretat a la qual l'usuari també està associat. Sovint només hi haurà una forma. Quan hi ha més d'un formulari disponible, es poden utilitzar mètodes per a un element de formulari per canviar el formulari que l'usuari està visualitzant.

Nota

No formContext.ui.formSelectors'admet per als formularis de creació ràpida.

Nota

El selector de formularis no és visible si l'usuari només té accés a un formulari principal

Els elements de formulari estan disponibles a través de qualsevol dels següents:

  • col·lecció formselector.items: col·lecció de tots els elements del formulari accessibles per a l'usuari actual. Només els formularis que comparteixen una associació amb una de les funcions de seguretat de l'usuari estan disponibles en aquesta col·lecció. Exemple:

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

    Vegeu Col·leccions per obtenir informació sobre els mètodes de recollida.

    Nota

    Aquesta col·lecció no està disponible per als clients mòbils del Dynamics 365 (telèfons i tauletes).

  • formselector.getCurrentItem metode: Retorna una referència al formulari que s'està mostrant actualment. Quan només hi ha un formulari disponible, aquest mètode retornarà null. Exemple:

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

Mètodes de l'element de formulari

Després de recuperar un element de formulari mitjançant una de les maneres anteriors, utilitzeu els mètodes següents per treballar amb l'element de formulari.

Nom Descripció
getId Retorna l'identificador del formulari.
getLabel Retorna l'etiqueta del formulari.
getVisible Retorna un valor que indica si el formulari és visible actualment.
navegar Obre el formulari especificat.
setVisible Defineix un valor que indica si el formulari és visible.