ワークフローのトリガー

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

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

• API トリガーを使用すると、ワークフローを Workflows API 経由で実行できます。

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

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

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

ワークフロートリガー時にユーザーとデバイスをどのように識別しますか？

ワークフローオートメーションは、常にユーザーとデバイスのコンテキストの両方を必要とします。 一方のみが提供された場合、システムは以下のロジックを実行します：

• ユーザーのみが提供された場合、ワークフローはそのユーザーに対して最近使用されたデバイスを自動的に特定します。

• デバイスのみが提供された場合、ワークフローはそのデバイスに対して最後にログインしたユーザーを自動的に特定します。

これにより、全てのワークフローが有効なユーザー-デバイスのペアで開始されることが保証されます。

ワークフローが欠落している情報を特定できない場合、例えば最近のデバイスやユーザーが見つからない場合、そのワークフローは開始されずに実行が_期限切れ_状態で終了することがあります。

---

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

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

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

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

• Nexthink Amplify から直接ターゲット特定診断および是正アクションを起動します。

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

許可管理については、「ロール」を参照してください。

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

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

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

3. クレーンアイコンで識別可能な関心のあるワークフローを選択し、選択したセッション/デバイスで実行します。

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

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

ワークフロー設計と構成を学ぶために、ワークフローの作成 ドキュメントを参照してください。

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

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

ワークフロー設計と構成を学ぶために、ワークフローの作成 ドキュメントを参照してください。

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

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

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

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

• NQL: ワークフローの対象としてデバイスまたはユーザーを設定するためのNQLクエリを入力します。

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

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

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

    • ワークフローデザイナーで設定された事前定義された値のリスト。

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

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

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

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

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

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

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

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

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

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

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

    • listステートメント。

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

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

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

    • ワークフローデザイナーで設定された事前定義された値のリスト。

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

    • 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ドキュメントを参照してください。

デバイス または ユーザー に関連するリアルタイム イベントのみがワークフローをトリガーできます。

alerts.alerts などのクエリイベントはデバイスにリンクされていない場合、ワークフローをトリガーしません。 これは、調査モジュールからクエリを実行したときに、デバイス フィールド列が空であるために発生します。

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

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.*

• システムはfieldとfield の比較をサポートしていません。 例えば: user.upn != device.#last_user_upn

イベントトリガーのための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

---

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

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

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

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

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

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

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

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

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