Base de connaissances

Retour à la vue d’ensemble de l’assistance

Mise à jour de l’interface utilisateur

Transmet le nouveau contenu à l’interface utilisateur et l’actualise.

Identifiant : ui_update

Éléments

  • widget_params : Fait référence aux éléments de l’interface utilisateur qui doivent être modifiés au lieu d’utiliser des paramètres prédéfinis.
    • Requis : Oui
    • Valeur par défaut : Vide

Contenu de widget_params

  •  widget_params est une liste de ui_element.
    • ui_element : contient les paramètres qui doivent être modifiés.
    • name : Attribut de ui_element, qui est la référence à l’élément d’interface utilisateur à mettre à jour.

Exemple

<ui_update id="show_specified_amount">
   <widget_params>
      <ui_element name="EXT_SCANNER_NAME">
         <param name="content">Socket 7Xi</param>
      </ui_element>
      <ui_element name="STATUS">
         <param name="content">CONNECTED</param>
         <param name="text_color">green.dark</param>
      </ui_element>
   </widget_params>
</ui_update>

Modifier l’état du bouton

Modifie l’état d’un bouton. Il permet d’activer ou de désactiver un bouton.

Identifiant : change_button_status

Éléments

  • button_tag : nom du bouton dans votre mise en page. Ce « nom » doit être en majuscules.
    • Requis : Oui
    • Valeur par défaut : Vide
  • control : Définit l’état sur « ACTIVATE » ou « DEACTIVATE »

Exemple

<change_button_status id="deactivate_continue_btn">
    <button_tag>CONTINUE_BTN</button_tag><
    control>DEACTIVATE</control>
</change_button_status>

Notification

Affiche une notification temporaire sur le côté de l’application. Cela n’influence pas le flux de travail.

Identifiant : ui_notification

Attributs

  • type : définit la visualisation de la notification. Valeurs possibles : INFO, NOTIFICATION, WARN et ERROR.
    • Obligatoire : Non
    • Valeur par défaut: INFO
  • duration : délai après lequel la notification disparaît. Valeurs possibles : SHORT (3 secondes) et LONG (10 secondes).
    • Obligatoire : Non
    • Valeur par défaut : SHORT
  • show_immediately : affiche la notification immédiatement.
    • Obligatoire : Non
    • Valeur par défaut : False

Éléments

  • message : Le contenu à afficher
    • Obligatoire : Non
    • Valeur par défaut : Chaîne vide

Exemple

<ui_notification id="error_note » type="ERROR » duration="LONG » show_immediately="true">
   <message>Aucune connexion au serveur n’a été établie !</message>
</ui_notification>

Dialogue

Affiche une fenêtre de dialogue qui nécessite une interaction avec l’utilisateur. Il envoie des événements tels que les boutons sur lesquels l’utilisateur a cliqué pour une étape d’appel particulière.

Identifiant : ui_dialog

Attributs

  • type : définit la visualisation de la boîte de dialogue. Valeurs possibles : INFO, INTERMEDIATEPROGRESS, PROGRESS, QUESTION, NOTIFICATION, WARN, ERROR et FATAL.
    • Obligatoire : Non
    • Valeur par défaut : INFO
  • title : nom abrégé de la boîte de dialogue.
    • Obligatoire : Non
    • Valeur par défaut : Chaîne vide
  • message : Le contenu à afficher.
    • Obligatoire : Non
    • Valeur par défaut : Chaîne vide
  • close_command : La boîte de dialogue se ferme chaque fois que l’événement d’entrée est déclenché.
    • Obligatoire : Non
    • Valeur par défaut : Aucun

Éléments

  • buttons : contient une liste de boutons sur lesquels l’utilisateur peut cliquer. Il est possible de définir jusqu’à trois boutons. Le minimum est d’un bouton.
  • Requis : Oui
  • Valeur par défaut : Vide

Boutons

  • text : Texte de l’étiquette du bouton.
    • Requis : Oui
    • Valeur par défaut : Vide
  • command : commande d’événement qui se déclenche une fois que vous appuyez sur le bouton.
    • Requis : Oui
    • Valeur par défaut : Vide
  • speech_command : commande vocale qui active ce bouton.
    • Obligatoire : Non
    • Valeur par défaut : Vide
  • focused : Définit un bouton à présélectionner.
    • Obligatoire : Non
    • Valeur par défaut: Faux
  • son : voir Action Lire le son pour connaître les sons disponibles.
    • Obligatoire : Non
    • Valeur par défaut : Vide

Sortie

Déclenche des événements qui contiennent la commande spécifiée dans un bouton une fois qu’il a été cliqué (ou que sa commande vocale a été reconnue).

Exemple

<ui_dialog id="test » type="INFO » title="mon titre » message="mon message">
    <buttons>
        <button text="Nouvel ordre » command="NEW_ORDER » speech_command="Neue Order » focused="true"/>
        <button text="Même ordre » command="SAME_ORDER"/>
     </buttons>
</ui_dialog>

Boîte de dialogue de page

Affiche un écran de dialogue qui nécessite l’interaction de l’utilisateur. Il envoie les événements de boîte de dialogue qui se produisent une fois la fenêtre fermée.

Identifiant : ui_page_dialog

Attributs

  • type : définit la visualisation de la notification.
  • Valeurs possibles : INFO, INTERMEDIATEPROGRESS, PROGRESS, QUESTION, NOTIFICATION, WARN, ERROR, FATAL
    • Requis : Oui
    • Valeur par défaut : Vide
  • title : nom abrégé de la boîte de dialogue.
  • Valeurs possibles : il peut s’agir d’une référence à une ressource Android ou d’une chaîne de caractères.
    • Obligatoire : Non
    • Valeur par défaut : Vide

Éléments

  • messages : contient une liste des messages qui seront affichés dans la boîte de dialogue. Peut faire référence à une variable de contexte ou à une liste de messages. Lors du référencement d’une variable de contexte, l’attribut context_variable est défini sur la valeur booléenne true.
    • Requis : Oui
    • Valeur par défaut : Vide
  • buttons : il s’agit d’une liste de trois boutons sur lesquels l’utilisateur peut cliquer.

Boutons

L’utilisateur peut cliquer sur trois boutons :

  • previous_page_btn
  • next_page_btn
  • close_btn
  • speech_command : commande vocale qui déclenche ce bouton.
    • Obligatoire : Non
    • Valeur par défaut : Vide
  • focused : Définit un bouton à présélectionner.
    • Obligatoire : Non
    • Valeur par défaut : False
  • text : Le texte de l’étiquette du bouton.
    • Requis : Oui
    • Valeur par défaut : vide
  • command : commande d’événement qui se déclenche une fois que vous appuyez sur le bouton. Cette option n’est disponible que pour close_btn.

Sortie

Déclenche les événements qui contiennent la commande spécifiée dans un bouton, une fois que vous avez cliqué sur le bouton (ou que sa commande vocale est reconnue).

Exemples

Minimal

<ui_page_dialog id="show-server-errors-dialog » type="ERROR » title="Échec de la procédure">
   <messages>
      <message>First Error... </message>
      <message>Deuxième erreur... </message>
      <message>Troisième erreur... </message>
   </messages>
   <buttons>
      <previous_page_btn>
         <param name="text">←</param>
         <param name="speech_command">PRÉCÉDENT</param><
      /previous_page_btn>
      <next_page_btn>
         <param name="text">→</param>
         <param name="speech_command">NEXT</param>
         <param name="focused« >true</param>
      </next_page_btn>
      <close_btn><
         param name="text">ANDRRES_cancel</param>
         <param name="commande">EXIT_PAGER</param>
         <param name="speech_command">CANCEL</param>
      </close_btn>
   </buttons>
</ui_page_dialog>

Toutes les options

<ui_page_dialog id="confirm_pick » type="INFO » title="C’est reparti">
   <messages>
      <message>what</message>
      <message>to<message>
      <message>do</message>
   </messages>
   <buttons>
      <previous_page_btn>
         <text>< ![ CDATA[<]]></text>
         <speech_command>PREVIOUS</speech_command><
         focused>false</focused>
      </previous_page_btn>
      <next_page_btn>
         <text>< ![ CDATA[>]]></text>
         <speech_command>NEXT</speech_command>
         <focused>true</focused>
      </next_page_btn>
      <close_btn>
         <text>Return</text>
         <command>BW</command>
         <speech_command>RETURN</speech_command>
         <focused>false</focused><
      /close_btn>
   </buttons>
</ui_page_dialog>

Utilisation de context_variable = true

<ui_page_dialog id="confirm_what_to_do » type="INFO » title="C’est reparti">
   <messages context_variable="true">#{what_to_do}</messages>
   <buttons>
      <previous_page_btn>
         <text>< !
[CDATA[<]]></text> <speech_command>PRÉCÉDENT</speech_command> <focalisé>faux</focalisé> </previous_page_btn> <next_page_btn> <texte>< ! [CDATA[>]]></text> <speech_command>SUIVANT</speech_command> <focalisé>faux</focalisé> </next_page_btn> <close_btn> <texte>ANDRRES_cancel</texte> <commande>BW</commande> <speech_command>RETOUR</speech_command> <focalisé>faux</focalisé> </close_btn> </boutons> </ui_page_dialog>

Traitement du résultat

<rule id="confirm_what_to_do_back">
   <expression> < ![ CDATA[#{event :command} == 'BW' || #{event :command} == 'RETURN']]> </expression>
   <actions>
      <action ref="backwards"></action>
   </actions>
</rule>

Notification de progression

Ouvre et ferme une notification intermédiaire et non interruptive dans le coin supérieur droit de l’écran. Cela permet au travailleur de savoir si quelque chose se passe en arrière-plan.

Cas d’utilisation suggérés :

  • Un travailleur doit attendre que la communication soit exécutée.
  • En attente d’une communication réseau synchrone (téléchargement ou téléchargement de fichiers ou confirmation de données sur le back-end).

Identifiant : ui_progress_notification

Attributs

  • id : Référence à la notification affichée, nécessaire pour gérer l’action « close ».
  • Valeurs possibles : underscore_separated_string
    • Requis : Oui
    • Valeur par défaut : Doit être définie, pas de valeur par défaut.
  • title : Texte affiché dans la barre de titre
  • Valeurs possibles : Titre facultatif (les variables wf seront résolues)
    • Requis : Oui
    • Valeur par défaut : Vide
  • message : Texte affiché dans un espace de message
  • Valeurs possibles : Message de notification (les variables wf seront résolues)
    • Requis : Oui
    • Valeur par défaut : Doit être définie, pas de valeur par défaut.
  • action : Exécute une commande ou une liste de commandes.
  • Valeurs possibles : Afficher et fermer
    • Requis : Oui
    • Valeur par défaut : Doit être définie, pas de valeur par défaut.

Exemples

Minimal

Pour ouvrir la notification :

<ui_progress_notification id="show_progress">
    <param name="id">group_confirmation</param>
    <param name="message">Bestätige Schritt</param>
    <param name="action">show</param>
</ui_progress_notification>

Pour refermer la notification :

<ui_progress_notification id="close_progress">
    <param name="id">group_confirmation</param>
    <param name="action">close</param>
</ui_progress_notification>

Toutes les options

<ui_progress_notification id="show_progress">
  <param name="id">group_confirmation</param>
  <param name="title">CommitProcess</param>
  <param name="message">Confirmation de PickGroup</param>
  <param name="action">show</param>
</ui_progress_notification>
<ui_progress_notification id="close_progress">
    <param name="id">group_confirmation</param>
    <param name="action">close</param>
</ui_progress_notificatio

Modifications du référentiel de styles

Permet la création de nouveaux styles et la modification de styles existants dans votre mise en page.

Cas d’utilisation suggérés :

  • Faire en sorte que les éléments de la liste aient la même taille de texte

Identifiant : modify_style_repo

Attributs

  • style_name : Nom de la cible pour les styles créés
  • Valeurs possibles : Underscore_separated_string
    • Requis : Oui
    • Valeur par défaut : Doit être définie, pas de valeur par défaut.
  • base_on : Nom du style existant, le nouveau style héritera de ses attributs.
  • Valeurs possibles : underscore_separated_string
    • Obligatoire : Non
    • Valeur par défaut : Facultatif, pas de valeur par défaut
  • outrepasser: Remplace les propriétés du style précédemment créé.
  • Valeurs possibles : Vrai, faux
    • Obligatoire : Non
    • Valeur par défaut : False

Éléments

  • properties : il s’agit des attributs de l’interface utilisateur.
    • Requis : Oui
    • Valeur par défaut : Doit être définie, pas de valeur par défaut.

Exemples

Minimal

<modify_style_repo id="change_exception_style » style_name="list_item_style_same_size">
    <properties>
        <param name="text_group » type="string">#{test_group}</param>
    </properties>
</modify_style_repo>

Style de référence dans les éléments de mise en page de l’interface utilisateur :

<Nom de la liste="SELF_MENU_TABLE_MENU » Weight="0.75 » FocusOrder="0" 
      TextStyle="LIST_ITEM_STYLE_SAME_SIZE" 
      PageIndicatorStyle="PAGE_INDICATOR_STYLE » EntriesPerPage="5 » Border="0,gray.dark,black » Padding="10,0,10,0"/>

Produit:

Toutes les options

<modify_style_repo id="change_exception_style » style_name="list_item_style_same_size">
    <param name="base_on » type="string">list_item_style</param>
    <properties>
        <param name="text_group » type="string">#{test_group}</param>
        <param name="maxtextsize » type="string">15</param>
        <param name="gravity » type="string">center</param>
    </properties>
</modify_style_repo>

Élément de focus de l’interface utilisateur

Définit un élément de focus dans l’interface utilisateur.

Identifiant : ui_set_focus_item

Exemple

<ui_set_focus_item id="myaction"><ui_set_focus_item/>