用途:该技能为通过 CData Connect AI 查询 Sage Intacct 数据提供专门指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言与三段式查询命名约定。
前置条件:使用前必须定位并阅读 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止,告知用户需先安装并启用该技能。本技能取代 Sage Intacct 驱动的 getInstructions,不要再调用它,直接进入 getSchemas 与后续模式发现。
主要能力与用法:Sage Intacct 连接会呈现两种完全不同的 API 表面,由 CData Schema 连接属性决定,无法从连接名推断。第一步必须对连接运行 getSchemas:返回 SageIntacct 为 XML 表面,返回 SageIntacctRest 为 REST 表面。随后加载对应参考:XML 对应 references/xml.md,REST 对应 references/rest.md。三段式名称为 [Catalog].[Schema].[Table],中间段是模式名而非连接名。
两表面差异:XML 表面使用小写旧式对象名(如 Glaccount、Gldetail、Arinvoice、Apbill、Customer、Vendor),有约 14 个存储过程(如 ReverseInvoice、VoidAPPayment、AccountBalanceReport);REST 表面使用 PascalCase 实体(如 Account、Invoice、Bill、JournalEntryLine)与 camelCase 列,无存储过程。XML 表面还有 UseLegacy 属性,查询时不可见,SQL 写法相同,仅性能不同:新实现将 WHERE、ORDER BY、OFFSET 与聚合下推到服务端,旧实现客户端模拟,较慢且易超时。
通用约定:先识别表面;主数据按状态过滤,交易记录按日期过滤;交易表必须加日期条件以避免超时;部门、地点、项目、类别、客户、供应商、物料为维度;多币种区分本位币与交易币金额;查询前用 getColumns 确认列名,因租户含大量自定义字段且两表面列名差异大。
限制:资料未提供具体收费、价格、平台支持范围或效果数据。