Workiva Support Center

通过 Chain Builder，您可以创建一个链，从 Enablon® 下载数据，例如您的温室气体 (GHG) 排放量，用于环境、社会和治理 (ESG) 或可持续发展报告。 

先决条件

要构建这条链，您将使用以下核心连接器：

• HTTP 请求连接器
• 文件实用工具 连接器
• XML 连接器
• 如果您需要在电子表格或 Wdata 表中使用数据，请使用Workiva 连接器。

注： 此链中的所有命令均使用默认的 CloudRunner。无需 GroundRunner。

要运行该链，您需要从 Enablon 获取访问数据的详细信息：

• 用于下载数据的 Enablon 简单对象访问协议 (SOAP) 应用程序编程接口 (API) 端点
• 要访问的 Enablon 环境的 ID
• 访问环境所用的用户名和密码

步骤 1. 创建链条

1. 从链中，单击 创建，然后选择 创建链。
   
2. 在 设置下，输入名称和描述，以帮助识别链及其用途。
   
3. 在 变量下，添加访问数据所需的 Enablon 详细信息变量：
   • 端点

     提示： 对于 端点 变量，请输入默认值 ExportData ，或者，要以 64 位编码格式下载数据，请输入 ExportBinaryData。

   • 环境
   • 用户名
   • 密码
4. 点击 保存。

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

为了在每次链运行时过滤输出，首先使用 运行时输入 事件来提示要下载的数据的条件。

1. 将 运行时输入 从 触发事件 下方移动到 开始。
2. 选择 运行时输入 事件，然后单击 编辑。
   
3. 添加每次链式运行时需要请求的输入：

   显示名称	类型	必需的？
   报告期起始日期	日期字段	是的
   报告期结束日期	日期字段	是的
   活动	文本框或下拉框： TextField，用于打开的文本字段 下拉字段，用于从特定选项列表中进行选择	是的
   实体	ArrayField	是的

4. 点击 保存。

步骤 3. 添加 HTTP 请求连接器 POST 命令

要从 Enablon 端点检索数据，请设置一个 HTTP连接器 POST 命令：

1. 在 连接器下，单击 HTTP，并将 POST 命令移动到画布上。
2. 将链接从 开始 拖到 POST 命令。
3. 选择 POST 命令，然后单击 编辑。
4. 在 命令属性下，选择要使用的 HTTP 连接器。
5. 请输入命令属性：
   
   

   摘要信息	描述
   用户名	在 链 ] 下选择 用户名变量。
   密码	在 Chain下选择 Password 变量。
   显示回复	勾选此框。
   网址	在 链 下选择 端点变量。
   内容类型	输入 文本/xml。

6. 在 正文中，输入以下可扩展标记语言 (XML) 语法：

   <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:enab="enablon"><soapenv:Header><UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"><EnaHomeSite xsi:type="xsd:string"> [环境]</EnaHomeSite><EnaUserName xsi:type="xsd:string"> [用户名]</EnaUserName><EnaPassword xsi:type="xsd:string"> [密码] </EnaPassword></UserInfo></soapenv:Header><soapenv:Body><enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/实体/数据</Table>       <FolderId>0</FolderId><Fields>文件夹路径|报告周期|参考|指标名称|数值编号|本地单位|数值列表</Fields><Filter>ReportingPeriod 在 ([ReportPeriodEndDate],[ReportPeriodStartDate]) 中，且 Campaign 在 ([Campaign]) 中，且 Entities=[Entities]</Filter><CSVSeparator> 2</CSVSeparator><FormatOptions> 25</FormatOptions><FormatType> 3</FormatType><ExportOptions> 8192</ExportOptions></enab:ExportData></soapenv:Body></soapenv:Envelope>

7. 使用运行时输入和链式变量更新 XML 语法：
   • 在标题中，将 [Environment]、 [Username]和 [Password] 替换为 Chain下的相应变量。
   • 在正文中，将 [ReportPeriodEndDate]、 [ReportPeriodStartDate]、 [Campaign]和 [Entities] 替换为 Trigger下的运行时输入。
8. 点击 保存。

步骤 4. 添加文件实用工具连接器查找和替换命令

要准备下载的 XML 数据，请添加 文件实用工具 连接器 查找和替换 命令来修复尖括号和竖线。

提示：为了方便区分 查找和 替换命令，可以输入名称来标识每个命令 要修复的字符，例如“查找和替换尖括号”或“查找和替换竖线

1. 在 连接器下，单击 文件实用工具，并将 查找和替换 命令移动到画布上。
2. 将链接从 POST 命令拖到 查找和替换 命令。
3. 选择 查找和替换 命令，然后单击 编辑。
4. 在 命令属性下，选择要使用的 文件实用工具 连接器。
   
5. 输入命令属性，然后单击 保存:
   

   摘要信息	描述
   来源	选择 POST [ 命令的 响应 [] 输出。
   查找	输入 < 。
   取代	输入起始尖括号（<）。
   查找语法	选择精确值。

6. 在 连接器下，单击 文件实用工具，然后将另一个 查找和替换 命令移动到画布上。
7. 将查找和替换 命令连接起来。
8. 选择新的 查找和替换 命令，然后单击 编辑。
9. 在 命令属性下，选择相同的 文件实用工具 连接器。
   
10. 输入命令属性，然后单击 保存:
    

    摘要信息	描述
    来源	选择 查找和替换 [] 命令的 替换结果输出。
    查找	输入 >。
    取代	输入起始尖括号（>）。
    查找语法	选择精确值。

11. 在 连接器下，单击 文件实用工具，然后将另一个 查找和替换 命令移动到画布上。
12. 在第二个和第三个 查找和替换 命令之间拖动链接。
13. 选择第三个 查找和替换 命令，然后单击 编辑。
14. 在 命令属性下，选择相同的 文件实用工具 连接器。
    
15. 输入命令属性，然后单击 保存:
    

    摘要信息	描述
    来源	选择第二个 [ 查找和替换 命令的 [] 替换结果输出。
    查找	输入 >。
    取代	输入竖线（|）。
    查找语法	选择精确值。

步骤 5. 将 XML 连接器元素列表添加到 CSV 命令

要将下载的 XML 转换为表格数据，请添加 XML 连接器 元素列表到 CSV 命令：

1. 在 连接器下，单击 XML，然后将另一个 元素列表到 CSV 命令移动到画布上。
2. 将第三个 查找和替换 命令中的链接拖到 元素列表到 CSV 命令中。
3. 选择 元素列表到 CSV 命令，然后单击 编辑。
4. 在 命令属性下，选择要使用的 XML 连接器。
   
5. 请输入命令属性：
   

   摘要信息	描述
   来源	选择第三个 [ 查找和替换 命令的 替换结果 [输出。
   根路径	输入 //文档/记录。
   预览结果	勾选此框。

6. 在 列下，添加每个元素的列名和 XPath：
   
   

   列名称	XPath
   期间	报告期
   指标	/参考
   工业名称	/指标名称
   数值	/值编号
   单位	/本地单元

7. 在 多值分隔符中，输入逗号 (,)。
8. 点击 保存。

步骤 6. 添加文件实用工具连接器“创建文件”命令

要从表格数据创建逗号分隔值 (CSV) 文件，请添加 文件实用工具 连接器 创建文件 命令：

1. 在 连接器下，单击 文件实用工具，并将 创建文件 命令移动到画布上。
2. 将 元素列表到 CSV 命令的链接拖到 创建文件 命令。
3. 选择 创建文件命令，然后单击 编辑。
4. 在 命令属性下，选择与 查找和替换 命令相同的 [] 文件实用工具 连接器。
   
5. 输入命令属性，然后单击 保存:
   

   摘要信息	描述
   文本	选择 转换后的文件 输出的元素列表到 CSV命令。
   文件路径	选择 Runtime下的 Chain.Workspace 变量，并附加 \test.csv。

步骤 7. 添加命令以在 Workiva 中使用数据

要在 Workiva 平台中使用 CSV 数据，请添加 Workiva 连接器命令，以使用 创建文件 命令的 创建文件 变量输出，并将其与电子表格或 Wdata 表一起使用。例如，要将 Enablon 数据作为数据集添加到 Wdata 表中，请添加一个 运行链 事件，该事件使用从 更新表中的数据集模板创建的链。 

步骤 8. 发布并运行链

要使该链运行：

1. 点击 发布。
2. 输入有关其发布的任何评论，然后单击 发布。

运行该链：

1. 从 链中，从链的菜单中选择 编辑 。
2. 点击 链设置，输入变量值，然后点击 保存。

   注： 对于 端点 变量，请输入 ExportData 或 ExportBinaryData以 64 位编码格式下载数据。

3. 点击 执行。
4. 从 监视器中，单击 使用输入运行，输入运行时输入，然后单击 开始。