SuperAPI AI 工具集

connect-ai-workday

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能为通过 CData Connect AI 查询 Workday 数据提供 Workday 专属指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言与三段式查询命名约定。

前置条件:必须先定位并阅读 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止,告知用户需先安装并启用该技能。本技能取代 Workday 驱动的 getInstructions,不要调用它,识别连接后直接进行 schema 发现(getSchemas / getTables / getColumns)。

主要能力:Workday 是多 schema 类型驱动,有四种连接类型,由 ConnectionType 属性设置,决定 schema 列表、数据模型、写入支持与查询流程,且无法从连接名推断。REST 暴露多个功能区域 schema,支持插入/更新/有限删除;WQL 只读,单一 WQL schema;Reports(RaaS)只读,需 CustomReportURL,单一 Reports schema;SOAP 为旧版,使用下划线分隔的功能区域 schema。

使用方式:第一步始终先运行 getSchemas 判断连接类型——仅返回 WQL 即 WQL;仅返回 Reports 即 Reports;返回多个下划线分隔 schema 即 SOAP;返回多个 PascalCase 功能 schema 即 REST。第二步加载对应参考文件(references/rest.md、wql.md、reports.md、soap.md)。三段式名称为 [Catalog].[Schema].[Table]。许多表和数据源需要 prompt 列(_Prompt 后缀)才能返回数据,需先用 getColumns 查看,再通过值表解析 GUID;日期和布尔 prompt 用字面值。值表以 Values 结尾,含 Id、Descriptor、CollectionToken、Collection_Prompt 列,可逐层下钻,CollectionToken 为 NULL 即叶子。列名用 [] 引用。

适用场景:在 CData Connect AI 中查询 Workday 的 REST、WQL、Reports 或 SOAP 数据。

限制:WQL 与 Reports 设计为只读,无法改为可写;仅 REST 支持写入(在 Workday API 允许范围内)。schema、表位置与列名因租户、启用模块和驱动版本而异,须在实时连接上确认,不要假设。不要猜测 _Prompt GUID。具体各连接类型的完整数据模型与示例查询见对应参考文件,本资料未提供其内容。