> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-ja/kdo/buranchi/buranchi-validate-no.md).

# ブランチ Validate の使用

Validate は、デプロイせずにブランチのメタデータを Salesforce 組織に対してチェックします。互換性を確認し、依存関係が満たされていることを保証し、必要に応じて Apex テストを実行します。

{% hint style="warning" %}

#### 旧UI向けに作成

この記事は旧UI向けに作成されました。手順は今でも使用できますが、スクリーンショットは古くなっています。場合によっては、手順で参照されている項目が移動または変更されていることがあります。項目が見つからない場合は、 [どこに行ったのか](/devops/devops-ja/shii-uiux-heno/dokonittanoka.md) 記事。
{% endhint %}

## ![](https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) 概要 <a href="#what-is-validate" id="what-is-validate"></a>

Validate 機能は、ブランチのコンポーネントを対象の Salesforce 組織と照合します **デプロイせずに**。これにより、メタデータの互換性が確保され、依存関係が検証され、必要に応じて Apex テストが実行されます。デプロイ前に検証することで、問題を特定して修正でき、デプロイ失敗を減らせます。検証は次の方法で失敗を防ぎます:

* 対象組織とのメタデータ互換性を確認する
* 依存関係が満たされていることを確認する
* Apex テストを実行する（選択したテストレベルに基づく）

このプロセスにより、デプロイが成功するという確信が得られます。この記事では、Validation ジョブの実行方法と結果の表示方法を学びます。

{% hint style="info" %}

#### ベスト プラクティス

* UAT または本番環境にデプロイする前には、必ず Validate を実行してください。
* 検証エラーを避けるために、依存コンポーネントを含めてください。
* 使って **ローカルテストを実行** より高品質なチェックのために下位環境で。
* 使って **テストを実行しない** サンドボックスでの簡易検証専用。
* デプロイを進める前に、ログを慎重に確認してください。
* 競合の解決、メタデータの更新、または不足している依存関係の取得後に、Validate を再実行してください。
  {% endhint %}

## ブランチ検証ジョブを実行

{% stepper %}
{% step %}

### ブランチを選択して検証を開始

1. 次をクリックします **コード** を左側のサイドバー メニューから。
2. 一覧からブランチを選択します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FMF5U2AgC0IVyRELJXWsv%2FUsingBranchValidate-Run-S01-01.png?alt=media&amp;token=9f7fd50e-f2b5-4053-ad43-1f58fd427c34" alt="" width="563"><figcaption></figcaption></figure></div>
3. 次をクリックします **縦の三点リーダー ⋮** デプロイの横にあるドロップダウンメニュー。
4. 次をクリックします **検証**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F9jej1YdpDM9j6srk602I%2FUsingBranchValidate-Run-S01-02.png?alt=media&amp;token=20471301-04fc-4b0b-938b-ae937eea405b" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### コンポーネントと接続を選択

1. 次をクリックします **追加** 検証に含める各ブランチコンポーネントについて。
2. （任意）クリック **すべて追加** すべてのコンポーネントを検証に追加するには。
3. 次をクリックします **次へ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FwOzj9OAMyIqbaRJjaIbx%2FUsingBranchValidate-Run-S02-01.png?alt=media&amp;token=3b2a29c0-8e62-4943-adbe-6ccc82ee5592" alt="" width="563"><figcaption></figcaption></figure></div>
4. 次をクリックします **選択** 検証の対象組織として使用する Salesforce 組織接続用。
5. 次をクリックします **次へ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FM5hBgK6zJvsUlgSQnqmM%2FUsingBranchValidate-Run-S02-02.png?alt=media&amp;token=36f0a878-363f-415e-82b0-85fb76bcdfa9" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 破壊的変更を選択

{% hint style="info" %}
デフォルトでは、前後の破壊的変更がすべて追加されます。
{% endhint %}

1. （任意）検証から破壊的変更を削除するには、 **追加済み**.
2. 次をクリックします **次へ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FVTbXVP1YBS0c9LJ8pdq0%2FUsingBranchValidate-Run-S03-01.png?alt=media&amp;token=14cbc49b-bafe-4d09-906f-339a90a86ab8" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 検証を設定して実行

1. 次をクリックします **テストを実行** ドロップダウンメニューで実行する Apex テストのレベルを選択します。各項目の説明は下の表を参照してください。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F7vNJLaSjbWM3DnqUV1BM%2FUsingBranchValidate-Run-S04-01.png?alt=media&amp;token=bdbbd178-ad81-4c07-8852-d4b2502e67cf" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="180.333251953125">テストレベル</th><th>説明</th></tr></thead><tbody><tr><td><strong>デフォルト</strong></td><td>パッケージに含まれるテストのみを実行します。</td></tr><tr><td><strong>テストを実行しない</strong></td><td>すべてのApexテストをスキップします（本番以外の組織でのみ許可されます）。</td></tr><tr><td><strong>ローカルテストを実行</strong></td><td>インストール済みの管理パッケージのテストを除く、組織内のすべてのテストを実行します。</td></tr><tr><td><strong>すべてのテストを実行</strong></td><td>管理パッケージのテストを含む、組織内のすべてのテストを実行します。</td></tr><tr><td><strong>関連テストを実行</strong></td><td>選択したコンポーネントとその依存関係に関連するテストのみを実行します。このオプションは、Salesforce の RunRelevantTests 機能を使用して、実行するテストを自動的に判定します。詳細については、 <a href="https://help.salesforce.com/s/articleView?id=release-notes.rn_apex_run_relevant_tests.htm&#x26;release=260&#x26;type=5">Salesforceヘルプ</a>.</td></tr><tr><td><strong>指定したテストを実行</strong></td><td>実行する個別のテストクラスまたはメソッドを指定できます。</td></tr></tbody></table>

2. 設定を有効にするには、デプロイ設定のトグルをクリックします。各設定の説明は次の表を参照してください。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FWELpcaRxByblsA4xU5sv%2FUsingBranchValidate-Run-S04-02.png?alt=media&amp;token=270d6f7f-6196-4ddb-915b-e99697f2203e" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="280.333251953125">設定</th><th>説明</th></tr></thead><tbody><tr><td><strong>選択したコンポーネントに対してのみプロファイル設定をデプロイする</strong></td><td>検証のみ <strong>プロファイル設定</strong> この検証ジョブに含めるよう選択したコンポーネントに対して。</td></tr><tr><td><strong>選択したコンポーネントに対してのみ権限セット設定をデプロイする</strong></td><td>検証のみ <strong>権限セット設定</strong> この検証ジョブに含めるよう選択したコンポーネントに対して。</td></tr></tbody></table>

3. 次をクリックします **実行** Validation ジョブを開始します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FhNODemQFTXTfjNO7ZtlL%2FUsingBranchValidate-Run-S04-03.png?alt=media&amp;token=70c26313-2d7e-4c25-ab0e-e14d1d37988b" alt="" width="563"><figcaption></figcaption></figure></div>
4. Validation ジョブを開始すると、次の場所に表示されます **アクティビティ** タブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FJhBpFgtfYNxvAoIUKmQv%2FUsingBranchValidate-Run-S04-04.png?alt=media&amp;token=89903300-4024-41fc-b150-8fd7069477cd" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

## 検証結果 <a href="#how-to-check-validation-status" id="how-to-check-validation-status"></a>

{% stepper %}
{% step %}

### 結果を表示

1. 次をクリックします **アクティビティ** タブ。
2. 次を確認してください **検証** ジョブのステータスが **完了**.

{% hint style="info" %}
Validation ジョブ中にエラーが発生すると、状態は次のように変わります **例外**。エラーを特定するために Validation ジョブのログを確認してください。
{% endhint %}

<table><thead><tr><th width="159.6666259765625">ジョブのステータス</th><th>説明</th></tr></thead><tbody><tr><td><strong>キューに入っています</strong></td><td>ジョブが作成され、実行待ちです。</td></tr><tr><td><strong>進行中</strong></td><td>ジョブは実行中です。</td></tr><tr><td><strong>完了</strong></td><td>ジョブは正常に完了しました。</td></tr><tr><td><strong>例外</strong></td><td>ジョブはエラーとともに完了しました。</td></tr></tbody></table>

3. 次をクリックします **検証** ジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FIQKZ9cXeOX0VWlWEaQbo%2FUsingBranchValidate-View-S01-01.png?alt=media&amp;token=f2cdae89-d121-4a69-92d8-99293ef6f6d1" alt="" width="563"><figcaption></figcaption></figure></div>
4. この **検証** 結果ページには、ジョブの情報とジョブの詳細ログが表示されます。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FIe0U497ovIZblH7YmIjN%2FUsingBranchValidate-View-S01-02.png?alt=media&amp;token=7fb837f7-1f7c-437e-813b-8c92b2b9661b" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### ログを確認（エラーなし）

Validation ジョブのログには、次の詳細が含まれます:

* Destructive Changes オブジェクトの有無。
* 検証済みコンポーネントの件数と一覧。
* Apex テスト実行の種類と結果。
* 完了した検証ステップ。

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F7jZ2Zo6GTswLdv6qF1GO%2FUsingBranchValidate-View-S02-01.png?alt=media&amp;token=43785a97-4118-4be9-afb4-25f7f177ec58" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### ログを確認（エラーあり）

Validation ジョブでエラーが発生した場合は、原因を見つけるためにログを確認してください。次のマークが付いた項目に注目してください **\[エラー]**。以下のスクリーンショットは、Salesforce 組織にブランチに含まれる複数のコンポーネントが存在しない状態で Validation ジョブを実行した例です。

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FkZFC3qKPu3soCbwRjJHg%2FUsingBranchValidate-View-S03-01.png?alt=media&amp;token=6b2e39e5-48a1-4f7b-bf55-51edd2a311e5" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FukmpgbJMZ8P4v97u4OHA%2FUsingBranchValidate-View-S03-02.png?alt=media&amp;token=4553a42c-7a93-4447-9b17-b67eb9da71e6" alt="" width="563"><figcaption></figcaption></figure></div>

完全なログファイルは以下のとおりです:

{% code expandable="true" %}

```
[Jan 1, 2026 3:14 PM]: [情報] ジョブを開始しました
[Jan 1, 2026 3:14 PM]: [情報] Salesforce プロジェクトの作成を開始しました
[Jan 1, 2026 3:14 PM]: [情報] Salesforce プロジェクトの作成を完了しました
[Jan 1, 2026 3:14 PM]: [情報] Salesforce コンポーネントの取得を開始しました
[Jan 1, 2026 3:14 PM]: [情報] Salesforce コンポーネントの取得を完了しました
[Jan 1, 2026 3:14 PM]: [情報] マニフェストの準備を開始しました
[Jan 1, 2026 3:14 PM]: [情報] マニフェストの準備を完了しました
[Jan 1, 2026 3:14 PM]: [情報] Salesforce メタデータの検証を開始しました
[Jan 1, 2026 3:14 PM]: [エラー] 検証に失敗しました
[Jan 1, 2026 3:14 PM]: [情報] 検証済みコンポーネント数: 2
[Jan 1, 2026 3:14 PM]: [情報] ValidateJobId: 0Afg5000001uyNVCAY
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: SuccessGoal__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: objective
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: LightningCommunityUtils
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: objective
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: objective.Owner
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: objective
[Jan 1, 2026 3:14 PM]: [情報] 検証済みコンポーネント: Example_Test_Object_1__c, CustomObject; Example_Test_Object_2__c, CustomObject
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: objectives
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: Account__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: LightningCommunityUtils
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Schema.SuccessGoal__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Schema.SuccessGoal__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Schema.SuccessGoal__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Schema.SuccessGoal__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Schema.SuccessGoal__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 変数が存在しません: LightningCommunityUtils
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Schema.Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanController: 無効な型: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: GuidUtil
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: PortalSession__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: DML には SObject または SObject リスト型が必要です: PortalSession__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: PortalSession__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: EncryptHelper
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: portalSession
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: PortalSession__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: EncryptHelper
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: portalSession
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: DML には SObject または SObject リスト型が必要です: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: objective
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: objective
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: DML には SObject または SObject リスト型が必要です: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: objective
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: PortalSession__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: EncryptHelper
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: portalSession
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: DML には SObject または SObject リスト型が必要です: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: objective
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: PortalSession__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: EncryptHelper
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 変数が存在しません: portalSession
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: 無効な型: Objective__c
[Jan 1, 2026 3:14 PM]: [エラー] ApexClass SuccessPlanControllerTest: DML には SObject または SObject リスト型が必要です: Objective__c
[Jan 1, 2026 3:14 PM]: [情報] Validate テストレベル: Default
[Jan 1, 2026 3:14 PM]: [エラー] ジョブに失敗しました: Salesforce メタデータの検証に失敗しました
```

{% endcode %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-ja/kdo/buranchi/buranchi-validate-no.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.