# 子需求索引 ## 概述 本文档索引了所有 API 实现的子需求文档，按照开发优先级排序。 --- ## PartnerAPI 源 org 实现（需求编号：001） ### 1. 认证和会话管理（001-01） - **文件**: [2026-01-28-001-01-认证和会话管理.md](./2026-01-28-001-01-认证和会话管理.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: Login、Logout、ChangeOwnPassword、SessionHeader - **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 2. CRUD 操作（001-02） - **文件**: [2026-01-28-001-02-CRUD操作.md](./2026-01-28-001-02-CRUD操作.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: Create、Retrieve、Update、Delete、Upsert、Merge - **依赖项**: 子需求 001-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 3. 批量操作（001-03） - **文件**: [2026-01-28-001-03-批量操作.md](./2026-01-28-001-03-批量操作.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: Create 批量、Update 批量、Delete 批量、Upsert 批量 - **依赖项**: 子需求 001-01、子需求 001-02、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 4. 查询功能（001-04） - **文件**: [2026-01-28-001-04-查询功能.md](./2026-01-28-001-04-查询功能.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: Query、QueryAll、QueryMore、Search - **依赖项**: 子需求 001-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 5. 描述功能（001-05） - **文件**: [2026-01-28-001-05-描述功能.md](./2026-01-28-001-05-描述功能.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: DescribeGlobal、DescribeSObject、DescribeSObjects、DescribeLayout、DescribeTabs、DescribeQuickActions - **依赖项**: 子需求 001-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 6. 高级功能（001-06） - **文件**: [2026-01-28-001-06-高级功能.md](./2026-01-28-001-06-高级功能.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: ConvertLead、EmptyRecycleBin、ProcessSubmitRequest、GetUserInfo、GetServerTimestamp - **依赖项**: 子需求 001-01、子需求 001-02、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 --- ## ApexAPI 源 org 实现（需求编号：002） ### 1. 连接管理（002-01） - **文件**: [2026-01-28-002-01-连接管理.md](./2026-01-28-002-01-连接管理.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: Connector、SoapConnection、SessionHeader、CallOptions、DebuggingHeader - **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 2. Apex 代码编译和执行（002-02） - **文件**: [2026-01-28-002-02-Apex代码编译和执行.md](./2026-01-28-002-02-Apex代码编译和执行.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: CompileClasses、CompileTriggers、CompileAndTest、ExecuteAnonymous、CompileClassResult、CompileTriggerResult、CompileIssue - **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 3. 测试执行（002-03） - **文件**: [2026-01-28-002-03-测试执行.md](./2026-01-28-002-03-测试执行.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: RunTests、RunTestsRequest、RunTestsResult、RunTestSuccess、RunTestFailure - **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 4. 代码覆盖率（002-04） - **文件**: [2026-01-28-002-04-代码覆盖率.md](./2026-01-28-002-04-代码覆盖率.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: CodeCoverageResult、CodeCoverageWarning、CodeLocation - **依赖项**: 子需求 002-01、子需求 002-03、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 5. Flow 覆盖率（002-05） - **文件**: [2026-01-28-002-05-Flow覆盖率.md](./2026-01-28-002-05-Flow覆盖率.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: FlowCoverageResult、FlowCoverageWarning - **依赖项**: 子需求 002-01、子需求 002-03、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 6. 日志记录（002-06） - **文件**: [2026-01-28-002-06-日志记录.md](./2026-01-28-002-06-日志记录.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: LogInfo、LogType、LogCategory、LogCategoryLevel - **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 7. WSDL 转换（002-07） - **文件**: [2026-01-28-002-07-WSDL转换.md](./2026-01-28-002-07-WSDL转换.md) - **优先级**: 低 - **状态**: 待开始 - **核心功能**: WsdlToApexInfo、WsdlToApexResult - **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 --- ## MetadataAPI 源 org 实现（需求编号：003） ### 1. 连接管理（003-01） - **文件**: [2026-01-28-003-01-连接管理.md](./2026-01-28-003-01-连接管理.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: Connector、MetadataConnection、SessionHeader、CallOptions - **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 2. 元数据类型定义（003-02） - **文件**: [2026-01-28-003-02-元数据类型定义.md](./2026-01-28-003-02-元数据类型定义.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: 核心组件类型、配置类型、分析类型、AI 和自动化类型、UI 和用户体验类型 - **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 3. 部署操作（003-03） - **文件**: [2026-01-28-003-03-部署操作.md](./2026-01-28-003-03-部署操作.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: DeployOptions、DeployResult、DeployMessage、DeployDetails、DeployStatus - **依赖项**: 子需求 003-01、子需求 003-02、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 4. 异步操作（003-04） - **文件**: [2026-01-28-003-04-异步操作.md](./2026-01-28-003-04-异步操作.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: AsyncResult、AsyncRequestState - **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 5. 删除操作（003-05） - **文件**: [2026-01-28-003-05-删除操作.md](./2026-01-28-003-05-删除操作.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: DeleteResult - **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 6. 检索操作（003-06） - **文件**: [2026-01-28-003-06-检索操作.md](./2026-01-28-003-06-检索操作.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: RetrieveRequest、RetrieveResult、RetrieveMessage - **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 7. 检查部署和检索状态（003-07） - **文件**: [2026-01-28-003-07-检查部署和检索状态.md](./2026-01-28-003-07-检查部署和检索状态.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: CheckDeployStatus、CheckRetrieveStatus - **依赖项**: 子需求 003-01、子需求 003-03、子需求 003-06、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 8. 描述和列出元数据（003-08） - **文件**: [2026-01-28-003-08-描述和列出元数据.md](./2026-01-28-003-08-描述和列出元数据.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: DescribeMetadataResult、DescribeValueType、ListMetadataQuery、ListMetadataResult、ListMetadata - **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 --- ## ToolingAPI 源 org 实现（需求编号：004） ### 1. 连接管理（004-01） - **文件**: [2026-01-28-004-01-连接管理.md](./2026-01-28-004-01-连接管理.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: Connector、ToolingConnection、SessionHeader、CallOptions、DebuggingHeader - **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 2. 元数据操作（004-02） - **文件**: [2026-01-28-004-02-元数据操作.md](./2026-01-28-004-02-元数据操作.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: 自定义对象和字段、Apex 组件、Flow 和自动化 - **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 3. 开发工具功能（004-03） - **文件**: [2026-01-28-004-03-开发工具功能.md](./2026-01-28-004-03-开发工具功能.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: 诊断和调试、查询和搜索 - **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 4. AI 和智能功能（004-04） - **文件**: [2026-01-28-004-04-AI和智能功能.md](./2026-01-28-004-04-AI和智能功能.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: AI 应用、AI 评估、AI 创作 - **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 5. 动作和自动化（004-05） - **文件**: [2026-01-28-004-05-动作和自动化.md](./2026-01-28-004-05-动作和自动化.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: 动作定义、可操作列表、动作任务 - **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 6. 访问和安全（004-06） - **文件**: [2026-01-28-004-06-访问和安全.md](./2026-01-28-004-06-访问和安全.md) - **优先级**: 中 - **状态**: 待开始 - **核心功能**: 访问控制、连接器 - **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 7. 高级功能（004-07） - **文件**: [2026-01-28-004-07-高级功能.md](./2026-01-28-004-07-高级功能.md) - **优先级**: 低 - **状态**: 待开始 - **核心功能**: 聚合和计算、预测和预测、激活和应用 - **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ### 8. SOQL 查询功能（004-08） - **文件**: [2026-01-28-004-08-SOQL查询功能.md](./2026-01-28-004-08-SOQL查询功能.md) - **优先级**: 高 - **状态**: 待开始 - **核心功能**: query、queryMore、支持所有 Tooling API 对象的查询、支持复杂的查询条件、排序、分页 - **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类 ## 开发顺序建议 ### 第一阶段（高优先级） 1. **001-01：认证和会话管理** - 基础功能，其他子需求都依赖它 2. **001-02：CRUD 操作** - 核心数据操作功能 3. **001-03：批量操作** - 批量数据操作功能，依赖 CRUD 操作 4. **001-04：查询功能** - 数据查询功能 ### 第二阶段（中优先级） 5. **001-05：描述功能** - 元数据描述功能 6. **001-06：高级功能** - 高级业务功能，依赖 CRUD 操作 ### ApexAPI 源 org 实现（需求编号：002） #### 第一阶段（高优先级） 1. **002-01：连接管理** - 基础功能，其他子需求都依赖它 2. **002-02：Apex 代码编译和执行** - 核心编译和执行功能 3. **002-03：测试执行** - 测试执行功能 #### 第二阶段（中优先级） 4. **002-04：代码覆盖率** - 代码覆盖率分析 5. **002-05：Flow 覆盖率** - Flow 覆盖率分析 6. **002-06：日志记录** - 日志记录功能 #### 第三阶段（低优先级） 7. **002-07：WSDL 转换** - WSDL 转换功能 ### MetadataAPI 源 org 实现（需求编号：003） #### 第一阶段（高优先级） 1. **003-01：连接管理** - 基础功能，其他子需求都依赖它 2. **003-02：元数据类型定义** - 核心元数据类型定义功能 3. **003-03：部署操作** - 核心部署功能 4. **003-04：异步操作** - 异步操作功能 #### 第二阶段（中优先级） 5. **003-05：删除操作** - 删除操作功能 6. **003-06：检索操作** - 检索操作功能 7. **003-07：检查部署和检索状态** - 状态检查功能 8. **003-08：描述和列出元数据** - 描述和列出功能 ### ToolingAPI 源 org 实现（需求编号：004） #### 第一阶段（高优先级） 1. **004-01：连接管理** - 基础功能，其他子需求都依赖它 2. **004-02：元数据操作** - 核心元数据操作功能 3. **004-03：开发工具功能** - 诊断和调试功能 4. **004-08：SOQL 查询功能** - 核心查询功能（Tooling API 的核心特性） #### 第二阶段（中优先级） 5. **004-04：AI 和智能功能** - AI 应用、评估和创作功能 6. **004-05：动作和自动化** - 动作定义和自动化功能 7. **004-06：访问和安全** - 访问控制和安全配置 #### 第三阶段（低优先级） 8. **004-07：高级功能** - 聚合、预测和激活功能 ## 技术约束 所有子需求必须遵守以下技术约束： - 直接使用 `partner.jar` 中的现有类 - 使用 `datai-salesforce-auth` 的 SessionManager 管理会话 - 优先使用 `datai-salesforce-common` 模块中的现有异常 - 提供 Service 层和 Controller 层（REST API） - 不进行不必要的二次封装 ## 成功标准 每个子需求必须满足以下成功标准： 1. 实现所有核心功能 2. 正确处理各种异常情况，使用合适的异常类 3. 代码符合项目规范，无编译错误和警告 4. 通过单元测试