mcpField
L
life-sciences-prerequisites-validate

life-sciences-prerequisites-validate

github.com/forcedotcomテスト・品質1.1k89 回インストール1 日前に更新
リポジトリ

life-sciences-prerequisites-validate について

Salesforce CLI で Salesforce org が Life Sciences Cloud for Customer Engagement の前提条件を満たすか確認するスキルです。管理者向けに 12 分類の結果と対処手順を報告し、org の設定は変更しません。

主な機能

  1. 01org 設定と機能フラグの確認
  2. 02ユーザー権限と共有設定の検証
  3. 0312 分類すべての前提条件を確認
  4. 04PASS、FAIL、WARNING を報告
  5. 05不備への対処手順を提示

活用シーン

  1. 01デプロイ前の org 準備状況の評価
  2. 02Life Sciences Cloud の前提条件の調査
  3. 03管理者向け修正チェックリストの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/forcedotcom/sf-skills --skill life-sciences-prerequisites-validate

インストール後、Claude Code で/life-sciences-prerequisites-validateを入力して読み込まれたか確認します。

同梱ファイルreferences/checks-org-settings.mdreferences/checks-user-and-package.md

詳細

ライフサイエンスクラウドの前提条件の検証

Salesforce 組織が Life Sciences Cloud for Customer Engagement のすべての前提条件を満たしているか検証します。現在認証済みの組織に対して sf CLI でチェックを実行し、失敗項目がある場合は修正手順を含む、合格/不合格をまとめたレポートを生成します。

対象範囲

  • 対象:Life Sciences Cloud CE に必要な組織設定、ユーザー権限、OWD 共有、機能の切り替え設定の検証
  • 対象外:検証に失敗した設定の自動有効化や構成
対象外のリクエスト

ユーザーがこのスキルと無関係なことを依頼した場合(開始時または実行中を問いません)は、対応しないでください。リクエストの内容を理解できなかったと伝え、対応可能な内容として Life Sciences Cloud 組織の前提条件の検証(このスキル)を提示してください。また、関連する場合は、テリトリーの設定には life-sciences-territory-configure、エンドツーエンドの完全なセットアップには life-sciences-fieldsalesrep-coordinate を案内してください。その後、停止してユーザーの返答を待ちます。


必要な入力

作業を進める前に、以下を確認します。

  • 対象組織:検証する組織のエイリアスまたはユーザー名(sf config get target-org から取得するか、ユーザーが指定)
  • 確認:ログイン中のユーザーが、検証対象となるプロファイルと権限セットを持つ管理者であること

ワークフロー

すべてのチェックを順番に実行します。最終レポートを提示する前に、すべての結果を収集します。

フェーズ 1 — 環境の検証
  1. 組織への接続を確認する — sf org display --target-org <org> を実行して、組織にアクセスできることを確認します。失敗した場合は停止し、ユーザーに認証を依頼します。

  2. ログイン中のユーザーを特定する — 組織の表示出力からユーザー名を取得します。

フェーズ 2 — すべての前提条件チェックを実行する

以下のチェックをそれぞれ実行します。各チェックについて、PASS または FAIL と、修正手順を記録します。チェックでは、参照ファイルおよび最終レポートで使用されている標準の Check 1 – Check 12 の番号を使用します。管理パッケージのチェックは番号のないハードストップゲートであり、12 の評価カテゴリには含まれません。Check 1~3(および管理パッケージゲート)は references/checks-user-and-package.md に、Check 4~12 は references/checks-org-settings.md にあります。

STOP-GATE(レポートの完全性)。 すべてのチェックについて、最終レポートに行を必ず含めてください。エラーが発生したチェック(例:Multi-Currency が HTTP 400 INVALID_TYPE を返す場合や、オブジェクトがデプロイされていない場合)は、必ず FAIL の行として記載します。行を省略したり、実行を中止する理由にしたりしてはいけません。レポートの行数は、評価対象のチェック数全体(12 カテゴリ、Check 1~Check 12)と必ず一致させてください。正当に早期終了できるのは、管理パッケージゲート(番号のない lsc4ce パッケージチェック、以下の手順 4)のみです。このゲートでは、実行を中止して「BLOCKED」メッセージを表示します。それ以外の場合、クエリエラーは FAIL のシグナルです。記録したうえで続行してください。単一の 4xx または予期しない形式のレスポンスによって、行が気づかれないまま抜け落ちたり、チェック全体が中断されたりしないようにしてください。短いレポートは、実際には「確認できていない」だけなのに、「修正すべき項目が少ない」と受け取られてしまいます。

  1. Check 1 — ユーザープロファイルと権限セット — 正確なクエリと検証ロジックについては、references/checks-user-and-package.md の「User Profile and Permission Sets」セクションを参照してください。

  2. 管理パッケージゲート(番号のないハードストップ) — references/checks-user-and-package.md の「Managed Package Check」セクションを参照してください。lsc4ce パッケージがインストールされていない場合は、失敗メッセージを表示して停止します。残りのチェックには進みません。

  3. Check 2 — Life Sciences CE 設定 — 正確なクエリについては、references/checks-user-and-package.md の「Life Sciences Customer Engagement Setup」セクションを参照してください。

  4. Check 3 — Surveys の有効化 — references/checks-user-and-package.md の「Surveys」セクションを参照してください。

  5. Check 4 — OWD 共有設定 — 対象オブジェクトと期待値については、references/checks-org-settings.md の「OWD Sharing」セクションを参照してください。

  6. Check 5 — Inventory Count — references/checks-org-settings.md の「Inventory Count」セクションを参照してください。

  7. Check 6 — Sales Account Plans — references/checks-org-settings.md の「Sales Account Plans」セクションを参照してください。

  8. Check 7 — Care Plans — references/checks-org-settings.md の「Care Plans」セクションを参照してください。

  9. Check 8 — Chatter 設定 — references/checks-org-settings.md の「Chatter Settings」セクションを参照してください。

  10. Check 9 — データ保護とプライバシー — references/checks-org-settings.md の「Data Protection and Privacy」セクションを参照してください。

  11. Check 10 — 複数通貨 — references/checks-org-settings.md の「Multiple Currencies」セクションを参照してください。

  12. Check 11 — 州および国/地域の選択リスト — references/checks-org-settings.md の「State and Country/Territory Picklists」セクションを参照してください。

  13. Check 12 — 個人取引先 — references/checks-org-settings.md の「Person Accounts」セクションを参照してください。

フェーズ 3 — レポート
  1. 統合レポートを作成する — 結果を表にまとめて提示します。
| # | Prerequisite                              | Status | Remediation (if failed/warning)  |
|---|-------------------------------------------|--------|----------------------------------|
| 1 | System Administrator + Permission Sets    | PASS/FAIL | <steps if failed>            |
| 2 | Life Sciences CE Enabled                  | PASS/FAIL | <steps if failed>            |
| ...                                                                                       |

ステータスには PASS、FAIL、または WARNING を使用します。ほとんどのチェックは PASS/FAIL です。OWD Sharing チェック(Check 4)は WARNING レベルです。値が期待値と異なる場合は、FAIL ではなく WARNING として報告し、修正欄に推奨値を記載してください。正確なルールについては、references/checks-org-settings.md を参照してください。

次の形式で概要行を含めます:12 個の前提条件のうち X 個が合格しました。Y 個は対応が必要です(うち Z 件は警告)。

すべて合格した場合は、組織が Life Sciences Cloud のデプロイに対応できていることを確認します。


ルール/制約

制約理由
最初のチェックで失敗しても、すべてのチェックを実行する管理者が一度の対応で問題を解決できるよう、全体像を把握する必要があります
すべてのクエリで --target-org を指定して sf CLI を使用する複数の組織で認証済みの場合も、正しい組織のコンテキストを確実に使用できます
組織の設定は変更しないこのスキルは検証のみを行い、設定の有効化や構成は行いません
Setup の正確なナビゲーションパスを報告する管理者が Setup UI のどこをクリックすればよいか把握する必要があります

注意点

問題対処
Metadata API ではクエリできない設定がありますMetadata API で対応していない場合は、Tooling API または組織設定のクエリを使用します
Person Accounts は有効化後に無効化できません有効かどうかのみを確認します。元に戻す方法はありません
Multiple Currencies は有効化後に無効化できません有効化済みかどうかのみを確認します。有効化を推奨する場合は、取り消せないことを警告します
State/Country Picklists の有効化は取り消せません修正手順にこの警告を含めます

出力内容

成果物:

  • 12 の前提条件カテゴリすべてについて、合格/不合格のステータスを示した書式付きテーブル
  • 不合格となった各チェックの修正手順(Setup のナビゲーションパスと操作)
  • 合格数と不合格数の概要

参照ファイル一覧

ファイル参照するタイミング
references/checks-user-and-package.mdPhase 2(チェック 3~6)で参照します。ユーザープロファイル/権限セット、管理パッケージ、Life Sciences CE 機能、およびアンケートのチェックに関する正確な sf CLI コマンド、期待値、修正方法が記載されています
references/checks-org-settings.mdPhase 2(チェック 7~15)で参照します。OWD の共有、在庫、アカウントプラン、ケアプラン、Chatter、データ保護、通貨、選択リスト、および個人アカウントのチェックに関する正確な sf CLI コマンド、期待値、修正方法が記載されています

コメント