formContext.ui.formSelector (referencia de la API de cliente)

  • Artículo

La propiedad formContext.ui.formSelector le permite trabajar con los elementos de formulario donde un elemento de formulario representa un formulario que está disponible para un usuario porque está asociado con un rol de seguridad al que el usuario también está asociado. A menudo habrá solo un formulario. Cuando hay más de un formulario disponible, los métodos para un elemento del formulario se pueden usar para cambiar el formulario que el usuario está visualizando.

Nota

formContext.ui.formSelector no es compatible con formularios de creación rápida.

Nota

El selector de formulario no es visible si el usuario solo tiene acceso a un formulario principal

Los elementos del formulario están disponibles a través de cualquiera de las siguientes:

  • Recopilación formselector.items: una recopilación de todos los elementos de formulario accesibles al usuario actual. Sólo los formularios que comparten una asociación con uno de los roles de seguridad del usuario están disponibles en esta colección. Ejemplo:

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

    Consulte Colecciones para obtener información sobre los métodos de recopilación.

    Nota

    Esta recopilación no está disponible para los clientes de móviles de Dynamics 365 (teléfonos y tabletas).

  • Método formselector.getCurrentItem: devuelve una referencia al formulario mostrado actualmente. Si solo hay un formulario disponible, este método devolverá el valor nulo. Ejemplo:

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

Métodos de elementos de formulario

Después de recuperar un elemento de formulario de una de las formas anteriores, utilice los siguientes métodos para trabajar con el elemento de formulario.

Nombre Descripción
getId Devuelve el identificador del formulario.
getLabel Devuelve la etiqueta del formulario.
getVisible Devuelve un valor que indica si el formulario está visible actualmente.
navigate Abre el formulario especificado.
setVisible Establece un valor que indica si el formulario está visible.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).