data360-harmonize

data360-harmonize：Data Cloud 协调阶段

当用户需要架构协调与统一工作时使用此技能：DMO、字段映射、关系、身份解析、统一档案、数据图或通用 ID 查询。

此技能负责的任务

当工作涉及以下内容时，使用 data360-harmonize：

• sf data360 dmo *
• sf data360 identity-resolution *
• sf data360 data-graph *
• sf data360 profile *
• sf data360 universal-id lookup

以下情况应委派给其他技能：

• 仍在摄取数据流或构建 DLO → data360-prepare
• 正在处理细分逻辑或计算洞察 → data360-segment
• 正在运行 SQL、describe 或搜索索引工作流 → data360-query

---

首先收集所需上下文

询问或推断：

• 源 DLO 和目标 DMO 名称
• 任务是创建架构、映射、IR 还是与图相关
• 目标组织别名
• 是否已存在规则集
• 用户期望的统一实体模型

---

核心操作规则

• 创建映射前检查 DMO 架构。
• 修改协调资源前，先运行共享就绪状态分类器：node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase harmonize --json。
• 浏览目录时优先使用 dmo list --all，但快速检查就绪状态时使用首页 dmo list。
• 使用 query describe 或 dmo get --json，不要臆造不受支持的 describe 流程。
• 将身份解析运行视为异步操作，并在执行后验证结果。
• 将统一档案工作与 STDM/会话跟踪工作分开处理。

---

推荐工作流

1. 为协调工作分类就绪状态

node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase harmonize --json

2. 检查目录

sf data360 dmo list --all -o <org> 2>/dev/null
sf data360 identity-resolution list -o <org> 2>/dev/null

3. 映射前检查架构

sf data360 query describe -o <org> --table ssot__Individual__dlm 2>/dev/null
sf data360 dmo get -o <org> --name ssot__Individual__dlm --json 2>/dev/null

4. 有目的地创建或检查映射

sf data360 dmo mapping-list -o <org> --source Contact_Home__dll --target ssot__Individual__dlm 2>/dev/null
sf data360 dmo map-to-canonical -o <org> --dlo Contact_Home__dll --dmo ssot__Individual__dlm --dry-run 2>/dev/null

5. 仅在映射可靠后运行 IR

sf data360 identity-resolution create -o <org> -f ir-ruleset.json 2>/dev/null
sf data360 identity-resolution run -o <org> --name Main 2>/dev/null

---

高度相关的注意事项

• dmo list 通常应使用 --all。
• 使用 query describe 或 dmo get --json；不存在 dmo describe 命令。
• 映射及相关命令可能受 API 版本差异影响。
• 统一 DMO 名称因规则集而异，并非通用名称。
• 数据图定义对字段选择和关系结构较为敏感。
• 如果 dmo list 可用，但 identity-resolution list 受到限制，应将其视为特定阶段的缺口，而不是整个 Data Cloud 服务中断。

---

输出格式

Harmonize task: <dmo / mapping / relationship / ir / data-graph>
Source/target: <dlo → dmo or ruleset/graph names>
Target org: <alias>
Artifacts: <json files / commands>
Verification: <passed / partial / blocked>
Next step: <segment / retrieve / follow-up>

---

参考

• ../data360-orchestrate/assets/definitions/dmo.template.json
• ../data360-orchestrate/assets/definitions/mapping.template.json
• ../data360-orchestrate/assets/definitions/relationship.template.json
• ../data360-orchestrate/assets/definitions/identity-resolution.template.json
• ../data360-orchestrate/assets/definitions/data-graph.template.json
• ../data360-orchestrate/references/feature-readiness.md