全般

ワークフローを開始する

属性

template: ワークフローが必要なテンプレートの名前
- 必須: はい
include_tasks: true の場合、テンプレートとして定義されているものはすべてタスクにもなり得ます
- 必須: いいえ
- 既定値: True

アウトプット

WORKFLOW_EXTRACTED: ワークフローは、指定されたテンプレートから正常に抽出されました
- ペイロード: wf_uri start_workflow アクションで "wf" 識別子として使用できます。
WORKFLOW_EXTRACTION_ERROR: 指定されたテンプレートからワークフローを抽出できませんでした

手記： これは タスクブラウザ コンポーネントと似ていますが、特定のテンプレートに関連付けられたワークフローを個別に実行するのではなく、取得するだけです。

例

このアクションは、次のように使用できます。

<get_workflow_from_template id="get_workflow_from_template">
  <param name="template">NameOfTemplate</param>
</get_workflow_from_template>

結果処理:

<ルールid="extracted">
   <expression><![CDATA[ #{event:command} == 'WORKFLOW_EXTRACTED']]></expression>
   <actions>
     <action id="start_workflow" type="start_workflow">
       <param name="wf">#{event:payload.wf_uri}</param><
     /action>
   </actions>
</rule>
<rule id="extraction_error">
   <expression><![CDATA[ #{event:command} == 'WORKFLOW_EXTRACTION_ERROR']]></expression>
   <actions>
     <finish_workflow id="finish_workflow">
       <output><
         param name="wf_error" type="bool">true</param><
       /output><
     /finish_workflow><
   /actions><
/rule>

setvar

ワークフローまたはステップのパラメーターを設定または更新します。

識別子: setvar

元素

context_update: 設定または更新する必要があるパラメーターのリスト。
- 必須: はい
- 初期値: 空のリスト
context_of: 更新するコンテキストスコープを定義します。既定では、現在アクティブなステップが更新されます。
- 必須: いいえ
初期値: ステップ
設定可能な値:
- ワークフロー: 現在アクティブなステップが更新されます。
- ルート: 任意のワークフローでアクセス可能な方法で値をルートワークフローに保存します。
- グローバル: アプリケーション内の任意の場所 ({global::my_value} 直接参照または appcontext.global.my_value Javascript) からアクセスできるグローバルコンテキスト値を作成します。
- User_session: "global" ( によるアクセス) #{user_session::my_value}と同様に機能しますが、ユーザーがサインアウトすると値が削除されます。

例

極小

<setvar id="increase_step">
    <context_update>
        <param name="current_step">#{current_step}+1</param>
    </context_update>
</setvar>

すべてのオプション

<setvar id="next_step">
    <context_of>root</context_of>
    <context_update>
        <param name="current_step_index" type="long">#{current_step}+1</param>
        <param name="step" type="object">?{context.steps[context.current_step_index]}?</param>
    </context_update>
</setvar です>

アセットのダウンロード

指定した 1 つ以上のアセットをダウンロードします。

識別子: download_assets

例

<download_assets id="test">
      <asset_uris>xai:/assets/hops_02?version=1</asset_uris>
</download_assets>
<download_assets id="test">
  <list name="asset_uris" listType="UNNAMED"><
      elem>xai:/assets/hops_02?version=1</elem>
      <elem>xai:/assets/hops_01?version=1</elem><
      elem>xai:/assets/hops_03?version=1</elem>
    </list><
/download_assets>

タイマー

特定の遅延と期間を設定するオプションを使用してタイマーを設定します。ステップが変わると、期間またはタイマーが終了します。

識別子: タイマー

属性

command: タイムアウト期間が終了すると送信されます。
- 必須: はい
- デフォルト値: 空
delay: コマンドが送信されるまでの時間が含まれます。
- 必須: はい
- デフォルト値: 空
period: コマンドが再送信されるまでの時間間隔が含まれます。
- 必須: いいえ
- デフォルト値: -1

例

最初に 5 秒 (5000 ミリ秒) 後にイベントをトリガーし、その後は 2 秒 (2000 ミリ秒) ごとにイベントをトリガー REFRESH するタイマーを開始するには、これを使用できます。

<タイマーID =" trigger_refresh" コマンド="REFRESH" 遅延="5000" 期間="2000"/>

Rest Request

このアクションは、REST API を介して JSON データを取得するように設計されています。POST および GET データ要求タイプをサポートします。

識別子: rest_request

属性

rest_url: REST API URL が含まれます。
- 設定可能な値: REST URL
- 必須: はい
- 例：

「https://myfcc.com/sampledata/enginedata」

request_type: REST 要求タイプが含まれます。
- 設定可能な値: "POST"、"GET"
- 必須: はい
- 例：

「取得」

value_path: JSON データ値へのパスが含まれます。
- 必須: はい
- 例：

"$.rpm" // その他の例については、Jayway JsonPath を確認してください

rest_params: REST サービスに渡す必要があるパラメーターが含まれます。
- 設定可能な値: MAP
- 必須: いいえ
- 例：

\<list name="rest_params"
listType="NAMED">

\<param name="serial"
type="string">1337\</param>
\</listです>

repeat_every_ms: アクションが新しい値を要求するまでの時間間隔 (ミリ秒単位) が含まれます。
- 設定可能な値: 整数
- 必須: はい
- 例(5秒ごと):

payload_path: 受信した値を格納できるオプションのパスが含まれます。パスが指定されていない場合は、「sensor_value」が使用されます。
- 設定可能な値: 文字列
- 必須: いいえ
- 例：

「sensor_value」

例

次の JSON 構造を前提とした JsonPath について考えてみましょう。

[{
    "color"="blue",
    "id"=87427,
    "name"="Blueforce87427",
    "position"={
        "datetime"="2017-07-20T13: 58: 47.947513+02: 00",
        "positionX"=2722,
        "positionY"=2,
        "positionZ"=3980
    }
}{
    "color"="red",
    "id"=11111,
    "name"="Opfor11111",
    "position"={
        "datetime"="2017-07-20T13: 58: 47.947513+02: 00",
        "positionX"=3222,
        "positionY"=232,
        "positionZ"=4000
    }
}]

次の JsonPath 文字列を使用して、エンドポイントからデータを取得できます。

1. JsonPathの場合:

$[0]['名前']

2. 返される文字列:

ブルーフォース87427

3. JsonPath:

$[0]['位置']

4. 返される文字列:

[{
"datetime"="2022-07-27T13:58:47.925260+02:00,
"positionX"=2722,
"positionY"= 2, 
"positionZ"= 3980
}]

5. JsonPath:

$[*]

6. 返される文字列:

両方のオブジェクトを含む配列全体

極小

<rest_request id="my_rest_test0">
    <param name="rest_url" type="string">https://alex.dev.ubimax.com/sampledata/enginedata</param><
    param name="request_type" type="string">POST</param><
    param name="value_path" type="string">$.rpm</param><
    list name="rest_params" listType="NAMED">
        <param name="serial" type="string">1337</param><
    /list><
/rest_request>

すべてのオプション

<rest_request id="my_rest_test0">
    <param name="rest_url" type="string">https://alex.dev.ubimax.com/sampledata/enginedata</param><
    param name="request_type" type="string">POST</param><
    param name="value_path" type="string">$.rpm</param><
    param name="repeat_every_ms" type="string">5000</param>
    <param name="payload_path" type="string">myPayload</param><
    list name="rest_params" listType="NAMED">
        <param name="serial" type="string">1337</param><
    /list><
/rest_request>

コミットメッセージの送信

カスタマイズ可能なプロパティを含む汎用メッセージを Frontline コネクタに送信します。これらは属性によって DefaultInspectionRequestHandler.class 処理されます。

識別子: send_commit_message

属性

type: Frontline コネクタで切り替えるイベントの種類が含まれます。
- 設定可能な値: 文字列
- 必須: True
- 既定値: 空
connection_timeout: タイムアウトを秒単位で含みます。
- 設定可能な値: numeric_value
- 必須: False
- デフォルト値: 50
save_response: 応答を保存するコンテキストが含まれます。
- 設定可能な値: ステップ、ワークフロー
- 必須: False
- 既定値: ステップ

元素

identifier: 統合サービスに使用される ID (タスク ID など) が含まれます。
- 必須: False
- デフォルト値: "" (空の文字列)

properties: 統合サービスで使用できるパラメーターのコレクションが含まれます。
必須: False
既定値: [] (空のコレクション)

注: プロパティは内部でマップに変換され、その値は再帰的変換のコレクションにすることができます。最終的なマップは、メッセージのペイロード文字列に JSON 文字列として格納され、文字列、数値、ブール値などのプリミティブ値はプロパティマップフィールド内に格納されます。これにより、統合サービスとの通信時にメッセージが非常に柔軟になります。

応答処理

コミットメッセージを送信する場合、次の 3 つの結果が考えられます。

成功
タイムアウト
エラー

タイムアウトは、指定された時間が経過しても応答が受信されない場合に発生します。これは、メッセージがネットワークで失われたか、サーバーが結果を処理するのに時間がかかりすぎるために発生します。

この場合のエラーは、通常、ネットワークエラーやサーバーエラーによるメッセージの送信の失敗など、予期しない動作を意味します。予期されるエラー処理 (プロセス内の無効な状態の処理など) は、正常な応答によって行われます。

すべての応答は、モダリティで send_commit_message 入力イベントを生成します。コマンドはまたはRESPONSE_ERROR のいずれかです RESPONSE_OK, RESPONSE_TIMEOUT。

メッセージには、 payload 応答の追加データを含むオブジェクトが含まれています。と timeoutの場合error 、ペイロードには、要求で使用されているものと同じ値に設定された "type" フィールドと "identifier" フィールドが含まれます。これは、必要に応じて特定の要求のエラーを識別するために使用できます。

成功した場合、これらのフィールドは存在しませんが、「status」フィールドは数値(統合サービスのハンドラーによって定義される)に設定されます。この値は、プロセスで予期されるエラーケースを処理するために使用できます。いずれの場合も、「response」フィールドには、応答をさらに区別するために使用できる統合サービスによって定義された文字列が含まれます。

統合サービスでは、状況と応答の値に加えて、イベントとともに送り返される追加のプロパティーを定義できます。これらのプロパティは、イベント処理時にコンテキスト変数として使用できます。この例としては、エラー処理のために顧客の WMS からエラーメッセージを送り返したり、成功したコミットを処理するための追加情報を送信したりすることがあります (このフラグメントについては以下を参照してください)。

例

<send_commit_message id="pre_task_request" type="PRE_TASK_REQUEST" connection_timeout="600">
    <properties>
        <param name="group" type="string">#{group}</param>
        <param name="aisle" type="string">#{aisle}</param>
    </properties><
/send_commit_message>
<send_commit_message id="complete_inspection" type="COMPLETE_INSPECTION" connection_timeout="1500">
  <param name="identifier">#{cockpit_id}</param>
</send_commit_message>

識別子の値は、タグ属性として設定するには無効です – これは、作成者の将来の反復で可能になるはずです。

<send_commit_message id="send_asset_info" type="PHOTO" connection_timeout="60">
    <properties>
        <param name="asset_uri" type="string">#{event:payload.media_file}</param>
        <param name="order_id" type="string">?{pickOrder.name}?</param>
        <param name="group_id" type="string">?{pickOrder.groups[activeGroup].label}?</param>
        <param name="customer_reference">?{pickOrder.groups[activeGroup].picks[0].article.customerReference}?</param>
        <param name="amount" type="string">?{pickOrder.groups[activeGroup].picks[0].amountOpen}?</param>
    </properties><
/send_commit_message>

画像アセットをアップロードし、アップロードされたアセットに関する情報を含むコミットメッセージを送信する

この手順例では、入力として画像アセット URI (media_file) が必要です。

<step id="send_asset" uitemplate="WAIT" persist="false" screen_lock_enabled="false" debug_mode="false">
    <actions>
        <action id="upload_media" type="trigger_upload_asset">
            <param name="asset_uri">#{media_file}</param><
            param name="delete_after_upload" type="bool">true</param>
            <param name="upload_immediately" type="bool">true</param>
            <param name="upload_immediately_delete_on_failure" type="bool">true</param>
        </action><send_commit_message

        id="send_asset_info" type="PHOTO" connection_timeout="200">
            <properties><
                param name="asset_uri" type="string">#{event:payload.asset_uri}</param>
                <param name="asset_name" type="string">#{event:payload.asset_name}</param><
                param name="asset_version" type="string">#{event:payload.asset_version}</param>
            </properties><
        /send_commit_message>

        <ui_notification id="show_nok" type="WARN">
            <duration>SHORT</duration><
            message>Picture NOT OK</message><
        /ui_notification>

        <ui_notification id="show_upload_error" type="ERROR">
            <duration>SHORT</duration>
            <message>media upload failed</message><
        /ui_notification>

        <ui_notification id="show_commit_error" type="ERROR">
            <duration>SHORT</duration><
            message>Commit failed</message><
        /ui_notification>
    </actions>

    <states>
        <onresume>
            <rule id="auto_exec">
                <expression>1</expression><
                actions>
                    <action ref="upload_media"/>
                </actions></rule>
        
            </onresume>

        <onevent><
            rule id="upload_ok"><
                expression><
                    ![CDATA[#{event(trigger_upload_asset):command} == 'OK']]><
                /expression>
                <actions><
                    action ref="send_asset_info"/>
                </actions>
            </rule><
            rule id="upload_error">
                <expression><
                    !

[CDATA[#{event(trigger_upload_asset):command} == 'ERROR' || #{event(trigger_upload_asset):command} == 'NETWORK_ERROR' || #{event(trigger_upload_asset):command} == 'INTERNAL_ERROR']]> </式> <アクション> <action ref="show_upload_error"/> <action ref="finish"/> </アクション> </ルール> <ルール id="commit_ok_ok"> <式> <![CDATA[#{event(send_commit_message):command} == 'RESPONSE_OK' && #{event(send_commit_message):p ayload.response} == 'OK']]> </式> <アクション> <action ref="finish_workflow"/> </アクション> </ルール> <ルール id="commit_ok_nok"> <式> <![CDATA[#{event(send_commit_message):command} == 'RESPONSE_OK' && #{event(send_commit_message):p ayload.response} != 'OK']]> </式> <アクション> <action ref="show_nok"/> <アクション ref="goto_take_picture"/> </アクション> </ルール> <ルール id="commit_error_or_timeout"> <式> <![CDATA[#{event(send_commit_message):command} == 'RESPONSE_ERROR' || #{event(send_commit_message):command} == 'RESPONSE_TIMEOUT']]> </式> <アクション> <action ref="show_commit_error"/> <アクション ref="goto_take_picture"/> </アクション> </ルール> </onevent> </状態> </ステップ>

カスタムエラーステータスでの処理

<actions>
  <!--ダイアログは、エラー処理のためにコミットメッセージレスポンスによって設定された変数を参照します--><ui_dialog
  id="sap_error" type="Error" title="Error"><
    message><![CDATA[#{sap_message}<br>Continue to '#{sap_material}/#{sap_position}'?]]></message><
    buttons><
      button><
        text>ANDRRES_fw</text><
        command>SAP_FIX</command><
        focused>true</focused><
      /button><
      button><
        text>ANDRRES_bw</text><
        command>DO_NOT_TRY_AGAIN</command><
      /button>
    </buttons></ui_dialog>

<!--
  その他のアクション
  [...]
-->
</actions><!--

より多くの WF コード
 [...]
-->

<onevent>
  <!--技術的には成功しましたが、SAP応答を確認します--><
  rule id = "success">
    <expression><![CDATA[#{event:command} == 'RESPONSE_OK' && #{event:payload.status} == 0 ]]></expression>
    <actions><ui_notification
      id="show_done" type="INFO">
        <duration>SHORT</duration><>
        message#{cockpit_id} completed...</message><
      /ui_notification>
      <action ref="close_ds_task"/>
      <action ref="finish_workflow"/>
    </actions><
  /rule><

  rule id="sap_error_in_success">
    <expression><![CDATA[#{event:command} == 'RESPONSE_OK' && #{event:payload.status} == 500 ]]></expression>
    <actions><!--  
      変数は、イベントが処理されるときに自動的に設定され、アクションで使用できます -->
      <action ref="sap_error"/>
    </actions>
  </rule><

  rule id="unknown_error_in_success">
    <表現><![CDATA[#{event:command} == 'RESPONSE_OK' &&#{event:payload.status} != 0 && #{event:payload.status} != 500 ]]></expression>
    <actions>
      <action ref="completion_error"/>
    </actions>
  </rule><

  rule id="request_error">
    <expression><![CDATA[#{event:command} == 'RESPONSE_ERROR']]></expression>
    <actions>
      <action ref="completion_error"/>
    </actions><
  /rule>

  <rule id="request_timeout">
    <expression><!

[CDATA[#{event:command} == 'RESPONSE_TIMEOUT']]></expressionです> <アクション> <action ref="completion_error"/> </アクション> </ルール> </onevent>

MQTT の例

<send_commit_message id="send_mqtt" type="FRONTLINE_MQTT" connection_timeout="200">
    <properties>
        <param name="mqtt" type="string"><![CDATA[?{
            var mqtt = {
                topic: "MY/TOPIC",
                content: "マイコンテンツ"
            };
            var stringmqtt = JSON.stringify(mqtt);
            stringmqtt;}?]]>
        </param><
    /properties>
</send_commit_message>

ハンドラ側

以下は、コネクタの "Inspection" 要求ハンドラー内のコードを処理する例です。

@Override public CommitMessageResponse handleCommitMessage(CommitMessage aCommit) {
    if("COMPLETE_INSPECTION".equals(aCommit.getType())) {
        String evaluation = aCommit.getIdentifier();
        HANDLE EVENT/
        / [CODE]
        if(isSuccess) {
            log.info("完了成功!");
            return new CommitMessageResponse(aCommit, 0, "Success!");
        }
        HANDLE ERROR
        CommitMessageResponse cmr = new CommitMessageResponse(aCommit, 500, "SAP Error!");
        cmr.addProperties("sap_message"、cr.getMessage());'cr' はカスタムコード
        に固有のオブジェクトです cmr.addProperties("sap_material", cr.getMaterial());
        cmr.addProperties("sap_position", cr.getPosition());
        CMRを返します;
    }
    その他のメッセージ

エラーケースで追加されたプロパティは、イベントが処理されるときにワークフローで使用できます。

添付ファイルを追加

現在のステップのタスク結果に添付ファイルを追加します。

識別子: add_attachment

注: ワークフロータグでコンポーネントのレポートを有効にする必要があります。それ以外の場合、アクションは無効になります。これを行う方法の例を次に示します。 <workflow [...] reporting="true"></workflow>

元素

type: タスクの結果に追加する添付ファイルの種類が含まれます。
- 必須: はい
- 既定値: 空
content: タスクの結果に追加するコンテンツが含まれます。
- 必須: False
- 既定値: 空
override: 指定された型が置き換えられた状態で既に保存されている値が含まれます。
- 必須: いいえ
- 既定値: True

既定の型

資産
バーコードコンテンツ
ドキュメントコメント
コメント
質問 (質問全体を保存するために「アンケート」コンポーネントで使用)
selected-answers (選択した回答を保存するために「アンケート」コンポーネントで使用)

手記： また、独自のタイプを設定することもできます。

例

極小

<add_attachment id="add_attachment">
    <param name="type" type="string">documentation-comment</param>
    <param name="content" type="string">#{current_comment}</param><
/add_attachment>

すべてのオプション

<add_attachment id="document_barcode">
    <param name="type" type="string">barcode-content</param>
    <param name="content" type="string">#{code}</param>
    <param name="override" type="bool">false</param><
/add_attachment>

添付ファイルの内容の取得

特定の添付ファイルのデータ型に最後に追加された添付ファイルを取得します。

識別子: get_attachment_content

元素

type: 添付ファイルから取得する添付ファイルのタイプが含まれます。
- 必須: はい
- 既定値: 空
write_to: 取得した添付ファイルの内容を保存する変数の名前が含まれます。
- 必須: はい
- 既定値: 空
write_if_empty: 受信した値を保存します。指定された変数に既存の値が存在する場合、データは上書きされます。
- 必須: いいえ
- 既定値: True

既定の型

資産
バーコードコンテンツ
ドキュメントコメント
コメント
質問 (質問全体を保存するために「アンケート」コンポーネントで使用)
selected-answers (選択した回答を保存するために「アンケート」コンポーネントで使用)

手記： また、使用可能なタイプのリストにまだ含まれていない場合は、独自の添付ファイルタイプを追加することもできます。

例

極小

<get_attachment_content id="get_attachment_content">
    <param name="type" type="string">documentation-comment</param>
    <param name="write_to" type="string">current_comment</param><
/get_attachment_content>

すべてのオプション

<get_attachment_content id="get_attachment_content">
    <param name="type" type="string">documentation-comment</param><
    param name="write_to" type="string">current_comment</param>
    <param name="write_if_empty" type="bool">true</param><
/get_attachment_content>

モジュールの状態

モジュールの状態を変更するために使用します。たとえば、これを使用して、音声入力認識を無効にすることができます。

識別子: module_state

属性

module_name: モジュールの名前
設定可能な値:
- de.ubimax.andriod.speechrecognition.SpeechRecognitionModule
- de.ubimax.andriod.client.output.SoundManager
- de.ubimax.andriod.core.gps.GeoModule
- de.ubimax.andriod.core.output.sound.TextToSpeechManager
- 必須: False
change_state_to: モジュールが入るはずの状態
- 設定可能な値:
  - 初期化
  - 滅ぼす
  - 止める
  - 休止
  - レジュメ
  - 始める
- 必須: True

例

<module_state id="resume_speech" module_name="de.ubimax.android.speechrecognition.SpeechRecognitionModule" change_state_to="resume"/><module_state
id="pause_speech" module_name="de.ubimax.android.speechrecognition.SpeechRecognitionModule" change_state_to="pause"/>

ログアウトする

クライアントをログオフします。

識別子: logoff

例

<ログオフ id="myaction"/>

知識ベース

ワークフローを開始する

属性

アウトプット

例

setvar

元素

例

アセットのダウンロード

例

タイマー

属性

例

Rest Request

属性

例

コミットメッセージの送信

属性

元素

応答処理

例

画像アセットをアップロードし、アップロードされたアセットに関する情報を含むコミットメッセージを送信する

カスタムエラーステータスでの処理

MQTT の例

ハンドラ側

添付ファイルを追加

元素

既定の型

例

添付ファイルの内容の取得

元素

既定の型

例

モジュールの状態

属性

例

ログアウトする

例

お住まいの地域を選択してください

推奨地域

Americas

Asia Pacific

Commonwealth of Independent States

Europe

Middle East Africa