用途
analyzing-omnistudio-dependencies 是一个跨组件的 OmniStudio 分析技能,专注于命名空间检测、依赖关系映射与影响分析。它覆盖 OmniScript、FlexCard、Integration Procedure、Data Mapper 全套组件,执行组织级组件盘点,并自动构建依赖图与 Mermaid 可视化。
该技能不负责编写或修改组件。如需编写 OmniScript 请使用 building-omnistudio-omniscript,构建 FlexCard 请使用 building-omnistudio-flexcard,创建 Integration Procedure 请使用 building-omnistudio-integration-procedure,配置 Data Mapper 请使用 building-omnistudio-datamapper。
主要能力
- 命名空间检测:判断组织使用的是 Core(Industries)、vlocity_cmt(通信、媒体与能源)还是 vlocity_ins(保险与健康)命名空间。
- 组织级组件盘点:统计 OmniScript、Integration Procedure、FlexCard、Data Mapper 的数量(区分激活与草稿)。
- 依赖图构建:使用 BFS 遍历构建组件间的有向依赖边,并检测循环引用。
- 影响分析:确定当某个 OmniScript、IP、FlexCard 或 Data Mapper 变更时,哪些组件会受影响。
- Mermaid 可视化:生成可复制粘贴的 Mermaid graph LR 依赖图,便于文档与评审。
- 多格式输出:每次分析可产出命名空间检测结果、组件清单、依赖图、Mermaid 图、JSON 摘要、人类可读报告以及循环引用警告。
使用方式
开始前需询问或推断以下输入:目标组织别名(默认向用户询问)、分析范围(默认全组织所有 OmniStudio 组件类型)、要影响分析的具体组件(默认无,先产出完整清单)、输出格式偏好(默认三种全出:Mermaid 图 + JSON 摘要 + 人类可读报告)。
工作流为四阶段模式:
-
命名空间检测:按顺序探测对象,直到某个 COUNT() 查询成功返回。Core 命名空间探测
SELECT COUNT() FROM OmniProcess;vlocity_cmt 探测SELECT COUNT() FROM vlocity_cmt__OmniScript__c;vlocity_ins 探测SELECT COUNT() FROM vlocity_ins__OmniScript__c。若都失败,则组织未安装 OmniStudio。可使用 sf data query 命令配合--target-org myorg --json执行。 -
组件发现:根据检测到的命名空间查询各组件类型。Core 示例中,OmniScript 查询 OmniProcess 且
IsIntegrationProcedure = false,IP 查询IsIntegrationProcedure = true,FlexCard 查询 OmniUiCard(注意该对象没有 Definition 字段,应使用 DataSourceConfig 和 PropertySetConfig),Data Mapper 查询 OmniDataTransform,Data Mapper 明细查询 OmniDataTransformItem(外键字段为 OmniDataTransformationId,非 OmniDataTransformId)。大型组织使用 LIMIT/OFFSET 分页。 -
依赖分析:使用带循环检测的 BFS 算法构建有向图。解析 PropertySetConfig JSON 提取元素依赖,例如 DataRaptor Transform/Turbo Action 通过 bundle/bundleName 指向 Data Mapper,Remote Action 通过 remoteClass/remoteMethod 指向 Apex 类,Integration Procedure Action 通过 integrationProcedureKey 指向 IP,OmniScript Action 通过 omniScriptKey 或 Type/SubType 指向 OmniScript,HTTP Action 通过 httpUrl/httpMethod 指向外部端点,DocuSign Envelope Action 通过 docuSignTemplateId 指向 DocuSign 模板。FlexCard 解析 DataSourceConfig JSON,注意 IP 数据源类型为
IntegrationProcedures(复数),ApexRemote 通过 className 指向 Apex 类,子卡通过 PropertySetConfig 解析。Data Mapper 通过明细项的 InputObjectName(读)和 OutputObjectName(写)指向 sObject。 -
可视化与报告:生成 Mermaid 依赖图(含配色方案:OmniScript 蓝色、Integration Procedure 琥珀色、Data Mapper 绿色、FlexCard 粉色、Apex Class 紫色、外部 HTTP 石板色)、JSON 摘要(含命名空间、组件计数、依赖列表、循环引用、影响分析)以及人类可读报告(含组件清单、依赖汇总、最多被依赖组件排序)。
适用场景
适用于 Salesforce OmniStudio 项目的维护、审计和变更影响评估。该技能在多个 OmniStudio 技能协作时优先运行,用于建立下游技能所消费的命名空间上下文和依赖映射。推荐编排顺序为:analyzing-omnistudio-dependencies → building-omnistudio-datamapper → building-omnistudio-integration-procedure → building-omnistudio-omniscript → building-omnistudio-flexcard。
限制与注意事项
- 三个命名空间可能共存,迁移中的组织可能返回多个结果,组件可能同时存在于旧命名空间和迁移后的命名空间中。
- IsIntegrationProcedure 布尔字段和 DataSourceConfig(非 Definition)字段名仅存在于 Core 命名空间。
- Data Mapper 明细的外键字段是 OmniDataTransformationId(完整单词 Transformation)。
- FlexCard 的 IP 数据源类型是 IntegrationProcedures(复数),不是 IntegrationProcedure。
- 循环引用可能发生,例如 OmniScript A → IP B → 通过嵌入调用回到 OmniScript A。
- 只有激活组件参与运行时依赖链,但非激活组件及其依赖仍会纳入依赖图并标记为非激活。
- 关键洞察:依赖存储在 JSON 中(PropertySetConfig 的元素、FlexCard 的 DataSourceConfig、Data Mapper 的 InputObjectName/OutputObjectName)。
- 完整的三命名空间对象、字段和元数据类型映射需参考 references/namespace-guide.md;完整依赖提取规则和示例需参考 references/dependency-patterns.md。这些参考文件的详细内容暂未提供。