Workiva サポートセンター

Urjanet Utility Cloud® は、世界中のユーティリティ・プロバイダーからの正確なオンデマンド・データにより、企業が気候変動への影響に対して行動することを可能にします。 

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

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

メモ： これらのチェーンで使用されているウルジャネットコントロールシート スプレッドシートは Workiva によって提供されている。お持ちでない方でご興味のある方は、カスタマーサクセスマネージャー（CSM）までご連絡ください。

前提条件

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

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

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

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

• Urjanetのサービスにアクセスするのに使うユーザー名とパスワード
• Urjanet コントロールシートスプレッドシート、そのコントロールシートセクション、およびその接続テーブルの ID。

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

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

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

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

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

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

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

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

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

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

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

   プロパティ	値
   コネクタ	使用するファイル・ユーティリティ・コネクターを選択します。
   テキスト	Site usage 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 テンプレート を使い、Urjanetコントロールシート スプレッドシートの接続テーブルをUrjanetからダウンロードしたデータで更新するチェーンを構築する。Load Data to Wdata テンプレートは、データセットがすでにテーブルに存在するかどうかを判断し、最新のデータセットでテーブルを更新するために連動するチェーンを作成します。

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

ウルジャネットからデータをダウンロードするチェーンを構築する。

最終的には、Urjanetからユーティリティデータをダウンロードしてインポートするチェーンを構築する。

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

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

1. チェーン から、作成 をクリックし、チェーンの作成 を選択する。
2. セットアップ で、1 の名称を入力する。Urjanetとチェーンをさらに識別するのに役立つ説明。
   
3. 変数 に、Urjanet の認証情報と、Urjanet コントロールシート スプレッドシートとそのコントロールシート セクションの ID の変数を追加します。
   

   名称	値
   Urjanetusername	ウルジャネットのサービスに使用するユーザー名を入力します。
   ウルジャネットパスワード	ウルジャネットのサービスに使用するパスワードを入力します。
   スプレッドシートID	ウルジャネットコントロールシート スプレッドシートのIDを入力します。
   シートID	スプレッドシートのコントロールシート セクションのIDを入力する。

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

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

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

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

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

ステップ3.コマンドを追加し、ウルジャネットの期間を準備する。

ウルジャネットの期間識別には、Advanced query と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-01' when `Start Month` = 'February' then '02-01' when `Start Month` = 'March' then '03-01' when `Start Month` = 'April' then '04-01' when `Start Month` = 'May' then '05-01' when `Start Month` = 'June' then '06-01' when `Start Month` = 'July' then '07-01' when `Start Month` = 'August' then '08-01' when `Start Month` = 'September' then '09-01' when `Start Month` = 'October' then '10-01' when `Start Month` = 'November' then '11-01' else '12-01' end as 'sm', case when `End Month` = 'January' then '01-31' when `End Month` = 'February' then '02-28' when `End Month` = 'March' then '03-31' when `End Month` = 'April' then '04-30' when `End Month` = 'May' then '05-31' when `End Month` = 'June' then '06-30' when `End Month` = 'July' then '07-31' when `End Month` = 'August' then '08-31' when `End Month` = 'September' then '09-30' when `End Month` = 'October' then '10-31' when `End Month` = 'November' then '11-30' else '12-31' 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.Urjanetにベアラートークンを送信するPOSTコマンドを追加します。

Urjanetに認証用のベアラートークンを提供するには、HTTPPOST コマンドを追加します：

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

   プロパティ	値
   コネクタ	使用する HTTP コネクターを選択します。
   回答表示	このチェックボックスを選択する。
   URL	https://api.urjanet.com/auth/login を入力。
   コンテンツタイプ	application/jsonと入力します。
   本文	ベアラートークンを構築する文字列を入力します： {"パスワード":"と入力します。 チェーン からUrjanetpassword 変数を選択する。 ","username":"を入力します。 チェーン からUrjanetusername 変数を選択する。 入力"}.
   出力スキーマ	この回答サンプルを入力してください： {"status":200,"message":"Authentication Successful","type":"Bearer","token":"abc","expires":"1694017012"}

ステップ5.Urjanetからサイトを取得するコマンドを追加する。

Urjanetアカウントからサイトを取得して解析するには、HTTPGET と HandlebarsRender text template コマンドを追加します：

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

   プロパティ	値
   コネクタ	先ほどと同じHTTPコネクターを選択する。
   回答表示	このチェックボックスを選択する。
   URL	入力https://api.urjanet.com/utility/sites.
   ヘッダー	このヘッダーを追加： キーでauthorizationと入力します。 Valueで、Typeを選択し、POSTコマンドのResponse出力からTokenを選択する。
   コンテンツタイプ	application/jsonと入力します。
   出力スキーマ	この回答サンプルを入力してください： { "_embedded" : { "sites" : [ { "createdBy" : "jack.doe", "createdDate" : "2023-08-29T18:49:32.000+00:00", "entityId" : "1ee469cc-a606-d007-9415-eeeb8714a7ae", "facilityType" : "Office", "lastModifiedBy" : "jack.doe", "lastModifiedDate" : "2023-08-29T18:49:32.000+00:00", "region" : null, "serviceAddress" : { "addressType" : "RAW", "city" ："city" : "RAW", "country" : "USA", "fullAddress" : "123 EVERGREEN TERRACE, CHICAGO, IL, 60603, USA", "postalCode" : "60603", "recipient" : null, "state" : "IL", "streetLine1" : "123 EVERGREEN TERRACE", "streetLine2" : null }, "siteCode" : "DIO", "siteName" : "Doe, Inc.", "siteNumber" : "1", "subRegion" : null, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae" }, "accounts" ：{ "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/accounts" }, "credentials" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/credentials" }, "events" ：{ "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/events" }, "meters" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/meters" }, "statements" ：{ "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/statements" }.}}]}, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites?page=0&size=20" } }.}, "page" : { "size" : 20, "totalElements" : 1, "totalPages" : 1, "number" : 0 } }。}

6. Available connectors から、Handlebars を選択し、Render text template をキャンバスに移動完了。
7. GETからテキストテンプレートをレンダリングへのリンクをドラッグします。
8. テキストテンプレートのレンダリング コマンドを選択し、編集 をクリックする。
9. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
10. コマンドのプロパティを入力し、Saveをクリックします：
    
    

    プロパティ	値
    コネクタ	使用するHandlebarsコネクターを選択します。
    テンプレート	このテキストテンプレートを入力してください： [{{#each a}} "{{entityId}}" {{#unless @last}},{{/unless}}{{/each}}]]。
    JSON変数	この変数を追加する： 名称 に、a と入力。 値で、GETコマンドのレスオンス出力の_embedded、サイトを選択します。

ステップ6.Urjanetにサイトデータを依頼するコマンドを追加する。

貴社のサイトデータをUrjanetに依頼するには、HTTPPOSTコマンドを追加し、その後にPause chainイベントを追加して、リクエストがプロセスする時間を確保します：

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

   プロパティ	値
   コネクタ	先ほどと同じHTTPコネクターを選択する。
   回答表示	このチェックボックスを選択する。
   URL	入力https://api.urjanet.com/utility/sites/downloads/usages.
   コンテンツタイプ	application/jsonと入力します。
   本文	ベアラートークンを構築する文字列を入力します： {"siteIds":と入力します。 レンダリングテキストテンプレートコマンドのレンダリングテキスト出力を選択します。 入力値, "startDate":" CSV to JSONコマンドのJSON file出力を選択し、 JSONからの値を取得 変数変換を適用します： 出力 で、テキストを選択する。 値に、0とryを入力します。 - を入力。 CSV to JSONコマンドのJSON file出力を選択し、 JSONからの値を取得 変数変換を適用します： 出力 で、テキストを選択する。 Value に、0 と入力し、sm と入力する。 入力", "endDate":". CSV to JSONコマンドのJSON file出力を選択し、 JSONからの値を取得 変数変換を適用します： 出力 で、テキストを選択する。 値に、0とryを入力します。 - を入力。 CSV to JSONコマンドのJSON file出力を選択し、 JSONからの値を取得 変数変換を適用します： 出力 で、テキストを選択する。 Value に、0 と入力し、em と入力する。 ", "outputFormat": "CSV"}と入力します。
   ヘッダー	ヘッダーを2つ追加： authorizationヘッダー： キーでauthorizationと入力します。 Value で、最初のPOST コマンドのResponse 出力から、Type を選択し、次にToken を選択する。 accept ヘッダー： キーでacceptと入力します。 値 に、application/json と入力する。
   出力スキーマ	この回答サンプルを入力してください： { "createdDate" : "2023-09-19T15:11:09.944+00:00", "entityId" : "1ee56fec-3a9c-d96e-a849-a6c381b08d2b", "_links" : { "download" : { "href" : "https://api.urjanet.com/utility/downloads/1ee56fec-3a9c-d96e-a849-a6c381b08d2btpnu" }.}}

6. チェーンイベント から、一時停止チェーン をキャンバスに移動する。
7. POST からPause chain へリンクをドラッグ。
8. Pause chainイベントを選択し、Editをクリックします。
   
9. Basic infoに、コマンドの識別を手助けする名称と説明を入力します。
10. イベントの詳細を入力し、保存をクリックします：
    

    詳細	値
    待機時間	入力6.
    待機時間単位	秒を選択。

ステップ7.サイトデータをCSVでダウンロードするコマンドを追加する。

UrjanetからサイトデータをCSVファイルとしてダウンロードするには、HTTPGET コマンドとTabular TransformationMap headers コマンドを追加します：

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

   プロパティ	値
   コネクタ	先ほどと同じ HTTP リクエスト・コネクターを選択する。
   回答表示	このチェックボックスを選択する。
   URL	2番目のPOSTコマンドの応答出力の_linksからhrefを選択します。
   ヘッダー	このヘッダーを追加： キーでauthorizationと入力します。 Value で、最初のPOST コマンドのResponse 出力から、Type を選択し、次にToken を選択する。
   コンテンツタイプ	application/jsonと入力します。

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

    プロパティ	値
    コネクタ	先ほどと同じ表形式変換コネクターを選択します。
    入力ファイル	2番目のGET コマンドのResponse 出力を選択する。
    出力ファイル	urjanet.csv を入力。
    プレビュー結果	このチェックボックスを選択する。
    区切り記号	コンマを選択。
    入力ヘッダー	UrjanetからダウンロードしたCSVファイルのヘッダーをこの順序で追加します： ステートメントID インターバル・スタート インターバル終了 サービスタイプ メーターID メーター番号 メーター・ステータス 生アカウント番号 正規化アカウント番号 プロバイダー名称 サービス住所 サービス・シティ サービス国家 サービス郵便番号 サービス提供国 サイトコード 名称 サイト番号 サイト地域 サイトサブ地域 サイト 施設タイプ別 サイトアドレス サイトシティ サイトの状態 サイトの郵便番号 サイトの国 関税名称 消費 消費量 測定単位 追加プロバイダー名称 追加プロバイダーアカウント番号 プロバイダー分類 料金合計 料金合計 通貨コード
    出力ヘッダー	データを含むテーブルに対応するヘッダーをこの順序で追加します： ステートメントID インターバルスタート インターバルエンド サービスタイプ メーターID メーター番号 meter_status raw_account_number 正規化口座番号 プロバイダー名 service_address service_city サービス状態 サービス郵便番号 サービス国 サイトコード サイト名 サイト番号 サイト・リージョン サイトサブリージョン 施設タイプ サイトアドレス サイト_都市 サイトステート サイト郵便番号 国 関税名 消費 consumption_unit_of_measure additional_provider_name additional_provider_account_number プロバイダー分類 合計料金 合計料金_通貨コード

ステップ8.他のチェーンの実行チェーンイベントを追加する。

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

1. チェーンイベントから、チェーンを実行をキャンバスに移動します。
2. マップヘッダー から実行チェーン へリンクをドラッグする。
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ファイル出力を選択し、 Get variable from JSON変数変換ンを適用するには： 出力 で、テキストを選択する。 値 に、0 とtid を入力する。
   ファイル名	データの期間に基づいて、アップロードするデータセットの名称を定義するには： Site Usage_と入力します。 開始月は、CSV to JSON コマンドで出力されたJSON ファイル を選択し、ダッシュ (-) を入力し、CSV to JSON コマンドで出力されたJSON ファイル を再度選択します。 アンダースコア (_) を入力してください。 終了月は、CSV to JSON コマンドの出力JSON ファイル を選択し、ダッシュ (-) を入力し、CSV to JSON コマンドの出力JSON ファイル を再度選択します。 .csv を入力。 両月とも、最初のJSONファイル出力をクリックし、JSONから変数を取得変換を適用します： 出力 で、テキストを選択する。 値 に、0 とry を入力する。 両月とも、最初のJSONファイル出力をクリックし、JSONから変数を取得変換を適用します： 出力 で、テキストを選択する。 値に、0とemを入力します。
   データファイル	マップヘッダー コマンドのマップヘッダー出力 を選択する。
   読み込み中	データセットの置換を選択する。
   ロールバック	このチェックボックスを選択する。

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

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

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

チェーン実行

最新のユーティリティ・データでテーブルを更新する：

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

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