Configurer des attributs et des variables d'écran du formulaire d'entrée

Utilisez les variables d'écran pour collecter automatiquement des informations auprès de l'utilisateur ou définir les informations par défaut. Les variables peuvent inclure des informations comme les ID d'utilisateur et les coordonnées GPS.

Avant de commencer

Vous devez créer un écran du formulaire d'entrée avant de créer des variables et des attributs. 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.

Rôle requis : admin

Procédure

1. Accédez à la Tout > Mobile système > Mobile App Builder.
   Générateur d'application mobile 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'application mobile s'affiche.
3. Sélectionnez la catégorie Écrans, puis sélectionnez l'écran du formulaire d'entrée pour lequel vous souhaitez configurer des variables.
4. Faites défiler vers le bas jusqu'à la section « Variables » du formulaire, puis sélectionnez Nouveau pour créer une variable.
   Le formulaire Variable s'affiche.
5. Renseignez les champs suivants si nécessaire.

   Tableau 1. Champs de variables

   Champ	Description
   Nom	Nom de la variable.
   Type de variable
   Champ de base de données	Données d'un champ. Ce champ utilise l'attribut FieldName. Après avoir configuré la section Placement des variables, consultez l'Étape 6 pour configurer l'attribut.
   Date	Date actuelle. Cette variable ne prend pas d'attribut. Après avoir configuré la section Placement des variables, consultez l'Étape 8 pour terminer la configuration des variables.
   Constante	Une valeur statique définie par l'administrateur à l'aide de l'attribut ConstantValue. Après avoir configuré la section Placement des variables, consultez l'Étape 6 pour configurer l'attribut.
   Coordonnées GPS	Longitude et latitude de l'utilisateur. Cette variable ne prend pas d'attribut. Après avoir configuré la section Placement des variables, consultez l'Étape 8 pour terminer la configuration des variables.
   Mode hors ligne	L'entrée est disponible lorsque l'application Mobile est hors ligne. Cette variable ne prend pas d'attribut. Après avoir configuré la section Placement des variables, consultez l'Étape 8 pour terminer la configuration des variables.
   Utilisateur	Sys_id de l'utilisateur. Cette variable ne prend pas d'attribut. Après avoir configuré la section Placement des variables, consultez l'Étape 8 pour terminer la configuration des variables.
   ParentContext	Informations de contexte qui sont acheminées d'un enregistrement parent vers une action. Utilise l'attribut ContextField. Après avoir configuré Placement des variables, consultez l'Étape 7 pour configurer la variable et l'attribut.
   Scriptés	Script qui renseigne automatiquement les entrées. Utilise l'attribut Script. Après avoir configuré la section Placement des variables, consultez l'Étape 7 pour configurer la variable et l'attribut.
   Emplacement de variable
   Écran du formulaire d'entrée	Sélectionnez l'écran du formulaire d'entrée dans lequel la variable apparaît.
   Section de formulaire d'entrée	Sélectionnez la section du formulaire d'entrée dans laquelle la variable apparaît. Si l'écran du formulaire d'entrée ne contient pas de sections, ce champ n'est pas disponible.

6. Facultatif : Si vous avez sélectionné Champ de base de données ou Constante comme type de variable, la section « Attributs de variable » s'affiche.
   Dans la section « Attributs de variable », sélectionnez Nouveau pour configurer l'attribut de variable. Selon le type de variable que vous définissez à l'Étape 5, sélectionnez les propriétés de l'attribut.

   Tableau 2. Propriétés de l'attribut

   Nom d'attribut	Propriétés
   FieldName	Définissez les informations suivantes : Table : la table que vous souhaitez utiliser. Valeur : le nom du champ dans cette table. Utilisez cet attribut si vous avez sélectionné le type de variable Champ de base de données. Consultez l'Étape 8 pour terminer la configuration des variables.
   ConstantValue	Saisissez les données statiques définies par l'administrateur. Utilisez cet attribut si vous avez sélectionné le type de variable Constante. Consultez l'Étape 8 pour terminer la configuration des variables.

7. Facultatif : Si vous souhaitez configurer des variables de types ParentContext ou Scripted, procédez comme suit :
   1. Enregistrez l'écran du formulaire d'entrée en sélectionnant Enregistrer.
   2. Revenez au nœud de l'écran du formulaire d'entrée dans le menu de navigation de gauche.
   3. Dans le formulaire d'écran du formulaire d'entrée, sélectionnez l'icône du menu d'options dans le coin supérieur droit du formulaire dans Mobile App Builder, puis sélectionnez Ouvrir dans la plateforme.
   4. Sélectionnez l'onglet Variables.
   5. Sous Nom, sélectionnez le nom que vous avez saisi pour la variable lors de l'Étape 5.
   6. Sélectionnez l'un des types de variables suivants.

      Type de variable	Description
      ParentContext	Informations de contexte qui sont acheminées d'un enregistrement parent vers une action. Ce type utilise l'attribut ContextField. Par exemple, utilisez cette variable lorsqu'un employé intervient dans le cadre d'un appel de service et doit consigner les dépenses associées telles que le kilométrage.
      Scriptés	Script qui renseigne automatiquement les entrées. Ce type utilise l'attribut Script. Par exemple, vous pouvez pré-remplir un numéro de bâtiment en fonction du profil d'un utilisateur final lors d'une réservation.

   7. Dans la section « Attributs » sous « Nom », double-cliquez sur Insérer une nouvelle ligne... et saisissez le nom de votre attribut de variable tel que répertorié dans la table suivante.
      Important :

      Saisissez le nom d'attribut exactement comme il est répertorié dans la table. Le nom est sensible à la casse.

      Nom d'attribut	Description
      ContextField	Saisissez ce nom d'attribut pour les variables ParentContext. Remarque : Saisissez exactement le nom de l'attribut. Celui-ci est sensible à la casse.
      Script	Saisissez ce nom d'attribut pour les variables Scripted. Remarque : Saisissez exactement le nom de l'attribut. Celui-ci est sensible à la casse.

   8. Après avoir saisi le nom de l'attribut, cliquez sur la coche ( ) pour enregistrer l'attribut.
   9. Double-cliquez sur le champ sous « Valeur » et ajoutez la valeur appropriée pour l'attribut que vous configurez, comme décrit dans le tableau suivant.

      Nom d'attribut	Description
      ContextField	Saisissez le nom du champ de l'écran parent dont vous souhaitez que le contenu serve à renseigner le champ de l'écran du formulaire d'entrée.
      Script	Collez le code JavaScript qui remplit automatiquement le champ de l'écran du formulaire d'entrée. Par exemple, vous pouvez pré-remplir un numéro de bâtiment en fonction du profil d'un utilisateur final lors d'une réservation.

   10. Sélectionnez l'icône de coche ( ) pour enregistrer l'attribut.
   11. Sélectionnez Mettre à jour.
   12. Revenez à Mobile App Builder en sélectionnant cet onglet de navigateur.
8. Dans Mobile App Builder, sélectionnez Enregistrer.
   Important :

   Si vous avez effectué l'Étape 7 facultative, vous avez déjà sauvegardé l'enregistrement dans Mobile App Builder et vous n'avez donc pas besoin de le sauvegarder à nouveau.

Que faire ensuite

Une fois que vous avez créé vos variables d'écran du formulaire d'entrée, vous pouvez les mapper aux entrées d'écran du formulaire d'entrée ou aux éléments d'action. Pour obtenir des détails sur ce processus, consultez Configurer un élément d’action.