Configurer des éléments descriptifs pour les écrans du formulaire d’entrée

  • Rversion finale: Yokohama
  • Mis à jour 5 mars 2025
  • 4 minutes de lecture

    • Ajoutez des éléments descriptifs, tels que du texte simple, du texte enrichi ou une image, avant un champ d’entrée dans un écran de formulaire d’entrée. Ces informations supplémentaires à l’écran fournissent un contexte à vos utilisateurs, ce qui leur permet de mieux comprendre ce qui est requis lorsqu’ils entrent des données dans un formulaire d’entrée.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez ajouter des éléments descriptifs aux champs d’entrée, aux sections qui en contiennent ou même aux sections de formulaire d’entrée sans entrée. Les éléments descriptifs peuvent être une sélection de texte simple, de texte enrichi ou une image qui précède une entrée.

    Vous devez avoir les éléments suivants configurés pour configurer des éléments descriptifs :
    • Source de données qui contient au moins un identificateur d’élément. Les sources de données facilitent le mappage de l’élément descriptif à l’écran du formulaire d’entrée. Pour plus d'informations, consultez Sources de données.
    • Section d’enregistrement qui peut être une section d’entrée ou une section de formulaire d’entrée :
      • Une section de formulaire d’entrée est un groupe d’entrées dans une zone définie de l’écran du formulaire d’entrée, généralement avec un en-tête défini.
      • Les entrées sont des champs individuels que les utilisateurs doivent compléter avec l’écran du formulaire d’entrée. Les entrées peuvent être situées dans une section ou indépendamment d’une section.
    Remarque :
    Il peut y avoir plusieurs éléments descriptifs pour chaque entrée ou pour chaque section de formulaire d’entrée. Toutefois, vous devez créer un enregistrement distinct pour chaque élément descriptif de chaque entrée.
    Les étapes suivantes sont nécessaires lors de la création d’un élément descriptif : Tout d’abord, déclarez ce qu’est l’élément descriptif et à quoi il est lié. Déterminez ensuite si l’élément descriptif est associé à une entrée ou à une section de formulaire d’entrée. Ensuite, créez des attributs pour chaque type d’élément descriptif que vous avez sélectionné. Enfin, mappez l’élément descriptif dans un élément d’interface utilisateur d’écran de formulaire d’entrée.
    Éléments descriptifs d’une image et texte enrichi sur un écran de formulaire d’entrée Éléments descriptifs d’image et de texte brut sur un écran de formulaire d’entrée
    Éléments descriptifs d’une image et texte enrichi dans un écran de formulaire d’entrée. Éléments descriptifs d’une image et texte brut dans un écran de formulaire d’entrée.

    Procédure

    1. Accédez à la Tout > Mobile système > Mobile App Builder.
      Générateur d'apps mobiles s'ouvre dans un onglet de navigateur séparé et affiche l'écran de sélection du périmètre de l'application.
    2. Recherchez le périmètre de l’application dans lequel vous travaillez, puis sélectionnez le nom du périmètre de l’application.
      L'écran d'accueil des catégories Générateur d'apps mobiles s'affiche.
    3. Sélectionnez Tous les enregistrements mobiles dans le menu.
    4. Dans le champ Type d’enregistrement, sélectionnez Élément descriptif [sys_sg_descriptive_element], puis Nouveau.
    5. Renseignez les champs suivants si nécessaire.
      Champ Valeur
      Propriétés
      Nom Nom unique pour votre élément descriptif.
      Étiquette Étiquette qui s’affiche au-dessus de l’élément descriptif.
      Paramètres
      Types d’éléments descriptifs Trois éléments descriptifs sont disponibles :
      • Texte enrichi : prend en charge les balises HTML telles que le gras, le soulignement, l’italique, les puces, les listes numérotées et la couleur de police.
      • Texte : texte brut sans aucun élément de texte enrichi.
      • Image : Une seule image pour accompagner l’élément descriptif.
      Remarque :
      Les attributs disponibles avec le champ Attributs d’éléments descriptifs diffèrent selon l’élément descriptif que vous sélectionnez.
      Commande Ordre dans lequel cet élément descriptif s’affiche avant l’entrée.
      Emplacement de l'élément descriptif
      Table parente Option permettant de placer l’élément descriptif dans une zone spécifiée. Les options suivantes sont disponibles :
      • Entrée : l’élément descriptif précède l’entrée.
      • Section de formulaire d’entrée : l’élément descriptif existe dans la section spécifique.
      Remarque :
      Habituellement, un élément descriptif est placé en haut d’une section. Cependant, il existe également une option permettant d’inclure un élément descriptif dans une section sans afficher d’entrées.
      Pour effectuer cet affichage :
      1. Ouvrez l’interface utilisateur Web.
      2. Accédez à la Tout > sys_sg_section_attribute.
      3. Sélectionnez Nouveau.
      4. Dans le champ Nom , ajoutez le nom de l’attribut HideIfDescriptiveOnly avec la valeur false. Ce paramètre indique que les éléments descriptifs sont affichés même s’il n’y a pas d’entrées dans cette section.
      Enregistrement parent Section d’entrée ou de formulaire d’entrée à laquelle la table parente se rapporte.
      Attributs d'élément descriptif Utilisez des attributs pour déterminer le mode d’affichage des éléments descriptifs sur l’appareil mobile. Sélectionnez Nouveau pour ajouter des attributs. Les attributs suivants sont disponibles pour tous les types d’éléments descriptifs (texte enrichi, texte et image) :
      • DataSourceId : identificateur unique de la source de données avec laquelle vous travaillez
      • ElementIdentifier : identificateur unique pour chaque élément de l’interface utilisateur.
        Remarque :
        Cet identificateur est répertorié sous la forme valuesMapper.addRecordMapping dans le script de source de données
      • MergeWithNextUIElement : voici comment l’élément descriptif apparaît sur l’écran du formulaire d’entrée. Marquez comme vrai pour créer un écart entre les entrées ou les sections d’entrée.
        Les valeurs par défaut suivantes existent :
        • La table parente de type entrée a une valeur faux.
        • La table parente de type Section de formulaire d’entrée a la valeur true.
      Remarque :
      Les éléments descriptifs doivent contenir des valeurs pour les attributs DataSourceId et ElementIdentifier.
      Les attributs suivants sont également disponibles pour le type d’élément descriptif, Image :
      • AlternativeText : possibilité de saisir un texte alternatif à lire aux utilisateurs.
      • MediaHeight : La hauteur de l’image. La valeur par défaut est de 210 pixels.
      • Mise à l’échelle : sélectionnez Ajuster pour vous assurer que le cadre s’adapte à l’image, en conservant ses proportions. Sélectionnez Remplissage pour que l’image soit recadrée afin de remplir le cadre. Il s’agit de la valeur par défaut.
    6. Dans le champ Attributs d’éléments descriptifs, sélectionnez Nouveau et procédez comme suit :
      1. Sélectionnez DataSouceId dans le champ Nom .
      2. Dans le champ Valeur , sélectionnez une valeur telle que répertoriée dans le script source de données.
      3. Sélectionnez Enregistrer.
      4. Sélectionnez ElementIdentifier dans le champ Nom .
      5. Saisissez l’identificateur d’élément tel qu’il est écrit dans le script source de données.
      6. Sélectionnez Enregistrer.
      Remarque :
      La valeur disponible pour les sources de données et l’identificateur d’élément sont détaillées dans le script de source de données. Vous sélectionnez la source de données qui contient le mappage à l’identificateur d’élément que vous souhaitez utiliser pour cet élément descriptif.
    7. Facultatif : Sélectionnez tous les autres attributs d’éléments descriptifs pertinents pour l’élément descriptif sur lequel vous travaillez.
    8. Sélectionnez Enregistrer.