Partager via

formContext.ui.formSelector (référence de l’API client)

  • Article

La propriété formContext.ui.formSelector vous permet d’utiliser les éléments de formulaire, où un élément de formulaire représente un formulaire accessible à un utilisateur, car il est associé à un rôle de sécurité auquel l’utilisateur est également associé. Il existe souvent un seul formulaire. Lorsque plusieurs formulaires sont disponibles, les méthodes d’un élément de formulaire peuvent être utilisées pour modifier le formulaire que l’utilisateur consulte.

Notes

formContext.ui.formSelector n’est pas pris en charge pour les formulaires de création rapide.

Notes

Le sélecteur de formulaire n’est pas visible si l’utilisateur n’a accès qu’à un seul formulaire principal

Les éléments de formulaire sont disponibles via l’un des éléments suivants :

  • Collection formselector.items : collection de tous les éléments de formulaire accessibles à l’utilisateur actuel. Seuls les formulaires qui partagent une association avec l’un des rôles de sécurité de l’utilisateur sont disponibles dans cette collection. Exemple :

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

    Voir Collections pour plus d’informations sur les méthodes de collection.

    Notes

    Cette collection n’est pas disponible pour les clients Dynamics 365 mobile (téléphones et tablettes).

  • Méthode formselector.getCurrentItem : renvoie une référence au formulaire actuellement affiché. Lorsqu’un seul formulaire est disponible, cette méthode renvoie null. Exemple :

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

Méthodes d’élément de formulaire

Après avoir récupéré un élément de formulaire à l’aide de l’une des méthodes décrites ci-dessus, utilisez les méthodes suivantes pour utiliser l’élément de formulaire.

Nom Description
getId Renvoie l’ID du formulaire.
getLabel Renvoie l’étiquette du formulaire.
getVisible Renvoie une valeur indiquant si le formulaire est actuellement visible ou non.
navigate Ouvre le formulaire spécifié.
setVisible Définit une valeur qui indique si le formulaire est visible.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).