mcpField
C
consumer-goods-tpe-dashboard-configure

consumer-goods-tpe-dashboard-configure

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

关于 consumer-goods-tpe-dashboard-configure

此技能面向 Salesforce TPM 系统管理员，通过引导式流程在已认证的 Salesforce 组织中部署 TPE Analytics 仪表板所需组件。流程覆盖权限、数据套件、导出与应用安装，并可选委派 KPI 定制。

主要功能

  1. 01检查组织连接与软件包版本
  2. 02引导确认租户配对和权限
  3. 03部署 TPM Accruals Data Kit
  4. 04配置数据导出并运行数据转换
  5. 05安装 TPE Analytics 应用
  6. 06可选委派自定义 KPI

适用场景

  1. 01在 Salesforce 组织中搭建 TPE 仪表板
  2. 02检查配置阶段并报告阻塞或待处理项

安装

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

$npx skills add https://github.com/forcedotcom/sf-skills --skill consumer-goods-tpe-dashboard-configure

安装后在 Claude Code 中输入/consumer-goods-tpe-dashboard-configure确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
phases-1-6.md
phases-7-12.md
scripts/
find-failure-reason.js
poll-status.js
render-apex.js
run-data-transform.js
schedule-business-period-export.apex
sf-rest.js
soql-escape.js

详细介绍

Consumer Goods TPE Dashboard Configure

通过一次引导式会话，将 TPM 组织从初始状态配置为可运行的 TPE 仪表板。整个过程完全通过 sf CLI + REST/匿名 Apex 操作已通过身份验证的组织，绝不会代替用户使用密码或交互式登录。

角色：负责为其组织设置 TPE 仪表板的 Salesforce TPM System Admin。

其中三个步骤委派给独立的同级技能（各自拥有 SKILL.md 和独立输入，并遵循本仓库技能架构规则自成一体——不共享文件）：

  • Step 7 → consumer-goods-tpe-datakit-deploy
  • Step 9 → consumer-goods-rtr-datacloud-export-configure
  • Step 12 → consumer-goods-tpe-dashboard-custom-kpi-configure（可选，仅当客户想为基础仪表板添加自定义 KPI 时）

其他步骤均直接在此技能中执行。

首先收集的输入

开始前先询问。不要猜测。

  1. TPM System Admin 用户名 — 必须已通过 sf CLI 完成身份验证。使用 node ./scripts/sf-rest.js org-status --target-org <username> 验证（绝不能直接运行 sf org display --json，详见 references/phases-1-6.md）。
  2. 是否试运行？ — 默认提供此选项。试运行期间仍会执行所有读取/验证/检查步骤；跳过所有写入/触发/安装步骤，并记录为 pending — not run (dry-run)。

在 Phase 1 之前，还要检测已安装的软件包命名空间并验证组织版本（必须为 Consumer Goods Cloud >= 262.2），详见 references/phases-1-6.md 中的“Namespace detection”。

阶段列表

PhaseStepSummaryDetails
Setup—收集输入、检测命名空间、验证组织版本references/phases-1-6.md
1租户配对请用户确认 Hyperforce Processing Service 配对（无法通过编程方式验证）references/phases-1-6.md
2TPM Admin 权限集请用户确认已分配组织专属的角色权限集references/phases-1-6.md
3GenieAdmin / TableauEinsteinAdmin查询这两个权限集，并在用户确认后分配references/phases-1-6.md
4SSOT 软件包验证是否已安装 ssot 托管软件包references/phases-1-6.md
5启用 Tableau Next请用户确认已通过 UI 手动启用（无法通过编程方式验证）references/phases-1-6.md
6C360 SDM验证或触发 C360 Unified Semantic Model 应用安装，并轮询状态references/phases-1-6.md
7TPM Accruals Data Kit委派给 consumer-goods-tpe-datakit-deployreferences/phases-7-12.md
8Business Period 导出通过 Hyperforce 底层的 Sales Org 使用匿名 Apex 导出并轮询状态，然后确认 tpmbusinessperiod Data Stream 同步references/phases-7-12.md
9RTR Data Cloud 导出委派给 consumer-goods-rtr-datacloud-export-configurereferences/phases-7-12.md
10TPM_PROMOTION_MEASURE Data Transform先询问（涉及额度消耗），然后运行并轮询 Data Transformreferences/phases-7-12.md
11TPE Analytics App 安装触发并轮询异步 app-framework 安装（约 15-20 分钟）references/phases-7-12.md
12自定义 KPI（可选）委派给 consumer-goods-tpe-dashboard-custom-kpi-configure，仅在用户提出要求时执行references/phases-7-12.md

references/phases-7-12.md 还介绍了共用的 scripts/poll-status.js 轮询器，以及适用于所有阶段的完整硬性规则（绝不代替用户进行身份验证、绝不硬编码命名空间或 Sales Org、只有状态最终成功时才能宣称成功、轮询超时不代表失败等）。

脚本

  • scripts/sf-rest.js — 经过身份验证的 REST 调用；还提供 org-status（打印前会移除 accessToken）。
  • scripts/poll-status.js — 通用异步状态轮询器，供阶段 6 和 11 重用。
  • scripts/find-failure-reason.js — 提取 FailedStatus 应用框架安装中每项要求的实际失败原因（阶段 11），包括检测“DMO 不可用”。
  • scripts/render-apex.js — 使用 --var 替换项渲染匿名 Apex 模板；会加载 scripts/soql-escape.js 来转义替换后的字面量。
  • scripts/soql-escape.js — 转义值，以便安全地插入单引号括起的 SOQL/Apex 字符串字面量中。
  • scripts/run-data-transform.js — 触发并轮询已命名的数据转换（阶段 10）。
  • scripts/schedule-business-period-export.apex — 阶段 8 使用的匿名 Apex 模板。

报告

运行结束时，按阶段（1-12）向用户提供结构化状态：通过 / 受阻 / 待处理，并在适用时说明具体受阻原因和补救操作的点击路径。注明因试运行、用户拒绝确认或（阶段 12）客户选择不自定义 KPI 而跳过的任何内容。

评论

支持 Markdown