Chain Builder から、これらのチェーン・テンプレートを使用することができ、これらのテンプレートは、環境、社会、ガバナンス(ESG)データのロールフォワードを簡素化します:
- 1a. ESGロールフォワード|プライマリー|ここからスタート
- 1b. ESGロールフォワード|接続とステータスのリフレッシュ
- 1c. ESGロールフォワード|リフレッシュ接続|実行
ヒント: これらのテンプレートから3つのチェーンを作成しても、最初に作成したチェーンだけが実行され、すべてのチェーンが自動的に実行される。
注: これらのチェーンは、データ収集用スプレッドシートのみをロールフォワードするものであり、ESGプログラム ではない。ESGプログラム を新しい報告年にロール・フォワードするには、Workivaカスタマー・サクセス・マネージャーまでご連絡ください。
これらのテンプレートから作成されたチェーンを実行すると、連動して前年のESGデータセットが自動的にアーカイブされ、テーブルにインポートされます。連鎖を実行する際、以下を選択することもできる:
- データセットをインポートする前に、ソーススプレッドシートの接続をリフレッシュする。
- 次年度のデータ収集の準備など、ソーススプレッドシートの値をクリアにする(ソースまたは宛先にリンクされているものを除く)。
注: これらのチェーンは、接続されているWdataテーブルの同じ期間のデータセットを自動的に置き換える。新しいデータセットのインポート時にエラーが発生した場合、テーブルは以前のデータセットに戻る。
前提条件
これらのテンプレートから作成されたチェーンは、そのコマンドを実行するために特定のコネクターを必要とする。
これらのテンプレートからチェーンを作成する前に、Chain Builderでこれらのコネクタを設定してください:
- Workiva コネクター
- Workiva Chains コネクター
- 表形式変換 コネクタ
- JSON コネクター
- ハンドルバー コネクター
- ファイルユーティリティ コネクタ
- HTTP リクエスト コネクタ
注: これらのテンプレートのチェーンで使用されるすべてのコネクタは、デフォルトのCloudRunnerを使用します。グラウンドランナーは必要ない。
注: そのコマンドを実行するために、HTTP Request コネクタは、Workiva コネクタの統合ユーザー用に作成された OAuth グラント のクライアント ID とシークレットを必要とします。OAuthグラントが適切なスコープを持っていることを確認してください。
ステップ1.Workivaファイルのセットアップ
これらのテンプレートから作成されたチェーンは、ESGデータ収集のためにWorkivaファイルの特定のセットアップを必要とします。これらのテンプレートチェーンを実行する前に、ESGデータを収集し、ロールフォワードするためのWorkivaファイルを設定します:
- スプレッドシート」で、ESG報告に使用するデータ収集シートを特定する。
- 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 | 環境のリージョンに基づく、ChainsコマンドのURLホストベースとベースパス:
|
1aから作成したチェーンを実行する。ESG roll forward | Primary | Start here テンプレートでは、相互作用するWorkivaファイルを特定するための実行時入力と、データセットを特定する方法を求めるプロンプトが表示される:
ランタイム入力 | 値 |
---|---|
データ収集-ロールフォワード・テーブルID | ESG データセットをインポートする Wdata テーブル(ESG データ収集スプレッドシートに接続)の ID。 |
データ収集-ロールフォワード・クエリーID | データをアーカイブするために実行するWdataクエリのID |
年 | アーカイブされるデータの年 |
タグの値 | アーカイブされたデータセットの名前 注: チェーンは、タグ値 入力と、年度 入力を使って、 |
ステータス・シート名 | スプレッドシートのWdataテーブルへの送信接続のリフレッシュ状態を追跡するシートの名前。 |
ステップ3.チェーンを作る
ESGデータ収集のロールフォワードに必要なチェーンを作成するには、1a.を使用します。ESG roll forward | Primary | Start here テンプレート:
- Chain Builder のTemplates から、1a を開く。ESG roll forward | Primary | Start here テンプレートをクリックし、New chain をクリックする。
- チェーンを識別するための名前を入力します。
- チェーンを使用する環境を選択し、Next をクリックします。
-
dcv-clearSuccess 変数に、
dvc-clearSuccess
と入力し、Next をクリックする。
- 各接続について、使用するコネクタを選択し、Next chain をクリックします。
注: 各コネクタには、デフォルトの CloudRunner を使用します。
- 各変数を設定し、Next をクリックする。
変数 可変タイプ 新しい変数 wsv-ClientID ワークスペース wsv-ClientIDを選択する。 cv-TimeToCheck チェーン cv-TimeToCheck
wsv-ClientSecret ワークスペース wsv-ClientSecretを選択する。 dcv-RefreshStatus チェーン・ダイナミック dcv-RefreshStatus
wsv-BaseURL-IAM ワークスペース wsv-BaseURL-IAMを選択する。 wsv-BaseURL-OC ワークスペース wsv-BaseURL-OCを選択する。 - 各接続について、使用するコネクタを選択し、Next chain をクリックします。
注: 各コネクタには、デフォルトの CloudRunner を使用します。
- 各変数を設定し、Next をクリックする。
変数 可変タイプ 新しい変数 dcv-srcStatus チェーン・ダイナミック dcv-srcStatus
wsv-ClientID ワークスペース wsv-ClientIDを選択する。 dcv-destStatus チェーン・ダイナミック dcv-destStatus
wsv-ClientSecret ワークスペース wsv-ClientSecretを選択する。 wsv-BaseURL-Wdata ワークスペース wsv-BaseURL-Wdata を選択する。 wsv-BaseURL-IAM ワークスペース wsv-BaseURL-IAMを選択する。 - 各接続について、使用するコネクタを選択し、Submit をクリックします。
注: 各コネクタには、デフォルトの CloudRunner を使用します。
ステップ4.チェーンを公開する
注: インストールを容易にするため、Refresh connections & status テンプレートには、Run chain イベントがあります。テンプレートから作成したチェーンを公開する前に、この余計なRun chain イベントを削除してください。
-
Chains から、Refresh connections & status テンプレートから作成されたチェーンについて、Edit を選択します。
-
Run chain - Delete イベントを選択し、Delete とDelete をクリックする。
- PublishとPublish をクリックする。
- Chains から、Primary テンプレートから作成したチェーンについて、Edit を選択します。
- PublishとPublish をクリックする。
- Chains から、Execution テンプレートから作成したチェーンについて、Edit を選択します。
- PublishとPublish をクリックする。
チェーンを走らせる
ESGデータをアーカイブし、次年度のデータ収集に備える:
-
Chain Builder で、Chains から、Execute を選択し、1a.ESG roll forward | Primary | Start here テンプレート。
-
Run with inputs をクリックし、ランタイム入力を入力する:
ランタイム入力 値 データ収集-ロールフォワード・テーブルID データセットをインポートするWdataテーブルのIDを入力してください。 データ収集-ロールフォワード・クエリーID データをアーカイブするために実行するクエリのIDを入力します。 年 アーカイブするデータの年を入力します。 タグの値 アーカイブされたデータセットの名前を入力します。 注: PY年 入力で、この入力はデータセットのファイル名を
[タグ値]_[PY年].csv
として作成する。例えば、PY年 が2021年、タグ値 がArchivedの場合、Archived_2021.csv
というファイル名が作成される。データアーカイブ前にシート接続をリフレッシュ ロールフォワードクエリを実行する前に、WdataテーブルへのSpreadsheetの送信接続をリフレッシュするかどうかを選択する。 ステータス・シート名 スプレッドシートからWdataテーブルへの送信接続のリフレッシュステータスを追跡するシートの名前を入力します。 リフレッシュ実行チェーン名 ESG Rollforward | Refresh connection | Execution テンプレートから作成されたチェーンの名前を入力します。 スプレッドシートの値列を消去する ロールフォワードの一環として、スプレッドシートから入力値を削除するかどうかを選択する。 注: 送信元または送信先のリンクを持つ値は削除されない。
- データセットをインポートする前に最新の値を確認するには、Refresh connections before data archival を選択してください。
このオプションを選択すると、チェーンがスプレッドシートの発信接続をリフレッシュし、そのリフレッシュ状態をコントロールシートで追跡します:- Status-SheetName に、チェーンが発信接続のリフレッシュ・ステータスを保存できるソース・スプ レッドシートのシート名を入力する。
- RefreshExecution-ChainName には、ESG Rollforward | Refresh connection | Execution テンプレートから作成されたチェーンの名前を入力します。
ヒント: Spreadsheetの発信接続数によっては、更新に数分かかる場合があります。待ち時間を調整するには、Pause chain event of chain created from1bを編集する。ESGロールフォワード|接続とステータスのリフレッシュ テンプレート。
- 次年度のデータ収集に備えるなど、アーカイブの一環としてソーススプレッドシートから入力値を削除するには、Clear spreadsheet value column を選択します。
注: チェーンは、ソースまたは宛先にリンクされた値を保持します。スプレッドシートから削除された値を復元することはできません。次年度のデータ収集のためにスプレッドシートを準備するため、その年の最終ロールフォワードにのみこのオプションを選択することを推奨する。
ヒント: デフォルトでは、チェーンはスプレッドシートのシートの2行目から値を削除します。これを調整するには、Clear sheet data コマンドのRegion プロパティを編集します。
- Start をクリックする。