組織間のコンポーネントのリリースでエラーが発生した際のトラブルシューティングガイド

はじめにエラーに関する基本的な情報を確認し、記録します。

エラーに関する基本的な情報

• エラーが発生した具体的な時刻 (例: 2025/06/10 17:00:00 - 17:00:30)
  ※問い合わせ時には タイムゾーンを併記してください。 
• 特定の組織でのみ発生するか
• 特定のユーザーでのみ発生するか
• 特定のコンポーネントでのみ発生するか
• 以前はリリースできていたが急に動作しなくなったか／はじめてリリースをおこなうコンポーネントか
• 画面上にエラーメッセージが表示されているか

切り分けポイント

• デプロイ元の組織とデプロイ先の組織の環境（バージョン、ライセンス、設定の有効化状況など）が一致しているか
• コンポーネントを最小限の組み合わせに絞った場合もエラーが発生するか
• コンポーネントが依存関係を満たしているか
• 作業を実施しているユーザーが対象のコンポーネントのリリースに必要な権限を有しているか（関連ドキュメント）
• Metadata Coverage Report にて、デプロイを試みているコンポーネントとデプロイ方法の組み合わせが有効か

Salesforce CLI での作業時には追加で以下のポイントを確認してください。

• Salesforce CLI (sf コマンド) は最新か (関連ドキュメント)
• 端末 - Salesforce 組織間にネットワーク接続の問題がないか
• sfdx-project.json ファイルの sourceApiVersion は適切に設定されているか

DevOps Center での作業時には追加で以下ポイントを確認してください。

• 関連ドキュメントに記載のあるエラーか
• 作業ユーザーの言語設定を英語に変更してもエラーが発生するか

上記ガイドの内容をすべて確認しても問題が解決しない場合、下記の内容に沿ってお客様環境における調査のための情報および弊社検証環境で事象を再現するための情報を提供してください。

サポートに提供する情報

• リリース元組織 ID
• リリース先組織 ID
• リリース先組織の [リリース状況] ページから確認できるリリース名 (0Af で始まる ID) 
• リリース方法 (変更セット・メタデータAPI・DevOps Center など)
• 具体的なエラー再現手順
• 上記『エラーに関する基本的な情報』で取得した情報 (直近の発生日時、発生範囲、メッセージ内容など)
• 上記『切り分けポイント』で確認した情報 
• 関連記事を参照してログインアクセス許可を設定したユーザーのユーザー名

Salesforce CLI での作業時には追加で以下情報を提供してください。

• リリースに使用した package.xml
• エラーが発生する最小限のコンポーネント (メタデータファイル) を圧縮した Zip ファイル

DevOps Center での作業時には追加で以下情報を提供してください。

• 対象のプロジェクト名
• 作業項目名 (WI-xxxxxx)
• ソース管理システム (GitHub など) 側の状態が確認できるスクリーンショット