Configurer un écran de liste paramétré

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 8 minutes de lecture

    • Configurez un écran de liste pour interroger un utilisateur sur un paramètre, que l’écran utilise pour filtrer les enregistrements qui apparaissent à l’écran.

    Avant de commencer

    Rôle requis : admin
    La création d’une liste paramétrée est similaire à la création d’une liste standard. En plus des étapes suivies pour créer une liste standard, vous devez créer :
    • Élément de données paramétré pour votre liste. Cet élément de données utilise votre paramètre pour filtrer les données affichées dans votre liste.
    • Un paramètre sur votre écran de liste. Ce paramètre stocke la valeur transmise à votre liste.
    • Un mappage de paramètre d'interface utilisateur d'écran pour associer le paramètre dans votre liste au paramètre dans votre élément de données.

    Procédure

    1. Accédez à la Tout > Mobile système > Mobile App Builder.
      Le Générateur d'application mobile
    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.
      Le Générateur d'application mobile
    3. Sélectionnez la catégorie Écrans, puis sélectionnez Nouveau.
    4. Sélectionnez l’option Liste dans la page Créer un écran, puis sélectionnez Continuer.
    5. Renseignez les champs suivants si nécessaire.
      Tableau 1. Enregistrement de l’écran de la liste
      Champ Description
      Propriétés
      Nom Le nom de votre écran de liste. Ce nom apparaît comme une mosaïque dans l’application Mobile.
      Description Informations supplémentaires sur votre écran de liste.
      Paramètres de l'écran
      Disponible en mode hors connexion Option permettant de déterminer si l’écran est disponible en mode hors ligne ou non.
      Masquer le pseudonyme Option permettant de déterminer si le nom de l'écran n'est pas affiché en tant qu'en-tête d'écran. Ceci est utile si le texte apparaît déjà dans le nom de l’en-tête ou s’il ne fournit aucune valeur à l’utilisateur.
      Masquer les filtres Option pour empêcher la liste d’afficher un filtre de liste.
      Icône Icône utilisée pour représenter votre écran de liste lorsqu’elle est ajoutée à un écran de lanceur.
      Filtre personnalisé Option permettant d’ajouter un filtre personnalisé pour filtrer les types d’enregistrements par catégorie.
      État vide Configurez ce qui s’affiche dans un espace vide lorsqu’aucune donnée n’est disponible à afficher.
      Segments d'écran Configurez des segments d’écran supplémentaires pour l’écran de liste.
      Instances de fonctions du menu supérieur Option permettant de déterminer s'il faut utiliser des fonctions du menu supérieur pour afficher des options supplémentaires.
      Instances de fonction de pied de page Option permettant de déterminer s’il faut utiliser les fonctions de pied de page pour afficher des options supplémentaires.
      Paramètres de l'interface utilisateur Modifiez le comportement d’un champ ou d’un élément d’interface utilisateur.
      Titre d'écran dynamique Vous permet de créer un élément et de le mapper à un paramètre d’interface utilisateur. Utilisez-le pour transmettre une valeur d’un écran à un autre et l’inclure dans le titre de l’écran de destination.
      Accès du rôle Déterminez quels rôles d'utilisateur peuvent accéder à cet écran. Si vous n’avez sélectionné aucun rôle, les utilisateurs ayant n’importe quel rôle auront accès à l’écran.
    6. Dans la section Icône , sélectionnez une icône existante ou créez-en une.

      Cette icône s’affiche dans l’écran du lanceur lorsque vous l’ajoutez à votre écran de liste. Pour plus d’informations sur la création d’icônes, reportez-vous à la section Icônes Mobile.

    7. Dans la section Segments d’écran, sélectionnez Nouveau.
    8. Renseignez les champs suivants si nécessaire.
      Tableau 2. Enregistrement de segment d’écran
      Champ Description
      Propriétés
      Nom Nom de l’écran de segment d’écran.
      Ordre Ordre dans lequel le segment apparaît à l’écran. Les segments s’affichent de la valeur la plus basse à la valeur la plus élevée.
      Écran Affiche le nom de liste à partir de l’enregistrement d’écran de liste.
      Nombre maximum de lignes hors ligne Nombre de lignes affichées pour l’affichage hors connexion.
      Flux Enregistrements qui connectent des éléments de données et des enregistrements de configuration d’élément de liste à l’écran de liste.
      Tri de l'entrelacement
      Champ d'entrelacement de flux de liste de tri Déterminez si le champ d’entrelacement du flux de liste est trié par ordre croissant ou décroissant.
    9. Dans la section Flux , sélectionnez Nouveau.
    10. Renseignez les champs suivants si nécessaire.
      Tableau 3. Enregistrement de flux de liste
      Champ Description
      Propriétés
      Nom Nom du flux.
      Table Choisissez la table pertinente qui contient les données à afficher dans votre liste.
      Champ d’entrelacement Sélectionnez le champ que vous souhaitez utiliser pour entrelacer votre élément de données.
      Élément de données Les éléments de données sont des requêtes sur une table sélectionnée qui fournissent les données présentées dans un écran.
      Configuration d'élément de liste Déterminez comment chaque enregistrement apparaît et les actions qui lui sont associées.
    11. Dans la section Élément de données , sélectionnez Nouveau.
    12. Renseignez les sections Propriétés (Propriétés ) et Données (Données ) selon vos besoins.
      Pour en savoir plus sur la création d'un élément de données, reportez-vous à la rubrique Configurer un élément de données standard.
    13. Dans la section Paramètres , sélectionnez Nouveau.
    14. Dans l’écran Paramètres de données , dans le champ Nom , entrez un nom pour le paramètre.

      Les noms de paramètres correspondent souvent aux champs d’un formulaire. Par exemple, saisissez Priorité comme nom de paramètre lorsque le champ fait référence à la priorité.

    15. Dans le champ Type , sélectionnez un type de données pour le paramètre.

      Le type détermine comment l’utilisateur interagit avec l’interface utilisateur Mobile. Par exemple, un type Décimal ou Entier indique à l’équipement mobile d’ouvrir un clavier comprenant uniquement des chiffres. Sélectionnez un type parmi les types suivants :

      • Entier : ouvre un clavier comprenant uniquement des chiffres.
      • Chaîne : utilise un clavier complet pour la saisie. Utilisez le type Chaîne pour les paramètres de liste tels que Priorité ou État ou pour les champs de référence tels que Affecté à ou Appelant.
      • Décimal : ouvre un clavier comprenant uniquement des chiffres.
      • Booléen : ouvre une option pour sélectionner Vrai ou Faux.
      • Date/Heure : ouvre un calendrier avec un sélecteur d'heure exacte
      • Date : ouvre un calendrier.
    16. Dans le formulaire Élément de données , dans la section Condition, ajoutez une condition de requête pour votre paramètre.

      Le champ Condition doit correspondre au paramètre pour lequel vous interrogez la base de données. Par exemple, si vous créez un élément de données pour interroger le champ Priorité, créez une condition de priorité appelée {{paramètre de données}}. Assurez-vous de sélectionner le paramètre de données que vous avez créé en le sélectionnant dans le générateur de conditions.

      Vous avez maintenant un élément de données paramétré à utiliser dans votre liste paramétrée. Cet exemple montre un élément de données paramétré qui utilise un paramètre nommé Priorité pour filtrer les éléments de données pour une priorité correspondant à la valeur de ce paramètre.

    17. Revenez à votre flux de liste à l’aide de l’arborescence de configuration hiérarchique.
    18. Dans le champ Élément de données , sélectionnez l’élément de données paramétré que vous avez créé lors des étapes précédentes.
    19. Revenez à votre écran de liste et sélectionnez Nouveau sous Paramètres de l’interface utilisateur pour créer un nouveau paramètre d’interface utilisateur.
    20. Renseignez les champs suivants si nécessaire.
      Champ Valeur
      Nom Nom de votre paramètre de l'interface utilisateur.
      Nom d'affichage Renseigné automatiquement avec le même texte que celui utilisé pour le champ Nom .
      Paramètres
      Type de paramètre Ce champ est automatiquement renseigné.
      Écran Ce champ est automatiquement renseigné.
      Style d'entrée Style d'entrée pour votre paramètre. Sélectionnez entre En ligne, Fenêtre contextuelle ouAucun.
      Obligatoire Détermine si l’entrée de l’utilisateur pour le paramètre est obligatoire.
      Texte d’espace réservé Texte qui s'affiche dans le champ d'entrée de paramètre avant que les utilisateurs n'entrent une valeur.
      Ordre Champ facultatif que vous pouvez utiliser pour définir l’ordre dans lequel les paramètres de l’interface utilisateur s’affichent. Si vous avez plusieurs paramètres, définissez l’ordre.
      Source d’entrée Indiquez si l’entrée du paramètre provient de l’entrée de l’utilisateurou du remplissage automatique. Sélectionnez l’entrée utilisateur pour cet exemple.
      Type d’entrée

      Comment vos utilisateurs entrent une valeur pour ce paramètre. Sélectionnez une option parmi les suivantes :

      • Texte
      • Liste de choix
      • Liste de recherches
      • Code QR/Code-barres

      Sélectionnez Liste de choix pour cet exemple.
      Transporté Si ce paramètre est un paramètre transporté. Utilisez des paramètres transportés pour déplacer l’information entre les différents écrans et actions.
      Sélection multiple Indique si l'utilisateur peut sélectionner plusieurs valeurs à partir de la liste de choix. Ce champ n’est visible que lorsque le champType d’entrée est défini sur Liste de choix.
      Données
      Table Table utilisée pour la liste de choix dans laquelle les utilisateurs sélectionnent une valeur de paramètre. Ce champ n’est visible que lorsque le champ Type d’entrée est défini sur Liste de choix ou Liste de recherche.
      Champ Le champ utilisé pour la liste de choix dans laquelle les utilisateurs sélectionnent une valeur de paramètre. Ce champ n’est visible que lorsque le champ Type d’entrée est défini sur Liste de choix ou Liste de recherche.
      Mappage des paramètres des données d'écran Déterminez les valeurs spécifiques que vous souhaitez transmettre à cet écran.
    21. Dans la section Mappage des paramètres de données de l’écran , choisissez le paramètre de données que vous avez créé dans votre élément de données.
    22. Sélectionnez Enregistrer.
    23. Facultatif : Nous avons ajouté la prise en charge de l’élément de données paramétré avec un écran de formulaire d’entrée. Pour en savoir plus, reportez-vous à Prise en charge des éléments de données paramétrés pour les écrans de formulaire d’entrée.

      Ces étapes vous permettent de configurer un écran de formulaire d’entrée qui contient les entrées et les variables que vous souhaitez utiliser dans le cadre de la condition de requête d’élément de données. Cette fonctionnalité est configurée dans l’interface utilisateur Web au lieu de Générateur d'application mobile.

      Remarque :

      L’écran du formulaire d’entrée peut contenir uniquement des entrées, uniquement des variables ou à la fois des entrées et des variables à utiliser dans le cadre de la condition de requête d’élément de données. Pour plus d'informations sur la création d'un écran du formulaire d'entrée, consultez Configurer un écran de formulaire d'entrée.

      1. Accédez à la liste cible, par exemple, si vous souhaitez configurer un écran de liste d’éléments de données paramétrés :
        1. Entrez sys_sg_list_screen.list dans le filtre
        2. Sélectionnez l’écran de liste que vous souhaitez paramétrer.
        3. Dans le champ Écran du formulaire d’entrée , recherchez l’écran du formulaire d’entrée que vous avez créé.
        4. Sélectionnez Mettre à jour.
      2. Mappez les entrées ou les variables créées dans l’écran du formulaire d’entrée au paramètre de données, comme indiqué dans la table suivante.
        Tableau 4. Formulaire Mappage des paramètres des variables d’entrée
        Champ Description
        Variable Variable d’écran du formulaire d’entrée
        Écran Écran cible. Ce champ se remplit automatiquement.
        Application Périmètre de l'application. Ce champ se remplit automatiquement.
        Entrée Étiquette d’entrée à partir de l’écran du formulaire d’entrée
        Paramètre de données Paramètre de données de l’élément de données de l’écran cible