Configurer un élément de données de relation pour une liste incorporée

Configurez des éléments de données de relation afin que vous puissiez 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 en savoir plus sur les listes incorporées dans Mobile, consultez Listes incorporées pour un écran d’enregistrement.

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 la catégorie Données dans le menu, puis sélectionnez Nouveau.
4. Sélectionnez l'icône Élément de données de relation, puis sélectionnez Continuer.
5. Renseignez les champs suivants si nécessaire.

   Tableau 1. Champs de l'élément de données de relation

   Champ	Description
   Section Propriétés :
   Nom	Titre de l’élément de données. Il est possible d’avoir plusieurs éléments de données du même nom. Assurez-vous que ce nom est unique afin de pouvoir retrouver l’élément facilement.
   Description	Détails supplémentaires facultatifs sur l'élément de données.
   Section Données :
   Table	Table depuis laquelle vous souhaitez que l'élément de données collecte des informations. Cette table est la table des enregistrements qui est incorporée sous forme de liste sur l'écran de l'enregistrement parent. Remarque : Les tables personnalisées ne sont pas disponibles par défaut. Vous pouvez modifier ce comportement en modifiant la propriété système subscription.custom_table.enforce_entitlement. Pour plus de détails sur cette modification, voir 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 l’élément de données sont associés. Par exemple, pour une liste d'enregistrements SLA de tâche incorporée dans un écran d'enregistrement de tâche, la valeur de Tables associées à correspondra à la table 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électionner à partir de : Déclarative Utilisez une condition déclarative pour créer des conditions pour l’élément de données à l’aide du créateur de condition. Scriptés Utilisez un script pour déterminer les conditions de votre élément de données. Une fenêtre de texte pour entrer un script s'affiche 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 Graphique. Pour plus d'informations sur ce type d'élément de données, consultez Configurer un élément de données à demande 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électionnez Déclarative dans le champ Type de condition.
   Trier par	Vous permet d'ajouter des champs au formulaire qui vous permettent de configurer le tri de la liste. Dans le créateur de condition, sélectionnez le champ que vous souhaitez utiliser pour trier la liste. 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électionnez Déclarative dans 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.

6. Facultatif : Si vous avez sélectionné Scriptée dans le champ Type de condition, vous devez créer un script dans le champ Script de condition de requête.

   Votre condition scriptée doit renvoyer une chaîne de requête, que l'instance utilise pour filtrer l'élément de données. Utilisez la variable input pour accéder aux informations à partir 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 input pour filtrer l'élément de données pour les enregistrements correspondant à la société et à l'emplacement des enregistrements actuels. Il ajoute ensuite le texte ^EQ^ORDERBYDESCsys_updated_on à la requête, qui trie les enregistrements d'éléments de données par le champ Updated on.

   Remarque :

   La variable d’entrée permet aux scripts mobiles d’accéder aux valeurs transmises dans les objets SubmitForm ou ParameterData.
7. 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 en savoir plus, reportez-vous à la rubrique Configuration de l’écran de liste.