チェーンビルダー から、環境、社会、ガバナンス(ESG)または持続可能性レポート用の温室効果ガス(GHG)排出量など、Schneider Electric® から Workiva にデータをダウンロードするチェーンを作成できます。
前提条件
このチェーンを構築するには、これらのコアコネクターを使用します:
メモ: すべてのコネクターは CloudRunner を使用します。このチェーンにGroundRunnerは必要ない。
排出量データをダウンロードするには、Schneider Electricとの基本認証に使用したユーザー名とパスワードも必要です。
ステップ1:チェーンを作成する
-
チェーン から、作成 をクリックし、チェーンの作成 を選択する。
- セットアップ で、チェーンを識別する名称と説明を入力する。
-
変数 で、変数を追加してシュナイダーエレクトリックからダウンロードするデータを指定します:
名称 値 クライアント階層 Resource Advisorでシュナイダーエレクトリック用に設定した、貴社のクライアント階層のIDを入力します。 サービスID 特定の排出源のデータのみをダウンロードするには、排出データをダウンロードするGHG排出源IDを入力します。 fromMonth データをダウンロードする期間の最も古い月を、 yyyy-MM書式設定で入力する。月 データをダウンロードする期間の最新月を、 yyyy-MM書式設定で入力する。カーボンマップタイプ リソースアドバイザーから使用するカーボンマップ(プライマリまたはセカンダリ)を入力します。空白の場合、コマンドはプライマリカーボンマップを使用する。 エミッションUOMId ダウンロードした排出量データで使用する測定単位を入力する。 エミッションURL データを依頼するSchneider Electric API エンドポイント の URL を入力します。 - [保存]をクリックします。
ステップ2.HTTPリクエストで開始する。
シュナイダーエレクトリックにデータのダウンロードを依頼するには、HTTP POST コマンドで開始します。
- コネクター の下で、HTTP を選択し、POST を開始 に移動する。
- POST コマンドを選択し、Edit をクリックする。
- 基本情報の下に、コマンドの識別をヘルプする名称と説明を入力します。
- コマンドプロパティ で、使用する HTTP リクエストコネクターを選択します。
- コマンドのプロパティを入力する:
プロパティ 説明 ユーザー名称 シュナイダーエレクトリックとの基本認証に使用するユーザー名称を入力します。 パスワード シュナイダーエレクトリックとの基本認証に使用するパスワードを入力します。 回答表示 このボックスをチェックしてください。 URL チェーン の下にあるemissionsURL 変数を選択する。 コンテンツタイプ application/jsonを選択。 本文 リクエストをJavaScript Object Notation (JSON)文字列として入力し、Chainの下で 、各名称/値のペアの値として該当する変数を選択します: { "clientHierIds":[<clientHierId>], "serviceIds":[<serviceIds>], "fromMonth":"<fromMonth>", "toMonth":"<toMonth>", "carbonMapType":「<carbonMapType>", "emissionsUOMId":"<emissionUOMId>"}出力スキーマ Schneider ElectricからのサンプルJSONレスポンスを入力します: { "serviceOutput": [ { "divisionClientHierId": 0, "divisionName": "string", "siteClientHierId": 0, "siteName": "string", "dataSourceLevel": "string", "serviceId": 0, "serviceName": "string", "scope": "string", "usage": 0, "emission": 0, "emissionUOM": "string", "usageUOM": "string", "serviceMonth": "string" } ], "errorMessage": "string", "errorCode": "string" } - [保存]をクリックします。
ステップ3.CSVコマンドに配列を追加する
シュナイダーエレクトリックからのJSON応答をカンマ区切り値(CSV)書式設定に変換するには、Array to CSV コマンドを追加します:
- コネクター で、JSON を選択し、Array to CSV をキャンバスに移動する。
- Start からArray to CSV コマンドにリンクをドラッグします。
- Array to CSV コマンドを選択し、Edit をクリックする。
- 基本情報の下に、コマンドの識別をヘルプする名称と説明を入力します。
-
コマンドのプロパティ で、使用する JSON コネクターを選択します。
- JSONデータ については、POST コマンドのResponse 出力を選択する。
-
Columns で、シュナイダーエレクトリックからダウンロードしたデータの列を追加する:
列名 JSONPath 使用 使用状況 排出量 .emissions - Delimiterでは、Comma を選択します。
- [保存]をクリックします。
ステップ4:[ファイルを作成]コマンドを追加する
データからCSVファイルを作成するには、ファイルを作成コマンドを追加します:
- コネクター で、ファイルユーティリティ を選択し、ファイル作成 をキャンバスに移動する。
- Array to CSV コマンドからCreate file コマンドにリンクをドラッグする。
- ファイル作成 コマンドを選択し、編集 をクリックする。
- 基本情報の下に、コマンドの識別をヘルプする名称と説明を入力します。
-
コマンドのプロパティ で、使用するファイル・ユーティリティ・コネクターを選択します。
- コマンドのプロパティを入力する:
プロパティ 説明 テキスト Array to CSVコマンドの変換済みファイル出力を変更します。 ファイルパス Runtime の下にあるChain.Workspace 変数を選択し、 \とファイル名称に.csvの拡張機能を入力する。 - [保存]をクリックします。
ステップ5.Workivaでデータを使用するコマンドを追加する。
Workiva プラットフォームで CSV データを使用するには、Workiva コネクターコマンドを追加し、ファイルを作成コマンドの作成ファイル変数出力を、スプレッドシートまたは Wdata テーブルで使用します。例えば、Schneider ElectricのデータをWdataテーブルのデータセットとして追加するには、チェーンを実行イベントを追加します。このイベントは、表内のデータセットを更新テンプレートから作成したチェーンを使用します。
ステップ6.チェーンの更新と実行
チェーンを実行できるようにする:
- [公開]をクリックします。
- 更新に関するコメントを入力し、更新をクリックします。
チェーンを実行する手順は次の通りです。
- チェーン から、チェーンのメニューから編集 を選択する。
- チェーン設定 をクリックし、変数値を入力してダウンロードするデータを指定し、保存 をクリックする。
- Execute とRun chain をクリックして実行する。