SuperAPI AI 工具集

connect-ai-dynamics365businesscentral

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能为通过 CData Connect AI 查询 Dynamics 365 Business Central(BC)数据提供专门指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言与查询命名约定。使用前必须先定位并阅读 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止任务并提示用户安装启用后再继续。

主要能力:覆盖 BC Common Service API(/api/v2.0 端点)的数据模型,该端点暴露 Microsoft 定义的稳定表集,表名采用小写 camelCase,如 customers、salesOrders、generalLedgerEntries。每个公司对应一个独立 schema,需先运行 getSchemas 发现公司,再对目标公司 schema 使用 getTables 探索表、getColumns 检查列。查询必须使用三部分名称,两部分名称或中间为空均会失败;公司名常含空格、逗号、句点(如 [Contoso, Ltd.]),须按 getSchemas 返回原样加方括号引用。

数据模型:主数据含 customers、vendors、items;销售文档含 salesQuotes/salesQuoteLines、salesOrders/salesOrderLines、salesInvoices/salesInvoiceLines、salesCreditMemos 及其行表;采购文档含 purchaseOrders、purchaseInvoices、purchaseCreditMemos 及行表,purchaseQuotes 为只读视图。总账含 accounts、generalLedgerEntries(均为视图)、journals、journalLines。财务报表含 agedAccountsReceivables、agedAccountsPayables、balanceSheets、incomeStatements、cashFlowStatements、trialBalances。行表通过 documentId 关联表头。

使用方式:先 getCatalogs 识别 BC 连接,再 getSchemas 识别公司,然后 getTables/getColumns 发现结构。TABLE_TYPE 是可靠的可写信号:TABLE 可写,VIEW 只读。查询示例:SELECT * FROM [YourConnection].[YourCompany].[customers] LIMIT 10。存储过程 RequestRawValue 可分两步拉取文档 PDF:先从 pdfDocument 视图取 pdfDocumentContent 链接,再将其作为 MediaReadLink 传入。

限制:不要调用 BC 驱动的 getInstructions,本技能已完全替代。列元数据中的 Readonly 标志不可靠,许多服务端管理字段虽标记为 false 却不可写。remainingAmount 为计算字段,不能用于 ORDER BY。若 getTables 结果出现混合大小写、Power_BI_* 前缀或自定义租户页面名,说明连接使用 Web Services(/ODataV4)端点,不在本技能覆盖范围。