Maintain Wdata Parametersテンプレートは、チェーンを通して値を更新することによって、Wdataパラメータのピックリストを維持することができます。
ヒント ：パラメータ値 は実行時に指定され、クエリ結果を動的にフィルターするために使用されます。ピックリストはこれらの値を強制しますが、クエリを実行する前に定義する必要があります -- それら値が定期的に変更する場合に課題を作成します。このテンプレートを使えば、プログラムによってその値を維持することができる。
要件
- このテンプレートを使用するには、パラメータピックリストに追加する値のリストを含むWorkivaスプレッドシートまたはクエリが必要です。
- OAuthトークン を生成し、クライアントIDとクライアントシークレットをワークスペース変数として保存する必要があります。クライアント秘密のワークスペース変数が暗号化されていることを確認する。
- 以下のコネクターをワークスペースに構成する必要があります：
テンプレートを作成
Maintain Wdata Parameters テンプレートは、 Templates 画面の Workiva チェーンセクションにある。
検索方法はこうだ：
- チェーンビルダーで、テンプレート タブに移動します。
- 上部のメニューからWorkiva チェーン を選択。
- 右上の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 | テキスト | パラメータのタイプがローカルの場合は必須。 これは、クエリに割り当てられているパラメータに関連付けられた選択リストIDを検索するために使用されます。 |
サブチェーン
- Maintain Wdata Parameters | Add Values ：このチェーンはプライマリチェーンをデプロイする際に自動的にデプロイされる。
注： プライマリチェーンを実行する前に、必ずこの子チェーンを更新してください。
構成可能なノード
メッセージングに使用されるフィールドは、ビジネス要件をサポートするために必要に応じて修正することができます：
- プライマリチェーン：テキストテンプレートのレンダリング - 無効なクエリID
- プライマリチェーン：設定チェーン結果 - 警告（クエリが検索されない）
- プライマリチェーン：テキストテンプレートのレンダリング - 無効なパラメータ
- プライマリチェーン：設定チェーン 結果 - 警告（無効パラメータ）
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - パラメータIDの指定なし
- 子チェーン（値の追加）：チェーン設定結果 - 警告 (パラメータID)
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - パラメータモードタイプ
- 子チェーン（値の追加）：チェーン設定結果 - 警告（パラメータタイプ）
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - 情報提供：新規アイテムなし
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - 警告：アイテムが多すぎます
- 子チェーン（値の追加）：チェーン設定結果 - 警告（置換）
- 子チェーン（値の追加）：チェーン設定結果 - 警告（追加）
- 子チェーン（値の追加）：テキストテンプレートのレンダリング - ステータスレポート