Workiva 支援中心

Urjanet Utility Cloud® 使企業能夠利用來自全球公用事業供應商的準確、按需數據，對其氣候影響採取行動。 

使用 Workiva，您可以建立鏈，根據自定義Urjanet 控制表 電子表格中指定的時間段，從 Urjanet 自動下載公用事業數據到表格中。然後，您可以使用此表作為查詢或試算表連結的來源，將其資料包含在環境、社會與治理 (ESG) 或永續性報告輸出中。

註記: 當您在這些指示中建立多個鏈時，您只會執行一個鏈 - 然後自動執行其他鏈 - 從 Urjanet 下載資料並更新試算表。

註： 這些連鎖店使用的Urjanet 控制表 電子表格由 Workiva 提供。如果您沒有但有興趣，請聯絡您的客戶成功經理 (CSM) 以取得詳細資訊。

必要條件

要建立這些鏈，您需要這些連接器：

• Workiva 連接器
• 表格轉換 連接器
• JSON 連接器
• HTTP 請求 連接器
• 手把 連接器
• 檔案公用程式 連接器

提示： 所有鏈的命令都使用預設 CloudRunner。不需要 GroundRunner。

要成功運行鏈，還需要確定

• 用戶名和密碼 用於認證和訪問 Urjanet 服務
• ID 的Urjanet 控制表 電子表格 ，其控制表 部分，及其連接的表

建立鏈以記錄資料下載

開始時，建立連鎖以更新控制表 部分，以追蹤公用程式資料上傳至 Workiva 的時間。

步驟 1. 建立鏈結

1. 從Chains ，點擊Create ，並選擇Create chain 。
   
2. 在Setup 中，輸入名稱3. Urjanet 和描述，以幫助識別該鏈記錄實用資料上載。
3. 按一下「儲存」(Save)。
   
   

步驟 2.以運行時輸入事件開始

1. 從連鎖事件 ，移動運行時間輸入 到開始 。
2. 選擇Runtime inputs 事件，然後按一下Edit 。
3. 在基本資訊 中，輸入名稱和描述以協助識別事件。
   
4. 在變數 中，使用這些顯示名稱新增 TextField 輸入：
   • 範圍
   • SpreadsheetID
   • SheetID

   祕訣 將這些變數的預設值留空；當您執行1. 稍後建立的 Urjanet 連鎖。

5. 為所有三個變數選擇Required ，然後按Save 。
   
   

步驟 3.新增檔案公用程式建立檔案指令

若要為Control Sheet 區段建立記錄檔，請新增 File UtilitiesCreate file 指令：

1. 從可用連線 ，選擇檔案公用程式 ，並將建立檔案 移至畫布。
2. 從Runtime inputs 拖曳連結到Create file 。
3. 選擇Create file 指令，然後按Edit 。
4. 在基本資訊 中，輸入名稱和描述以協助識別命令。
   
5. 輸入命令的內容，然後按一下儲存 ：
   

   摘要資訊	值
   連接器	選擇要使用的檔案公用程式連接器。
   文字	輸入上次在 更新的網站使用資料，並選擇System.DateTime 運行時間變數。

步驟 4.添加 Workiva Write Sheet Data 命令

若要使用記錄檔更新Control Sheet 區段，請新增 WorkivaWrite sheet data 指令：

1. 從可用的連接器 ，選擇Workiva ，並移動寫工作表資料 到畫布。
2. 從建立檔案 拖曳連結至寫入工作表資料 。
3. 選擇寫入工作表資料 指令，然後按一下編輯 。
4. 在Basic info 中，輸入名稱和說明，以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇要使用的 Workiva 連接器。
   試算表 ID	選擇SpreadsheetID runtime input fromTrigger 。
   工作表 ID/名稱	從觸發 ，選擇工作表 ID runtime 輸入。
   資料檔案	選擇Create file 指令的Created file 輸出。
   分隔符號	輸入逗號 (,)。
   區域	從觸發器 中選擇Range runtime 輸入。

6. 單擊發佈 ，輸入關於其發佈的備註，然後單擊發佈 。

從載入數據到 Wdata 模板建立鏈

接下來，使用 Load Data to Wdata 模板 建立鏈，用從 Urjanet 下載的數據更新Urjanet 控制表 電子表格的連接表。Load Data to Wdata 模板创建的链协同工作，以确定表中是否已存在数据集，并用最新数据集更新表。

要從Templates 創建鏈，打開Load Data to Wdata | Primary chain 模板，然後點擊New chain 。

建立從 Urjanet 下載資料的鏈

最後，建立一個從 Urjanet 下載和匯入公用程式資料的連鎖。

註記: 在這個鏈之前建立另外兩個鏈，為其Run chain 事件。

步驟 1. 建立鏈結

1. 從Chains ，按一下Create ，並選擇Create chain 。
2. 在設定 ，輸入名稱1. Urjanet 和描述，以幫助進一步識別鏈。
   
3. 在變數, 加入 Urjanet 認證的變數和Urjanet 控制表 電子表格及其控制表 部分的 ID。
   

   名稱	值
   Urjanetusername	輸入用來存取 Urjanet 服務的使用者名稱。
   密碼	輸入用來存取 Urjanet 服務的密碼。
   SpreadsheetID	輸入Urjanet 控制表 電子表格的 ID。
   SheetID	輸入控制工作表 電子表格部分的 ID。

4. 按一下「儲存」(Save)。
   
   

步驟 2.使用 Workiva Get Sheet Data 命令開始

以 WorkivaGet sheet data 命令開始，根據Urjanet 控制表 電子表格中的時間段，確定要下載的資料：

1. 從可用連接器 ，選擇Workiva ，並將Get sheet data 移至Start.
2. 選擇Get sheet data 指令，然後按Edit 。
3. 在Basic info 中，輸入名稱和說明，以協助識別命令。
4. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇與先前連鎖相同的 Workiva 連接器。
   試算表 ID	選擇試算表 ID 鍊變數。
   工作表 ID/名稱	選擇工作表 ID 鍊變數。
   區域	輸入A11:E12.
   數值樣式	選擇「計算」。
   修訂	要確保最新版本，請輸入-1 。

步驟 3.添加命令為 Urjanet 準備時間段

要識別 Urjanet 的時間段，請新增Advanced query 和CSV to JSON 指令：

1. 從可用的連線器 ，選擇表格轉換 ，並將進階查詢 移至畫布。
2. 從取得工作表資料 拖曳連結到進階查詢 。
3. 選擇進階查詢 指令，然後按編輯 。
4. 在基本資訊 中，輸入名稱和描述以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選取要使用的表格轉換連接器。
   表格	新增時段資料表： 在檔案 中，選擇Get sheet data 指令的Data 輸出。 在表名 中，輸入a 。
   查詢	輸入要執行的查詢 select case 當 `Start Month` = 'January「 則 」01-01「 當 `Start Month` = 」February「 則 」02-01「 當 `Start Month` = 」March「 則 」03-01「 當 `Start Month` = 」April「 則 」04-01「 當 `Start Month` = 」May「 則 」05-01「 當 `Start Month` = 」June「 則 」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 當 `End Month` = 'January「 則 」01-31「 當 `End Month` = 」February「 則 」02-28「 當 `End Month` = 」March「 則 」03-31「 當 `End Month` = 」April「 則 」04-30「 當 `End Month` = 」May「 則 」05-31「 當 `End Month` = 」June「 則 」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'、`報告年份`為 'ry「，TableId 為 」tid' from a
   輸入分隔符	選擇逗號。
   輸出分隔符	選擇逗號。
   預覽結果	選擇此核取方塊。

6. 從可用連線 ，選擇JSON ，並將CSV 至 JSON 移至畫布。
7. 從進階查詢 拖曳連結到CSV 到 JSON 。
8. 選擇CSV 至 JSON 指令，然後按編輯 。
9. 在Basic info 中，輸入名稱和描述以協助識別命令。
   
10. 輸入命令的內容，然後按一下儲存 ：
    

    摘要資訊	值
    連接器	選擇要使用的 JSON 連接器。
    輸入檔	選擇結果 進階查詢 指令的輸出。
    分隔符號	選擇逗號 (, )。

步驟 4.添加 POST 命令向 Urjanet 發送承載令牌

要提供 Urjanet 用於認證的承載令牌，請新增 HTTPPOST 指令：

1. 從可用連接器 ，選擇HTTP ，並將POST 移至畫布。
2. 從CSV 拖曳連結到 JSON 到POST 。
3. 選擇POST 指令，然後按Edit 。
4. 在Basic info 中，輸入名稱和描述以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇要使用的 HTTP 連接器。
   顯示回應	選擇此核取方塊。
   URL|網址	輸入https://api.urjanet.com/auth/login.
   內容類型	輸入application/json.
   本文	輸入字串以建立承載令牌： 輸入密碼 從Chain 中選擇Urjanetpassword 變數。 輸入使用者名稱 從Chain 中選擇Urjanetusername 變數。 ENTER
   輸出模式	輸入此範例回應： {"status":200,"message":"Authentication Successful","type":"Bearer","token":"abc","expires":"1694017012"}

步驟 5.添加命令從 Urjanet 獲取網站

要從 Urjanet 帳戶擷取和解析網站，請新增 HTTPGET 和 HandlebarsRender text template 指令：

1. 從可用連接器 ，選擇HTTP ，並將GET 移動到畫布。
2. 從POST 拖曳連結到GET 。
3. 選擇GET 指令，然後按Edit 。
4. 在Basic info 中，輸入名稱和說明，以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇與先前相同的 HTTP 連接器。
   顯示回應	選擇此核取方塊。
   URL|網址	輸入https://api.urjanet.com/utility/sites 。
   頁首	添加此標頭： 在Key 中，輸入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" ："CHICAGO", "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" }, "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. 從可用連接器 ，選擇Handlebars ，並將渲染文字範本 移動到畫布。
7. 從GET 拖曳連結到渲染文字範本 。
8. 選取渲染文字範本 指令，然後按編輯 。
9. 在Basic info 中，輸入名稱和說明，以協助識別命令。
10. 輸入命令的屬性，然後按儲存 ：
    
    

    摘要資訊	值
    連接器	選擇要使用的 Handlebars 連接器。
    範本	輸入此文字範本： [{{#each a}} "{{entityId}}" {{#unless @last}},{{/unless}}{{/each}}]
    JSON 變數	新增此變數： 在Name 中，輸入a 。 在Value, 從Response output of theGET 命令的_embedded 中選擇sites 。

步驟 6.添加命令向 Urjanet 請求網站資料

若要向 Urjanet 索取貴公司的網站資料，請新增另一個 HTTPPOST 指令，接著是Pause chain 事件，讓請求有時間處理：

1. 從可用的連線器 ，選擇HTTP ，並移動POST 到畫布。
2. 從渲染文字範本 拖曳連結到POST 。
3. 選擇POST 指令，然後按Edit 。
4. 在Basic info 中，輸入名稱和描述以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇與先前相同的 HTTP 連接器。
   顯示回應	選擇此核取方塊。
   URL|網址	輸入https://api.urjanet.com/utility/sites/downloads/usages.
   內容類型	輸入application/json.
   本文	輸入字串以建立承載令牌： 輸入{"siteIds": 。 選擇渲染文字範本 指令的渲染文字 輸出。 輸入, "startDate":" 選擇JSON 檔案 CSV 到 JSON指令的輸出，並應用Get value from JSON 變數轉換 ： 在Output 中，選擇 Text。 在Value 中，輸入0 ，然後輸入ry 。 ENTER 選擇CSV 至 JSON指令的JSON 檔 輸出，並套用Get value from JSON 變數轉換： 在Output 中，選擇 Text。 在Value 中，輸入0 ，然後輸入sm 。 輸入", "endDate":". 選擇CSV 至 JSON指令的JSON 檔 輸出，並套用Get value from JSON 變數轉換： 在Output 中，選擇 Text。 在Value 中，輸入0 ，然後輸入ry 。 ENTER 選擇CSV 至 JSON指令的JSON 檔 輸出，並套用Get value from JSON 變數轉換： 在Output 中，選擇 Text。 在Value 中，輸入0 ，然後輸入em 。 輸入", "outputFormat": "CSV"} 。
   頁首	添加兩個標頭： 授權 標頭： 在Key 中，輸入authorization 。 在Value 中，選擇Type ，然後從第一個POST 指令的Response 輸出中選擇Token 。 accept 標頭： 在Key 中 ，輸入accept 。 在Value 中 ，輸入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. FromChain events, movePause chain to the canvas.
7. 從POST 拖曳連結到Pause chain 。
8. 選擇Pause chain 事件，然後按Edit 。
   
9. 在Basic info 中，輸入名稱和描述以協助識別命令。
10. 輸入事件的詳細資訊，然後按一下儲存 ：
    

    詳細資訊	值
    等待時間	輸入6 。
    等待時間單位	選擇秒。

步驟 7.新增指令下載網站資料為 CSV 檔案

若要從 Urjanet 下載網站資料為 CSV 檔案，請新增 HTTPGET 指令和表格轉換Map headers 指令：

1. 從可用連接器 ，選擇HTTP ，並將GET 移至畫布。
2. 從POST 拖曳連結到GET 。
3. 選擇GET 指令，然後按Edit 。
4. 在Basic info 中，輸入名稱和說明，以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇與先前相同的 HTTP Request 連接器。
   顯示回應	選擇此核取方塊。
   URL|網址	從第二個POST 指令的回應 輸出中選擇href _links 。
   頁首	添加此標頭： 在Key 中，輸入authorization 。 在Value 中，選擇Type ，然後從第一個POST 指令的Response 輸出中選擇Token 。
   內容類型	輸入application/json 。

6. 從可用的連線器 ，選擇表格轉換 ，並將地圖標頭 移至畫布。
7. 從GET 拖曳連結到地圖標頭 。
8. 選擇Map headers 指令，然後按Edit 。
9. 在Basic info 中，輸入名稱和描述以協助識別命令。
10. 輸入命令的屬性，然後按儲存 ：
    
    

    摘要資訊	值
    連接器	選擇與先前相同的表格轉換連接器。
    輸入檔	選擇第二個GET 指令的回應 輸出。
    輸出檔案	輸入urjanet.csv 。
    預覽結果	選擇此核取方塊。
    分隔符號	選擇 Comma。
    輸入標頭	按以下順序添加從 Urjanet 下載的 CSV 檔案的標頭： 報表編號 間隔開始 間隔結束 服務類型 電表編號 電錶號碼 電錶狀態 原始帳號 標準化帳號 服務提供者名稱 服務地址 服務城市 服務州 服務郵遞區號 服務國家 站台碼 網站名稱 網站編號 網站區域 地點子區域 場地設施類型 站台位址 地點城市 網站州 網站郵遞區號 網站國家 關稅名稱 消費量 消費量測單位 附加提供商名稱 附加提供商帳號 提供者分類 總收費 總費用 貨幣代碼
    輸出標題	依序為包含資料的資料表加入對應的標題： statement_id interval_start interval_end service_type meter_id meter_number meter_status raw_account_number normalized_account_number 提供者名稱 service_address service_city service_state service_postal_code 服務國家 site_code .siteName site_number 地區 site_sub_region site_facility_type site_address site_city site_state site_postal_code 國家 關稅名稱 消耗量 消耗量單位 附加供應商名稱 附加提供者帳號 provider_classification 總費用 total_charges_currency_code

步驟 8.為其他鏈添加運行鏈事件

要將資料上傳至 Wdata，並在控制表 區段中記錄上傳情況，請為先前建立的鏈新增Run chain 事件：

1. FromChain events, moveRun chainto the canvas.
2. 從地圖標頭 拖曳連結至運行鏈 。
3. 選擇Run chain 事件，然後按Edit 。
4. 在Basic info 中，輸入名稱和描述，以協助識別事件將資料上載到 Wdata。
5. 在Chain to run 中，選擇Load Data to Wdata | Primary chain ，它是從Load Data to Wdata 範本中較早建立的。
6. 輸入鏈運行時輸入，並點擊Save ：
   
   

   輸入	值
   表格 ID	要提供要上傳資料的 Wdata 表 ID，請選擇CSV 到 JSON 指令的JSON 檔 輸出，並應用Get variable from JSON 變數轉換 ： 在Output 中，選擇 Text。 在Value 中 ，輸入0 和tid 。
   檔案名稱	要根據資料的時間段來定義要上傳的資料集名稱： 輸入 Site Usage_ ： 輸入Site Usage_ 。 對於起始月份，選擇CSV 至 JSON 指令的JSON 檔案 輸出，輸入破折號 (-) 並再次選擇CSV 至 JSON 指令的JSON 檔案 輸出。 輸入下劃線 (_)。 對於月底，選擇CSV 至 JSON 指令的JSON 檔案 輸出，輸入破折號 (-)，並再次選擇CSV 至 JSON 指令的JSON 檔案 輸出。 輸入.csv 。 對於兩個月，點選第一個JSON 檔 輸出，並套用Get variable from JSON 變換： 在Output 中，選擇 Text。 在Value 中，輸入0 和ry 。 點選兩個月的第二個JSON 檔案 輸出，並套用另一個從 JSON 取得變數 變換： 在Output 中，選擇 Text。 在Value 中，輸入0 和em 。
   資料檔案	選擇Map headers 指令的Map headers output 。
   載入方法	選擇取代資料集。
   復原	選取此核取方塊。

7. 從Chain events ，移動另一個Run chain到畫布。
8. 從第一個Run Chain 拖曳連結到第二個。
9. 選擇第二個Run chain 事件，然後按一下Edit 。
10. 在Basic info, 輸入名稱和描述，以幫助識別事件記錄在Urjanet 控制表 電子表格中的數據上載。
11. 在Chain 中執行 ，選擇3. 較早前建立的 Urjanet 鏈。
    
12. 輸入鏈運行時間輸入，並點擊儲存 ：

    輸入	值
    範圍	輸入F12:F12.
    試算表 ID	選擇SpreadsheetID 鍊變數。
    工作表 ID	選擇SheetID 鍊變數。

13. 按一下發佈 ，輸入關於其發佈的任何備註，然後按一下發佈 。

執行鏈

用最新的公用事業數據刷新表格：

1. 從控制表 Urjanet 控制表 電子表格的部分，選擇要從 Urjanet 下載的資料的時間段 - 月和年。
   
2. 從Chains, 選擇1. Urjanet 鏈，然後單擊Execute 和Run chain 。
   
   

   注意： 當您執行此鏈時，它會自動執行其他兩個鏈，以更新 Wdata 表和Urjanet 控制表 電子表格中的數據。