Ajouter des formulaires aux pages du générateur d’IU

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • Utilisez le composant Formulaire pour ajouter un ou plusieurs formulaires à des Générateur d'IU pages.

    Ajoutez des fonctionnalités à vos Générateur d'IU pages en incluant des formulaires. Vous définissez les champs sur le formulaire et leurs propriétés, par exemple en les rendant obligatoires. Ensuite, collectez les données au fur et à mesure que le formulaire est rempli et soumis.
    Figure 1. Exemple de composant de formulaire
    Exemple de composant de formulaire nommé tâche de ligne d’ordre de transfert sur une page.
    Vous pouvez ajouter plusieurs formulaires à une seule page. Vous pouvez également ajouter un formulaire à une page qui contient déjà un composant avec un formulaire imbriqué. Voici quelques exemples de cas d’utilisation :
    • Étendez les pages d’enregistrement en ajoutant un onglet en ligne avec un formulaire à l’aide de sa propre instance de contrôleur de formulaire.
    • Ajoutez des modaux avec un formulaire sur une page d’enregistrement.
    Pour les pages existantes avec des formulaires créés dans une version antérieure à Xanadu ServiceNow , vous devez appliquer un paramètre prédéfini au formulaire d’origine avant d’ajouter un autre formulaire à la page. L’application du paramètre prédéfini est une condition préalable à l’ajout de plusieurs formulaires à une page et permet à plusieurs formulaires de fonctionner comme prévu sur une page. Le paramètre prédéfini de contrôleur de formulaire doit être appliqué à tous les contrôleurs de formulaire.
    1. Ouvrez la page contenant un formulaire existant.
    2. Dans le tiroir de données, développez la liste Ressources de données et sélectionnez le contrôleur de formulaire d’origine.

      Tiroir de données avec la liste des ressources de données développée et la flèche noire pointant vers le contrôleur de formulaire.

    3. Sélectionnez le champ Préréglage .
    4. Sélectionnez le paramètre prédéfini du contrôleur de formulaire.

      Fenêtre contextuelle Modifier le contrôleur de formulaire avec une flèche noire pointant vers le champ prédéfini et une seconde flèche noire pointant vers l’option prédéfinie du contrôleur de formulaire.

    5. Sélectionnez Appliquer.
    6. Sélectionnez le X pour fermer la fenêtre contextuelle Modifier le contrôleur de formulaire .

      Un seul de vos contrôleurs de formulaires doit avoir la propriété Est mappé à l’interpréteur de commandes de l’application définie sur vrai. Cette propriété est utilisée pour spécifier le formulaire primaire sur la page. Le formulaire primaire est responsable de la gestion des événements mondiaux. Vous ne devez pas définir la propriété sur vrai pour plusieurs contrôleurs de formulaire ou avoir zéro contrôleur de formulaire avec la propriété définie sur vrai.

    7. Ouvrez la page contenant un ou plusieurs formulaires.
    8. Dans l’arborescence de contenu, sélectionnez un formulaire.

      Arborescence de contenu avec une flèche noire pointant vers un composant de formulaire.

    9. Dans le panneau de configuration, sous l’onglet Configurer , sélectionnez Contrôleur de formulaire.

      Panneau de configuration du formulaire avec l’onglet de configuration affiché et la flèche noire pointant vers le lien du contrôleur de formulaire.

    10. Dans la fenêtre contextuelle Modifier le contrôleur de formulaire , faites défiler la liste Contrôleur de formulaire vers le bas pour trouver l’option Est mappé à l’interpréteur de commandes d’application .

      Fenêtre contextuelle Modifier le contrôleur de formulaire avec une flèche noire pointant vers est mappé à l’option d’interpréteur de commandes d’application.

    11. Sélectionnez ou désactivez l’option pour chaque composant de formulaire sur la page afin de confirmer qu’exactement un contrôleur de formulaire est mappé à l’interpréteur de commandes d’application.

    Gestion avancée des événements de formulaire

    Les développeurs expérimentés ayant des connaissances en matière de gestion des événements de conflit peuvent trouver les détails suivants utiles.

    Si isMapped to app shell est défini sur vrai, le formulaire gère automatiquement ces événements :
    État de l'écran modifié
    • Description : action pour indiquer qu’un formulaire est erroné.
    • Sortie : CTRL_RECORD#SCREEN_STATUS_CHANGED
    Mettre à jour le menu de configuration demandé
    • Description : action pour définir les éléments du menu de configuration d’enregistrement dans le menu avatar.
    • Sortie : CTRL_RECORD#UPDATE_CONFIGURATION_MENU_REQUEST
    Téléphone demandé
    • Description : Action pour passer un appel lorsque le module d’extension CTI est activé.
    • Sortie : CTRL_RECORD#PHONE_REQUESTED
    État de chargement du formulaire changé
    • Description : Action pour afficher un chargement tournant lorsque ce formulaire charge des données.
    • Sortie : CTRL_RECORD#FORM_LOADING_STATE_CHANGED

    Pour plus d’informations sur le composant Formulaire et ses propriétés, consultez Vue d’ensemble du formulaire sur le ServiceNow site développeur.