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 } } - 在 Key中,输入
- 从 可用连接器中选择 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 [ 命令的 响应 输出中选择 类型 ,然后选择 令牌 。
- 在 Key中,输入
- 一个 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。 - 在 Key中,输入
- 从 可用连接器中选择 表格变换,并将 地图标题 移动到画布上。
- 将链接从 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 控制表 电子表格。