DataV:フローコントロール

単一条件

単一パス条件ノードは If 条件ノードとして機能します。設定した条件が満たされると、[条件を満たした場合] イベントをトリガーします。

シナリオ

たとえば、スイッチの状態に基づいてレイヤーを表示するには、[単一パス条件] ノードを使用して現在のスイッチの状態を評価できます。スイッチがオンの場合、レイヤーが表示されます。

使用方法

[単一パス条件] ノードをブループリントキャンバスに追加します。その後、そのイベント、アクション、および設定パラメーターを表示できます。詳細については、「ロジックノードの使用」をご参照ください。

ノード設定

ビジュアルエディターまたはコードエディターを使用して、判定条件を設定します。

• ビジュアルエディター: すべての条件を満たす必要がある場合は [AND] パターンを選択し、いずれかの条件を満たせばよい場合は [OR] パターンを選択します。

• コードエディター：新しいデータフィルターを追加し、フィルター条件を記述します。条件はブール値を返す必要があります。結果が TRUE の場合、[条件を満たした場合] イベントがトリガーされます。複数のデータフィルターを追加できます。

アンカーポイント設定

イベントとアクションの説明

条件判断

条件判定ノードは If-Else 条件ノードとして機能し、指定された条件が満たされた場合は [条件成立] イベントを、満たされない場合は [条件不成立] イベントをトリガーします。

シナリオ

たとえば、スイッチの状態に基づいて 2 つのレイヤーを表示または非表示にするには、 [条件判断] ノードを使用して現在のスイッチの状態を評価できます。 スイッチがオンの場合、レイヤー A のみが表示されます。 スイッチがオフの場合、レイヤー B のみが表示されます。

使用方法

[条件判断] ノードをブループリントキャンバスに追加します。 その後、そのイベント、アクション、および設定パラメーターを表示できます。 詳細については、「ロジックノードの使用」 をご参照ください。

ノード設定

設定項目の説明

アンカーポイント設定

イベントとアクションの説明

マルチパス判定

[マルチパス判定] ノードは、Case-When ノードとして機能します。上位ノードからの出力を評価し、条件を満たす最初の下位ノードでアクションをトリガーします。

シナリオ

たとえば、[デジタル入力ボックス] の現在の値に基づいて、マップ上の散布点の色を設定できます。[多分岐判断] ノードを使用して入力値がどの範囲に収まるかを判断し、値が 100 より大きい場合は赤、50～100 の場合は黄色、50 未満の場合は青というように、対応する色の設定をトリガーします。

使用方法

ブループリントキャンバスに [多経路判定] ノードを追加します。すると、そのイベント、アクション、および設定パラメーターを表示できます。詳細については、「ロジックノードを使用する」をご参照ください。

イベントとアクションの説明

設定項目の説明

タイマー

[タイマー] ノードは、遅延タイミング、指定時刻タイミング、ループ遅延タイミング、およびループ定期タイミングをサポートしています。

シナリオ

タイマーは、時間指定実行が必要なあらゆるシナリオに適しています。設定された時間に達すると、タイマーノードは[指定時間に達した時] イベントをトリガーし、上位ノードからの結果を出力し、後続のアクションをトリガーします。

使用方法

ブループリントキャンバスに [タイマー] ノードを追加して、そのイベント、アクション、設定パラメーターを表示します。 詳細については、「ロジカルノードを使用する」をご参照ください。

ノード設定

設定項目の説明

アンカーポイント設定

イベントとアクションの説明

シリアル実行

[シリアル実行] ノードは、祖先ノードからの出力をハンドラで順番に処理し、各ハンドラに対応するアクションをトリガーします。

シナリオ

たとえば、シナリオごとに多数のデータパネルがある場合に、異なるシナリオのデータパネルを切り替えるには、まずシナリオ A のパネルを非表示にし、その後にシナリオ B のパネルを表示する必要がある場合があります。シリアル実行 ノードを使用すると、データパネルをシナリオ単位でグループ化し、A、次に B の順に切り替えられます。

使用方法

[シリアル実行] ノードをブループリントキャンバスに追加すると、イベント、アクション、および設定パラメーターを表示できます。ノードの追加方法の詳細については、「ロジックノードの使用」をご参照ください。

イベントとアクションの説明

設定項目の説明

WebSocket ノード

WebSocket ノードは、画面間の通信を可能にします。各メッセージは、カスタムメッセージ名と祖先ノードから出力されたデータで構成されます。

シナリオ

WebSocket ノードは、大画面とモバイルクライアント間、または大画面とタッチスクリーンクライアント間など、複数のクライアント間でコマンドとデータを送信します。

使用方法

WebSocket ノードをブループリントキャンバスに追加して、そのイベント、アクション、設定パラメーターを表示します。ノードの追加方法の詳細については、「ロジックノードの使用」をご参照ください。

ノード設定

設定項目の説明

アンカーポイント設定

イベントとアクションの説明

設定例

メッセージ登録

WebSocket ノードは、次のフォーマットでメッセージを送信します：

{
  event: "register",
  data: {
    sid: "99326",                                      // 画面 ID
    group: "g_a9b9x"                                  // 自動生成されたグループ名
  },
  callback: "callback_15832235175585251131307383912" // 現在の登録タイムスタンプ、自動生成
}

WebSocket サービスが登録メッセージを受信した後、登録を完了するには次のメッセージを返す必要があります：

{
  event: "callback_15832235175585251131307383912",   // 同じ登録タイムスタンプを返す
  data: {
    isError: false,                                  // false に設定
    data: "ok"
  }
}

メッセージの送信

WebSocket ノードは、次のフォーマットでメッセージを送信します：

{
  event: 'broadcast',
  data: {
    event: "sent_message_1",                         // 送信メッセージ名
    data: {}                                         // data は任意のフォーマットが可能
  }
}

メッセージの受信

WebSocket ノードは、次のフォーマットでメッセージを受信します：

{
  event: "broadcast_received_message_1",                  // broadcast_${受信メッセージ名}
  data: {}                                          // data は任意のフォーマットが可能
}

トラブルシューティング

WebSocket サービスに接続できない場合は、次のように問題をトラブルシューティングしてください：

1. WS サービスには、HTTPS プロトコル経由で直接アクセスすることはできません。WSS サービスを使用する必要があります。独自の SSL 証明書を使用して WS サービスのエンドポイントをプロキシした後、HTTPS 経由でサービスにアクセスできます。

2. F12 キーを押して、ブラウザのデベロッパーツールを開きます。[ネットワーク] タブで、[WS] タブの接続情報を表示します。クロスドメイン設定のエラーを確認し、接続応答の Sec-WebSocket-Protocol ヘッダーが echo-protocol に設定されていることを確認してください。

3. 接続に成功したら、このドキュメントで説明されているメッセージフォーマットに従ってパラメーターを渡してください。

WebSocket-pro ノード

[WebSocket-pro] ノードを使用すると、WebSocket ノードよりもきめ細かい設定オプションで画面間通信が可能になります。各メッセージは、カスタムメッセージ名と祖先ノードの出力データで構成されます。

シナリオ

WebSocket ノードと同様に、[WebSocket-pro] ノードは複数のクライアント間でコマンドとデータを送信します。

使用方法

その設定パラメーターを表示するには、ブループリントキャンバスに [WebSocket-pro] ノードを追加します。ノードの追加方法の詳細については、「論理ノードの操作」をご参照ください。

ノード設定

設定項目の説明

アンカーポイント設定

イベントとアクションの説明

設定例

メッセージ登録

[WebSocket-pro] ノードは、以下の形式でメッセージを送信します。

{
	"source":"407194",
	"target":["10000","20000"],
	"data":{
		"name":"Data source controlled mode test",
		"group":"Default group",
		"hasCbMsg":true,
		"disconnectTime":60000
	},
	"event":"register"
}

[WebSocket-pro] サービスが登録メッセージを受信すると、内部でそのメッセージを処理します。登録が成功した場合、クライアントの hasCbMsg パラメーターによって、アクセプターに確認応答を送信するかどうかが決まります。クライアントが 10 秒以内に登録に失敗した場合、そのクライアントへの接続は切断されます。確認応答メッセージは、以下の形式です。

{
  "event":"register",
  "source":"407194",
  "data":{
    "isError":false,
    "data":"ok"
  }
}

ハートビート検出

WebSocket-pro ノードでハートビート検出を有効にした場合、必要な確認応答フォーマットは次のとおりです。

{
  "event": "heartbeat",
  "data": {
    "group": "Default group",
    "hasCbMsg":true,
    "disconnectTime": 60000
  }
}

メッセージの送受信

[WebSocket-pro] ノードは、メッセージの送受信に同じ構造を使用します。形式は次のとおりです。

{
  "event":"send_test",
  "source":"407194",
  "target":["10000","20000"],
  "data":{
    "zoom":12
  }
}