mcpField
H
harmonizing-datacloud

harmonizing-datacloud

github.com/forcedotcom数据与数据库1.1k2.5k 次安装1 天前更新
代码仓库

关于 harmonizing-datacloud

面向 Salesforce Data Cloud 数据协调的技能，涵盖数据模型对象、字段映射、身份解析、统一档案和数据图，并指导架构检查及协调工作流。

主要功能

  1. 01数据模型对象检查
  2. 02字段映射工作流
  3. 03身份解析规则集
  4. 04统一档案工作流
  5. 05数据图管理

适用场景

  1. 01检查源与目标架构
  2. 02将源数据映射到标准模型
  3. 03执行身份解析

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/forcedotcom/sf-skills --skill harmonizing-datacloud

安装后在 Claude Code 中输入/harmonizing-datacloud确认已加载。

附带文件CREDITS.mdREADME.md

详细介绍

harmonizing-datacloud：Data Cloud 协调阶段

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

此技能负责的任务

当工作涉及以下内容时，使用 harmonizing-datacloud：

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

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

首先收集所需上下文

询问或推断：

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

核心操作规则

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

建议工作流

1. 分类 harmonize 工作的就绪情况
node ../orchestrating-datacloud/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>

参考资料

评论

支持 Markdown