Workiva Support Center

Greenly® 使您能够评估和计算贵公司直接和间接的范围 1、2 和 3 碳排放量。 

借助 Workiva 平台，您可以构建链式操作，自动将 Greenly 的碳足迹和活动数据下载到表格中。然后，您可以将该表用作查询或电子表格连接的来源，例如包含在环境、社会和治理 (ESG) 或可持续性披露中。

注意： 虽然您需要按照这些说明构建多个链，但您 只需运行 其中一个链 （该链会自动运行其他链）即可将数据从 Greenly 下载到表中。

先决条件

要构建这些链， 首先在 链中设置这些连接 器：

• Workiva 连接器
• 文件实用工具 连接器
• 表格变换 连接器
• JSON 连接器
• HTTP 连接器

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

要启用与 Greenly 的集成，请向您的 Greenly 管理员申请以下权限：

• 您的公司 ID
• 您的账户客户端 ID 和密钥

另外 ，请注意 Greenly 主表 电子表格、其 控制表 部分及其关联表的 ID 。

构建链式日志记录 Greenly 下载

从 Greenly 下载数据时，自动更新 控制表 部分 Greenly 引导表 电子表格。

1. 从 链中，单击 创建，然后选择 创建链。
   
   
2. 输入名称和描述，以帮助说明该链记录从 Greenly 下载的数据，然后单击 保存。
3. 从 触发事件中，将 运行时输入 拖到 开始。
4. 选择 运行时输入，然后单击 编辑。
   
5. 在 变量中，这些文本字段输入，没有 默认值：
   • 范围
   • 电子表格ID
   • 工作表 ID
6. 为每个变量选择 必填 ，然后单击 保存。
7. 从 可用连接器中，选择 文件实用程序，并将 创建文件 移动到画布上。
8. 将链接从 运行时输入 拖到 创建文件。
9. 选择 创建文件 命令，然后单击 编辑。
10. 在 基本信息中，输入名称和描述以帮助识别命令。
    
11. 输入命令属性，然后单击 保存:
    

    摘要信息	值
    连接线	选择要使用的文件实用程序连接器。
    文本	创建日志消息文本： 输入 排放数据已于刷新。 从 Runtime中选择 SystemDateTime变量。

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

    摘要信息	值
    连接线	选择要使用的 Workiva 连接器。
    电子表格ID	从 触发器 [中选择 电子表格 ID [] 运行时输入。
    图纸编号/名称	从 触发器中选择 [] 工作表 ID 运行时输入。
    数据文件	从 创建文件 中选择 创建文件的输出。
    分隔符号	选择逗号（，）。
    地区	从 触发器 [] 中选择 范围运行时输入。
    使用异步	取消选中此复选框。
    使用平台 API	选中此复选框。

17. 点击 发布，输入有关该连锁店发布的说明，然后点击 发布。

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

首先，使用 “加载数据到 Wdata ” 模板来构建链，以使用从 Greenly 下载的数据更新表。“将数据加载到 Wdata”模板创建协同工作的链，以实现以下目的：

• 确定数据集是否已存在于表中
• 使用最新数据集更新表格

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

构建一条从 Greenly 下载数据的链

然后，构建一个从 Greenly 下载和导入数据的链。

步骤 1. 创建链条

1. 从 链中，单击 创建，然后选择 创建链。
2. 在 设置中，输入名称和描述，以帮助解释该链从 Greenly 下载数据。
3. 在 变量中，添加以下变量，然后单击 保存：

   姓名	值
   表格 ID	请输入要上传数据的表的ID。
   格林利客户ID	请输入贵公司 Greenly 帐户的客户 ID。
   格林利客户秘密	请输入贵公司 Greenly 帐户的客户密钥。
   格林利观众	输入 https://corporate.greenly.earth/api/v2。
   格林利公司 ID	请输入贵公司 Greenly 帐户的 ID。
   电子表格ID	输入 Greenly 主表 电子表格的 ID。
   工作表 ID	输入电子表格中 控制表 部分的 ID。

步骤 2. 添加从 Greenly 下载数据的命令

要从 Greenly 下载碳足迹数据：

1. 从 可用连接器中，选择 HTTP，并将 Post 移动到 Start。
2. 选择 发布 命令，然后单击 编辑。
3. 在 基本信息中，输入名称和描述以帮助识别命令。
4. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择要使用的HTTP连接器。
   显示回复	选中复选框。
   网址	输入 https://greenly-production.eu.auth0.com/auth/token。
   内容类型	选择 application/json。
   正文	创建用于身份验证的有效负载文本： 输入 {"client_id":"。 从 链中选择 Greenly 客户端 ID 变量。 输入 ","client_secret":"。 从 Chain中选择 Greenly 客户端密钥 变量。 输入 ","audience":"。 从 Chain中选择 Greenly audience 变量。 输入 ","grant_type":"client_credentials"}。
   输出方案	输入示例响应： {"access_token":"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Im80VnNKMERMdlJhOW0zTWNwZ1BJXyJ9.eyJhdXRob3JpemVkX2NvbXBhbmllcyI6WyJjMTUxYjMwNi0yODY5LTQwM2YtYWY4OS0wMTBhYmJkMTUwNDkiXSwiaXNzIjoiaHR0cHM6Ly9ncmVlbmx5LXByb2R1Y3Rpb24uZXUuYXV0aDAuY 29tLyIsInN1YiI6IjM3VFhpRGU3bWxGbGh5cG9yWjlhN1c3Mmt3bkFUMmkyQGNsaWVudHMiLCJhdWQiOiJodHRwczovL2NvcnBvcmF0ZS5ncmVlbmx5LmVhcnRoL2FwaS92MiIsImlhdCI6MTY5NjM2NTgzNiwiZXhwIjoxNjk2NDUyMjM2LCJhenAiOiIzN1RYaURlN21sRmxoeXBvclo5YTdXNzJrd25BVDJpMiIsInNj b3BlIjoicmVhZDphY3Rpdml0aWVzIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.kA-6hrCShQ7usZhIR2Bl5eBoJHCoKQNc3NvHtv8uRtjDvH2DMdI xQeIsD7_GmT-_b4CxVPxPpEwy24UCTuDTmBQiI9JgKcprp-40uCzOzan2v5U7nXbcT5Z7uiN4QE15kcIevWGuZAQ11K23h_ftISwAOQR18F-kT03mHtklNoG wLZiETze12lTvDjMKy2NzFIUL7CP1yBgtTDoSc3j_oJC_M780Dc_hW_IfuHHDXMXmOdzp9d6lPzOfAhjyb33l5KKho5YjwJGtrCzKU6kRhY4txeMdrAjsx0IZ61ThFezXWJUSqo30_kTSBxG7Dje5TA-B2i0xBhSgcKZB_iFWUg","scope":"read:activities","expires_in":86400,"token_type":"Bearer"}

5. 从 可用连接器中选择 HTTP，并将 Get 移动到画布上。
6. 将链接从 Post 拖到 Get。
7. 选择 获取 命令，然后单击 编辑。
8. 在 基本信息中，输入名称和描述以帮助识别命令。
9. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择与 Post相同的 HTTP 连接器。
   显示回复	选中复选框。
   网址	输入 https://corporate.greenly.earth/api/v2/activities/audit-export。
   查询字符串	创建查询字符串： 输入 companyId=。 从 链中选择 Greenly 公司 ID 变量。 输入 &expand=carbonFootprint&limit=100&offset=1。
   页首	添加此标题： 在 键中，输入授权信息。 在 Value中，从 Post的 [ Response 输出中选择 Token_type 和 Access_token 。
   内容类型	选择 application/json。
   输出方案	输入示例响应： {"data":[{"activityId":"297b29b1-a474-4fa5-a9fd-f80ff5fd7e4d","ownerCompanyId":"c151b306-2869-403f-af89-010abbd15049","ownerProfileId":"e620cee6-97e2-4f02-8ef1-c928d4cf8649","companyId":"c151b306-2869-403f-af89-010abbd15049","profileId":"e620cee6-97e2-4f02-8ef1-c928d4cf8649","companyName":"Demo for Greenly Certified合作伙伴","财政年度","时间范围开始","时间范围结束","监管方法","BEGESv4","范围","范围 3","子范围","9","子范围名称","商品和服务采购","站点名称","实际值估算","实际值","父业务类别","业务类别","银行手续费和服务","活动名称","商业账户[服务]银行]","activityType":"基于费用","source":"会计","quantity":5.73,"quantityForSubScope":5.73,"unit":"欧元","conversionFactor1Value":null","conversionFactor1Name":null","conversionFactor1InputUnit":null","conversionFactor1OutputUnit":null","conversionFactor1Methodology":null","conversionFactor2Value":null" versionFactor2Name":null,"conversionFactor2InputUnit":null,"conversionFactor2OutputUnit":null,"conversionFactor2Methodology":null,"conversionFactor3Value":null,"conversionFactor3Name":null,"conversionFactor3InputUnit":null,"conversionFactor3OutputUnit":null,"conversionFactor3Methodology":null,"emissionFactorName":"Bank费用和服务","排放因子名称和单位","银行费用和服务（欧元）","排放因子值","排放因子输入单位","排放因子输出单位","千克二氧化碳当量","排放因子参考类型","格林利排放因子参考年份","排放因子地理有效性","排放因子参考描述","排放因子参考类别","排放因子方法","0.11 千克二氧化碳当量/欧元。这一货币因素来自法国生态转型机构（ADEME）。它适用于“服务 - 保险、银行、咨询和费用”（“Service - Assurance, services bancaires, conseil et honoraires”）类别。更多信息请访问 ADEME 网站。请参阅 https://www.bilans-ges.ademe.fr/en/accueil/documentation-gene/index/page/Ratio-monetaires","percentEmissionsInScope":"1.000000000000000000000","emissionsInKGCO2e":0.63,"emissionsIntCO2e":0.00063,"entityCreatedAt":"2023-04-20T13:44:14.010Z","versionCreatedAt":"2023-11-12T12:36:12.598Z" "granularType":"Transaction","supplierName":null,"marketBased":"Location-Based","isCrossEntity":false,"shouldBeExcluded":false,"purchaseCategoryId":"73679b6b-7f02-4292-a473-0aee658300b4","language":"en"}],"limit":1,"offset":1,"orderBy":"entityCreatedAt","order":"ASC","totalCount":2568}

步骤 3. 添加命令以创建数据的 JSON 数据

要将下载的数据保存为 JavaScript 对象表示法 (JSON)：

1. 从 可用连接器中选择 Workiva，并将 创建查询移动到画布上。
2. 将链接从 获取 拖到 创建查询。
3. 选择 创建查询 命令，然后单击 编辑。
4. 在 基本信息中，输入名称和描述以帮助识别命令。
5. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择与创建用于记录数据下载的链相同的 Workiva 连接器。
   姓名	请输入临时查询的名称。
   查询文本	创建查询字符串： 输入 select row_number() over ( order by a) as R, a from (select a from unnest(sequence(0,. 从 [] Get 的 ] Response 输出中选择 TotalCount。 输入 ,1000)) t(a))。
   暂时的	选中此复选框。

6. 从 可用连接器中选择 Workiva，并将 运行查询移动到画布上。
7. 将链接从 创建查询 拖到 运行查询。
8. 选择 运行查询 命令，然后单击 编辑。
9. 在 基本信息中，输入名称和描述以帮助识别命令。
   
10. 输入命令属性，然后单击 保存:
    

    摘要信息	值
    连接线	选择与之前相同的 Workiva 连接器。
    查询 ID	从 Query 的输出中选择 Id ，该 创建查询。

11. 从 可用连接器中选择 Workiva，并将 下载查询结果移动到画布上。
12. 将链接从 运行查询拖到 下载查询结果。
13. 选择 下载查询结果 命令，然后单击 编辑。
14. 在 基本信息中，输入名称和描述以帮助识别命令。
15. 输入命令属性，然后单击 保存:
    
    

    摘要信息	值
    连接线	选择与之前相同的 Workiva 连接器。
    查询结果 ID	从 查询结果 输出中选择 Id ，该 [] 是 运行查询的结果。

16. 从 可用连接器中选择 Workiva，并将 删除查询移动到画布上。
17. 将链接从 下载查询结果 拖到 删除查询。
18. 选择 删除查询 命令，然后单击 编辑。
19. 在 基本信息中，输入名称和描述以帮助识别命令。
    
20. 输入命令属性，然后单击 保存:
    

    摘要信息	值
    连接线	选择与之前相同的 Workiva 连接器。
    查询 ID	从 Query 的输出中选择 Id ，该 创建查询。

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

    摘要信息	值
    连接线	选择要使用的JSON连接器。
    输入文件	选择 查询结果 的输出 下载查询结果。
    分隔符号	选择逗号（，）。

步骤 4. 创建命令组以下载所有数据

1. 将 命令组 移动到画布上，并将 CSV 到 JSON的链接拖到该组中。
2. 选择组，然后单击 编辑。
3. 选择 迭代器，并启用 迭代。
   
4. 设置迭代器，然后单击 保存:

   摘要信息	值
   修饰符类型	选择列表。
   迭代	选择 JSON 文件 输出 CSV 转 JSON。

5. 从 可用连接器中选择 HTTP，然后将另一个 Get 移动到画布上。
6. 将链接从 组开始 拖到 获取。
7. 选择 获取 命令，然后单击 编辑。
8. 在 基本信息中，输入名称和描述，以帮助识别该命令检索活动数据。
9. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择与之前相同的HTTP连接器。
   显示回复	选中复选框。
   网址	输入 https://corporate.greenly.earth/api/v2/activities/audit-export。
   查询字符串	创建查询语法： 输入 companyId=。 从 链中选择 Greenly 公司 ID 变量。 输入 &expand=carbonFootprint&limit=100&offset=。 从 组迭代器 [中选择 JSON 文件迭代 [ 输出。 单击 JSON 文件迭代，并添加 从 JSON 获取值 转换。 在 值中，输入 一个。 点击 应用。
   页首	添加此标题： 在 键中，输入授权信息。 在 Value中，从 Post的 [ Response 输出中选择 Token_type 和 Access_token 。
   内容类型	选择 application/json。
   输出方案	输入示例响应： {"data":[{"activityId":"297b29b1-a474-4fa5-a9fd-f80ff5fd7e4d","ownerCompanyId":"c151b306-2869-403f-af89-010abbd15049","ownerProfileId":"e620cee6-97e2-4f02-8ef1-c928d4cf8649","companyId":"c151b306-2869-403f-af89-010abbd15049","profileId":"e620cee6-97e2-4f02-8ef1-c928d4cf8649","companyName":"Demo for Greenly Certified合作伙伴","财政年度","时间范围开始","时间范围结束","监管方法","BEGESv4","范围","范围 3","子范围","9","子范围名称","商品和服务采购","站点名称","实际值估算","实际值","父业务类别","业务类别","银行手续费和服务","活动名称","商业账户[服务]银行]","activityType":"基于费用","source":"会计","quantity":5.73,"quantityForSubScope":5.73,"unit":"欧元","conversionFactor1Value":null","conversionFactor1Name":null","conversionFactor1InputUnit":null","conversionFactor1OutputUnit":null","conversionFactor1Methodology":null","conversionFactor2Value":null" versionFactor2Name":null,"conversionFactor2InputUnit":null,"conversionFactor2OutputUnit":null,"conversionFactor2Methodology":null,"conversionFactor3Value":null,"conversionFactor3Name":null,"conversionFactor3InputUnit":null,"conversionFactor3OutputUnit":null,"conversionFactor3Methodology":null,"emissionFactorName":"Bank费用和服务","排放因子名称和单位","银行费用和服务（欧元）","排放因子值","排放因子输入单位","排放因子输出单位","千克二氧化碳当量","排放因子参考类型","格林利排放因子参考年份","排放因子地理有效性","排放因子参考描述","排放因子参考类别","排放因子方法","0.11 千克二氧化碳当量/欧元。这一货币因素来自法国生态转型机构（ADEME）。它适用于“服务 - 保险、银行、咨询和费用”（“Service - Assurance, services bancaires, conseil et honoraires”）类别。更多信息请访问 ADEME 网站。请参阅 https://www.bilans-ges.ademe.fr/en/accueil/documentation-gene/index/page/Ratio-monetaires","percentEmissionsInScope":"1.000000000000000000000","emissionsInKGCO2e":0.63,"emissionsIntCO2e":0.00063,"entityCreatedAt":"2023-04-20T13:44:14.010Z","versionCreatedAt":"2023-11-12T12:36:12.598Z" "granularType":"Transaction","supplierName":null,"marketBased":"Location-Based","isCrossEntity":false,"shouldBeExcluded":false,"purchaseCategoryId":"73679b6b-7f02-4292-a473-0aee658300b4","language":"en"}],"limit":1,"offset":1,"orderBy":"entityCreatedAt","order":"ASC","totalCount":2568}

10. 从 可用连接器中选择 JSON，并将 数组到 CSV移动到画布上。
11. 将链接从 获取拖到 数组到 CSV。
12. 选择 数组到 CSV 命令，然后单击 编辑。
13. 在 基本信息中，输入名称和描述以帮助识别命令。
14. 请输入命令属性：
    
    

    摘要信息	值
    连接线	选择与之前相同的JSON连接器。
    JSON 数据	从前面的 Get [] 的 Response 输出中选择 Data 。
    多值分隔符	选择逗号（，）。
    预览结果	选中复选框。
    分隔符号	选择逗号。

15. 添加这些列，然后单击 保存：

    列名称	JSONPath
    活动ID	.activityID
    公司ID	.公司ID
    公司名称	。公司名称
    财政年度	。财政年度
    temporalScopeStart	.temporalScopeStart
    时间范围结束	.temporalScopeEnd
    监管方法论	监管方法论
    范围	。范围
    子范围	.子范围
    子范围名称	.子范围名称
    站点名称	.站点名称
    实际值估算	.actualsEstimate
    父业务类别	.parentBusinessCategory
    商业类别	.businessCategory
    活动名称	.activityName
    活动类型	.activityType
    源化	。来源
    数量	。数量
    子范围的数量	.quantityForSubScope
    单元	。单元
    转换因子1值	.转换因子1值
    转换因子1名称	.转换因子1名称
    转换因子1 输入单位	.转换因子1输入单位
    转换因子1 输出单位	.转换因子1输出单位
    转换因子1方法	.转换因子1方法论
    转换因子2值	.转换因子2值
    转换因子2名称	.转换因子2名称
    转换因子2 输入单位	.转换因子2输入单位
    转换因子2输出单位	.转换因子2输出单位
    转换因子2方法	.转换因子2方法论
    转换因子3值	.转换因子3值
    转换因子3名称	.conversionFactor3Name
    转换因子3 输入单位	.转换因子3输入单位
    转换因子3输出单位	.转换因子3输出单位
    转换因子3方法	.转换因子3方法论
    排放因子名称	.排放因子名称
    排放因子值	.排放因子值
    排放因子输入单位	.emissionFactorInputUnit
    排放因子输出单位	.排放因子输出单位
    排放因子参考类型	.emissionFactorReferenceType
    排放因子参考年	.emissionFactorReferenceYear
    排放因子地理有效性	.emissionFactorGeographicalValidity
    排放因子参考描述	.emissionFactorReferenceDescription
    排放因子参考类别	.emissionFactorReferentialCategory.en
    排放因子方法	排放因子方法
    排放范围内的百分比	.percentEmissionsInScope
    排放量（千克二氧化碳当量）	.emissionsInKGCO2e
    排放量（国际二氧化碳当量）	.emissionsIntCO2e
    entityCreatedAt	.entityCreatedAt
    版本创建于	.versionCreatedAt
    颗粒类型	.granularType
    供应商名称	.供应商名称
    市场导向	基于市场的
    语言	。语言
    isCrossEntity	.isCrossEntity

16. 从 可用连接器中选择 表格变换，并将 堆栈文件移动到画布上。
17. 将链接从 数组拖到 CSV到 堆叠文件。
18. 选择 堆叠文件 命令，然后单击 编辑。
19. 在 基本信息中，输入名称和描述以帮助识别命令。
    
20. 输入命令属性，然后单击 保存:
    

    摘要信息	值
    连接线	选择要使用的表格转换连接器。
    分隔符号	选择逗号。
    输入文件	指定要堆叠的文件： 选择 先前堆栈文件输出 来自 堆栈文件。 输入逗号（,）。 选择 转换后的文件 输出，来自 数组到 CSV。
    预览结果	选中复选框。

步骤 5. 添加运行链事件以上传和记录下载的数据

要将碳核算数据上传到 Wdata：

1. 从 链事件中，将 运行链 移动到画布上。
2. 将链接从命令组的 Out 拖到 Run 链。
3. 选择 运行链 事件，然后单击 编辑。
4. 在 基本信息中，输入名称和描述，以帮助识别事件。
5. 在 运行链中，选择从 将数据加载到 Wdata 模板创建的主链。
   
6. 输入链的运行时输入，然后单击 保存:

   输入	值
   表格 ID	从 链中选择 [] 表 ID 变量。
   文件名称	输入 activities.csv。
   数据文件	选择 堆栈文件输出 来自 堆栈文件。
   加载方法	选择“替换数据集”。
   回滚	取消选中此复选框。

7. 从 链式事件中，将另一个 运行链 移动到画布上。
8. 在两个 运行链 事件之间拖动链接。
9. 选择新的 运行链 事件，然后单击 编辑。
   
10. 在 基本信息中，输入名称和描述，以帮助识别事件。
11. 在 运行链中，选择创建用于记录从 Greenly 下载数据时的链。
12. 输入链的运行时输入，然后单击 保存:

    输入	值
    范围	输入 B11:B11。
    电子表格ID	从 链中选择 [] 电子表格 ID 变量。
    工作表 ID	从 链中选择 [] 工作表 ID 变量。

13. 点击 发布，输入有关该连锁店发布的说明，然后点击 发布。

要将 Greenly 中的数据下载到 Wdata 表中，请在 Chains中选择此链，然后单击 Execute 和 Run chain。

提示：运行此链时，它会自动运行其他链 ，以使用最新数据更新表并记录下载过程