formContext.ui.formSelector (посилання на API клієнта)

Властивість formContext.ui.formSelector дає змогу працювати з елементами форми, де елемент форми представляє форму, доступну для користувача, оскільки її пов'язано з роллю безпеки, з яким також пов'язано користувача. Часто з'явиться лише одна форма. Якщо доступно кілька форм, можна використовувати методи для елемента форми, щоб змінити форму, яку переглядає користувач.

Нотатка

Цей formContext.ui.formSelectorпараметр не підтримується для експрес-форм створення.

Нотатка

Селектор форми не відображається, якщо користувач має доступ лише до однієї головної форми

Елементи форми доступні в будь-якому з таких елементів:

  • formselector.items collection: колекція всіх елементів форми, доступних для поточного користувача. У цій колекції доступні лише ті форми, які мають зв'язок з однією з ролей безпеки користувача. Приклад:

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

    Відомості про методи збирання див. в статті Колекції .

    Нотатка

    Ця колекція недоступна для мобільних клієнтів Dynamics 365 (телефонів і планшетів).

  • метод formselector.getCurrentItem : повертає посилання на форму, яка зараз відображається. Якщо доступна лише одна форма, цей метод поверне null-значення. Приклад:

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

Методи елемента форми

Отримавши елемент форми одним із наведених вище способів, скористайтеся наведеними нижче способами для роботи з елементом форми.

Ім'я Декрипція
getId (ідентифікатор) Повертає ідентифікатор форми.
getLabel Повертає підпис форми.
getVisible Повертає значення, яке вказує на те, чи відображається форма.
Переміщатися Відкриття вказаної форми.
setVisible Установлює значення, яке вказує на те, чи відображається форма.