Workiva支持中心

借助 IBM® Planning Analytics® TM1® 连接器，您可以 使用链式命令 与由 Cognos® TM1 提供支持的 IBM Planning Analytics 进行交互。例如，使用此连接器，您可以：

• 在规划分析中管理家务及其任务
• 管理 TM1 多维数据集、多维数据集视图和单元格
• 筛选消息和事务日志
• 管理流程及其错误日志

注: 此连接器由 Workiva 构建，并连接到第三方系统。虽然我们的支持团队可以帮助您在工作区内配置此连接器，但我们无法对源自 Workiva 平台之外的任何问题进行故障排除或提供其他帮助。

先决条件

为了实现连接，连接器使用 IBM Planning Analytics REST API。注意：该连接器支持 IBM Planning Analytics 10.2 或更高版本。

要建立连接，您需要：

• 要连接的 TM1 实例的完整 URL，例如 https://TM1-url.com/api/v1
• 在 TM1 实例中为连接器设置的指定服务帐户
• 服务帐户的用户名和密码
• 如果启用了 集成 Windows@ 身份验证 (IWA) 或 Cognos 身份验证管理器 (CAM) ，则需要为 TM1 服务器提供其他身份验证凭据。
  • 如果启用了 IWA，则使用其身份验证令牌
  • 如果启用了 CAM，则其轻量级目录访问协议 (LDAP) 命名空间
• 要连接到本地 TM1 服务器，请使用 GroundRunner执行

  命令。

  注意 ：要连接到 TM1 的云实例，请使用默认的 CloudRunner。

设置 IBM Planning Analytics TM1 连接器

注： 要使连接器可在您组织的链中使用， 组织安全管理员首先需要在配置中启用它。

1. 从 链构建器中，单击 连接比较箭头，然后单击右上角的 创建 。
2. 在 连接器连接下，选择 IBM Planning Analytics TM1和要与连接器一起使用的运行程序。
   
3. 在 基本信息下，输入一个唯一的名称和描述，以帮助识别连接。
4. 在 属性下，输入连接的详细信息：
   
   

   摘要信息	详细信息
   TM1 API URL	输入要连接的 TM1 实例的完整 URL，例如 https://TM1-url.com/api/v1。
   用户名	输入 TM1 实例中连接器服务帐户的用户名。
   密码	输入 Username 属性的密码。
   令牌	如果 TM1 服务器启用了集成 Windows 身份验证 (IWA)，请输入其身份验证令牌。
   身份验证类型	选择为 TM1 服务器启用的身份验证类型： 基本身份验证，仅用于 TM1 用户名和密码身份验证 如果启用了 IWA，则使用 Windows 集成身份验证。 如果启用了 Cognos 安全性，则需要使用 Cognos 身份验证管理器 (CAM)。
   LDAP 命名空间	如果启用了 CAM，请输入其 LDAP 命名空间。

   注意：所有敏感凭证均会自动加密，并以高级加密标准 (AES ) -256 加密方式存储

   。
5. 选择要使用连接的环境，然后单击 保存。
6. 要测试连接， 创建并运行一个链 使用 连接器的 列出立方体 命令，并验证它是否返回有效输出。

疑难解答

如果与 IBM Planning Analytics 的连接失败：

• 检查要连接的 TM1 实例的 URL。
• 验证服务帐户的身份验证凭据。
• 验证 TM1 服务器启用的身份验证类型及其相关凭据，例如 IWA 令牌或 LDAP 命名空间。

如果您收到 “无法找到到请求目标 的有效证书路径”错误，请将服务器证书添加到您信任的 Java® 密钥库中：

1. 要从服务器获取证书，请输入以下命令：

   # openssl s_client -connect tm1server.tux:5010 -servername tm1server.tux:5010 < /dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > public.crt

2. 要将证书导入密钥库，请输入以下命令：

   # /usr/lib/jvm/java-8-openjdk-amd64$ sudo bin/keytool -import -alias tm1server.tux -keystore jre/lib/security/cacerts -file /home/administrator/public.crt

   注意： 密钥库的密码可能是 changeit。