パラメーターと動的値

パラメーターと動的値を効果的に使用することで、ITチームは柔軟かつ動的に動作する自動化を構築できます。このセクションでは、それらをNexthink Flowで定義、設定、および使用する方法をカバーしています。

ワークフローは入力パラメーター、ワークフロー実行中に取得した値、またはNexthinkデータ値に依存して、動的で柔軟かつコンテキストを考慮した自動化を可能にします。これらの要素は、ワークフローが入力を処理し、異なるシナリオに適応し、ワークフローステップ間で情報を渡すことを可能にします。

ワークフローは次のタイプの動的値を使用します：

ワークフローのパラメーター；

ワークフローパラメーターは、ワークフローに期待される入力値を定義し、それを異なるシナリオでカスタマイズして再利用できることを保証します。それらはワークフローのトリガー時に設定され、ワークフロー実行の終了まで一定です。 &#x20；

ワークフローの中でそれらを渡してパラメーター化されたアクションを実行したり、条件の一部として評価したりするためにワークフローパラメーターを使用します；

それらはワークフローのトリガーで動的に設定されることも、ワークフローの設計時に定義された静的値として維持されることもあり、ワークフロー全体で参照することができます

パラメーターを定義する

パラメーターはワークフロー設計の一部として定義されます

パラメーターを追加するとき：

ワークフローパラメーターの名前を入力します。
ワークフローパラメーターの必須のデフォルト値を入力します。
- カスタム値を許可を選択して、パラメーターをワークフロートリガーで設定できるようにします。

ワークフロー開始時に動的にワークフローパラメーターを設定する：

トリガータイプに応じてパラメーターを動的に設定する次の方法を使用します：

NQL スケジュールまたはリアルタイムイベント

トリガーがNQLリアルタイムイベントまたはスケジュールに基づいている場合、NQLクエリで返された値をパラメーターとして渡すことができます；

設定でパラメーターを設定するには、Designerで事前に作成する必要があることに注意してください。

スケジュールまたはリアルタイムイベントを作成する際に、次のオプションからパラメーターの値を選択します：

Designerに設定されているデフォルトのパラメーター値
NQLクエリの出力の1つ
スケジュールレベルで定義されたカスタム値

ワークフローAPI

外部システムからAPIを呼び出す際、ワークフローのパラメーターを設定します。詳細はAPIドキュメントを参照してください；

手動トリガー；

Nexthink製品（Amplifyも含む）から手動アクションとしてワークフローをトリガーする際、ユーザーはパラメーターの値を入力するよう求められます；

ワークフローパラメーターへの参照；

Nexthinkワークフロー内でグローバルパラメーターを参照できます。例えば、API ThinkletのJSONペイロードに値を渡すためです。次の構文を使用します：

{{global.ParameterName}}

Thinkletの出力

出力変数は、実行されるThinkletの一部として作成され設定された値です。例えば、リモートアクションが情報を収集し出力として提示する場合、これらはワークフロー実行のライフサイクル中に後で使用されることができます。例えば、リモートアクションのパラメーターとして使用したり、ITSMチケットにペイロードとして渡すためです；

ワークフロー内の他のThinkletからの出力を参照する際は、次の形式を使用します：

{{thinkletID.result.outputs.outputid}}

各Thinkletの出力パラメーターの設定方法については、詳細なThinklet ドキュメントを参照してください；

データベースの値

データベースの値はNexthinkプラットフォームdatabaseから得られます。システムがアクセスできるオブジェクトは2つあります：

device
user

device と user は実行時に常にワークフローにパラメーターとして送信されるオブジェクトです。デバイスがターゲットとなる場合、これらのパラメーターはワークフロー実行時の最新情報を使用して更新されます。

サポートされている属性のリストについては、デバイスおよびユーザーセクションを参照し、NQLデータモデルのフィールド列にある値をフィールド名として使用してください。

現在利用可能なのは静的値だけです。システムは現時点でイベントデータおよびカスタムフィールドはサポートしていません。

ワークフロー内でNexthinkフィールドを参照する際は次の形式を使用します：

{{nx.object.fieldname}}

デバイス属性を参照した例：

{{nx.device.ad_site}}

ユーザー属性を参照した例：

{{nx.user.ad.email_address}}

システムの値：

システムの値は現在のワークフロー実行への参照を提供するために使用されます。これは、ワークフローが3rdパーティシステムがあるアクションを実行し、それがワークフローを進めるための呼び戻しを行う必要がある場合に有用です。

システムの値は常にsys.workflowで始まります

これらの値のリストは以下に示されています。

sys.workflow.executionId: 現在実行されているワークフロー実行のIDへの参照です
sys.workflow.workflowId: 実行される特定のワークフロー設計への参照です。

これらの値の使用例を以下にMoveworksチャットボットとの統合のコンテキストで示しています。これらの値はチャットボットによってワークフローを進めるために使用されます。

{
    "message": "Hello, {{nx.user.ad.fullname}}, あなたのコンピューターにはパフォーマンスに影響を与える可能性のある重要なドライバ更新が不足しています",
    "recipients": [
        {{nx.user.ad.email_address}}
    ],
    "context": {
        "slots": {
            "executionid": "{{sys.workflow.executionId}}",
            "workflowid": "{{sys.workflow.workflowId}}"
        }
    }
}

ペイロードフィールドでのパラメーターと動的値の使用

動的な値とパラメーターは、リソースおよびペイロードとメッセージ/テキストthinkletsのフィールドで参照することができます。二重中括弧内にデータへの参照を含めます：

{{}}

Nexthinkデータベース属性を使用してServiceNowへペイロードを送信する例：

"cmdb_ci": "{{nx.device.name}}"

以前のService/API thinkletからデータをログに記録するServiceNowインシデント更新のリソース例：

api/now/table/incident/{{log_service_now_ticket.result.outputs.sys_id}}

Last updated 7 hours ago

Was this helpful?