Maintain Wdata Parameters テンプレートでは、Wdata パラメータのピックリストの値を連鎖的に更新することができます。
ヒント ：パラメータ値 は実行時に指定され、クエリ結果を動的にフィルタリングするために使用されます。ピックリストはこれらの値を強制するものだが、クエリを実行する前に定義しなければならない。このテンプレートを使えば、プログラムによってこれらの値を維持することができる。
要件
- このテンプレートを使用するには、パラメータのピックリストに追加する値のリストを含むWorkivaのスプレッドシートまたはクエリが必要です。
- OAuthトークン を生成し、クライアントIDとクライアントシークレットをワークスペース変数として保存する必要があります。クライアント秘密ワークスペース変数が暗号化されていることを確認する。
- 以下のコネクタをワークスペースに設定する必要があります：
テンプレートを作成する
Maintain Wdata Parameters テンプレートは、Templates 画面の Workiva Chains セクションにある。
探し方はこうだ：
- Chain Builder で、Templates タブを開きます。
- 上部のメニューからWorkiva Chains を選択。
- 右上のMaintain Wdata Parameters を検索し、テンプレートを開く。
テンプレートが見つかったら、以下のランタイム入力を使ってワークスペース用に設定する。
注： テンプレートからチェーンを作成する詳細な手順については、チェーンの作成と管理 の記事を参照してください。
変数
| 可変タイプ | 変数名 | 可変目的 |
| チェーン | cv-Wdata パラメータ項目リストの上限 | ピックリストの項目数に対するWdataの制限値を格納します。これは、将来的な制限の変更を可能にするための変数として作成される。 |
| ワークスペース変数 | wsv_API ベース URL - IAM | IAM API のルートパス。この値はAPI 開発者向けドキュメント に記載されています。 |
| ワークスペース変数 | wsv_API ベース URL - Wdata | Wdata API のルートパス。この値はAPI 開発者向けドキュメント に記載されています。 |
| ワークスペース変数 | wsv_クライアントID | OAuthグラントのクライアントID。 |
| ワークスペース変数 | wsv_Client シークレット | OAuth グラントのクライアントシークレット。入力後、この変数が暗号化されていることを確認する。 |
チェーンの設定
以下のセクションは、このチェーンの設定可能な要素とその機能を確認するのに役立ちます。
ランタイム入力
| ランタイム入力 | タイプ | 目的 |
| パラメータ名 | テキスト | このチェーンによって値が更新されるWdataパラメータを指定する。 |
| 種別を更新 | ドロップダウン | 既存のリストに新しい値を追加するか、すべての値を追加される値で置き換えるかのオプション。 |
| 追加する値 | ファイル | 行として追加する値を含む単一列ファイル。このファイルにはヘッダー行が必要である。このファイルは、Workivaのスプレッドシート、Wdataクエリ、または必要な形式のファイルを生成するその他のソースから作成することができます。 |
| パラメータ・タイプ | ドロップダウン | パラメータをワークスペース内でグローバルに定義するか、クエリ内でローカルに定義するかを指定するオプション。 |
| クエリーID | テキスト | パラメータタイプがlocalの場合は必須。 これは、クエリに割り当てられているパラメータに関連付けられたセレクト・リスト ID を検索するために使用されます。 |
サブチェーン
- Wdata パラメータの管理｜値の追加 ：このチェーンは、プライマリ・チェーンのデプロイ時に自動的にデプロイされる。
注： 、プライマリー・チェーンを実行する前に、この子チェーンをパブリッシュしておくこと。
設定可能なノード
メッセージングに使用されるフィールドは、ビジネス要件をサポートするために必要に応じて変更することができます：
- プライマリチェーンテキストテンプレートのレンダリング - 無効なクエリID
- プライマリーチェーンセットチェーン結果 - 警告（クエリが見つかりません）
- プライマリチェーンテキストテンプレートのレンダリング - 無効なパラメータ
- プライマリーチェーンSet Chain 結果 - 警告（無効なパラメータ）
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - パラメータIDの指定なし
- 子チェーン（値の追加）：セットチェーン結果 - 警告(パラメータID)
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - パラメータモードタイプ
- 子チェーン（値の追加）：セットチェーン結果 - 警告（パラメータタイプ）
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - 情報提供：新規項目なし
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - Warning：項目が多すぎます
- 子チェーン（値の追加）：セットチェーン結果 - 警告（置換）
- 子チェーン（値の追加）：セットチェーン結果 - 警告（追加）
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - ステータスレポート