Workiva支持中心

本文概述了在与客户最常咨询的 Microsoft 产品集成时可用的选项。

注： 微软产品众多，这里我们仅介绍其中一小部分。

哪些人需要参与？

与微软产品的任何集成都需要有 Azure 访问权限和经验的人员。在大多数企业中，这很可能是 IT 团队中的某个人，因此您应该确保他们从一开始就参与所有规划和讨论，以避免出现问题。

第一个决定：运输者

任何集成的第一个决定是 Workiva 和外部系统（在本例中是 Microsoft 平台）之间应该使用什么方式传输数据。Workiva 拥有执行此操作的流程，而微软则拥有许多不同的平台（Azure 数据工厂、Power Automate、Power Query 等）。您也可以使用来自两家公司以外的第三方的软件或程序代码。只要你使用的工具能够与 API 配合使用，那么它就应该能够在平台之间传输数据。

注： 我们通常建议只使用这些工具中的一种。在大多数使用场景中，限制集成中的故障点，从而减少涉及的不同软件包的数量，对于提高效率、可扩展性和可维护性都更有利。

使用 Workiva 的链条

如果您计划使用 Workiva 的 Chains 产品，请先检查您的工作区中是否已激活 Wdata。

链条专用连接器

Chains 拥有多个专用连接器，可以轻松连接到某些 Microsoft 产品。

注意： 任何高级连接器都需要激活 ，并且可能会产生额外费用。请查看您的合同或联系您的客户成功经理了解更多详情。

Microsoft® OneDrive®（也涵盖 SharePoint®）

• OneDrive 是链中的 核心连接器 ，这意味着拥有 Wdata 许可证的所有人都可以免费使用它。
• 您可以复制、删除和搜索文件和文件夹，还可以下载和上传文件以及列出可用驱动器。

Power BI®

• 一个 高级连接器。
• 非常适合从 Workiva 创建数据或将数据发送到 Power BI 数据集，并列出报表、网关、仪表板和数据集等项目。
• 它无法从 Power BI 中提取数据，使其能够以 Workiva 平台可以使用的格式运行。如果您希望将数据从 Power BI 导入到 Workiva，则需要寻找其他方法，例如 HTTP 连接器。

Microsoft® SQL Server®（也称 Azure SQL 数据库）

• 一个 高级连接器。
• 执行 SQL 命令，检索有关表的详细信息，或将记录插入数据库。
• 兼容 Azure SQL 数据库、Azure Synapse Analytics、Azure SQL 托管实例和 SQL Server 2017-2022。

Azure 文件存储

• 一个 高级连接器。
• 从 Azure 文件存储实例下载文件。
• 没办法再做其他事了。

Microsoft® Dynamics® CRM

• 一个 高级连接器。
• 管理实体和查询。

在没有专用链条连接器的地方

如果您的 Microsoft 产品没有专用连接器，或者您想要的功能在现有连接器中不可用，那么这并不意味着就此结束；只是可能意味着需要做更多的工作。

这些连接器让使用微软的 API 变得更加容易，但是如果您具备学习微软 API 的技术知识、动力和意愿，那么您或许可以通过我们的 HTTP 连接器直接使用它。

HTTP 请求连接器（使用 HTTPS）

• 链中的 核心连接器 ，这意味着拥有 Wdata 许可证的所有人都可以免费使用它。
• 能够直接连接到任何 API，包括微软的许多 API，但您需要学习 API 并了解需要交换的正确消息和格式。
• 示例用途：可用于从 Power BI 中提取数据， 而专用连接器不具备此功能。

Microsoft Fabric®

• 使用 HTTP 请求连接器从 Microsoft Fabric® 下载计算出的 ESG 指标，用于可持续发展报告

Microsoft® 可持续发展经理

• 使用 HTTP 请求连接器从 Microsoft® Sustainability Manager 中的外部报告下载数据
• 使用 HTTP 请求连接器从 Microsoft® Sustainability Manager 下载排放数据

使用微软选项代替链式调用

除了使用链式结构，您还可以使用微软提供的众多能够进行集成的软件平台之一。所有选项都需要使用和了解 Workiva的 API。

Azure 数据工厂 (ADF)

• 它是什么: 一个基于云的 ETL（提取、转换、加载）服务，专为大规模数据摄取和复杂的数据工程管道而设计。它是系统间海量数据传输的“重型搬运工”。
• 与 Workiva API 集成: 工作流程：您可以从两步管道开始：步骤 1 是一个“Web 活动”，用于访问 Workiva 身份验证端点（发送客户端 ID/密钥）以检索访问令牌。步骤 2 是“复制活动”，它会将该令牌动态地传递到 Authorization 标头（Bearer）中。<token> ）提取实际数据。
• 典型用例： 您需要移动大量数据，或者您正在构建一个企业级“后端”解决方案，该解决方案需要监控、日志记录和错误处理。

Power Automate（原名 Flow）

• 它是什么： 一款低代码自动化工具，专为业务逻辑、通知和“如果这样，那么那样”工作流而设计。
• 与 Workiva API 集成： 您可以使用 HTTP 操作（高级功能）发出原始 POST/GET 请求，或者构建自定义连接器，只需定义一次 Workiva OAuth2 安全设置。这样，您就可以将“Workiva”操作拖放到您的流程中，而无需每次都担心身份验证码。
• 典型应用场景：
  • 您实现的是业务流程的自动化，而不仅仅是移动数据（例如，“批准此记录”、“发送 Teams 通知”）。
  • 交易数据量为低到中等。
  • 你需要基于触发器（事件）的近乎实时的操作，而不是基于批次的操作。

Azure 逻辑应用

• 它是什么： Power Automate 的“老大哥”。它使用完全相同的工作流设计器和连接器，但运行在 Azure 而不是 Microsoft 365 中。它专为关键任务型、企业级集成而设计，而不是为个人或团队生产力而设计。
• 与 Workiva API 集成： 与 Power Automate 相同（HTTP 操作或自定义连接器）。主要区别在于逻辑应用运行在 Azure 的基础架构上。
• 何时选择：
  • 您需要 IT 治理、高级监控和警报（例如，“如果 Workiva API 出现故障，则通知 DevOps 团队”）。
  • 你想要的是一种 “按执行付费 ”的计费模式（低量使用成本低），而不是为每个接触流程的人购买用户许可证。
  • 该工作流程涉及关键财务数据，需要审计日志和安全标准高于标准的 Office 365 流程。

Azure Functions

• 它是什么： “无服务器计算”。在这里，你可以编写按需运行的纯代码（C#、Python、JavaScript 等）。当现成的工具不够灵活时，它是终极的“万能”解决方案。
• 与 Workiva API 集成： 您需要编写代码来请求 OAuth 令牌、处理复杂的分页（循环遍历数据页）或解析标准工具无法处理的混乱 JSON/XBRL 数据。然后，您可以将此代码“发布”为一个简单的 URL，供其他工具（如 Power BI 或 ADF）调用。
• 何时选择：
  • Workiva API 需要 复杂的逻辑 （例如，“循环遍历这 50 个工作表，但仅当单元格 A1 包含‘Active’时才进行循环，然后重新格式化日期字符串”）。
  • 您需要以极快的 速度处理 数据，或者并行处理请求，以保持在 API 速率限制之内。
  • 你想构建一个“自定义 API 包装器”，以便你的内部团队可以在不了解 OAuth 工作原理的情况下获取或发送 Workiva 数据。

Microsoft Fabric（特别是 Fabric 中的 Data Factory）

• 这是什么： 微软的全新“一体化”分析平台。它本质上是将 Azure 数据工厂、Power BI 和数据湖 (OneLake) 合并到一个 SaaS 产品中。
• 与 Workiva API 集成： 与 Azure 数据工厂 (ADF) 非常相似，使用管道和复制活动。
• 何时选择：
  • 您的组织已经开始采用 Microsoft Fabric作为其未来的数据平台。
  • 您希望缩短从“原始 Workiva 数据”到“Power BI 报表”的路径（Fabric 消除了在中间管理单独的 SQL 数据库的需要）。
  • 您想要 ADF 的强大功能，但又希望拥有 SaaS 界面的简洁性（无需管理 Azure 资源/订阅）。

总结