---
sourceDocument: Configuration et navigation mobiles Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/mobile
Release :
- yokohama
ft:locale :
- fr-FR
ft:publication_title :
- Configuration et navigation mobiles Yokohama
ft:clusterId :
- mobile
bundleId :
- mobile
workflow :
- evelopment, Data and Analytics
---
# Configurer un élément de données de relation pour une liste incorporée
# Configurer un élément de données de relation pour une liste incorporée {#ariaid-title1}
* Rversion finale: Yokohama
*
* Mis à jour 30 janv. 2025
*
*  3 minutes de lecture
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](https://servicenow-prod.fluidtopics.net/YiBkkRL2DtDsw5FibWgVHQ "Utilisez une liste incorporée pour placer une liste d’informations liées à votre enregistrement actuel dans un segment de votre écran d’enregistrement afin que vos utilisateurs n’aient pas à accéder à une liste connexe.").
## Procédure
1. Accédez à TousMobile systèmeGé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.
2. Recherchez le périmètre de l'application dans lequel vous travaillez, puis sélectionnez son nom.
L'écran Générateur d'apps mobiles d'accueil des catégories s'affiche.
3. Sélectionnez la catégorie de données dans le menu, puis sélectionnez Nouveau.
4. Sélectionnez l'icône d'élément de données de relation , puis sélectionnez Continuer.
5. Renseignez les champs suivants selon vos besoins.
{#sg-data-item-relationship__table_cbg_pzm_42b__entry__2}
| 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 mobiles](https://servicenow-prod.fluidtopics.net/wnViL4QZkjReMM3xaTxVlw "Utilisez les propriétés système pour contrôler la disponibilité de tables personnalisées lors de la création ou de la modification d’éléments de données."). |
| 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](https://servicenow-prod.fluidtopics.net/AVi6y3xf~IiVc2xAuYeLQg "Configurez un élément de données de requête codée pour interroger les données des écrans de graphique. Un élément de données de requête codée est un élément de données paramétré qui sert de base à la transmission d’un écran de graphique à un écran de liste. Lorsqu’il est touché, il permet aux utilisateurs d’explorer une liste d’éléments à partir desquels le graphique est créé."). |
| 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](https://www.servicenow.com/docs/access?context=c_ConditionBuilder&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). Remarque : Ce champ n'est disponible que lorsque vous sélectionnez `Déclaratif` dans 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électionnez `Déclaratif` 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. |
[Tableau 1. Champs d'élément de données de relation]
{#sg-data-item-relationship__table_cbg_pzm_42b}
6. **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ée` pour 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ée` et 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_on` est ensuite ajouté à la requête, qui trie les enregistrements d'éléments de données en fonction du champ Mis à jour le .
Remarque :
La variable `d'entrée` permet aux scripts mobiles d'accéder aux valeurs transmises dans les objets SubmittedForm 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 plus d'informations, consultez [Configuration de l'écran de liste](https://servicenow-prod.fluidtopics.net/fi7yXnXRKL6ZNhV2xOZWug "Configurez un écran de liste afin que vos utilisateurs puissent afficher une liste des enregistrements à partir de leur application mobile. Pour accéder à un enregistrement de la liste, un utilisateur peut appuyer sur le nom de l’enregistrement.").