パラメータと動的値

ワークフローはインプットパラメーター、ワークフロー実行中に取得された値、もしくはNexthinkのデータ値に依存しており、これにより動的で柔軟かつコンテキストに応じた自動化が可能です。

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

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

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

ワークフローパラメーターを使用してワークフロー内部でパラメーター化されたアクションを実行したり、条件の一部として評価したりします。

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

パラメーターを定義する

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

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

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

• ワークフローパラメーターの名前を入力します。

• ワークフローパラメーターの必須のデフォルト値を入力します。

  • カスタム値を許可を選択して、パラメーターをワークフロートリガーで設定できるようにします。

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

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

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

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

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

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

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

APIトリガーの場合

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

手動トリガーの場合

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

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

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

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

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

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

{{global.parameter_id}}

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

1. ターゲットワークフローにパラメーターを追加します。

2. ワークフローのビジュアルデザイナーのNEALタブで、パラメーターの内部idを見つけます。

以下の例では、ワークフローパラメーターp22はNEALビューでp_22のパラメーターIDを持っています。 下の画像を参照してください。

<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}}"
        }
    }
}

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

動的値とパラメーターは、ResourceやPayload、Message/Text thinkletsフィールドで参照できます。 データへの参照を二重中括弧内で含めてください:

{{}}

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

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

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

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