Workiva サポートセンター

Watershed の企業向け気候プラットフォームでは、組織の二酸化炭素排出量を測定、レポート、削減することができます。

Workivaプラットフォームでは、環境・社会・ガバナンス（ESG）または持続可能性レポートでの情報開示のためなど、Watershedからカーボンフットプリントデータを自動的にダウンロードするチェーンを構築し、Watershed スプレッドシートで指定した期間に基づいてテーブルに格納することができます。その後、レポート出力にデータを含むなど、クエリやスプレッドシート接続のソースとしてテーブルを使用することができます。

メモ： この手順では複数のチェーンを構築しますが、Watershedからデータをダウンロードし、スプレッドシートを更新するために、1つのチェーンのみを実行し、他のチェーンを自動的に実行します。

注： これらのチェーンで使用されている流域スプレッドシートは、Workiva から提供されています。お持ちでない方でご興味のある方は、カスタマー・サクセス・マネージャーまでご連絡ください。

前提条件

これらのチェーンを作るには、これらのコネクターが必要だ：

• Workiva コネクター
• 表形式変換 コネクター
• JSON コネクター
• HTTP リクエスト コネクター
• ファイルユーティリティ コネクター

ヒント チェーンのコマンドはすべてデフォルトのCloudRunnerを使用します。GroundRunnerは必要ない。

チェーンを正常に実行するには、識別も行います：

• Watershed API で認証し、アクションを実行するために使用する、主なアクティビティプロバイダー
• Watershed コントロールシートスプレッドシート、そのコントロールシートセクション、およびその接続テーブルの ID

データダウンロードを記録するチェーンの構築

手始めに、コントロールシート のセクションを更新し、カーボンフットプリントデータがいつ Workiva にアップロードされたかを追跡するチェーンを構築する。

ステップ1：チェーンを作成する

1. チェーン から、作成 をクリックし、チェーンの作成 を選択する。
   
2. セットアップで、3の名称を入力します。Watershedと、チェーンがWatershedデータのアップロードを記録していることを識別するのに役立つ説明。
   
3. [保存]をクリックします。
   
   

ステップ2.Runtime Inputsイベントで開始する。

1. チェーンイベントから、ランタイム入力を開始に移動します。
2. Runtime inputs イベントを選択し、Edit をクリックする。
3. Basic infoに、イベントの識別を手助けする名称と説明を入力します。
   
4. 変数 で、これらの表示名称を持つTextField入力を追加する：
   • 範囲
   • スプレッドシートID
   • シートID

   ヒント これらの変数のデフォルト値は空白のままにしておく。1を実行したときに生成される。流域 チェーンは後に作成。

5. 3つの変数すべてにRequired を選択し、Save をクリックする。
   
   

ステップ3.ファイルユーティリティを追加 ファイルコマンドを作成

コントロールシート セクションのログファイルを作成するには、ファイルユーティリティファイル作成 コマンドを追加する：

1. Available connectors から、File Utilities を選択し、Create file をキャンバスに移動する。
2. Runtime inputs からCreate file へリンクをドラッグする。
3. ファイル作成 コマンドを選択し、編集 をクリックする。
4. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
   
5. コマンドのプロパティを入力し、Saveをクリックします：
   

   プロパティ	値
   コネクタ	使用するファイル・ユーティリティ・コネクターを選択します。
   テキスト	Footprint data last refreshed on と入力し、System.DateTime ランタイム変数を選択する。

ステップ 4.Workiva Writeシートデータコマンドの追加

コントロールシート セクションをログファイルで更新するには、Workivaシートデータの書き込み コマンドを追加する：

1. 利用可能なコネクター から、Workiva を選択し、シートデータの書き込み をキャンバスに移動する。
2. 作成ファイル からシートデータの書き込み へリンクをドラッグ。
3. シートデータの書き込み コマンドを選択し、編集 をクリックします。
4. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
5. コマンドのプロパティを入力し、Saveをクリックします：
   
   

   プロパティ	値
   コネクタ	使用する Workiva コネクターを選択します。
   スプレッドシート ID	TriggerからSpreadsheetIDランタイム入力を選択します。
   シートID/名称	SheetID ランタイム入力をトリガー から選択する。
   データファイル	ファイルを作成コマンドの作成済みファイル出力を選択します。
   区切り記号	カンマ (,) を入力する。
   地域	Range Runtime input fromTriggerを選択します。

6. Publish をクリックし、その更新についてのメモを入力し、Publish をクリックする。

Load Data to Wdataテンプレートからチェーンを構築します。

次へ Load Data to Wdata テンプレート を使い、Watershed スプレッドシートの接続テーブルをWatershedからダウンロードしたデータで更新するチェーンを構築する。Load Data to Wdata テンプレートは、データセットがすでにテーブルに存在するかどうかを判断し、最新のデータセットでテーブルを更新するために連動するチェーンを作成します。

テンプレート からチェーンを作成するには、Load Data to Wdata | Primary chain テンプレートを開き、New chain をクリックする。

Watershedからデータをダウンロードするチェーンを構築する。

最終的には、Watershedからカーボンフットプリントデータをダウンロードしてインポートするチェーンを構築する。

メモ：Run chain イベント用に、このチェーンの前に他の2つのチェーンを作成する。

ステップ1：チェーンを作成する

1. チェーン から、作成 をクリックし、チェーンの作成 を選択する。
2. セットアップ で、1 の名称を入力する。流域 、さらにチェーンを特定するのに役立つ説明。
   
3. Variables に、Watershed API キー、Watershed スプレッドシートとそのコントロールシートの ID の変数を追加する。
   

   名称	値
   APIKey	Watershed API キーを入力します。
   スプレッドシートID	流域スプレッドシートのIDを入力。
   シートID	流域スプレッドシートのコントロールシート セクションのIDを入力する。

4. [保存]をクリックします。
   
   

ステップ 2.Workiva シートデータ取得コマンドで開始します。

WorkivaGet sheet data コマンドで開始し、WatershedスプレッドシートのControl sheet の期間に基づいて、ダウンロードするデータを特定する：

1. 利用可能なコネクターからWorkivaを選択し、シートデータを取得をStartに移動します。
2. シートデータ取得 コマンドを選択し、編集 をクリックします。
3. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
4. コマンドのプロパティを入力し、Saveをクリックします：
   
   

   プロパティ	値
   コネクタ	使用する Workiva コネクターを選択します。
   スプレッドシート ID	スプレッドシート ID チェーン変数を選択する。
   シートID/名称	シート ID チェーン変数を選択する。
   地域	A11: を入力。
   値スタイル	計算済み」を選択。
   リビジョン	最新バージョンを確認するには、-1 と入力してください。

ステップ3.流域の期間を準備するコマンドを追加します。

Watershedの期間を識別するために、高度なクエリとCSV to JSON コマンドを追加します：

1. 利用可能なコネクターから表形式変換を選択し、高度なクエリをキャンバスに移動します。
2. Get sheet data からAdvanced query へリンクをドラッグする。
3. 高度なクエリコマンドを選択し、編集をクリックします。
4. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
5. コマンドのプロパティを入力し、Saveをクリックします：
   
   

   プロパティ	値
   コネクタ	使用する Tabular Transformation コネクターを選択します。
   テーブル	期間データのテーブルを追加する： ファイルでシートデータ取得コマンドのデータ出力を選択します。 テーブル名称 に、a と入力。
   クエリ	実行するクエリを入力します： select case when `Start Month` = 'January' then '01' when `Start Month` = 'February' then '02' when `Start Month` = 'March' then '03' when `Start Month` = 'April' then '04' when `Start Month` = 'May' then '05' when `Start Month` = 'June' then '06' when `Start Month` = 'July' then '07' when `Start Month` = 'August' then '08' when `Start Month` = 'September' then '09' when `Start Month` = 'October' then '10' when `Start Month` = 'November' then '11' else '12' end as 'sm', case when `End Month` = 'January' then '01' when `End Month` = 'February' then '02' when `End Month` = 'March' then '03' when `End Month` = 'April' then '04' when `End Month` = 'May' then '05' when `End Month` = 'June' then '06' when `End Month` = 'July' then '07' when `End Month` = 'August' then '08' when `End Month` = 'September' then '09' when `End Month` = 'October' then '10' when `End Month` = 'November' then '11' else '12' end as 'em', `Reporting Year` as 'ry', TableId as 'tid' from a
   入力区切り文字	コンマを選択。
   出力デリミター	コンマを選択。
   プレビュー結果	このチェックボックスを選択する。

6. 利用可能なコネクター から、JSON を選択し、CSV to JSON をキャンバスに移動する。
7. Advanced query からCSV to JSON へリンクをドラッグする。
8. CSV to JSON コマンドを選択し、編集 をクリックする。
9. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
   
10. コマンドのプロパティを入力し、Saveをクリックします：
    

    プロパティ	値
    コネクタ	使用するJSONコネクターを選択します。
    入力ファイル	Advanced queryコマンドのResult出力を選択します。
    区切り記号	カンマ（,）を選択。

ステップ4.HTTPリクエストGETコマンドの追加

選択した期間のカーボンフットプリントデータをダウンロードするには、HTTPリクエストGETコマンドを追加します：

1. 利用可能なコネクターからHTTPリクエストを選択し、GETをキャンバスに移動します。
2. CSV to JSONからGETにリンクをドラッグします。
3. GET コマンドを選択し、編集 をクリックする。
4. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
5. コマンドのプロパティを入力し、Saveをクリックします：
   
   

   プロパティ	値
   コネクタ	使用する HTTP リクエスト・コネクターを選択します。
   回答表示	このチェックボックスを選択する。
   URL	入力https://api.watershedclimate.com/v1/report/footprint_detail.
   クエリ文字列	ダウンロードするデータの開始月と終了月を示すクエリ文字列を入力します： 開始月は、startMonth=と入力し、CSV to JSONコマンドのJSON file出力を2回選択します。 次に、終了月については、&endMonth= と入力し、CSV to JSONコマンドのJSON file出力をさらに2回選択します。 両月とも、最初のJSONファイル出力をクリックし、JSONから変数を取得変換を適用します： 出力 で、テキストを選択する。 値 に、0 とry を入力する。 両月とも、最初のJSONファイル出力をクリックし、JSONから変数を取得変換を適用します： 出力 で、テキストを選択する。 Value に、0 とsm を入力する。
   ヘッダー	ヘッダーを追加する： キー で、Authorizationと入力します。 Value に、Bearer と入力し、APIKey チェーン変数を選択する。
   コンテンツタイプ	application/jsonと入力します。

ステップ5.データアップロードを実行し記録するための実行チェーンイベントを追加する。

データをWdataにアップロードし、アップロードの記録をコントロールシートセクションに記録するには、先に作成していたへーん向けにチェーンの実行イベントを追加します：

1. チェーンイベントから、チェーンを実行をキャンバスに移動します。
2. GET からRun chain へリンクをドラッグする。
3. チェーンを実行イベントを選択し、Editをクリックします。
4. Basic info に、イベントがWdataにアップロードされることを特定するのに役立つ名称と説明を入力します。
5. Chain to run で、Load Data to Wdata | Primary chain をLoad Data to Wdata テンプレートから選択する。
   
6. チェーン・ランタイム入力を入力し、保存をクリックします：

   入力	値
   テーブル ID	データをアップロードするWdataテーブルのIDをプロバイダーに提供します： CSV to JSON コマンドの出力JSON ファイル を選択する。 JSONファイル出力をクリックし、JSONから変数を取得変換を適用します： 出力 で、テキストを選択する。 値 に、0 とtid を入力する。
   ファイル接頭辞	データの期間に基づいて、アップロードするデータセットの接頭辞を定義するには： 開始月は、CSV to JSONコマンドのJSON file出力を2回選択します。 アンダースコア (_) を入力してください。 End monthについては、CSV to JSON コマンドのJSONファイル 出力をあと2回選択する。 .csv を入力。 両月とも、最初のJSONファイル出力をクリックし、JSONから変数を取得変換を適用します： 出力 で、テキストを選択する。 値 に、0 とry を入力する。 両月とも、最初のJSONファイル出力をクリックし、JSONから変数を取得変換を適用します： 出力 で、テキストを選択する。 Value に、0 とsm を入力する。
   データファイル	GET コマンドのResponse 出力を選択。
   読み込み中	データセットの置換を選択する。
   ロールバック	このチェックボックスを選択する。

7. チェーンイベントから、別のチェーンを実行をキャンバスに移動します。
8. 最初のRun チェーン から2番目のチェーンにリンクをドラッグする。
9. 2番目のRun chain イベントを選択し、Edit をクリックする。
10. 基本情報 に、そのイベントがWatershedスプレッドシートのデータアップロードを記録していることをヘルプで識別するための名称と説明を入力する。
11. 実行するチェーンで3.を選択する。流域 先に作成したチェーン。
    
12. チェーン・ランタイム入力を入力し、保存をクリックします：

    入力	値
    範囲	F12:F12と入力します。
    スプレッドシート ID	SpreadsheetID チェーン変数を選択する。
    シート ID	SheetID チェーン変数を選択する。

13. Publish をクリックし、その更新に関するメモを入力し、Publish をクリックする。
    
    

チェーン実行

Watershed のスプレッドシートを最新のカーボンフットプリントデータで更新する：

1. Watershed スプレッドシートのControl sheet セクションから、Watershed からダウンロードするデータの期間（月と年）を選択する。
   
2. Wdataチェーン から、1 を選択。Watershed チェーンをクリックし、Execute とRun chain をクリックする。
   
   

   メモ： このチェーンを実行すると、自動的に他の2つのチェーンが実行され、WdataテーブルとWatershed スプレッドシートがデータで更新される。