从 Urjanet® 下载公用事业数据，用于可持续发展报告

Urjanet Utility Cloud®使公司能够利用来自世界各地公用事业供应商的准确、按需数据来应对其气候影响。

使用 Workiva，您可以构建链，根据自定义 Urjanet 控制表 电子表格中指定的时间段，自动将 Urjanet 中的公用事业数据下载到表中。然后，您可以将此表用作查询或电子表格连接的来源，以便将其数据包含在环境、社会和治理 (ESG) 或可持续性报告输出中。

注意：虽然这些说明中您需要构建多个链，但您只需运行其中一个链（该链会自动运行其他链）即可从 Urjanet 下载数据并更新电子表格。

注：这些连锁店使用的 Urjanet 控制表电子表格由 Workiva 提供。如果您还没有这项服务但对此感兴趣，请联系您的客户成功经理 (CSM) 了解详情。

先决条件

要构建这些链条，您需要以下连接器：

提示：所有链的命令都使用默认的CloudRunner。不需要地面巡逻员。

为了成功运行这些链，还需要确定：

用于验证身份和访问 Urjanet 服务的用户名和密码
Urjanet 控制表 电子表格、其控制表部分及其关联表的 ID

构建一个用于记录数据下载的链

首先，建立一个链来更新 控制表 部分，以跟踪公用事业数据何时上传到 Workiva。

步骤 1. 创建链条

从链中，单击创建，然后选择 创建链。
在设置中，输入 3 的名称。Urjanet 和描述，以帮助识别该链记录实用程序数据上传。
点击保存。

步骤 2. 从运行时输入事件开始

从 链事件中，将 运行时输入 移动到开始。
选择 运行时输入 事件，然后单击编辑。
在 基本信息中，输入名称和描述，以帮助识别事件。
在变量中，添加具有以下显示名称的 TextField 输入框：
- 范围
- 表格ID
- 工作表ID
提示： 将这些变量的默认值留空；它们将在运行 1. Urjanet 链是后来创建的。
为所有三个变量选择必填，然后单击保存。

步骤 3. 添加文件实用程序“创建文件”命令

要为 “控制表 ”部分创建日志文件，请添加“文件实用程序 ”中的“创建文件 ”命令：

从 可用连接器中，选择 文件实用工具，并将 创建文件 移动到画布上。
将链接从 运行时输入 拖到 创建文件。
选择 创建文件 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。
输入命令属性，然后单击保存:

摘要信息值

连接线选择要使用的文件实用工具连接器。

文本输入 站点使用情况数据上次刷新时间为，并选择 System.DateTime 运行时变量。

步骤 4. 添加 Workiva 写入工作表数据命令

要使用日志文件更新 控制表 部分，请添加 Workiva 写入表数据 命令：

从 可用连接器中选择 Workiva，并将 写入工作表数据 移动到画布上。
将链接从 创建文件 拖到 写入工作表数据。
选择 写入工作表数据 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择要使用的 Workiva 连接器。
电子表格ID	从触发器 [中选择 [ SpreadsheetID [] 运行时输入。
图纸编号/名称	从触发器[中选择 [] SheetID 运行时输入。
数据文件	选择创建文件命令的输出结果。
分隔符号	输入逗号（`,`）。
地区	从触发器 [] 中选择范围] 运行时输入。

点击发布，输入有关其发布的说明，然后点击发布。

从“加载数据到 Wdata”模板构建链

接下来，使用 将数据加载到 Wdata 模板构建链，以使用从 Urjanet 下载的数据更新 Urjanet 控制表 电子表格的连接表。 Load Data to Wdata 模板创建一系列链，这些链协同工作，以确定数据集是否已存在于表中，并使用最新数据集更新表。

要从模板创建链，请打开 加载数据到 Wdata | 主链 模板，然后单击 新建链。

构建一个从 Urjanet 下载数据的链

最后，构建一个从 Urjanet 下载和导入公用事业数据的链。

注：在此链之前创建其他两个链，以便运行其链事件。

步骤 1. 创建链条

从链中，单击创建，然后选择 创建链。
在设置中，输入名称 1。Urjanet 和描述，以帮助进一步识别该链。

在变量中，添加 Urjanet 凭据的变量以及 Urjanet 控制表 电子表格及其 控制表 部分的 ID。

姓名	值
Urjanet用户名	请输入用于访问 Urjanet 服务的用户名。
Urjanet密码	请输入用于访问 Urjanet 服务的密码。
表格ID	输入 Urjanet 控制表电子表格的 ID。
工作表ID	输入电子表格中控制表部分的 ID。

点击保存。

步骤 2. 首先使用 Workiva 的“获取工作表数据”命令

首先使用 Workiva 获取工作表数据 命令，根据 Urjanet 控制表 电子表格中的时间段来确定要下载的数据：

从 可用连接器中，选择 Workiva，并将 获取工作表数据移动到开始。
选择 获取工作表数据命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择与之前链条相同的 Workiva 连接器。
电子表格ID	选择电子表格 ID 链变量。
图纸编号/名称	选择工作表 ID 链变量。
地区	输入 `A11:E12`。
价值风格	选择“计算”。
修订	为确保使用最新版本，请输入 `-1`。

步骤 3. 添加命令以准备 Urjanet 的时间段

要确定 Urjanet 的时间段，请添加 高级查询 和 CSV 转 JSON 命令：

从 可用连接器中选择 表格转换，并将 高级查询 移动到画布上。
将链接从 获取工作表数据拖到 高级查询。
选择 高级查询 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择要使用的表格转换连接器。
表格	添加时间段数据表：在文件中，选择获取工作表数据命令的数据输出。在表名中，输入 `一个`。
查询	输入要运行的查询： 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' 结束，并标记为 'sm'，根据 `End Month` 的值进行判断：当 `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'；当 `End Month` = 'July' 时，则标记为 '07-31'；当 `End Month` = 'August' 时，则标记为 '08-31'；当 `End Month` = 'September' 时，则标记为 '09-30'；当 `End Month` = 'October' 时，则标记为 '10-31'；当 `End Month` = 'November' 时，则标记为 '11-30'。从中获取 '12-31' 的结尾，即 'em'，`报告年份` 的结尾，以及 TableId 的结尾，即 'tid'。
输入分隔符	选择逗号。
输出分隔符	选择逗号。
预览结果	选中此复选框。

从 可用连接器中选择 JSON，并将 CSV 到 JSON 移动到画布上。
将链接从 高级查询 拖到 CSV 转 JSON。
选择 CSV 转 JSON 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。
输入命令属性，然后单击保存:

摘要信息值

连接线选择要使用的JSON连接器。

输入文件选择 高级查询 命令的结果 [] 输出。

分隔符号选择逗号（，）。

步骤 4. 添加 POST 命令，向 Urjanet 发送 bearer token。

要向 Urjanet 提供用于身份验证的 bearer token，请添加 HTTP POST命令：

从 可用连接器中选择 HTTP，并将 POST 移动到画布上。
将链接从 CSV 拖到 JSON 再拖到 POST。
选择 POST 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择要使用的HTTP连接器。
显示回复	选中此复选框。
网址	输入 `https://api.urjanet.com/auth/login`。
内容类型	输入 `application/json`。
正文	请输入用于构建持有者令牌的字符串：输入 `{"密码":"`。从链中选择 Urjanetpassword 变量。输入 `","用户名":"` 从链中选择 Urjanetusername 变量。进入 `”}`。
输出方案	请输入以下示例回复： {"status":200,"message":"身份验证成功","type":"Bearer","token":"abc","expires":"1694017012"}

步骤 5. 添加从 Urjanet 获取站点的命令

要从您的 Urjanet 帐户检索和解析站点，请添加 HTTP GET 和 Handlebars Render text template 命令：

从 可用连接器中选择 HTTP，并将 GET 移动到画布上。
将链接从 POST 拖到 GET。
选择 GET 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择与之前相同的HTTP连接器。
显示回复	选中此复选框。
网址	输入 `https://api.urjanet.com/utility/sites`。
页首	添加此标题：在 Key中，输入 `authorization`。在值中，从 POST [ 命令的 [ 响应输出中选择类型，然后选择令牌。
内容类型	输入 `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,美国伊利诺伊州芝加哥，邮编 60603，"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 } }

从 可用连接器中选择 Handlebars，并将 渲染文本模板 移动到画布上。
将链接从 GET 拖到 Render text template。
选择 渲染文本模板 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择要使用的车把连接器。
范本	输入此文本模板： [{{#each a}} "{{entityId}}" {{#unless @last}},{{/unless}}{{/each}}]
JSON 变量	添加此变量：在名称中，输入 `一个`。在 Value中，从 _embedded 中选择 sites ，该 [] 是 GET [ 命令的 ] Response输出。

步骤 6. 添加从 Urjanet 请求站点数据的命令

要从 Urjanet 请求贵公司的网站数据，请添加另一个 HTTP POST 命令，后跟一个 Pause chain 事件，以便有时间处理请求：

从 可用连接器中选择 HTTP，并将 POST 移动到画布上。
将链接从 渲染文本模板 拖到 POST。
选择 POST 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择与之前相同的HTTP连接器。
显示回复	选中此复选框。
网址	输入 `https://api.urjanet.com/utility/sites/downloads/usages`。
内容类型	输入 `application/json`。
正文	请输入用于构建持有者令牌的字符串：输入 `{"siteIds":`。选择渲染文本模板命令的渲染文本输出。输入 `“开始日期”：”` 选择 CSV 转 JSON命令的输出 JSON 文件，并应用从 JSON 获取值变量转换：在输出中，选择文本。在值中，输入 `0` ，然后输入 `ry`。进入 `-`。选择 CSV 转 JSON 命令的输出 JSON文件，并应用从 JSON获取值的变量转换：在输出中，选择文本。在值中，输入 `0` ，然后输入 `sm`。输入 `","endDate":"`。选择 CSV 转 JSON 命令的输出 JSON文件，并应用从 JSON获取值的变量转换：在输出中，选择文本。在值中，输入 `0` ，然后输入 `ry`。进入 `-`。选择 CSV 转 JSON 命令的输出 JSON文件，并应用从 JSON获取值的变量转换：在输出中，选择文本。在值中，输入 `0` ，然后输入 `em`。输入 `","outputFormat":"CSV"}`。
页首	添加两个标题：授权标头：在 Key中，输入 `authorization`。在值中，从第一个 POST [ 命令的响应输出中选择类型，然后选择令牌。一个 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" } }}

从 链事件中，将 暂停链 移动到画布上。
将链接从 POST 拖到 Pause 链。
选择 暂停链 事件，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。
输入活动详情，然后点击保存:

细节值

等待时间输入 6。

等待时间单位选择秒数。

步骤 7. 添加命令以将站点数据下载为 CSV 文件

要从 Urjanet 下载站点数据到 CSV 文件，请添加另一个 HTTP GET 命令和一个表格转换 映射标头 命令：

从 可用连接器中选择 HTTP，并将 GET 移动到画布上。
将链接从 POST 拖到 GET。
选择 GET 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择与之前相同的HTTP请求连接器。
显示回复	选中此复选框。
网址	从第二个 POST 命令的 Response 输出的 _links中选择 href 。
页首	添加此标题：在 Key中，输入 `authorization`。在值中，从第一个 POST [ 命令的响应输出中选择类型，然后选择令牌。
内容类型	输入 `application/json`。

从 可用连接器中选择 表格变换，并将 地图标题 移动到画布上。
将链接从 GET 拖到 Map headers。
选择 地图标题 命令，然后单击编辑。
在 基本信息中，输入名称和描述以帮助识别命令。

输入命令属性，然后单击保存:

摘要信息	值
连接线	选择与之前相同的表格转换连接器。
输入文件	选择第二个 GET 命令的响应 ] 输出。
输出文件	输入 `urjanet.csv`。
预览结果	选中此复选框。
分隔符号	选择逗号。
输入头	按以下顺序添加从 Urjanet 下载的 CSV 文件的标题：声明 ID 间隔开始间隔结束服务类型电表 ID 电表编号电表状态原始账号标准化账号提供商名称服务地址服务城市服务状态服务邮政编码服务国家站点代码网站名称站点编号站点区域站点子区域场地设施类型网站地址赛特城站点状态网站邮政编码网站国家关税名称消耗消耗量单位其他提供者名称附加提供商账号提供者分类总费用总费用货币代码
输出头	按以下顺序添加表格的相应表头： statement_id 间隔开始间隔结束服务类型 meter_id 仪表编号仪表状态原始账号标准化账号提供者名称服务地址服务城市服务状态服务邮政编码服务国家站点代码站点名称站点编号站点区域站点子区域场地设施类型站点地址站点城市站点状态站点邮政编码站点国家/地区关税名称消耗消耗量单位附加提供商名称附加提供商账号提供者分类总费用 total_charges_currency_code

步骤 8. 为其他链添加运行链事件

要将数据上传到 Wdata 并在 控制表 部分记录上传操作，请为先前创建的链添加 运行链 事件：

从 链事件中，将 运行链 移动到画布上。
将链接从 映射标头 拖到 运行链。
选择 运行链 事件，然后单击编辑。
在 基本信息中，输入名称和描述，以帮助识别该事件将数据上传到 Wdata。
在 运行链中，选择 加载数据到 Wdata | 主链 ，该主链 [] 之前已从 加载数据到 Wdata 模板创建。

输入链运行时输入，然后单击保存:

输入	值
表格 ID	要提供要上传数据的 Wdata 表的 ID，请选择 JSON 文件CSV转 JSON 命令的输出，并应用从 JSON 获取变量变量转换：在输出中，选择文本。在值中，输入 `0` 和 `tid`。
文件名称	根据数据的时间段，定义要上传的数据集的名称：输入 `站点使用情况_`。对于起始月份，选择 CSV 转 JSON 命令的 JSON 文件输出，输入一个破折号 (`-`)，然后再次选择 CSV 转 JSON 命令的 JSON 文件输出。输入下划线（`_`）。对于月底，选择 CSV 转 JSON 命令的 JSON 文件输出，输入一个破折号 (`-`)，然后再次选择 CSV 转 JSON [] 命令的 ]JSON 文件输出。输入 `.csv`. 对于这两个月，单击第一个 JSON 文件输出，并应用从 JSON 获取变量转换：在输出中，选择文本。在值中，输入 `0` 和 `ry`。对于这两个月，单击第二个 JSON 文件输出，并应用另一个从 JSON 获取变量转换：在输出中，选择文本。在值中，输入 `0` 和 `em`。
数据文件	选择 Map headers命令的 Map headers 输出。
加载方法	选择“替换数据集”。
回滚	选中此复选框。

从 链事件中，将另一个 运行链 移动到画布上。
将链接从第一个 运行链 拖到第二个 []。
选择第二个 运行链 事件，然后单击编辑。
在 基本信息中，输入名称和描述，以帮助识别该事件记录了 Urjanet 控制表电子表格中的数据上传。
在 链式运行中，选择 3。Urjanet 链创建于先前。
输入链运行时参数，然后点击保存：

输入值

范围输入 F12:F12。

电子表格ID 选择 SpreadsheetID 链变量。

工作表 ID 选择 SheetID 链变量。
点击发布，输入有关其发布的任何注释，然后点击发布。

跑链

要使用最新的公用事业数据刷新表格：

从 Urjanet 控制表 电子表格的 控制表部分中，选择要从 Urjanet 下载的数据的时间段（月份和年份）。
从链中选择 1。Urjanet 链，然后单击执行和 运行链。

注：运行此链时，它会自动运行另外两个链，以使用数据更新 Wdata 表和 Urjanet 控制表 电子表格。

支持

社区

Workiva Support Center