SAP Analytics Cloud…

在 SAP Analytics Cloud 中设计、构建和调试企业计划应用（计划模型、数据操作、版本管理、日历工作流、数据锁定、分配、价值驱动树、BPC 实时连接、Datasphere 无缝计划）时使用。

适用场景

解决思路

1. 创建计划模型时确保包含必需的 Version 和 Date 维度，推荐加入 Account 维度及其他业务维度；仅需报表时改用 Analytic 模型（只读、无必需维度、性能更好）。
2. 在 Story 中启用计划：添加 Table 控件并关联计划模型，在 Planning 面板中启用 Planning，配置版本选择（公共或私有），设置可编辑的度量/科目、spreading 行为和校验规则。
3. 构建 Analytics Designer 计划应用：创建 Analytic Application（而非 Optimized Story），添加计划模型作为数据源，添加 Table 控件并启用计划，编写脚本处理版本选择、数据提交、自定义校验和工作流触发。
4. 使用 getPlanning() API 进行表级计划操作：isEnabled() 检查是否启用、getPublicVersions()/getPrivateVersion() 获取版本、setUserInput(selection, value) 写入数据、submitData() 提交更改。
5. 使用 PlanningModel API 操作主数据：getMembers() 获取成员及属性、createMembers() 创建成员、updateMembers() 更新成员、deleteMembers() 删除成员。
6. 使用 DataSource API 进行过滤和查询：setDimensionFilter() 设置维度过滤（MDX 语法如 [Version].[parentId].&[public.Actual]）、getMembers() 配合 MemberAccessMode.BookedValues 仅取已记账值、removeDimensionFilter() 移除过滤。
7. 创建数据操作（Data Action）步骤：Copy（在维度/版本间移动数据）、Advanced Formula（复杂计算）、Allocation（基于规则的分配）、Currency Conversion（货币换算）、Embedded Data Action（嵌套执行其他数据操作）。
8. 为数据操作添加参数以实现复用：Member Parameter（选择维度成员）、Number Parameter（数值）、String Parameter（文本，2025+）、Datetime Parameter（日期时间，2025+）。
9. 构建多操作（Multi Action）编排多个计划操作，可用步骤类型包括：Data Action Step、Version Management Step、Predictive Step、Data Import Step、API Step、Data Locking Step、PaPM Step；跨模型时使用公共维度创建跨模型参数共享值。
10. 版本管理：公共版本对所有有权限用户可见、需发布才能更新；私有版本仅创建者可见、用于模拟和 what-if 分析、可发布为公共版本或新版本；编辑公共版本时使用 Edit Mode 临时私有副本，发布时自动校验。
11. 使用 JavaScript 发布版本：getPublicVersion() 获取版本，isDirty() 检查是否有未发布更改，publish() 发布。
12. 配置日历计划工作流：General Task（数据录入）、Review Task（审批）、Composite Task（录入+审批合并）、Data Locking Task（定时锁定/解锁）；通过前置任务配置多级审批链和任务依赖。
13. 配置数据锁定：在计划模型上启用 Data Locking，定义驱动维度（如 Region、Version），分配所有者，通过模型设置配置锁定区域；锁定状态包括 Open、Restricted、Locked、Mixed。
14. 使用脚本检查数据锁定状态：getDataLocking().getState(selection) 获取锁定状态，与 DataLockingState.Locked 比较后决定是否允许编辑。
15. 实现 spreading（纵向）：在父级输入值时自动分配到子成员，支持 Equal Spread（均分）、Proportional Spread（按比例）、Automatic（自动选择）。
16. 实现 distribution（横向）：在同层级成员间移动值，选择源和目标单元格后通过右键菜单或脚本应用分配方法。
17. 在数据操作中配置基于规则的分配：定义驱动科目计算分配百分比，设置分配目标，通过数据操作或多操作执行。
18. 使用 Value Driver Tree 进行驱动因素计划：添加 VDT 控件、选择含 Date 维度的计划模型、添加节点（可从模型自动创建或手动）、配置每个节点的度量和结构、连接节点（驱动因素在右、结果在左）、设置展示日期范围；通过 getSelectedNode().getValue() 获取值，collapseNode()/expandNode() 折叠展开节点。
19. 使用数据操作追踪（Tracing）调试：在 Data Action Designer 中添加 Tracepoint（命名如 "After Copy Step"），点击 Run with Tracing 执行，在 Tracing Results Panel 中查看各追踪点的数据、与前一追踪点的差异、过滤视图；在高级公式中用 TRACE("label") 插入追踪点。
20. 通过 BPC 实时连接运行 BPC 计划序列：setParameterValue() 设置参数，execute() 执行后 refreshData() 刷新表数据；BPC Embedded (S/4HANA) 支持完整计划功能，BPC for NetWeaver 仅只读，BPC Standard 需导出到 BPC。
21. 配置 Datasphere 无缝计划：创建计划模型时选择 SAP Datasphere Space 作为数据存储位置，配置维度（公共维度存储在 Datasphere），在 Model Details 中启用 Expose to Datasphere；跨模型操作的所有模型必须在同一 Datasphere space 中。
22. 运行时动态管理维度成员（Members on the Fly）：createMembers()/updateMembers()/deleteMembers() 操作 Generic 维度（不支持 Account、Version、Time、Organization），更改后调用 Application.refreshData() 刷新，自定义属性使用前缀避免命名冲突。
23. 通过属性查找活动版本：遍历 getMembers("Version")，检查 properties.Active === "X" 找到活动版本。
24. 从计划周期设置过滤器：遍历 getMembers("PlanningCycle") 找到 Flag === "ACTIVE" 的周期，用 setDimensionFilter() 应用 MDX 过滤，期间用 showBusyIndicator()/hideBusyIndicator() 和 setVisible() 优化体验。
25. 执行数据操作：setParameterValue() 设置参数后 execute() 同步执行或 executeInBackground() 后台执行。
26. 优化数据操作性能：使用 Input Controls 链接参数缩小数据范围、嵌入相关操作合并同模型/版本的操作、减少跨模型操作、使用批处理分组操作。
27. 优化 Story 性能：仅在需要的模型上启用数据锁定、大表使用 Growing Mode 分页、限制可见维度减少数据单元格、在数据录入前应用 Story 过滤器。
28. 优化 API 性能：使用 BookedValues 过滤仅取已发布数据、为 getMembers() 设置 limit 参数、缓存成员列表到脚本变量、使用 Busy Indicator 改善感知性能。
29. 排查数据不保存问题：检查表是否启用计划、用户是否有计划权限、数据是否被锁定、校验规则是否失败；用 console.log 输出 isEnabled() 和 getState() 结果调试。
30. 排查版本无法发布问题：检查是否只有有效更改（无效更改会被丢弃）、数据访问控制是否允许写入、版本是否已发布。
31. 排查数据操作失败问题：检查源数据是否存在、目标版本是否可写、维度映射是否正确、参数是否设置正确；使用数据操作追踪表配合 "Show Only Leaves" 选项调试。
32. 排查 getMembers() 返回空问题：检查维度名称是否正确、模型是否连接、用户是否有读权限、是否使用了正确的 API（PlanningModel vs DataSource）。
33. 使用 CDP 进行本地只读浏览器排查：通过 sap-browser-automation 处理浏览器/认证层，加载 references/edge-cdp-control.md 获取计划特定边界；用于检查计划表、控制台错误、数据操作状态和已批准的截图；任何写回、发布、数据操作、多操作或锁定更改交互前必须获得明确批准。
34. 处理 S/4HANA ACDOCP 导出（仅限遗留系统维护）：启用 Legacy Mode、创建带 Cloud Connector 的 S/4HANA 连接、在 Data Management 中创建 Data Export Job、映射维度到 ACDOCP 字段、定义导出范围（FiscalYearPeriod + PlanningCategory 必需）、调度或运行导出；注意导出数据会覆盖范围内现有数据、删除不会传播（需设为 0 再导出）、导出作业创建后无法更改过滤器。
35. 遵循 MDX 语法编写维度过滤器：[Dim].[Hierarchy].&[Member] 格式。
36. 在生产部署前使用追踪测试数据操作，先用简化场景测试再逐步扩展。
37. 使用 AI 辅助数据操作（2026 QRC1）：从自然语言注释生成高级公式脚本，或从现有脚本生成注释。
38. 利用 2026 QRC2 新功能：非对称报表（每行/列可有不同时间范围、层级和度量，支持计划数据录入）、复合版本管理（最多 10 个版本带回滚）、Job Monitor 中的数据导出 API、数据导入服务 API 增强（导入主数据到 Datasphere 公共维度、导入外部事实数据到无缝计划私有版本）、onAfterExecute 事件增强、多操作 API 步骤接受 HTTP 204 响应、日历团队引用保留、Just Ask 中混合高级过滤器。

适用边界 · 注意事项

• 非计划场景（仅需只读报表）应使用 Analytic 模型而非 Planning 模型。
• 非计划类的 SAC 脚本应使用 sap-sac-scripting 技能；Datasphere 建模应使用 sap-datasphere 技能。
• S/4HANA ACDOCP 导出已被 SAP 弃用（2026 Q2 起），新实现不应使用此路径，应改用 write-back 集成场景。
• Members on the Fly 不支持 Account、Version、Time、Organization 维度类型，仅支持 Generic 维度。