Persefoni Template Spreadsheet を使えば、環境・社会・ガバナンス(ESG)報告で開示するための排出量データをPersefoni® から収集することができます。WdataChain Builder から、自動的に連動する複数のチェーンを構築できます:
- ペルセフォーニから炭素会計データのダウンロードを開始
- Persefoni Template Spreadsheet の値を更新する。
- ペルセフォーニからのデータダウンロード時のログ
注: この手順では3つのチェーンを構築するが、ペルセフォニからデータをダウンロードし、ペルセフォニ・テンプレート スプレッドシートを更新するために、1つのチェーンだけを実行し、他のチェーンを自動的に実行する。
ペルセフォーニからは、さまざまな種類のデータをダウンロードすることができる:
- 排出量 、取引に伴う温室効果ガス(GHG)排出量
- 活動内容 、カーボンフットプリントの算出に使用したすべての投融資活動。
- 設備 、取引に関連する御社の拠点について
注: Persefoni Template SpreadsheetはWorkivaが提供しています。このスプレッドシートをお持ちでない方で、ご興味のある方は、カスタマー・サクセス・マネージャーまでお問い合わせください。
前提条件
これらのチェーンを作るには、これらのコネクターが必要だ:
注: チェーンのコマンドはすべてデフォルトのCloudRunnerを使用します。グラウンドランナーは必要ない。
チェーンをつなぐ前に、そのチェーンを確認すること:
- PersefoniリソースグループのIDとダウンロードするデータの言語
- Persefoni Template Spreadsheet およびそのControl Sheet セクションのID。
データのダウンロードを記録するチェーンを構築する
手始めに、Persefoni Template SpreadsheetのControl Sheet のセクションで、炭素会計データが最後にいつ更新されたかを追跡するチェーンを構築する。
ステップ1:チェーンを作成する
-
チェーンビルダー で、チェーン から、チェーンの作成 をクリックし、チェーンの作成 を選択する。
-
Setup で、チェーンの識別に役立つ名前と説明を入力する。
- Variables の下に、Persefoni Template Spreadsheet とそのControl Sheet セクションの ID の変数を追加する。
- [保存]をクリックします。
ステップ2.Runtime Inputsイベントから始める
コントロールシート セクションのどのセルをチェーン実行時に更新するかを示すには、ランタイム入力 イベントで始める:
- ランタイム入力 をトリガーイベント の下から開始 に移動する。
- Runtime inputs イベントを選択し、Edit をクリックする。
-
Add input をクリックし、TextField を選択する。
- 表示名 に「範囲」と入力。
-
必須 を選択し、保存 をクリックする。
ステップ3.ログファイルを作成するコマンドを追加する
チェーンがPersefoniからデータをダウンロードしたときのログファイルを作成するには、Create file コマンドを追加する:
- BizApps で、File Utilities を選択し、Create file をキャンバスにドラッグします。
- Start からCreate file コマンドにリンクをドラッグする。
- Create file コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、ログファイルを作成する意図を識別するのに役立つ名前と説明を入力する。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 使用する File Utilities コネクタを選択します。 テキスト Data last refreshed on
と入力し、System.DateTime ランタイム変数を選択する。
ステップ4.コントロールシートのセクションを更新するコマンドを追加する
Persefoni Template Spreadsheet のControl Sheet セクションをログファイルで更新するには、Overwrite sheet data コマンドを追加する:
- BizApps で、Workiva を選択し、Overwrite sheet data をキャンバスにドラッグします。
- Create file コマンドからOverwrite sheet data コマンドにリンクをドラッグします。
- シートデータの上書き コマンドを選択し、編集 をクリックします。
-
基本情報 の下に、コントロールシート セクションを上書きする意図を識別するのに役立つ名前と説明を入力します。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 使用する Workiva コネクタを選択します。 スプレッドシート ID Persefoni Template Spreadsheet のチェーン変数を選択する。 セクションID/名前 コントロールシート セクションのチェーン変数を選択する。 データファイル 作成ファイル コマンドの作成ファイル 出力を選択する。 - Publish をクリックし、掲載に関するコメントを入力し、Publish をクリックする。
Persefoniからデータをダウンロードしてインポートするチェーンを構築する。
次に、Persefoniから排出量、活動、施設のデータをダウンロードするチェーンを構築する。
ステップ1:チェーンを作成する
- チェーンビルダー で、チェーン から、チェーンの作成 をクリックし、チェーンの作成 を選択する。
-
Setup で、チェーンの識別に役立つ名前と説明を入力する。
-
Allow concurrent runs を選択し、Save をクリックする。
ステップ2.コントロールシートのセクションに基づいてデータをダウンロードするロジックを追加します。
Persefoni Template SpreadsheetのControl Sheet セクションから、排出量、活動、または施設データに基づいて値を更新するかどうかを選択できます。チェーン実行時にこれらの選択に基づいてデータをダウンロードするには、Runtime inputs イベントで開始し、各データタイプの条件とコマンドグループを追加します:
- Runtime inputs をTrigger Events の下からStart に移動する。
-
Runtime inputs イベントを選択し、Edit をクリックする。
-
コントロールシート セクションの選択に基づいて、レポートするデータ タイプの変数と、タイプに基づいてデータをアップロードする Wdata テーブルの ID を追加します:
入力タイプ 表示名 テキストフィールド レポート テキストフィールド テーブル ID - 両方の変数にRequired を選択し、Save をクリックする。
- Events の下にあったConditional をキャンバスに移動し、Start からリンクをドラッグする。
- Conditional イベントを選択し、Edit をクリックする。
-
基本情報(Basic info) の下に、排出量データのコンテキストを識別するのに役立つ名前と説明を入力する。
-
Conditions(条件) の下で、Emissions(排出量)の入力選択に基づくルールを追加し、Save(保存) をクリックする:
データ型 変数 演算子 値 ストリングを選択する。 トリガー の下にあるレポート ランタイム入力変数を選択する。 を選択する。 エミッション
を入力する。 - コマンドグループ をキャンバスに移動し、条件付き イベントからリンクをドラッグする。
- コマンドグループを選択し、Edit をクリックする。
- 基本情報 の下で、排出量データのコンテキストを識別するための名前と説明を入力し、保存 をクリックする。
- Events の下にあるConditional をキャンバスに移動し、Start からリンクをドラッグします。
- この条件付き イベントを選択し、編集 をクリックする。
-
基本情報 の下に、施設データのコンテキストを識別するのに役立つ名前と説明を入力します。
-
条件 の下で、「施設」の入力選択に基づいてルールを追加し、保存 をクリックする:
データ型 変数 演算子 値 ストリングを選択する。 トリガー の下にあるレポート ランタイム入力変数を選択する。 を選択する。 設備
を入力する。 - さらに2つのコマンドグループをキャンバスに移動し、FacilitiesConditional イベントからそれぞれにリンクをドラッグする。
- 各コマンドグループについて、「Edit(編集)」 をクリックし、データのコンテキスト(それぞれ「Facilities(施設)」または「Activities(活動)」)を識別するための名前と説明を入力し、「Save(保存)」 をクリックします。
- ランタイムインプットが 排出ガスでも施設でもない場合にのみアクティビティグループを実行するには、そのリンクをダブルクリックし、リンク条件の編集 のエラーを選択し、閉じる をクリックする。
ステップ3.Wdataテーブルからデータセットを削除するコマンドを追加する。
Persefoniからの最新データ用に各Wdataテーブルを準備するために、これらのコマンドを3回 -排出量、施設、活動の各コマンドグループごとに1回-構築し、既存のデータセットを削除する。
ヒント: チェーンの作成を簡単にするために、これらのコマンドを1つのデータ型用に作成し、コピー をクリックして他のデータ型用に複製し、必要に応じて編集する。
- BizApps の下で、Workiva を選択し、List files をキャンバスに移動します。
- コマンドグループのGroup start からList files コマンドにリンクをドラッグする。
- List files コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、目的のデータを特定するのに役立つ名前と説明を入力する。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 前のチェーンと同じWorkivaコネクタを選択する。 テーブル ID Trigger の下にあるTable ID ランタイム変数を選択する。 - BizApps で、JSON を選択し、Array to CSV をキャンバスに移動します。
- List files コマンドからArray to CSV コマンドにリンクをドラッグします。
- Array to CSV コマンドを選択し、Edit をクリックする。
-
Basic info の下に、テーブルのデータセットのリストをカンマ区切り値(CSV)形式に変換する意図を識別するのに役立つ名前と説明を入力する。
- コマンドのプロパティを入力する:
プロパティ 値 コネクタ 使用する JSON コネクタを選択します。 JSONデータ List files コマンドのFiles list 出力を選択する。 複数値の区切り記号 カンマ ( ,
) を入力してください。プレビュー結果 このチェックボックスを選択する。 - ID、名前、ステータスのカラムを追加する:
カラム名 JSONパス アイドル .id 名称 名前 状態 ステータス - Delimiter で、Comma を選択し、Save をクリックする。
- BizApps で、Tabular Transformation を選択し、Advanced query をキャンバスに移動します。
- Array to CSV コマンドからAdvanced query コマンドにリンクをドラッグします。
- Advanced query コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、テーブルのデータセットを照会する意図を識別するのに役立つ名前と説明を入力する。
- 使用する Tabular Transformation コネクタを選択します。
-
Tables の下に、クエリーするデータのあるファイルを追加する:
プロパティ 値 ファイル 変換ファイルArray to CSV コマンドの出力 を選択します。 テーブル名 a
. - コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 クエリ 入力 select * from a where status = 'IMPORTED'
.入力区切り文字 コンマを選択する。 出力デリミター コンマを選択する。 プレビュー結果 このチェックボックスを選択する。 - BizApps で、Workiva を選択し、Un-import file from table をキャンバスに移動します。
- Advanced query コマンドからUn-import file from table コマンド にリンクをドラッグします。
- Un-import file from table コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、データセットのインポートを解除する意図を識別するのに役立つ名前と説明を入力する。
- コマンドのプロパティを入力する:
プロパティ 値 コネクタ 先ほどと同じ Workiva コネクタを選択します。 テーブル ID トリガー(Trigger)の下にあるテーブルID ランタイム入力を選択する。 ファイルID List files コマンドのFiles list 出力を選択する。 -
File ID フィールドで、Files list 出力をクリックし、変換を適用する:
変換 出力 値 JSONから値を取得を選択します。 テキストを選択する。 0
とid
を入力する。 - Skip タブを選択する。
- Skip condition で、Success を選択する。
- Persefoni からデータがダウンロードされない場合、このコマンドをスキップするルールを追加し、Save をクリックします:
データ型 変数 演算子 値 整数を選択する。 Advanced queryコマンドのRecord count 出力を選択する。 を選択する。 0
を入力する。 - [保存]をクリックします。
- BizApps の下で、Workiva を選択し、Delete file をキャンバス に移動します。
- Un-import file from table コマンドからDelete file コマンドにリンクをドラッグする。
- Delete fileコマンドを選択し、Edit をクリックする。
-
基本情報 の下に、データセットを削除する意図を識別するのに役立つ名前と説明を入力する。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 先ほどと同じ Workiva コネクタを選択します。 ファイルID File import output ofUn-import file from table コマンドからID を選択する。
ステップ4.Persefoniからデータをダウンロードしてインポートするコマンドを追加する。
Persefoniから最新のデータを取得しアップロードするには、これらのコマンドを、3回 、排出量、施設、活動の各コマンドグループに対して1回ずつ実行する。これらのコマンドはPersefoniからそれぞれのデータをダウンロードし、Persefoni Template Spreadsheetの値とログを更新します。
ヒント: チェーンの作成を簡単にするために、これらのコマンドを1つのデータ型用に作成し、コピー をクリックして他のデータ型用に複製し、必要に応じて編集する。
- BizApps の下で、Persefoni を選択し、Fetch transactions をキャンバスに移動する。
- コマンドグループのGroup start からFetch transactions コマンドにリンクをドラッグする。
注: Fetch transactions とList files の両コマンドはGroup start にリンクしているため、グループ実行時に同時に開始される。
- Fetch transactions コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、それぞれのデータタイプをダウンロードする意図を識別するのに役立つ名前と説明を入力する。
- BizApps で、Workiva を選択し、Create file をキャンバスに移動します。
- Fetch transactions とUn-import file from table コマンドの両方からCreate file コマンドにリンクをドラッグする。
- Create file コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、データのカンマ区切り値(CSV)ファイルを作成する意図を識別するのに役立つ名前と説明を入力します。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 先ほどと同じ Workiva コネクタを選択します。 テーブル ID トリガー の下にあるテーブルID ランタイム入力を選択する。 ファイル Fetch transactions コマンドのFetched transactions 出力を選択する。 名称 作成されたデータセットの名前を入力します。System.DateTime ランタイム変数を含みます。例えば、排出量データの場合、 emissions-
System.DateTime.csv
と入力する。 - BizApps で、Workiva を選択し、Import file into table をキャンバスに移動します。
- Create file コマンドからImport file into table コマンドにリンクをドラッグする。
- Import file to table コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、データセットをWdataテーブルにインポートする意図を識別するのに役立つ名前と説明を入力する。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 先ほどと同じ Workiva コネクタを選択します。 テーブル ID トリガー の下にあるテーブルID ランタイム入力を選択する。 ファイルID Create file コマンドのResult 出力からID を選択。 - BizApps の下にあるRun chain イベントをキャンバスに移動します。
- Import file into table コマンドからRun chain イベントへリンクをドラッグする。
- Run chain イベントを選択し、Edit をクリックする。
-
Basic info(基本情報) の下に、チェーンを識別するための名前と説明を入力し、それぞれのデータのダウンロードを記録する。
- Chain to run で、Persefoniからのダウンロードを記録するために構築されたチェーンを選択します。
-
Chain runtime inputs の下のRange に、データのダウンロードを記録するControl Sheet section cellの座標を入力する:
- 排出量の場合は、
D13:D13
と入力する。 - 施設については、
D15:D15
と入力する。 - アクティビティの場合は、
D14:D14
と入力する。
- 排出量の場合は、
- 接続されているWdataテーブルから前のデータのデータセットを削除するには、BizApps の 下にあるWorkiva を選択し、Delete file をキャンバス に移動する。
- Import file from table コマンドからDelete file コマンドにリンクをドラッグする。
- Delete fileコマンドを選択し、Edit をクリックする。
-
基本情報 の下に、データセットを削除する意図を識別するのに役立つ名前と説明を入力する。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 先ほどと同じ Workiva コネクタを選択する。 ファイルID File import output ofUn-import file from table コマンドからID を選択。 - Skip タブを選択する。
- Skip condition で、Success を選択する。
- Persefoni からデータがダウンロードされない場合、このコマンドをスキップするルールを追加し、Save をクリックします:
データ型 変数 演算子 値 整数を選択する。 Advanced queryコマンドのRecord count 出力を選択する。 を選択する。 0
を入力する。 - インポートに失敗した場合に以前のデータセットを再インポートするには、ファイルをテーブルにインポート コマンドを選択し、コピー をクリックします。
- 2つのImport file into table コマンド間のリンクをドラッグする。
- 新しいImport file to table コマンドを選択し、Edit をクリックする。
-
基本情報 の下に、以前のデータセットをWdataテーブルに再インポートする意図を識別するのに役立つ名前と説明を入力する。
- File ID で、値を削除し、Files list 出力のList files コマンドを選択する。
-
Files リスト 出力をクリックし、変換を適用する:
変換 出力 値 JSONから値を取得を選択します。 テキストを選択する。 0
とid
を入力する。 - 最初のImport file into table コマンドが失敗した場合のみコマンドを実行するには、そのリンクをダブルクリックし、Error forEdit link condition を選択し、Close をクリックする。
ステップ5.チェーンを公開する
データ型ごとにコマンドを設定したら、チェインを実行できるようにする:
- [公開]をクリックします。
- 出版に関するコメントを入力し、Publish をクリックする。
ペルセフォーニ・テンプレート・スプレッドシートをリフレッシュするチェーンを構築する
最後に、Persefoni Template SpreadsheetのControl Sheet セクションの選択項目をチェックし、Persefoniからデータをダウンロード、ログ、リフレッシュする他のチェーンを実行するチェーンを構築する。
注: このチェーンは自動的に他のチェーンを実行し、Persefoni Template Spreadsheetを更新するために実行する必要がある唯一のチェーンです。
ステップ1:チェーンを作成する
- チェーンビルダー で、チェーン から、チェーンの作成 をクリックし、チェーンの作成 を選択する。
-
Setup で、チェーンの識別に役立つ名前と説明を入力する。
- Persefoni Template Spreadsheet とそのControl Sheet セクションの ID の変数を追加する。
- [保存]をクリックします。
ステップ2.コントロールシートのセクション選択をチェックするコマンドを追加する
Persefoniからダウンロードするデータを特定する:
- BizApps で、Workiva を選択し、Get sheet data を Start に移動します。
- Get sheet data コマンドを選択し、Edit をクリックします。
-
Basic info の下に、チェーンとその意図を特定するための名前と説明を入力し、Control Sheet セクションをチェックする。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 他のチェーンと同じWorkivaコネクタを選択する。 スプレッドシート ID Persefoni Template SpreadsheetのIDのチェーン変数を選択する。 シートID/名前 コントロールシート セクションの ID のチェーン変数を選択する。 地域 A12:D15
を入力する。バリュー・スタイル Calculated を選択する。 リビジョン -1
を入力。 - BizApps で、Tabular Transformation を選択し、Advanced query をキャンバスに移動します。
- Start からAdvanced query コマンドにリンクをドラッグします。
- Advanced query コマンドを選択し、Edit をクリックする。
-
Basic info の下に、Control Sheet セクションの選択に基づいてダウンロードするデータを特定するために、チェーンとその意図を特定するための名前と説明を入力します。
- 先ほどのチェーンと同じTabular Transformationコネクタを選択します。
-
Tables の下に、クエリーするデータのあるファイルを追加する:
プロパティ 値 ファイル Get sheet data コマンドのData出力を選択する。 テーブル名 a
. - コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 クエリ select * from a where `Refresh Data` = 'Yes'
.入力区切り文字 コンマを選択する。 出力デリミター コンマを選択する。 プレビュー結果 このボックスを選択する。 - BizApps で、JSON を選択し、CSV to JSON をキャンバスに移動します。
- Advanced query コマンドからCSV to JSON コマンドにリンクをドラッグします。
- CSV to JSON コマンドを選択し、Edit をクリックする。
-
Basic info の下に、チェーンとその意図を識別するための名前と説明を入力し、クエリ結果をJavaScript Object Notation(JSON)に変換する。
- コマンドのプロパティを入力し、Save をクリックする:
プロパティ 値 コネクタ 前のチェーンと同じJSONコネクタを選択する。 入力ファイル Advanced query コマンドのResults 出力を選択する。 区切り記号 カンマ(,)を選択する。
ステップ3.コントロールシートのセクションに基づき、ダウンロードを開始するコマンドグループを追加する。
コントロールシート セクションの選択に基づいてダウンロードチェーンを開始します:
- BizApps の下で、Command group をキャンバスに移動します。
- CSV to JSON コマンドからコマンドグループの にリンクをドラッグします。
- コマンドグループを選択し、Edit をクリックする。
-
Iterator タブで、Iterator を有効にし、List修飾子タイプを選択する。
- Iterations の下で、CSV to JSON コマンドのJSON ファイル 出力を選択する。
- [保存]をクリックします。
- BizApps の下で、Run chain イベントをキャンバスに移動します。
- Group start からRun chain イベントへリンクをドラッグする。
- Run chain イベントを選択し、Edit をクリックする。
-
基本情報 の下に、ペルセフォニ・データをダウンロードするためにチェーンを実行する意図を特定するための名前と説明を入力する。
- Chain to run で、Persefoniからデータをダウンロードしてインポートするために構築されたチェーンを選択する。
- Chain runtime inputs の下で、JSON file iteration 変数を選択し、Group iterator の下で、Report とTable ID の両方を選択する。
-
レポート で、JSONファイルの反復 変数をクリックし、変換を適用する:
変換 出力 値 JSONから値を取得を選択します。 テキストを選択する。 名前を入力
. -
テーブルID で、JSONファイル反復 変数をクリックし、変換を適用する:
変換 出力 値 JSONから値を取得を選択します。 テキストを選択する。 TableID
を入力。 - [保存]をクリックします。
- チェーンを実行できるようにするには、Publish をクリックし、その発行に関する任意のコメントを入力し、Publish をクリックします。
チェーンを走らせる
Persefoni Template Spreadsheetの値をPersefoniの最新データで自動的に更新する:
ステップ1.リフレッシュするデータを選択する
Persefoni Template Spreadsheet のControl Sheet セクションで、Refresh data 列で、更新するデータの種類に Yes を選択する。
ステップ2.スプレッドシートIDを確認する
- WdataChain Builder から、Edit をクリックし、この手順で構築された3つ目のチェーンについて説明する。
- チェーン設定 をクリックする。
- Variables の下で、Persefoni Template Spreadsheet とそのControl Sheet セクションの ID を確認する。
- [保存]をクリックします。
- 変数の値を更新したら、Publish とPublish をクリックする。
ステップ3チェーンを動かす
この手順で構築した3つ目のチェーンから、Execute とRun chain をクリックする。
チェーンが実行されると、自動的に他の2つのチェーンが実行され、Persefoniから選択されたデータがダウンロードされ、Persefoni Template Spreadsheetの対応する値とログファイルが更新されます。