Urjanet Utility Cloud® 使企業能夠利用來自全球公用事業供應商的準確、按需數據,對其氣候影響採取行動。
使用 Workiva,您可以建立鏈,根據自定義Urjanet 控制表 電子表格中指定的時間段,從 Urjanet 自動下載公用事業數據到表格中。然後,您可以使用此表作為查詢或試算表連結的來源,將其資料包含在環境、社會與治理 (ESG) 或永續性報告輸出中。
註記: 當您在這些指示中建立多個鏈時,您只會執行一個鏈 - 然後自動執行其他鏈 - 從 Urjanet 下載資料並更新試算表。
註: 這些連鎖店使用的Urjanet 控制表 電子表格由 Workiva 提供。如果您沒有但有興趣,請聯絡您的客戶成功經理 (CSM) 以取得詳細資訊。
必要條件
要建立這些鏈,您需要這些連接器:
提示: 所有鏈的命令都使用預設 CloudRunner。不需要 GroundRunner。
要成功運行鏈,還需要確定
- 用戶名和密碼 用於認證和訪問 Urjanet 服務
- ID 的Urjanet 控制表 電子表格 ,其控制表 部分,及其連接的表
建立鏈以記錄資料下載
開始時,建立連鎖以更新控制表 部分,以追蹤公用程式資料上傳至 Workiva 的時間。
步驟 1. 建立鏈結
- 從Chains ,點擊Create ,並選擇Create chain 。
- 在Setup 中,輸入名稱
3. Urjanet和描述,以幫助識別該鏈記錄實用資料上載。 - 按一下「儲存」(Save)。
步驟 2.以運行時輸入事件開始
- 從連鎖事件 ,移動運行時間輸入 到開始 。
- 選擇Runtime inputs 事件,然後按一下Edit 。
- 在基本資訊 中,輸入名稱和描述以協助識別事件。
- 在變數 中,使用這些顯示名稱新增 TextField 輸入:
範圍SpreadsheetIDSheetID
祕訣 將這些變數的預設值留空;當您執行1. 稍後建立的 Urjanet 連鎖。
- 為所有三個變數選擇Required ,然後按Save 。
步驟 3.新增檔案公用程式建立檔案指令
若要為Control Sheet 區段建立記錄檔,請新增 File UtilitiesCreate file 指令:
- 從可用連線 ,選擇檔案公用程式 ,並將建立檔案 移至畫布。
- 從Runtime inputs 拖曳連結到Create file 。
- 選擇Create file 指令,然後按Edit 。
- 在基本資訊 中,輸入名稱和描述以協助識別命令。
- 輸入命令的內容,然後按一下儲存 :
摘要資訊 值 連接器 選擇要使用的檔案公用程式連接器。 文字 輸入 上次在更新的網站使用資料,並選擇System.DateTime 運行時間變數。
步驟 4.添加 Workiva Write Sheet Data 命令
若要使用記錄檔更新Control Sheet 區段,請新增 WorkivaWrite sheet data 指令:
- 從可用的連接器 ,選擇Workiva ,並移動寫工作表資料 到畫布。
- 從建立檔案 拖曳連結至寫入工作表資料 。
- 選擇寫入工作表資料 指令,然後按一下編輯 。
- 在Basic info 中,輸入名稱和說明,以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇要使用的 Workiva 連接器。 試算表 ID 選擇SpreadsheetID runtime input fromTrigger 。 工作表 ID/名稱 從觸發 ,選擇工作表 ID runtime 輸入。 資料檔案 選擇Create file 指令的Created file 輸出。 分隔符號 輸入逗號 ( ,)。區域 從觸發器 中選擇Range runtime 輸入。 - 單擊發佈 ,輸入關於其發佈的備註,然後單擊發佈 。
從載入數據到 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. 建立鏈結
- 從Chains ,按一下Create ,並選擇Create chain 。
- 在設定 ,輸入名稱
1. Urjanet和描述,以幫助進一步識別鏈。 - 在變數, 加入 Urjanet 認證的變數和Urjanet 控制表 電子表格及其控制表 部分的 ID。
名稱 值 Urjanetusername 輸入用來存取 Urjanet 服務的使用者名稱。 密碼 輸入用來存取 Urjanet 服務的密碼。 SpreadsheetID 輸入Urjanet 控制表 電子表格的 ID。 SheetID 輸入控制工作表 電子表格部分的 ID。 - 按一下「儲存」(Save)。
步驟 2.使用 Workiva Get Sheet Data 命令開始
以 WorkivaGet sheet data 命令開始,根據Urjanet 控制表 電子表格中的時間段,確定要下載的資料:
- 從可用連接器 ,選擇Workiva ,並將Get sheet data 移至Start.
- 選擇Get sheet data 指令,然後按Edit 。
- 在Basic info 中,輸入名稱和說明,以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇與先前連鎖相同的 Workiva 連接器。 試算表 ID 選擇試算表 ID 鍊變數。 工作表 ID/名稱 選擇工作表 ID 鍊變數。 區域 輸入 A11:E12.數值樣式 選擇「計算」。 修訂 要確保最新版本,請輸入 -1。
步驟 3.添加命令為 Urjanet 準備時間段
要識別 Urjanet 的時間段,請新增Advanced query 和CSV to JSON 指令:
- 從可用的連線器 ,選擇表格轉換 ,並將進階查詢 移至畫布。
- 從取得工作表資料 拖曳連結到進階查詢 。
- 選擇進階查詢 指令,然後按編輯 。
- 在基本資訊 中,輸入名稱和描述以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選取要使用的表格轉換連接器。 表格 新增時段資料表: - 在檔案 中,選擇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
輸入分隔符 選擇逗號。 輸出分隔符 選擇逗號。 預覽結果 選擇此核取方塊。 - 從可用連線 ,選擇JSON ,並將CSV 至 JSON 移至畫布。
- 從進階查詢 拖曳連結到CSV 到 JSON 。
- 選擇CSV 至 JSON 指令,然後按編輯 。
- 在Basic info 中,輸入名稱和描述以協助識別命令。
- 輸入命令的內容,然後按一下儲存 :
摘要資訊 值 連接器 選擇要使用的 JSON 連接器。 輸入檔 選擇結果 進階查詢 指令的輸出。 分隔符號 選擇逗號 (, )。
步驟 4.添加 POST 命令向 Urjanet 發送承載令牌
要提供 Urjanet 用於認證的承載令牌,請新增 HTTPPOST 指令:
- 從可用連接器 ,選擇HTTP ,並將POST 移至畫布。
- 從CSV 拖曳連結到 JSON 到POST 。
- 選擇POST 指令,然後按Edit 。
- 在Basic info 中,輸入名稱和描述以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇要使用的 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 指令:
- 從可用連接器 ,選擇HTTP ,並將GET 移動到畫布。
- 從POST 拖曳連結到GET 。
- 選擇GET 指令,然後按Edit 。
- 在Basic info 中,輸入名稱和說明,以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇與先前相同的 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 }} - 在Key 中,輸入
- 從可用連接器 ,選擇Handlebars ,並將渲染文字範本 移動到畫布。
- 從GET 拖曳連結到渲染文字範本 。
- 選取渲染文字範本 指令,然後按編輯 。
- 在Basic info 中,輸入名稱和說明,以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇要使用的 Handlebars 連接器。 範本 輸入此文字範本: [{{#each a}} "{{entityId}}" {{#unless @last}},{{/unless}}{{/each}}]JSON 變數 新增此變數: - 在Name 中,輸入
a。 - 在Value, 從Response output of theGET 命令的_embedded 中選擇sites 。
- 在Name 中,輸入
步驟 6.添加命令向 Urjanet 請求網站資料
若要向 Urjanet 索取貴公司的網站資料,請新增另一個 HTTPPOST 指令,接著是Pause chain 事件,讓請求有時間處理:
- 從可用的連線器 ,選擇HTTP ,並移動POST 到畫布。
- 從渲染文字範本 拖曳連結到POST 。
- 選擇POST 指令,然後按Edit 。
- 在Basic info 中,輸入名稱和描述以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇與先前相同的 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 。
- 在Key 中,輸入
-
accept 標頭:
- 在Key 中 ,輸入
accept。 - 在Value 中 ,輸入
application/json。
- 在Key 中 ,輸入
輸出模式 輸入此回應範例: { "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" }}} - 輸入
- FromChain events, movePause chain to the canvas.
- 從POST 拖曳連結到Pause chain 。
- 選擇Pause chain 事件,然後按Edit 。
- 在Basic info 中,輸入名稱和描述以協助識別命令。
- 輸入事件的詳細資訊,然後按一下儲存 :
詳細資訊 值 等待時間 輸入 6。等待時間單位 選擇秒。
步驟 7.新增指令下載網站資料為 CSV 檔案
若要從 Urjanet 下載網站資料為 CSV 檔案,請新增 HTTPGET 指令和表格轉換Map headers 指令:
- 從可用連接器 ,選擇HTTP ,並將GET 移至畫布。
- 從POST 拖曳連結到GET 。
- 選擇GET 指令,然後按Edit 。
- 在Basic info 中,輸入名稱和說明,以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇與先前相同的 HTTP Request 連接器。 顯示回應 選擇此核取方塊。 URL|網址 從第二個POST 指令的回應 輸出中選擇href _links 。 頁首 添加此標頭: - 在Key 中,輸入
authorization。 - 在Value 中,選擇Type ,然後從第一個POST 指令的Response 輸出中選擇Token 。
內容類型 輸入 application/json。 - 在Key 中,輸入
- 從可用的連線器 ,選擇表格轉換 ,並將地圖標頭 移至畫布。
- 從GET 拖曳連結到地圖標頭 。
- 選擇Map headers 指令,然後按Edit 。
- 在Basic info 中,輸入名稱和描述以協助識別命令。
- 輸入命令的屬性,然後按儲存 :
摘要資訊 值 連接器 選擇與先前相同的表格轉換連接器。 輸入檔 選擇第二個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 事件:
- FromChain events, moveRun chainto the canvas.
- 從地圖標頭 拖曳連結至運行鏈 。
- 選擇Run chain 事件,然後按Edit 。
- 在Basic info 中,輸入名稱和描述,以協助識別事件將資料上載到 Wdata。
- 在Chain to run 中,選擇Load Data to Wdata | Primary chain ,它是從Load Data to Wdata 範本中較早建立的。
- 輸入鏈運行時輸入,並點擊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 。 載入方法 選擇取代資料集。 復原 選取此核取方塊。 - 從Chain events ,移動另一個Run chain到畫布。
- 從第一個Run Chain 拖曳連結到第二個。
- 選擇第二個Run chain 事件,然後按一下Edit 。
- 在Basic info, 輸入名稱和描述,以幫助識別事件記錄在Urjanet 控制表 電子表格中的數據上載。
- 在Chain 中執行 ,選擇3. 較早前建立的 Urjanet 鏈。
- 輸入鏈運行時間輸入,並點擊儲存 :
輸入 值 範圍 輸入 F12:F12.試算表 ID 選擇SpreadsheetID 鍊變數。 工作表 ID 選擇SheetID 鍊變數。 - 按一下發佈 ,輸入關於其發佈的任何備註,然後按一下發佈 。
執行鏈
用最新的公用事業數據刷新表格:
- 從控制表 Urjanet 控制表 電子表格的部分,選擇要從 Urjanet 下載的資料的時間段 - 月和年。
- 從Chains, 選擇1. Urjanet 鏈,然後單擊Execute 和Run chain 。
注意: 當您執行此鏈時,它會自動執行其他兩個鏈,以更新 Wdata 表和Urjanet 控制表 電子表格中的數據。