跳转至

Tagetik Data Loader - 在 CCH Tagetik 上的注册与监控

CCH Tagetik 为管理员用户提供了一个窗口，用于：

  • 注册新的 TDL，以便 CCH Tagetik 能够与其通信
  • 移除不再活跃且未在任何参数化（端点）中使用的 TDL
  • 实时显示已配置 TDL 的信息和状态
  • 显示最后执行或当前正在执行的 TDL 操作
  • 如果自动更新失败，请求手动更新 TDL
  • 请求下载 TDL 日志
  • 请求更新 TDL 上配置的数据源列表及其验证
  • 请求更新 TDL 上配置的路径列表及其验证

此监控功能可从 Repository 主页上同名磁贴访问。

已配置的 TDL 显示在窗口顶部，每个 TDL 显示以下信息：

  • Tagetik Data Loader 名称：用户定义的 TDL 描述
  • 最后操作：TDL 执行的最后一条命令或正在进行的命令
  • 轮询间隔：指定 TDL 检查待接管操作的间隔时间（以秒为单位）
  • 最后请求日期：TDL 最后一次"心跳"的日期
  • Tagetik Data Loader 版本：Karaf 上安装的 TDL 版本
  • 容器版本：Karaf 容器版本
  • 状态：通过指示器显示 TDL 的状态：
  • ：在线
  • ：离线
  • ：在线但已锁定
  • 身份验证失败
  • 等待自动更新
  • 自动更新进行中
  • 自动更新失败
  • 需要手动升级
  • 已使用：指示 TDL 是否在某个已配置的端点中使用。

窗口底部有两个不同的部分：

  • 数据源：系统在此显示数据源的逻辑名称，
  • 路径： 系统在此显示路径的逻辑名称

两者均为当前 TDL 在 Karaf 上配置的。两个部分都有以下按钮：

  • ：通过从当前 TDL 的配置文件中检索信息来更新该部分的数据。此按钮仅在所选 TDL 在线时启用

  • ：验证所选数据源/路径的有效性。验证结果无论为肯定还是否定，都会在操作结束时通过包含相应消息的警报通知。

注册新 TDL

CCH Tagetik 仅在 TDL 已预先注册的情况下才启用与其的通信。

可通过按钮 注册新的 TDL。系统会启用 属性 面板，您必须在其中指定：

  • Tagetik Data Loader ID：TDL 的唯一标识符。该字段必须填入 Karaf 在 TDL 首次启动时自动生成的 ID，该 ID 位于 Karaf 配置目录中的 tgk.agent.cfg 文件中。
  • Tagetik Data Loader 名称：用户定义的 TDL 描述
  • 身份验证代码：标识与 TDL 关联的身份验证代码；它必须与 Karaf 配置目录中 tgk.agent.cfg 文件中指定的代码一致。

TDL 管理

注册 TDL 后，您可以：

  • 通过详细管理编辑 Tagetik Data Loader 名称和身份验证代码，
  • 通过按钮
  • 通过 按钮移除 TDL 的配置。

仅当 TDL 未在端点的参数化中使用时，才能进行编辑和删除。

TDL 更新

TDL 的版本（例如 6.0.1）由三部分组成：

  • 主版本号：用于标识"破坏性变更"，例如更改 Karaf 容器或更改通信协议，
  • 次版本号：用于标识新增功能，这些功能不会影响现有功能的使用，
  • 补丁号：用于标识对现有功能的修正。

更新方式取决于 CCH Tagetik 上参考 TDL 的版本与 Karaf 上 TDL 版本之间的差异：

  • 如果两个主版本号不同，Tagetik Data Loader 的状态将变为 （警告），并且 最后操作 将显示 TO_UPGRADE。这意味着必须手动更新 Karaf/TDL 容器。
  • 如果 CCH Tagetik 上 TDL 的 次版本号.补丁号 小于 Karaf 上 TDL 的，则无需更新。
  • 如果 CCH Tagetik 上 TDL 的 次版本号.补丁号 大于 Karaf 上 TDL 的，则将执行自动更新。在 最后操作 字段中将执行 TO_UPDATE、UPDATING 命令，如果更新成功，则执行 POLLING 命令（证明通信已重新激活），否则将显示 UPDATE_FAILED 命令。在这种情况下，可以通过 按钮重试手动更新。

下载 Tagetik Data Loader 日志

从 Tagetik Data Loader 9.0.0 版本开始，可以直接从 CCH Tagetik 的 Agent 配置窗口通过 按钮下载 TDL 生成的日志，生成一个包含 Karaf 上配置的日志文件夹中所有文件的 zip 文件。此功能仅对版本大于或等于 9.0.0 且状态为在线的 TDL 启用。

在 CCH Tagetik 上的配置

在 CCH Tagetik Repository 的配置中，有与 TDL 使用相关的设置：

数据写入：数据包大小（Kbytes）：指示从 CCH Tagetik 提取并要传输到 Tagetik Data Loader 的数据必须分割并发送的最大大小（以 KBytes 为单位）。

读取数据：数据包大小（Kbytes）：指示从 Tagetik Data Loader 提取并要发送到 CCH Tagetik 的数据必须分割的最大大小（以 KBytes 为单位）。

超时（分钟）：指示 CCH Tagetik 等待 Tagetik Data Loader 响应命令的分钟数。超过此时间后，应用程序将返回"超时"错误。默认时间为 30 分钟。 重要：从 Tagetik Data Loader 9.0.0 版本开始，此超时也将应用于本地 TDL，同时中断当前线程。

端点

要完成 TDL 的配置，需要指定一个用于 ETL 和 Quick Data Loader 的代理类型端点（参见端点）