チェーンビルダー から、これらのチェーンテンプレートを使用することができます。これらのテンプレートは、環境、社会、ガバナンス（ESG）またはサステナビリティデータのロールフォワードを簡素化します：
- 1a. ESGロールフォワード｜プライマリ｜ここからスタート
- 1b. ESGロールフォワード｜接続とステータスの更新
- 1c. ESGロールフォワード｜接続更新｜実行
ヒント： これらのテンプレートから3つのチェーンを作成しても、実行するのは最初に作成したチェーンだけで、自動的にすべてのチェーンが実行される。
注： これらのチェーンは、データ収集スプレッドシートのみをロールフォワードします -持続可能性プログラムではありません。プログラムの値をロール フォワードする方法については、Sustainability プログラムのロール フォワードとレポート年の管理 をビューしてください。
これらのテンプレートから作成されたチェーンを実行すると、それらが連動して前年のデータセットを自動的にアーカイブし、テーブルにインポートします。チェーンを実行する際、以下の選択もできます：
- データセットをインポートする前に、ソーススプレッドシートの接続を更新して、最新の値を確保
- 次年度のデータ収集に備えるためなど、ソーススプレッドシートの値をクリアする（ソースまたはリンク先を除く）。
メモ: これらのチェーンは、接続Wdataテーブルの同じ期間のデータセットを自動的に置換する。新規データセットのインポート時にエラーが発生した場合、テーブルは前のデータセットに戻されます。
前提条件
これらのテンプレートから作成されたチェーンは、そのコマンドを実行するために特定のコネクターを必要とします。
これらのテンプレートからチェーンを作成する前に、チェーンビルダーでこれらのコネクターを設定してください：
- Workiva コネクター
- Workiva チェーン コネクター
- 表形式変換 コネクター
- JSON コネクター
- ハンドルバー コネクター
- ファイルユーティリティ コネクター
- HTTP リクエスト コネクター
メモ： これらのテンプレートのチェーンで使用されるすべてのコネクターは、デフォルトの CloudRunner を使用します。GroundRunnerは必要ない。
メモ： HTTP リクエスト コネクターがコマンドを実行するには、Workiva コネクターの統合ユーザー用に作成された OAuth グラント のクライアント ID とシークレットが必要です。OAuth付与のスコープが適切であることを確認してください。
ステップ1.Workiva ファイルの設定
これらのテンプレートから作成されたチェーンは、持続可能性データのためのWorkivaファイルの特定のセットアップを必要とする。これらのテンプレートのチェーンを実行する前に、データを収集しロールフォワードするための Workiva ファイルを設定します：
- スプレッドシートで、持続可能性レポートに使用するデータ収集シートを識別します。
- Wdataで、接続データセットとしてSpreadsheetを使用するテーブルを作成し、、チェーンを実行するときのためにテーブルのIDを記録します。
- スプレッドシートで、、Wdataテーブルへの発信接続の更新ステータスを追跡するシート を追加し、チェーンを実行するときのためにシートの名称を記録する。
- クエリを作成：
- データ収集スプレッドシートに接続したWdataテーブルを、データソース として使用する。
- クエリでは、、テーブルのYear 列と同じデータ型で、Yearの多選択パラメータ を含む。
- チェーンを実行するときのために、クエリのID を記録しておく。
ステップ 2.変数とランタイム入力の値を決定する。
チェーンが複数のワークスペースで作業できるようにするため、変数を使用して、Workiva コネクターの統合ユーザーと環境を識別します。チェーンビルダーで、これらのワークスペース変数を作成します：
| 変数 | 値 |
|---|---|
| wsv-ClientID | Workiva 統合ユーザー用に作成された OAuth2 グラントのクライアント ID。 |
| wsv-ClientSecret | 統合ユーザー用に作成された OAuth2 グラントに生成されたクライアントシークレット。 |
| wsv-BaseURL-Wdata | 環境のリージョンに基づいた、WdataコマンドのURLホストベースとベースパス：
|
| wsv-BaseURL-IAM | 環境のリージョンに基づく、Identity and Access Management コマンドの URL ホストベースとベースパス：
|
| wsv-BaseURL-OC | 環境のリージョンに基づく、チェーンコマンドのURLホストベースとベースパス：
|
1aから作成したチェーンを実行する場合ESG roll forward | Primary | Start here テンプレートでは、対話する Workiva ファイルの識別子とデータセットの識別方法について、実行時の入力を求めるプロンプトが表示されます：
| ランタイム入力 | 値 |
|---|---|
| データ収集-ロールフォワード・テーブルID | データセットをインポートするWdataテーブル（データ収集スプレッドシートに接続）のID。 |
| データ収集-ロールフォワード・クエリID | データをアーカイブするために実行するWdataクエリのID |
| 年 | アーカイブするデータの年 |
| タグ値 | アーカイブするデータセットの名称 注: チェーンはタグ値入力とPY年入力を用いて、 |
| Status—SheetName | WdataテーブルへのSpreadsheetの発信接続の更新状態を追跡するシートの名称。 |
ステップ3. チェーンの作成
データ収集のロールフォワードに必要なチェーンを作成するには、1a. ESGロールフォワード｜プライマリ｜ここからスタート テンプレート：
- チェーンビルダー のテンプレート から、1a を開く。ESGロールフォワード｜プライマリ｜ここからスタート テンプレートをクリックし、新規チェーン をクリックする。
- チェーンを識別するための名称を入力する。
- チェーンを使用する環境を選択し、次へ をクリックします。
-
dcv-clearSuccess変数に名称ｔぉして
dvc-clearSuccessを入力し、次へをクリックします。 - 各接続について、使用するコネクターを選択し、Next chain をクリックします。
メモ： 各コネクターには、デフォルトの CloudRunner を使用します。
- 各変数を設定し、次へ をクリックする。
変数 変数タイプ 新規変数 wsv-ClientID ワークスペース wsv-ClientIDを選択。 cv-TimeToCheck チェーン cv-TimeToCheckwsv-ClientSecret ワークスペース wsv-ClientSecretを選択する。 dcv-RefreshStatus チェーン・ダイナミック dcv-RefreshStatuswsv-BaseURL-IAM ワークスペース wsv-BaseURL-IAMを選択する。 wsv-BaseURL-OC ワークスペース wsv-BaseURL-OCを選択。 - 各接続について、使用するコネクターを選択し、Next chain をクリックします。
メモ： 各コネクターには、デフォルトの CloudRunner を使用します。
- 各変数を設定し、次へ をクリックする。
変数 変数タイプ 新規変数 dcv-srcStatus チェーン・ダイナミック dcv-srcStatuswsv-ClientID ワークスペース wsv-ClientIDを選択。 dcv-destStatus チェーン・ダイナミック dcv-destStatuswsv-ClientSecret ワークスペース wsv-ClientSecretを選択する。 wsv-BaseURL-Wdata ワークスペース wsv-BaseURL-Wdataを選択する。 wsv-BaseURL-IAM ワークスペース wsv-BaseURL-IAMを選択する。 - 各接続について、使用するコネクターを選択し、Submit をクリックします。
メモ： 各コネクターには、デフォルトの CloudRunner を使用します。
ステップ4.チェーンの更新
注： インストールを簡単にするため、接続とステータスを更新テンプレートにはチェーンを実行イベントがあります。テンプレートから作成したチェーンを更新する前に、この余計なチェーンを実行イベントを削除してください。
-
Chains から、Refresh connections & status テンプレートから作成したチェーンについて、Edit を選択する。
-
Run chain - Delete イベントを選択し、Delete とDelete をクリックする。
- 更新、更新をクリックします。
- Chains から、Primary テンプレートから作成したチェーンについて、Edit を選択する。
- 更新 と発行 をクリックする。
- Chains から、Execution テンプレートから作成したチェーンについて、Edit を選択する。
- 更新 と発行 をクリックする。
チェーン実行
データをアーカイブ（保存）し、次年度のデータ収集に備える：
-
チェーンビルダーで、チェーンから実行を選択し、1a. から作成したチェーンを実行します。ESGロールフォワード｜プライマリ｜ここからスタート テンプレート。
-
Run with inputs をクリックして、実行時の入力を入力する：
ランタイム入力 値 データ収集-ロールフォワード・テーブルID データセットをインポートするWdataテーブルのIDを入力してください。 データ収集-ロールフォワード・クエリID データをアーカイブ（する）ために実行するクエリのIDを入力します。 年 アーカイブするデータの年を入力します。 タグ値 アーカイブするデータセットの名称を入力します。 注： PY年 入力で、この入力はデータセットのファイル名称を
[タグ値]_[PY年].csvとして作成する。例えば、PY年 が2021年、タグ値 がアーカイブ（Archived）である場合、Archived_2021.csvというファイル名が作成される。データアーカイブする前のシート接続の更新 アーカイブ（する）前にデータセットを更新するなど、ロールフォワードクエリを実行する前に、スプレッドシートのWdataテーブルへの発信接続を更新するかどうかを選択する。 Status—SheetName スプレッドシートからWdataテーブルへの発信接続の更新状況を追跡するシートの名称を入力する。 RefreshExecution—ChainName ESG ロールフォワード｜接続更新｜実行 テンプレートから作成したチェーンの名称を入力します。 クリアスプレッドシート値列 ロールフォワードの一環としてスプレッドシートから入力値を削除するかどうかを選択する。 メモ： ソースリンクまたはリンク先がある値は削除されない。
- データセットをインポートする前に最新の値を確認するには、データのアーカイブ化の前に接続を更新を選択します。
このオプションを選択すると、チェーンはスプレッドシートの発信接続をリフレッシュし、そのリフレッシュ状態をコントロールシートで追跡する：- Status-SheetName に、チェーンが発信接続の更新ステータスを保存できるソーススプレッドシートのシート名称を入力する。
- RefreshExecution-ChainNameには、ESG ロールフォワード｜接続更新｜実行テンプレートから作成したチェーンの名称を入力します。
ヒント: スプレッドシートの発信接続数によっては、更新に数分かかる場合があります。待機時間を調整するには、1bから作成したチェーンのポーズチェーン イベントを編集する。ESGロールフォワード｜接続とステータスの更新 テンプレート。
- 次年度のデータ収集に備えるなど、アーカイブ化の一環としてソーススプレッドシートから入力値を削除するには、スプレッドシート値列をクリアを選択します。
メモ： チェーンはソースまたはリンク先にリンクされた値を保持する。スプレッドシートから削除済の値を復元することはできません。次年度のデータ収集のためにスプレッドシートを準備するため、年度最終のロールフォワードにのみこのオプションを選択することを推奨する。
Tip: デフォルトでは、チェーンはスプレッドシートの2行目から値を削除します。これを調整するには、シートデータのクリア コマンドのRegion プロパティを編集します。
- Start をクリックします。