パラメータと動的値

ワークフローは、動的で柔軟かつコンテキストに応じた自動化を可能にするために、パラメータとしてワークフローの実行中に取得された値や、Nexthinkデータの値に依存しています。

ワークフローでは、以下のセクションで説明される動的値の種類を使用します。

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

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

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

これらはワークフローのトリガー時に動的に設定されることもあれば、ワークフロー設計時に静的な値として定義されることもあり、ワークフロー全体を通して参照されます。

パラメーターを定義する

パラメーターはワークフローデザインの一部として定義されます。

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

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

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

ワークフローパラメーターを定義すると、ワークフロートリガーの種類に基づいてパラメーターの値を動的に設定できます。

スケジュールまたはイベント型トリガーの場合

スケジュールまたはイベント型トリガーを構成する際、パラメーターの値を選択します:

ワークフローデザイナーで構成された事前定義の値リスト。
カスタムの自由入力テキスト値。
NQLクエリのlistステートメントに定義された属性。

APIトリガーの場合

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

手動トリガーの場合

Nexthink製品（またはNexthink Amplifyからも）から手動のアクションでワークフローをトリガーするとき、ユーザーはパラメーターの値を入力するよう促されます。

ワークフローを手動でアクティブ化するには、ワークフローを手動でトリガーするドキュメントを参照してください。

以下の例では、binary_nameワークフローパラメーターの値を、NQLクエリのbinary.name属性値に設定し、実行中クラッシュのリアルタイムイベントでワークフローを起動します。

トリガーの設定には、ワークフローのトリガーを参照し、ワークフローパラメーターを組み込んだトリガーの設定について確認してください。

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

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

{{global.parameter_id}}

ワークフローパラメータを参照するには：

ターゲットワークフローにパラメーターを追加します。
ワークフロービジュアルデザイナーのNEALタブでパラメーターの内部idを見つけてください。

以下の例では、ワークフローパラメータ p22 のパラメータ id は NEAL ビューでは p_22 です。以下の画像をご覧ください。

<globalVariable id="p_22" name="p22" ...>
    <value>p22</value>
</globalVariable>

表示されているパラメータ Name を参照用途に使用しないでください。

NEAL では、ワークフローパラメータの XML タグは歴史的な言語実装により <global variable> となっています。

Thinkletの出力

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

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

{{thinkletID.result.outputs.outputid}}

各シンクレットの出力パラメーターを設定する方法については、シンクレットの設定のドキュメントを参照してください。

データベースの値

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

device
user

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

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

静的属性と手動カスタムフィールドは、パラメーターで使用可能です。

システムは現在、イベントデータや実行時に計算されるカスタムフィールドをサポートしていません。

ワークフロー内でNexthinkフィールドを参照する際には、以下の形式を使用してください:

{{nx.object.fieldname}}

デバイス属性を参照する例:

{{nx.device.ad_site}}

ユーザー属性を参照する例:

{{nx.user.ad.email_address}}

システム値

システム値は、現在のワークフロー実行に対するリファレンスを提供するために使用できます。これは、ワークフローがサードパーティシステムの操作を待機する必要がある場合に有用です。その後、ワークフローにコールバックをして続行を可能にします。

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

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

sys.workflow.executionId：現在実行中のワークフロー実行のIDを参照します。
sys.workflow.workflowId: 実行中の特定のワークフロー設計を参照します。

これらの値の使用例は、後にワークフローを進めるためにMoveworksチャットボット統合の文脈で使用される場面で示されています。

{
    "message": " こんにちは、{{nx.user.ad.fullname}} さん、お使いのコンピュータには重要なドライバーのアップデートがいくつか不足しており、パフォーマンスに影響を与えている可能性があります",
    "recipients": [
        {{nx.user.ad.email_address}}
    ],
    "context": {
        "slots": {
            "executionid": "{{sys.workflow.executionId}}",
            "workflowid": "{{sys.workflow.workflowId}}"
        }
    }
}

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

動的値とパラメータは、リソースおよびペイロード、メッセージ/テキストシンクレットフィールドで参照できます。データへの参照を二重中括弧内で含めてください:

{{}}

Nexthinkデータベース属性を使用したServiceNowへのペイロード例:

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

以前のサービス/APIシンクレットからのデータを含むServiceNowインシデント更新リソースの例:

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

Last updated 21 hours ago

Was this helpful?