Configurer un élément de données de relation pour une liste incorporée
Configurez les éléments de données de relation afin de pouvoir contrôler les informations qui apparaissent dans les listes incorporées dans un écran d’enregistrement.
Avant de commencer
Rôle requis : admin
Pourquoi et quand exécuter cette tâche
Un élément de données de relation est requis pour créer une liste incorporée. Les listes incorporées sont des listes qui peuvent être incorporées dans un écran d’enregistrement. Pour plus d’informations sur les listes incorporées dans Mobile, reportez-vous à la section Listes incorporées pour un écran d’enregistrement.
Procédure
-
Accédez à la Tous > Mobile système > Générateur d'application mobile.
Il s’ouvre Générateur d'apps mobiles dans un nouvel onglet de navigateur et affiche l’écran de sélection du périmètre de l’application.
-
Recherchez le périmètre de l’application dans lequel vous travaillez, puis sélectionnez son nom.
L'écran d'accueil des catégories Générateur d'apps mobiles s'affiche.
- Sélectionnez la catégorie de données dans le menu, puis sélectionnez Nouveau.
- Sélectionnez l’icône d’élément de données de relation , puis sélectionnez Continuer.
-
Renseignez les champs suivants selon vos besoins.
Tableau 1. Champs d’élément de données de relation Champ Description Section Propriétés : Nom Un titre pour l’élément de données. Vous pouvez avoir plusieurs éléments de données portant le même nom. Assurez-vous que ce nom est unique afin de pouvoir le retrouver facilement. Description Détails supplémentaires facultatifs sur l’élément de données. Section Data (Données) : Table La table à partir de laquelle vous souhaitez que l’élément de données extrait les informations. Cette table est la table des enregistrements incorporée sous forme de liste sur l’écran d’enregistrement parent. Remarque :Les tables personnalisées ne sont pas disponibles par défaut. Vous pouvez modifier ce comportement en modifiant la subscription.custom_table.enforce_entitlement propriété système. Pour en savoir plus sur cette modification, reportez-vous à la section Autoriser ou restreindre l’accès aux tables personnalisées dans les éléments de données Mobile.Grouper par Regroupe les résultats de la requête en fonction du champ sélectionné dans le menu. Table associée à Table à laquelle les enregistrements de cet élément de données sont liés. Par exemple, pour une liste d’enregistrements SLA de tâche incorporés dans un écran d’enregistrement de tâche, les tables associées àla valeur seraient la table de tâches . Relation Relation entre la table sélectionnée dans le champ Table et la table sélectionnée dans le champ Table associée à . Type de condition Détermine le type de condition que votre élément de données utilise. Sélectionnez parmi : - Déclarative
- Utilisez une condition déclarative pour créer des conditions pour l’élément de données à l’aide du générateur de conditions.
- Scripté
- Utilisez un script pour déterminer les conditions de votre élément de données. Une fenêtre de texte pour entrer un script apparaît sous ce champ lorsque vous sélectionnez cette option.
- Ajouter une demande codée
- Utilisez cette option uniquement lors de la création d’éléments de données pour vos écrans de graphique. Pour plus de détails sur ce type d’élément de données, reportez-vous à la section Configurer un élément de données de requête codée pour les écrans de graphique.
Condition Ensemble de conditions auxquelles l’élément de données doit se conformer. Vous pouvez créer des conditions à l’aide du Créateur de conditions. Remarque :Ce champ n’est disponible que lorsque vous sélectionnezDéclaratifdans le champ Type de condition .Trier par Vous permet d’ajouter des champs au formulaire qui vous permettent de configurer le mode de tri de la liste. Dans le générateur de conditions, sélectionnez le champ selon lequel vous souhaitez que la liste soit triée. Par exemple, sélectionnez Appelant. Sélectionnez ensuite croissant ou décroissant pour déterminer l’ordre de la liste. Remarque :Ce champ n’est disponible que lorsque vous sélectionnezDéclaratifdans le champ Type de condition .Paramètres Remarque :Le champ Paramètres ne doit pas être utilisé pour les éléments de données de relation. - Facultatif :
Si vous avez sélectionné Scripté dans le champ Type de condition , vous devez créer un script dans le champ Script de condition de la requête .
Votre condition de script doit renvoyer une chaîne de requête, que l’instance utilise pour filtrer l’élément de données. Utilisez la variable
d’entréepour accéder aux informations de l’enregistrement actuel.(function getQueryString(input) { var queryString = ''; if(input.company) { queryString += "company="+input.company; } if(input.location) { queryString += "^location="+input.location; } queryString += "^EQ^ORDERBYDESCsys_updated_on"; return queryString; })(input);Cet exemple utilise la variable
d’entréeet filtre l’élément de données pour obtenir les enregistrements correspondant aux enregistrements actuels, à la société et à l’emplacement. Le texte^EQ^ORDERBYDESCsys_updated_onest ensuite ajouté à la requête, qui trie les enregistrements d’éléments de données en fonction du champ Mis à jour le .Remarque :La variabled’entréepermet aux scripts mobiles d’accéder aux valeurs transmises dans les objets SubmittedForm ou ParameterData. - Sélectionnez Enregistrer.
Que faire ensuite
Après avoir créé un élément de données de relation, créez un écran de liste à l’aide de cet élément de données nouvellement créé. Pour plus d'informations, consultez Configuration de l’écran de liste.