Freigeben über

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.

Anmerkung

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

Anmerkung

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.

    Anmerkung

    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 des Dataflows 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.