UIアップデート
新しいコンテンツをUIに渡し、リフレッシュする。
識別子:ui_update
エレメント
- widget_params: 定義済みのパラメータを使う代わりに、変更しなければならないUI要素を参照する。
widget_paramsの内容
- widget_paramsは ui_elementのリストです。
- ui_element:変更すべきパラメータを含む。
- name: ui_elementの属性で、更新するUI要素への参照。
例
<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>
ボタンステータスの変更
ボタンの状態を変更します。ボタンをアクティブまたは非アクティブにします。
識別子:change_button_status
エレメント
- button_tag:レイアウト内のボタンの名前。この "name "は大文字でなければなりません。
- 制御する:ステータスを "ACTIVATE "または "DEACTIVATE "に設定する。
例
<change_button_status id="deactivate_continue_btn">
<button_tag>CONTINUE_BTN</button_tag>
<control>DEACTIVATE</control>
</change_button_status>
お知らせ
アプリケーションの横に一時的な通知を表示します。ワークフローには影響しません。
識別子:ui_notification
属性
- タイプ:通知の視覚化を定義します。可能な値:INFO、NOTIFICATION、WARN、ERROR。
- 期間:通知が消えるまでの時間。可能な値:SHORT(3秒)、LONG(10秒)。
- show_immediately:通知を直ちに表示します。
エレメント
例
<ui_notification id="error_note" type="ERROR" duration="LONG" show_immediately="true">
<message>No server connection established!</message>
</ui_notification>
ダイアログ
ユーザーとの対話を必要とするダイアログ・ウィンドウを表示する。特定の呼び出しステップでユーザーがどのボタンをクリックしたかなどのイベントを送信します。
識別子:ui_dialog
属性
- タイプ:ダイアログの視覚化を定義します。指定可能な値:INFO、INTERMEDIATEPROGRESS、PROGRESS、QUESTION、NOTIFICATION、WARN、ERROR、FATAL。
- タイトルダイアログの短い名前。
- メッセージ:表示する内容。
- close_command:入力イベントが発生するたびにダイアログを閉じます。
エレメント
- ボタン:ユーザーがクリックできるボタンのリスト。ボタンは3つまで定義できます。最小値は1ボタンです。
- 必須はい
- デフォルト値:空
ボタン
- テキストボタンのラベルテキスト。
- コマンド:ボタンが押されるとトリガーされるイベントコマンド。
- speech_command:このボタンをアクティブにする音声コマンド。
- フォーカス:あらかじめ選択されているボタンを1つ設定します。
- サウンドを再生します:利用可能なサウンドについては、PlaySound Actionを参照してください。
出力
ボタンがクリックされる(または音声コマンドが認識される)と、ボタン内で指定されたコマンドを含むイベントがトリガーされます。
例
<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>
ページダイアログ
ユーザーの対話を必要とするダイアログ画面を表示する。ウィンドウを閉じると、発生したダイアログイベントを送信します。
識別子:ui_page_dialog
属性
- タイプ:通知の視覚化を定義します。
- 取り得る値:info、intermediateprogress、progress、question、notification、warn、error、fatal
- タイトルダイアログの短い名前。
- 可能な値:アンドロイド・リソースへの参照、または文字列。
エレメント
- メッセージ:ダイアログに表示されるメッセージのリストを含む。コンテキスト変数を参照することも、メッセージのリストを参照することもできます。コンテキスト変数を参照する場合、context_variable属性は真偽値trueに設定されます。
- ボタンです:ユーザーがクリックできる3つのボタンのリストです。
ボタン
ユーザーがクリックできるボタンは3つある:
- speech_command:このボタンをトリガーする音声コマンド。
- フォーカス:あらかじめ選択されているボタンを1つ設定します。
- テキスト:ボタンのラベルテキスト。
- コマンド:ボタンが押された時にトリガーされるイベントコマンド。close_btnでのみ有効。
出力
ボタンがクリックされる(または音声コマンドが認識される)と、ボタン内の指定されたコマンドを含むイベントがトリガーされます。
例
最小限
<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>
すべてのオプション
<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>
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>
結果の扱い
<rule id="confirm_what_to_do_back">
<expression> <![CDATA[#{event:command} == 'BW' || #{event:command} == 'RETURN']]> </expression>
<actions>
<action ref="backwards"></action>
</actions>
</rule>
進捗状況通知
画面右上の中間的で邪魔にならない通知を開いたり閉じたりします。これにより、作業者はバックグラウンドで何かが起こっているかどうかを知ることができます。
推奨される使用例
- ワーカーは、通信が実行されるまで待たなければならない。
- 同期ネットワーク通信待ち(ファイルのダウンロードやアップロード、BackEndへのデータ確認)。
識別子:ui_progress_notification
属性
- id:閉じる」アクションを処理するために必要な、表示された通知への参照。
- 指定可能な値:underscore_separated_string
- 必須はい
- デフォルト値:設定必須、デフォルト値なし。
- タイトルタイトルバーに表示されるテキスト
- 可能な値任意のタイトル (wf 変数が解決される)
- メッセージメッセージスペースに表示されるテキスト
- 可能な値通知メッセージ (wf変数は解決される)
- 必須はい
- デフォルト値:設定必須、デフォルト値なし。
- アクションを実行する:コマンドまたはコマンドのリストを実行する。
- 可能な値表示と閉じる
- 必須はい
- デフォルト値:設定必須、デフォルト値なし。
例
最小限
通知を開く:
<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>
再度通知を閉じるには
<ui_progress_notification id="close_progress">
<param name="id">group_confirmation</param>
<param name="action">close</param>
</ui_progress_notification>
すべてのオプション
<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
スタイル・リポジトリの修正
レイアウトに新しいスタイルを作成したり、既存のスタイルを変更したりできます。
推奨される使用例
識別子:modify_style_repo
属性
- style_name:作成されたスタイルのターゲット名
- 可能な値アンダースコア区切り文字列
- 必須はい
- デフォルト値:設定必須、デフォルト値なし。
- base_on:既存のスタイルの名前で、新しいスタイルはその属性を継承します。
- 指定可能な値:underscore_separated_string
- をオーバーライドします: 以前に作成されたスタイルのプロパティをオーバーライドします。
- 可能な値:真、偽
エレメント
- プロパティです:ユーザーインターフェースの属性です。
- 必須はい
- デフォルト値:設定必須、デフォルト値なし。
例
最小限
<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>
UIレイアウト要素の参照スタイル:
<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"/>
プロデュースする:
すべてのオプション
<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 フォーカス設定項目
ユーザーインターフェース(UI)内のフォーカス項目を設定する。
識別子:ui_set_focus_item
例
<ui_set_focus_item id="myaction"><ui_set_focus_item/>