Configurer les actions d’entrée

Ajoutez un bouton à côté des champs du formulaire d’entrée pour donner aux utilisateurs la possibilité d’effectuer diverses actions d’entrée. Ces actions incluent l’ajout d’un commentaire, l’ajout d’une ou de plusieurs pièces jointes et la navigation vers d’autres écrans.

Avant de commencer

Rôle requis : admin

Cette rubrique décrit comment configurer les actions d’entrée pour vos différents champs d’entrée. Ces configurations doivent être effectuées avec la configuration générale des écrans du formulaire d’entrée. Les configurations d’actions d’entrée supplémentaires ne sont disponibles que lorsque l’option Écran est sélectionnée dans le champ Style de présentation de l’écran du formulaire d’entrée. Pour plus d'informations, consultez Configurer un écran de formulaire d'entrée.

Pourquoi et quand exécuter cette tâche

Bouton Ajouter un menu Plus par champs de valeur d’entrée spécifiés.

Remarque :

L’apparence du bouton peut varier selon iOSAndroid les systèmes d’exploitation. Le bouton est indiqué par trois points horizontalement ou verticalement.

Ce bouton peut inclure n’importe quelle variété d’éléments d’action : boutons de commentaire, de pièce jointe et de navigation :

• Commentaires : où les utilisateurs peuvent ajouter, modifier ou supprimer un commentaire. Les utilisateurs ne peuvent ajouter qu’un seul commentaire pour chaque champ de valeur d’entrée.
• Pièces jointes : Les utilisateurs peuvent soit sélectionner des images dans la galerie, soit ajouter une nouvelle image à la galerie. Ils peuvent également ajouter une image directement à l’aide de l’appareil photo. Les utilisateurs peuvent ajouter plusieurs pièces jointes à chaque champ de valeur d’entrée.
  Remarque :

  Pour les actions d’entrée de pièce jointe, lors du mappage de pièces jointes dans le cadre d’une source de données, le nom du champ doit être déclaré en tant que sys_id afin qu’il soit automatiquement ajouté à la table Pièce jointe [sys_sg_attachment]. Vous devez ensuite définir l’identificateur auquel l’élément appartient, à l’aide des valeurs. Attribut Mapper .

• Bouton de navigation : Les utilisateurs appuient sur cette option pour ouvrir un écran alternatif ou un écran de lancement. Par exemple, accédez à un écran de liste pour créer une tâche de suivi ou pour afficher un article de la base de connaissances dans le contexte d’une entrée. Un nombre illimité de boutons de navigation peut être ajouté au bouton de menu Plus.
  Remarque :

  Pour les fonctions de navigation étiquetées avec un contexte d’enregistrement, le mécanisme de source de données est requis. Pour les fonctions de navigation étiquetées avec un contexte global, le mécanisme de source de données n’est pas requis.

Pour des exemples de scripts d’actions d’entrée, reportez-vous aux sections suivantes Code de script pour le stockage des pièces jointes sélectionnées par l’utilisateur dans la base de données et Code de script pour le type de commentaire et mises à jour pour les actions d’entrée.

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 Écrans , puis sélectionnez un écran de formulaire d’entrée existant ou Nouveau.
   Si vous sélectionnez Nouveau, sélectionnez l’option Formulaire d’entrée dans la page Créer un écran, puis sélectionnez Continuer.
4. Sur la page Écran du formulaire d’entrée, sélectionnez Écran dans le champ Style de présentation .
5. Sélectionnez Nouveau dans la zone Actions pour ouvrir la page d’action du formulaire d’entrée.
6. Renseignez les champs suivants si nécessaire.

   Tableau 1. Champs d’action

   Champ	Valeur
   Propriétés
   Nom	Nom de l'action.
   Étiquette	Étiquette qui s’affiche pour l’action.
   Actif	Indique si l’action est active. Les actions inactives n’apparaissent pas sur l’écran du formulaire d’entrée.
   Disponible en mode hors connexion	Déterminez si cette action est disponible hors connexion.
   Type d'entrée	Option permettant de choisir si votre entrée est renseignée à partir d’une autre source ou modifiée par une action. Remarque : Pour cette configuration, sélectionnez Action d’entrée. Appliquez des actions d’entrée à un champ d’entrée tel que les commentaires, les pièces jointes ou les fonctions de navigation.
   Icône	Icône utilisée pour représenter votre action sur l’écran mobile de l’utilisateur.
   Positionnement de l’action
   Écran du formulaire d'entrée	Sélectionnez l’écran du formulaire d’entrée dans lequel l’action apparaît.
   Section de formulaire d'entrée	Sélectionnez la section de formulaire d’entrée dans laquelle l’action apparaît. Si l’écran de formulaire d’entrée sélectionné ne contient pas de sections, ce champ n’est pas disponible.
   Table parente	La table parente à laquelle l’action s’applique. Ce champ est renseigné automatiquement.
   Entrée parent	Sélectionnez l’entrée à laquelle l’action sera appliquée.
   Attributs de l'action	Déterminez où ou comment l’action gère les données générées. Remarque : Sauf indication contraire, tous les attributs énumérés sont disponibles lorsque vous sélectionnez Actions d’entrée dans le champ Type d’entrée . InputActionType : les actions d’entrée sont des actions qui peuvent être déclenchées dans l’icône de menu Affiché à côté d’un champ de valeur d’entrée. Les actions sont : pièces jointes, commentaire ou bouton (fonction de navigation). ButtonId : fonction de navigation associée à l’action d’entrée. Cette action d’entrée de navigation peut être un contexte global ou d’enregistrement . Le ButtonId est le sys_id d’un enregistrement de la table Button [sys_sg_button]. HiddenAttachmentSources : possibilité d’empêcher le chargement de sources de pièces jointes spécifiques de l’utilisateur. L’utilisateur ne peut télécharger que des images à partir de l’appareil photo du téléphone ou de la galerie. ID de la source de données : source de données utilisée pour charger les données à partir de la base de données. Utilisé pour l’action d’entrée de commentaire et de pièce jointe. Remarque : Un attribut ElementIdentifier est également requis. Pour plus d'informations, consultez Sources de données. ElementIdentifier : ID unique contenu dans une source de données, utilisé pour charger des données à partir de la base de données. Utilisé pour l’action d’entrée de commentaire et de pièce jointe. Remarque : Un attribut DataSourceID est également requis. Pour plus d'informations, consultez Sources de données. UserActionID : valeur unique qui identifie cet enregistrement d’action. Il est nécessaire d’associer l’action à une règle d’interface utilisateur. Remarque : Ce champ est disponible lorsque le champ Type d’entrée est Source d’entrée.

7. Entrez un nom pour votre action d’entrée dans le champ Nom .
8. Saisissez une étiquette pour votre action d’entrée visible par vos utilisateurs, dans le champ Étiquette .
9. Sélectionnez l’action d’entrée dans le champ Type d’entrée .
10. Sélectionnez l’emplacement où vous souhaitez que l’action s’affiche en remplissant les champs suivants dans la zone Placement de l’action : écran du formulaire d’entrée, table parente et entrée parent.
11. Sélectionnez Nouveau dans la zone Attributs d’action.
    Les attributs d’action de formulaire d’entrée s’affichent.
12. Procédez comme suit pour les actions d’entrée que vous souhaitez inclure dans la zone du champ d’entrée.

    Type d’action d’entrée	Procédure
    Pièce jointe	Sélectionnez InputActionType dans le champ Nom . Entrez les pièces jointes de texte dans le champ Valeur . Sélectionnez Enregistrer.
    Commentaire	Sélectionnez InputActionType dans le champ Nom . Saisissez le commentaire de texte dans le champ Valeur . Sélectionnez Enregistrer.
    Bouton de navigation	Sélectionnez InputActionType dans le champ Nom . Entrez le bouton de texte dans le champ Valeur . Sélectionnez Enregistrer. Vous revenez à la table Attribut d’action de formulaire d’entrée. Sélectionnez Nouveau dans la zone Attributs d’action. Sélectionnez ButtonId dans le champ Nom . Sélectionnez un type de navigation préconfiguré dans le champ Valeur . Pour plus d’informations sur la création de boutons de navigation, reportez-vous à la section Fonctions de navigation. Remarque : Si la fonction de navigation que vous avez sélectionnée a un contexte d’enregistrement (par opposition à un contexte global), vous devez la mapper à l’enregistrement spécifique à l’aide de sources de données. Si le ButtonId fait référence à un bouton avec un contexte d’enregistrement, il utilise par défaut le contexte du formulaire d’entrée. Toutefois, vous pouvez remplacer ce contexte par défaut en utilisant la source de données pour établir un lien vers un autre contexte d’enregistrement. Sélectionnez Enregistrer.

13. Sélectionnez Enregistrer.

Que faire ensuite

Pour ouvrir l’écran du formulaire d’entrée avec les pièces jointes et les commentaires déjà chargés à partir de la table d’instance [instance], vous devez configurer les attributs DataSourceId et ElementIdentifier. Par exemple, dans un scénario où plusieurs utilisateurs travaillent sur le même formulaire, le mécanisme de chargement de la source de données valide que les dernières données sont affichées à l’utilisateur suivant sur l’écran du formulaire d’entrée. Pour une fonction de navigation avec contexte d’enregistrement, le contexte d’enregistrement est défini dans le script source de données. Le script est mappé à l’sys_id de l’enregistrement qui contient un contexte pour la navigation. Pour plus d'informations, consultez Configurer les sources de données.