UI-Aktualisierung
Gibt neue Inhalte an die Benutzeroberfläche weiter und aktualisiert sie.
Kennung: ui_update
Elemente
- widget_params: Verweist auf die UI-Elemente, die geändert werden müssen, anstatt vordefinierte Parameter zu verwenden.
- Erforderlich: Ja
- Standardwert: Leer
Inhalt von widget_params
- widget_params ist eine Liste von ui_element.
- ui_element: Enthält die Parameter, die geändert werden sollen.
- name: Attribut von ui_element, das den Verweis auf das zu aktualisierende UI-Element darstellt.
Beispiel
<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>
Status der Schaltfläche ändern
Ändert den Status einer Schaltfläche. Er wird verwendet, um eine Schaltfläche zu aktivieren oder zu deaktivieren.
Bezeichner: change_button_status
Elemente
- button_tag: Der Name der Schaltfläche in Ihrem Layout. Dieser "Name" muss in Großbuchstaben geschrieben werden.
- Erforderlich: Ja
- Standardwert: Leer
- Kontrolle: Setzt den Status entweder auf "AKTIVIEREN" oder "DEAKTIVIEREN".
Beispiel
<change_button_status id="deactivate_continue_btn">
<button_tag>CONTINUE_BTN</button_tag>
<control>DEACTIVATE</control>
</change_button_status>
Benachrichtigung
Zeigt eine temporäre Benachrichtigung am Rande der Anwendung an. Sie hat keinen Einfluss auf den Arbeitsablauf.
Kennung: ui_notification
Attribute
- Typ: Legt die Art der Visualisierung der Benachrichtigung fest. Mögliche Werte: INFO, NOTIFICATION, WARN, und ERROR.
- Erforderlich: Nein
- Standardwert: INFO
- Dauer: Zeit, nach der die Benachrichtigung verschwindet. Mögliche Werte: KURZ (3 Sekunden), und LANG (10 Sekunden) .
- Erforderlich: Nein
- Standardwert: KURZ
- show_immediately: Zeigt die Benachrichtigung sofort an.
- Erforderlich: Nein
- Standardwert: False
Elemente
- Nachricht: Der anzuzeigende Inhalt
- Erforderlich: Nein
- Standardwert: Leere Zeichenkette
Beispiel
<ui_notification id="error_note" type="ERROR" duration="LONG" show_immediately="true">
<message>No server connection established!</message>
</ui_notification>
Dialog
Zeigt ein Dialogfenster an, das eine Interaktion mit dem Benutzer erfordert. Es sendet Ereignisse, z. B. welche Schaltflächen der Benutzer für einen bestimmten Aufrufschritt angeklickt hat.
Bezeichner: ui_dialog
Attribute
- Typ: Definiert die Visualisierung des Dialogs. Mögliche Werte: INFO, INTERMEDIATEPROGRESS, PROGRESS, QUESTION, NOTIFICATION, WARN, ERROR, und FATAL.
- Erforderlich: Nein
- Standardwert: INFO
- Titel: Ein kurzer Name für den Dialog.
- Erforderlich: Nein
- Standardwert: Leere Zeichenkette
- Nachricht: Der Inhalt, der angezeigt werden soll.
- Erforderlich: Nein
- Standardwert: Leere Zeichenkette
- schließen_Befehl: Der Dialog wird geschlossen, wenn das Eingabeereignis ausgelöst wird.
- Erforderlich: Nein
- Standardwert: Keine
Elemente
- Schaltflächen: Enthält eine Liste von Schaltflächen, auf die der Benutzer klicken kann. Es ist möglich, bis zu drei Schaltflächen zu definieren. Das Minimum ist eine Schaltfläche.
- Erforderlich: Ja
- Standardwert: Leer
Buttons
- text: Beschriftungstext der Schaltfläche.
- Erforderlich: Ja
- Standardwert: Leer
- Befehl: Der Ereignisbefehl, der ausgelöst wird, sobald die Schaltfläche gedrückt wird.
- Erforderlich: Ja
- Standardwert: Leer
- sprach_befehl: Der Sprachbefehl, mit dem diese Schaltfläche aktiviert wird.
- Erforderlich: Nein
- Standardwert: Leer
- fokussiert: Legt eine Taste zur Vorauswahl fest.
- Erforderlich: Nein
- Standardwert: False
- Ton: Siehe PlaySound Action für verfügbare Sounds.
- Erforderlich: Nein
- Standardwert: Leer
Ausgabe
Löst Ereignisse aus, die den in einer Schaltfläche angegebenen Befehl enthalten, sobald diese angeklickt (oder ihr Sprachbefehl erkannt) wird.
Beispiel
<ui_dialog id="test" type="INFO" title="my title" message="my message">
<buttons>
<button text="New order" command="NEW_ORDER" speech_command="Neue Order" focused="true"/>
<button text="Same order" command="SAME_ORDER"/>
</buttons>
</ui_dialog>
Seite Dialog
Zeigt einen Dialogbildschirm an, der die Interaktion des Benutzers erfordert. Es sendet die Dialogereignisse, die aufgetreten sind, sobald das Fenster geschlossen wird.
Bezeichner: ui_page_dialog
Attribute
- Typ: Definiert die Visualisierung der Meldung.
- Mögliche Werte: INFO, ZWISCHENFORTSCHRITT, FORTSCHRITT, FRAGE, BENACHRICHTIGUNG, WARNUNG, FEHLER, FATAL
- Erforderlich: Ja
- Standardwert: Leer
- Titel: Ein kurzer Name für den Dialog.
- Mögliche Werte: Kann ein Verweis auf eine Android-Ressource oder eine Zeichenkette sein.
- Erforderlich: Nein
- Standardwert: Leer
Elemente
- Meldungen: Enthält eine Liste von Meldungen, die im Dialogfeld angezeigt werden sollen. Kann entweder auf eine Kontextvariable oder auf eine Liste von Meldungen verweisen. Wenn eine Kontextvariable referenziert wird, wird das Attribut context_variable auf den booleschen Wert true gesetzt.
- Erforderlich: Ja
- Standardwert: Leer
- Schaltflächen: Dies enthält eine Liste von drei Schaltflächen, auf die der Benutzer klicken kann.
Buttons
Es gibt drei Schaltflächen, auf die der Benutzer klicken kann:
- vorherige_seite_btn
- nächste_seite_btn
- schließen_btn
- sprach_befehl: Der Sprachbefehl, der diese Schaltfläche auslöst.
- Erforderlich: Nein
- Standardwert: Leer
- fokussiert: Legt eine Taste zur Vorauswahl fest.
- Erforderlich: Nein
- Standardwert: False
- text: Der Beschriftungstext der Schaltfläche.
- Erforderlich: Ja
- Standardwert: Leer
- Befehl: Der Ereignisbefehl, der ausgelöst wird, sobald die Schaltfläche gedrückt wird. Dies ist nur für close_btn verfügbar .
Ausgabe
Löst Ereignisse aus, die den angegebenen Befehl innerhalb einer Schaltfläche enthalten, sobald die Schaltfläche angeklickt (oder ihr Sprachbefehl erkannt) wird.
Beispiele
Minimal
<ui_page_dialog id="show-server-errors-dialog" type="ERROR" title="Procedure failed">
<messages>
<message>First Error...</message>
<message>Second Error...</message>
<message>Third Error...</message>
</messages>
<buttons>
<previous_page_btn>
<param name="text">←</param>
<param name="speech_command">PREVIOUS</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="command">EXIT_PAGER</param>
<param name="speech_command">CANCEL</param>
</close_btn>
</buttons>
</ui_page_dialog>
Alle Optionen
<ui_page_dialog id="confirm_pick" type="INFO" title="Here we go again">
<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>
Verwendung von context_variable = true
<ui_page_dialog id="confirm_what_to_do" type="INFO" title="Here we go again">
<messages context_variable="true">#{what_to_do}</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>false</focused>
</next_page_btn>
<close_btn>
<text>ANDRRES_cancel</text>
<command>BW</command>
<speech_command>RETURN</speech_command>
<focused>false</focused>
</close_btn>
</buttons>
</ui_page_dialog>
Umgang mit dem Ergebnis
<rule id="confirm_what_to_do_back">
<expression> <![CDATA[#{event:command} == 'BW' || #{event:command} == 'RETURN']]> </expression>
<actions>
<action ref="backwards"></action>
</actions>
</rule>
Benachrichtigung über den Fortschritt
Öffnet und schließt eine nicht unterbrechende Zwischenmeldung in der oberen rechten Ecke des Bildschirms. Dadurch wird der Mitarbeiter informiert, wenn im Hintergrund etwas passiert.
Vorgeschlagene Anwendungsfälle:
- Ein Arbeiter muss warten, bis die Kommunikation ausgeführt wird.
- Warten auf synchrone Netzwerk-Kommunikation (Herunter- oder Hochladen von Dateien oder Bestätigen von Daten an BackEnd).
Kennung: ui_progress_notification
Attribute
- id: Verweis auf die angezeigte Meldung, die für die Abwicklung der Aktion "Schließen" benötigt wird.
- Mögliche Werte: underscore_separated_string
- Erforderlich: Ja
- Standardwert: Muss eingestellt werden, kein Standardwert.
- Titel: Text, der in der TitleBar angezeigt wird
- Mögliche Werte: Optionaler Titel (wf-Variablen werden aufgelöst)
- Erforderlich: Ja
- Standardwert: Leer
- Nachricht: Text, der in einem Nachrichtenfeld angezeigt wird
- Mögliche Werte: Benachrichtigungsmeldung (wf-Variablen werden aufgelöst)
- Erforderlich: Ja
- Standardwert: Muss eingestellt werden, kein Standardwert.
- Aktion: Führt einen Befehl oder eine Liste von Befehlen aus.
- Mögliche Werte: Anzeigen und schließen
- Erforderlich: Ja
- Standardwert: Muss eingestellt werden, kein Standardwert.
Beispiele
Minimal
Zum Öffnen der Benachrichtigung:
<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>
Um die Benachrichtigung wieder zu schließen:
<ui_progress_notification id="close_progress">
<param name="id">group_confirmation</param>
<param name="action">close</param>
</ui_progress_notification>
Alle Optionen
<ui_progress_notification id="show_progress">
<param name="id">group_confirmation</param>
<param name="title">CommitProcess</param>
<param name="message">Confirming 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
Änderungen am Style Repository
Ermöglicht die Erstellung neuer Stile und die Änderung bestehender Stile in Ihrem Layout.
Vorgeschlagene Anwendungsfälle:
- Listenelemente in derselben Textgröße anzeigen
Bezeichner: modify_style_repo
Attribute
- style_name: Ziel-Name für erstellte Stile
- Mögliche Werte: Underscore_separated_string
- Erforderlich: Ja
- Standardwert: Muss eingestellt werden, kein Standardwert.
- Basis_auf: Name des vorhandenen Stils, dessen Attribute der neue Stil erbt.
- Mögliche Werte: underscore_separated_string
- Erforderlich: Nein
- Standardwert: Optional, kein Standardwert
- überschreiben: Setzt die Eigenschaften des zuvor erstellten Stils außer Kraft.
- Mögliche Werte: Wahr, falsch
- Erforderlich: Nein
- Standardwert: False
Elemente
- Eigenschaften: Dies sind die Attribute der Benutzeroberfläche.
- Erforderlich: Ja
- Standardwert: Muss eingestellt werden, kein Standardwert.
Beispiele
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>
Referenzstil in UI-Layout-Elementen:
<List Name="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"/>
Produziert:
Alle Optionen
<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>
UI Fokus Element setzen
Setzt ein Fokuselement innerhalb der Benutzeroberfläche (UI).
Bezeichner: ui_set_focus_item
Beispiel
<ui_set_focus_item id="myaction"><ui_set_focus_item/>