OneStream 与 Workiva 的集成 使组织能够自动从 OneStream Cloud 提取、转换和交付数据到 Workiva 平台。这种集成可以通过两种方式实现：一种是使用 Workiva Chains 和 HTTP 连接器进行直接的 基于 API 的连接 ；另一种是使用 OneStream Smart Integration Connector (SIC) 进行基于文件的 SFTP 工作流。
两种集成方法均支持将数据导入 Workiva，以便下游连接的报告流程进行处理。
API集成
API 连接要求
- OneStream 云环境： 仅当 OneStream 托管在可公开访问的云环境中时，才支持 API 集成方法。
- 专用服务帐户： 为了安全、审计和运行稳定性，请在 OneStream 中创建一个专用的非交互式服务帐户，专门用于集成。
- 最低所需权限： 仅向服务帐户分配访问相关多维数据集视图和关联数据所需的权限。
- 个人访问令牌 (PAT)： 使用服务帐户凭据生成 PAT，并在创建后立即安全地存储令牌，因为之后可能无法检索。
- 网络和防火墙访问： 确保 Workiva 的静态 IP 地址 已列入允许列表，以允许出站 HTTPS（端口 443）通信到 OneStream API 端点。
配置 API 集成
API 集成利用 GetCubeView 或 GetAdoDataSetForCubeViewCommand 端点从 OneStream 检索 Cube View 数据。
Workiva Chains 可以对 OneStream 进行身份验证，执行 API 请求，转换返回的 JSON 有效负载，并将生成的数据集加载到 Wdata 表中以进行报告和下游处理。
Workiva配置步骤
- 安全地存储 PAT： 在 Chain Builder 中创建一个 工作区变量 （例如，
onestream_api_pat），并将该变量标记为 秘密 以加密该值并防止未经授权的查看。 - 启用所需连接器： 验证 HTTP 连接器、JSON 转换连接器和表格转换连接器是否已在 Workiva 环境中启用并正确配置。
- 创建目标 Wdata 表： 从 OneStream 导出示例 Cube 视图为 CSV 文件，并将其用作 Wdata 表架构的模板。记录表 ID，以便在链配置中使用。
- 转换和映射数据： 如果需要，将 JSON 响应 转换为表格格式，然后将 OneStream 字段名称映射到相应的 Workiva 表列和数据类型。
- 配置链自动化： 配置链的触发机制以控制其执行时间，选项包括按定义的 计划运行、按需（手动执行）、作为 更大的编排工作流[] 中的一个步骤 或由 控制表触发。
必需的 API 参数
| 参数 | 必要 | 描述 |
| 基础Web服务器网址 | 是的 | OneStream 应用服务器的基本 URL。 |
| 应用程序名称 | 是的 | 包含立方体视图的 OneStream 应用程序的名称。 |
| CubeViewName | 是的 | 用于检索数据集的立方体视图。 |
| 立方体名称 | 是的 | Cube 视图使用的关联 Cube 名称。 |
SFTP 集成
在基于 SFTP 的集成中，OneStream 使用智能集成连接器将数据文件（通常为 CSV 格式）导出到中间 SFTP 位置。Workiva Chains 然后使用 SFTP 连接器检索文件，处理数据，并将其加载到 Wdata 表中。
这种方法通常用于无法直接访问 API 的组织，或者组织更倾向于不创建或使用 CubeView 的组织。
| 客户IT/财务团队职责 | 实施伙伴的职责 |
|
|