本文概述了在与客户最常咨询的 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®
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 资源/订阅)。
总结
| 工具 | 最适合…… (为什么) | 专业级 |
|---|---|---|
| 动力自动化 | 业务逻辑。最适合连接应用程序和人员(例如,“Workiva 报告完成后给我发邮件”)。低代码且用户友好。 |
⭐⭐ (公民开发者) |
| Azure 逻辑应用 | 企业工作流。最适合需要 IT 治理、安全审计和专用网络访问的关键业务流程。 |
⭐⭐⭐ (IT专业人士) |
| Azure 数据工厂 | 大量数据传输。最适合将 Workiva 中的数百万行数据可靠、按计划批量传输到 SQL 仓库或数据湖。 |
⭐⭐⭐⭐ (数据工程师) |
| Microsoft Fabric | 统一分析。如果您想要数据工厂的强大功能,但又希望数据能够立即用于 Power BI/OneLake(现代 SaaS 方法),那么这是最佳选择。 |
⭐⭐⭐⭐ (数据工程师) |
| Azure Functions | 自定义代码。最适合处理标准工具无法处理的复杂 API 分页、循环逻辑或数据解析。纯编码(Python/C#)。 |
⭐⭐⭐⭐⭐ (软件开发人员) |