consumer-goods-tpe-dashboard-configure

Consumer Goods TPE Dashboard Configure

sf CLI + REST／anonymous-Apex のみを使用し、すでに認証済みの org に対して、何も設定されていない状態から稼働中の TPE ダッシュボードまでを、1 回のガイド付きセッションで構築します。ユーザーに代わってパスワードを使用したり、対話型ログインを実行したりすることはありません。

ペルソナ：自身の org に TPE ダッシュボードを設定する Salesforce TPM システム管理者。

12 ステップのうち 3 ステップを、単独で動作する兄弟スキルに委任します（それぞれ独自の 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 システム管理者のユーザー名 — 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 の前に、インストール済みパッケージの名前空間も検出し、org のバージョン要件を確認してください（Consumer Goods Cloud >= 262.2 が必要です）。references/phases-1-6.md の「Namespace detection」を参照してください。

フェーズ一覧

フェーズ	ステップ	概要	詳細
Setup	—	入力を収集し、名前空間を検出して、org のバージョン要件を確認します	references/phases-1-6.md
1	テナントのペアリング	Hyperforce Processing Service のペアリングについて、ユーザーに確認を求めます（プログラムでは検証できません）	references/phases-1-6.md
2	TPM 管理者権限セット	org 固有のペルソナ権限セットが割り当てられていることを、ユーザーに確認してもらいます	references/phases-1-6.md
3	GenieAdmin／TableauEinsteinAdmin	これら 2 つの権限セットを照会し、確認後に割り当てます	references/phases-1-6.md
4	SSOT パッケージ	ssot 管理パッケージがインストールされていることを確認します	references/phases-1-6.md
5	Tableau Next の有効化	手動で UI を有効化したことを、ユーザーに確認してもらいます（プログラムでは検証できません）	references/phases-1-6.md
6	C360 SDM	C360 Unified Semantic Model アプリのインストールを確認するか、開始して完了までポーリングします	references/phases-1-6.md
7	TPM Accruals Data Kit	consumer-goods-tpe-datakit-deploy に 委任	references/phases-7-12.md
8	Business Period のエクスポート	Hyperforce 基盤の Sales Org 経由で anonymous-Apex によるエクスポートを行い、完了までポーリングした後、tpmbusinessperiod Data Stream の同期を確認します	references/phases-7-12.md
9	RTR Data Cloud のエクスポート	consumer-goods-rtr-datacloud-export-configure に 委任	references/phases-7-12.md
10	TPM_PROMOTION_MEASURE Data Transform	質問（クレジット消費について）した後、Data Transform を実行して完了までポーリングします	references/phases-7-12.md
11	TPE Analytics App のインストール	非同期のアプリケーションフレームワークのインストールを開始し、完了までポーリングします（約 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 呼び出しです。出力前に accessToken を除去する org-status も公開します。
• scripts/poll-status.js — 汎用の非同期ステータスポーラーです。フェーズ 6 と 11 で再利用されます。
• scripts/find-failure-reason.js — アプリケーションフレームワークのインストールが FailedStatus になった場合に、要件ごとの実際の失敗理由を抽出します（フェーズ 11）。「DMO not available」の検出も含みます。
• scripts/render-apex.js — --var による置換を使用して、匿名 Apex テンプレートをレンダリングします。置換するリテラルをエスケープするために scripts/soql-escape.js を読み込みます。
• scripts/soql-escape.js — 単一引用符で囲まれた SOQL/Apex 文字列リテラルに安全に埋め込めるよう、値をエスケープします。
• scripts/run-data-transform.js — 名前を指定した Data Transform を実行し、ステータスをポーリングします（フェーズ 10）。
• scripts/schedule-business-period-export.apex — フェーズ 8 用の匿名 Apex テンプレートです。

レポート

実行の最後に、各フェーズ（1〜12）のステータスを、具体的なブロック理由と該当する場合は修正のためのクリックパスを添えて、パス／ブロック中／保留としてユーザーに提示してください。ドライラン、確認の辞退、または（フェーズ 12 で）KPI のカスタマイズを顧客が希望しなかったためにスキップした項目があれば、明記してください。