Share via

formContext.ui.formSelector (Client-API-Referenz)

  • Artikel

Die Eigenschaft formContext.ui.formSelector können Sie verwenden, um mit Formularelementen zu arbeiten, bei denen Element ein Formular repräsentiert, das für einen Benutzer verfügbar ist, da es einer Sicherheitsrolle zugeordnet ist, der auch der Benutzer zugeordnet ist. Häufig ist nur ein Formular vorhanden. Wenn mehr als ein Formular verfügbar ist, können Methoden für ein Formularelement verwendet werden, um das Formular zu ändern, das der Benutzer anzeigt.

Hinweis

formContext.ui.formSelector wird für Schnellerstellungsformulare nicht unterstützt.

Hinweis

Die Formularauswahl ist nicht sichtbar, wenn der Benutzer nur Zugriff auf ein Hauptformular hat

Formular-Elemente sind durch folgende Aktionen verfügbar:

  • formselector.items-Sammlung: Eine Sammlung von Formularelementen, die für den aktuellen Benutzer verfügbar sind. Nur Formulare, die einer Verknüpfung mit einer der Sicherheitsrollen des Benutzenden gemeinsam haben, sind in dieser Sammlung verfügbar. Beispiel:

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

    Weitere Informationen zu den Sammlungsmethoden finden Sie unter Sammlungen für Informationen zu den Sammlungsmethoden.

    Hinweis

    Diese Sammlung ist nicht für mobile Dynamics 365-Clients (Tablets und Smartphones) verfügbar.

  • formselector.getCurrentItem Methode: Gibt einen Verweis auf das Formular zurück, das zurzeit angezeigt wird. Wenn nur ein Formular verfügbar ist, gibt diese Methode null zurück. Beispiel:

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

Formular-Element-Methoden

Nachdem Sie ein Formularelement mithilfe einer der oben beschriebenen Methoden erhalten haben, können Sie die folgenden Möglichkeiten verwenden, um mit dem Formularelement zu arbeiten.

Name Beschreibung
getId Gibt die ID des Formulars zurück.
getLabel Gibt die Beschriftung des Formulars zurück.
getVisible Gibt einen Wert zurück, der angibt, ob das Formular derzeit angezeigt wird.
navigate Öffnet das angegebene Formular.
setVisible Legt einen Wert fest, der angibt, ob das Formular angezeigt wird.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).