動的テンプレートのデータ収集アクションの作成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • 動的テンプレート入力のレコードフィールド値を収集するデータ収集アクションを作成します。

    始める前に

    • 必要なロール：action_designer または admin
    • REST エンドポイントの認証情報と接続を作成する
    注:
    動的入力はベースシステムでは使用できません。ワークフロースタジオ で動的入力を使用するには、次のことを行う必要があります 要求 統合ハブ プラグイン.

    手順

    1. 移動先 すべて > プロセスの自動化 > Flow Designer.
    2. 選択 新規作成 > アクション.
    3. [アクション名] フィールドにアクションの名前を入力し、適切な [アプリケーション] スコープを選択して、[送信] を選択します。
    4. オプション: [アクションアウトライン] から、[入力] を選択します。
      場合によっては、REST ステップにテーブル名または動的 URL パスを提供するための入力を作成する必要があります。
      たとえば、テーブル名を格納する文字列入力を作成するなどです。手順については、「フィールド名を取得するためのデータ収集アクションの作成」を参照してください。
    5. [アクションアウトライン] の [入力] の下で、[新しいステップを追加] アイコン ([新しいステップを追加] アイコン) を選択し、[REST] ステップを選択します。
      1. [接続の詳細] から、接続エイリアスを選択するか、接続をインラインで定義します。
        接続エイリアスを選択すると、アクションを編集せずに接続の詳細を更新できます。
        たとえば、ローカルインスタンスへの接続エイリアスを選択するなどです。
      2. [要求の詳細] で、要求をビルドするメソッドを選択し、リソースパスを指定し、HTTP メソッドを選択して、任意のクエリパラメーターを指定します。
        データ収集アクションでは、通常、GET HTTP メソッドを使用して REST エンドポイントからデータを要求します。統合ハブ で REST ステップを使用する方法の詳細については、「REST ステップ」および「IntegrationHub の REST (REST in IntegrationHub)」を参照してください。
    6. [アクションアウトライン] の [REST ステップ] で、[新しいステップを追加] アイコン ([新しいステップを追加] アイコン) をクリックし、[スクリプト] ステップを選択します。
      1. [入力変数] から [変数の作成]を選択し、REST 応答の本文を格納する入力変数を作成します。
      2. 入力変数 [値] で、REST ステップの応答の本文の出力のデータピルを選択します。
      3. [スクリプト] に、入力変数から JSON 出力を作成するスクリプトを入力します。
        入力するスクリプトでは、次のタスクを実行する必要があります。
        入力変数を JSON として解析する
        JSON - Global API を使用して、入力変数を文字列から JSON オブジェクトに変換できます。
        動的テンプレート用にフォーマットされた新しい JSON オブジェクトを作成する
        応答の値をテンプレートの値にマッピングするには、REST 応答のデータ構造を把握している必要があります。スクリプトで data という名前のプロパティを持つ動的テンプレートの JSON オブジェクトを作成する必要があります。data プロパティの値は、テンプレート値のアレイである必要があります。各テンプレート値には、label プロパティ、name プロパティ、および空の value プロパティが必要です。label プロパティは、テンプレート値のオプションがアクション内でどのように表示されるかを決定します。name プロパティは、テンプレート値のオプションがシステム内でどのように格納され、参照されるかを決定します。アクションの設定時に値を動的に設定できるよう、value プロパティは空になっています。

        たとえば、この JSON オブジェクトは、インシデントテーブルのテンプレート値のアレイを定義します。

        {
    "data": [
      {
        "name": "parent",
        "label": "Parent",
        "value": ""
      },
      {
        "name": "number",
        "label": "Number",
        "value": ""
      },
      {
        "name": "state",
        "label": "State",
        "value": ""
      },
      {
        "name": "active",
        "label": "Active",
        "value": ""
      },
      {
        "name": "priority",
        "label": "Priority",
        "value": ""
      },
      {
        "name": "caller_id",
        "label": "Caller id",
        "value": ""
      },
      {
        "name": "short_description",
        "label": "Short description",
        "value": ""
      },
      {
        "name": "description",
        "label": "Description",
        "value": ""
      },
      {
        "name": "sys_id",
        "label": "Sys id",
        "value": ""
      },
      {
        "name": "urgency",
        "label": "Urgency",
        "value": ""
      },
      {
        "name": "assigned_to",
        "label": "Assigned to",
        "value": ""
      },
      {
        "name": "severity",
        "label": "Severity",
        "value": ""
      },
      {
        "name": "category",
        "label": "Category",
        "value": ""
      }
    ]
}
        注:
        動的テンプレート入力では、最大 5,000 個のフィールドテンプレート値しか表示できません。5,000 を超えるフィールドテンプレート値を返す JSON オブジェクトは、レンダリング時に切り捨てられます。
        出力オブジェクトを設定する
        動的テンプレートの JSON オブジェクトを返すように出力オブジェクトを設定します。
      4. [出力変数] から [変数の作成] を選択します。
        この出力変数には、スクリプトが作成するテンプレート値が保存されます。
      5. 出力変数タイプには、[JSON] を選択します。
        スクリプト出力変数タイプは JSON である必要があります。
    7. [アクションアウトライン] で、[出力] を選択します。
      1. [出力の作成] を選択します。
      2. 出力のラベルと名前に「output」を設定します。
      3. 出力タイプを「JSON」に設定します。
        注:
        アクションには複数の出力を含めることができますが、含めることができる JSON タイプは 1 つのみです。
      4. [編集モードを終了] を選択します。
      5. [値] フィールドの横にあるデータピルピッカー (データピルピッカー) を選択し、テンプレート値を格納するために作成したスクリプトステップの出力変数を選択します。
    8. [保存] をクリックし、アクションをテストします。
      実行の詳細で、[出力] のランタイム値に data プロパティが適切な形式で含まれている場合、データ収集アクションは正常に実行されます。
    9. [公開] をクリックし、同じアプリケーションスコープ内の他のフローやアクションでアクションを使用できるようにします。

    タスクの結果

    データ収集アクションを使用して、親アクションの動的テンプレート入力に表示されるオプションを設定できるようになりました。データ収集アクションを使用して動的テンプレートのオプションを設定します。