ワークフローのトリガー

ワークフローのビジュアルデザイナーから、右側のパネルにあるワークフローの詳細タブで、さまざまな実行オプションを持つワークフローのトリガーメカニズムを構成できます。

• 手動トリガーでは、一つまたは複数のターゲットに対してワークフローを手動で実行できます。

• APIトリガーを使用すると、ワークフローAPIを利用してワークフローを実行できます。

• スケジュールトリガーでは、定義された時間枠内で、NQLクエリによって定義されたターゲットデバイスやユーザーに対してワークフローを実行できます。

• イベントトリガーでは、NQLクエリによって定義されたリアルタイムイベントワークフローを実行できます。

これらのトリガーメカニズムを定義してワークフローの実行を開始します。 ワークフローをトリガーした後、そのアウトカムを確認するためにステータスをチェックできます。

ワークフローのデザインと設定について詳しく学ぶためには、ワークフローの作成ドキュメントを参照してください。

ワークフローを手動でトリガーする

ワークフローのビジュアルデザイナーから、手動トリガーを選択し、ワークフローのターゲットを定義し、Nexthinkの機能内でワークフローを手動でトリガーするためにワークフローのロジックを検証します。

• 調査データを分析した後、一つまたは複数のユーザーやデバイスに対してワークフローをトリガーします。

• 特定のデバイスに対してワークフローをトリガーします。例えば、デバイスビューから問題を解決します。

• Nexthink Amplifyから直接ターゲット診断および修正アクションのためのワークフローをトリガーします。

ユーザーにすべてのワークフローを手動でトリガーする権限を与えるか、トリガー特定の権限でワークフローを共有します。

権限管理については、ロールドキュメントを参照してください。

ワークフローを手動でトリガーするには、調査モジュールから開始します。

1. NQLエディタまたはビジュアルエディタを使用して、デバイスまたはVDIセッションのリストをクエリします。以下の画像を参照してください。

2. 1台以上のデバイスまたはVDIセッションを選択し、アクションバーを使用してアクションを実行します。

3. 興味のあるワークフローを選択し、クレーンアイコンで識別し、選択したセッション/デバイスで実行してください。

VDIセッションでのワークフローを手動でトリガーするには、Nexthink VDIエクスペリエンスが必要です。

VDI用に設定されたワークフローのみがセッションで実行できます。

APIによるワークフローのトリガー

ワークフローのビジュアルデザイナーから、APIトリガーを選択し、Nexthink Workflows APIを使用してワークフローをトリガーするためのワークフロー論理を検証します。

ワークフローのデザインと構成について詳しくは、 ワークフローの作成 のドキュメントをご参照ください。

スケジュールされたワークフローのトリガー

ワークフローのビジュアルデザイナーから、スケジュールトリガーを選択し、NQLクエリを使用して特定の繰り返し期間にワークフローをトリガーするためのワークフロー論理を検証します。

ワークフロートリガーのクエリでスケジュールを追加します。 フィールドに入力してください:

• 名前: スケジュール用に一意な名前を入力してください。

• NQL: devices、vdi_sessions、またはusersのいずれかを対象とするNQLクエリを入力してください。

• 繰り返し: スケジュールの時間と繰り返しを設定してください。 実行はスケジュールされた時間に開始され、1時間に均等に分散できます。

• ワークフローパラメーター: パラメーターを使用してワークフローをスケジュールしてください。

  • 次の方法でパラメーターを設定してください：

    • Designerにおける事前定義済みの値リスト。

    • カスタムのフリーテキスト値。

    • NQLクエリのlistステートメントで定義された属性。

パラメーターの設定については、ワークフローの作成ドキュメントを参照してください。

VDIセッションでのワークフローのスケジューリングには、Nexthink VDIエクスペリエンスが必要です。

イベントによるワークフローのトリガー

ワークフローのビジュアルデザイナーから、イベントトリガーを選択し、NQLクエリを使用して定義されたリアルタイムイベントワークフローをトリガーするためのワークフロー論理を検証します。

クエリでイベントトリガーを追加してワークフローを起動します。 フィールドに記入します：

• Name: イベントのためにユニークな名前を入力します。

• NQL: ワークフローをトリガーするイベントをキャプチャするためのNQLクエリを入力します。

  • クエリを有効にするためには、少なくとも1つが含まれている必要があります：

    • サポートされているイベント。

    • オブジェクトをフィルタリングできる場合のwhereステートメント。

    • listステートメント。

  • サポートされているリアルタイムイベントを使用し、それらの制限を遵守します。 以下の展開可能項目をご覧ください。

• パラメータ: ワークフローをスケジュールするためにパラメータを使用します。

  • 次の方法でパラメータを設定します:

    • Designerで設定された事前定義リストの値を使用。

    • カスタム自由テキスト値。

    • NQLクエリのlistステートメントで定義された属性。

パラメーター設定については、https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/user-guide/workflows/creating-workflows/ja/README.md#add-workflow-parametersドキュメントを参照してください。

NQLクエリのサポートされているリアルタイムイベントのリスト

以下はサポートされているリアルタイムイベントのリストです:

• alert.alerts

• device_performance.boots

• device_performance.hard_resets

• device_performance.system_crashes

• execution.crashes

• remote_action.executions

• session.connects

• session.disconnects

• session.locks

• session.logins

• session.logouts

• session.unlocks

• web.events

• web.transactions

• web.errors

• web.page_views

NQLクエリのイベント制限

• システムは、日付または時刻属性を使用したフィルタリングをサポートしていません。

• 次の制限がイベントトリガーの構成に適用されます:

  • ワークフローごとに1つのイベントトリガー。

  • 評価の使用はサポートされていません。

  • last_seen属性は、どのオブジェクトでもサポートされていません。

• システムは、デバイスオブジェクトからのクエリで次のフィールドの使用をサポートしていません:

  • last_seen

  • login.last_login_user_name

  • boot.days_since_last_full_boot

  • boot.last_full_boot_duration

  • boot.last_full_boot_time

  • connectivity.last_connectivity_type

  • connectivity.last_local_ip

• システムは、次のカスタムフィールドの使用をサポートしていません:

  • クエリベースのフィールド

  • ルールベースのフィールド

• システムはクエリ内で次のディメンションの使用をサポートしていません:

  • コンテキスト.*

  • device.public_ip.*

イベントトリガーのためのNQL例

以下に、イベントで使用できるNQLクエリの例を示します:

遅いログインイベント

デバイスのログイン時間が長い場合に、影響を受けたユーザーのユーザー名を特定するために次のクエリを使用します。

session.logins
| where time_until_desktop_is_ready > 1s
| list user.ad.username

ドライバーまたはストレージ関連のブルースクリーン（BSoD）

ドライバーまたはストレージ関連の問題によってBSoDが発生したWindowsデバイスに対応するために次のクエリを使用します。

device_performance.system_crashes
| where label == 'IRQ_NOT_LESS_OR_EQUAL'
| list error_code

アンチウイルスソフトウェアが無効化されました

アンチウイルスソフトウェアが無効化され、リモートで検出されたときに次のクエリを使用します。 ■

無効化されたアンチウイルスがリモートで検出されたときに次のクエリを使用します。これにより、コンプライアンスを保証し、デバイスのコンプライアンス状態についての追加のチェックを行うことができます。

remote_action.#AVCheck.executions
| where outputs.AVActive == 'false'
| list outputs.AVDefinitionVersion

システムは1つのイベントごとに1つのワークフローのみをトリガーします。

VDIセッション上のイベントによるワークフローのトリガーには、Nexthink VDIエクスペリエンスが必要です。

---

ワークフローのステータス：結果を決定

ワークフローをトリガーするときは、それがまだ実行中であるかどうか、どのように終了したかを理解するためにステータスを使用します。

ワークフローのステータスを確認するには:

• ワークフロー実行の詳細ページを表示します。

• NQLクエリを実行し、status属性をwhere文に含めます。 さらに詳細な情報を表示するためにstatus_detail属性を使用します（利用可能な場合）。

トラブルシューティングのためのワークフロー実行タイムラインの使用ドキュメントを参照してください。

下の表は、考えられるワークフローステータスとその一般的な意味を示しています。

ワークフローの実行は、ワークフロー設計のエンドブロックに達した場合に成功と見なされます。

ワークフローステータス	ステータスの意味
進行中	ワークフローがトリガーされ、現在ロジック設定に従って実行されています。
成功	ワークフローの成功した完了。
失敗しました	ワークフローは予期しない問題が発生したため実行に失敗しました。
キャンセルされました	ワークフローの実行が以下の理由の1つで停止しました: - ワークフローが無効化されました。 -同じターゲットとパラメーターでの実行がすでに進行中であり、現在のワークフローは重複として見なされます。
期限切れ	ワークフロー内のThinkletまたはフロー制御ステップが設定されたタイムアウト期間を超えました。 最も一般的には、リモートアクションのシンクレットがオフラインのデバイスで実行しようとする場合に、これが発生します。 ワークフローでの有効期限の処理に関するドキュメントを参照してください。