> 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/buranchikino.md).

# ブランチ上書き保護の使用

上書き保護は、Salesforce 組織に対して実行される保護プロセスで、メタデータの意図しない上書きを防止します。

{% 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) 概要

上書き保護は、ブランチのコンポーネントを本番 org 内のものと比較することで、誤って上書きしてしまうのを防ぎます。新しいもの、異なるもの、同じもののコンポーネントを強調表示し、デプロイ中に重要なメタデータが保持されるようにします。このガイドでは、上書き保護ジョブの実行方法、結果の確認方法、および差分への対処方法を説明します。

{% hint style="info" %}

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

* 常に実行する **上書き保護** 本番環境や重要な環境へデプロイする前に。
* 注目する **異なる** コンポーネント — どのバージョンを保持するか決める前に、慎重に確認してください。
* 意味のある **コミットメッセージ** 最終的に解決を確定するときに使用して、チームが変更理由を追跡できるようにしてください。
* 上書き保護 UI で競合を解決し、スキップしないでください。そうすることで、ブランチと org の同期が保たれます。
* ジョブが失敗するか、 **例外**で終了した場合は、すぐにログを確認し、修正後に再実行してください。
* 組み合わせる **上書き保護** と **事前デプロイ修正** を使って、デプロイ前に上書きと不足している依存関係の両方を検出します。
  {% 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%2FPZYhrPSpmJlqi1Le0rDn%2FUsingBranchOverwriteProtection-S01-01.png?alt=media&amp;token=51871bb1-b883-4544-96ac-54f1f372b1bf" 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%2FXI9seNN1MWDhG9zozbWL%2FUsingBranchOverwriteProtection-S01-02.png?alt=media&amp;token=947ba319-4aac-41e9-9b84-8dbc93e30526" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

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

{% hint style="info" %}
［ **検索**, **フィルター**、および **並べ替え** 正しい接続とコンポーネントを見つけるのに役立つオプション。
{% endhint %}

1. 次をクリックします **選択** Salesforce org 接続で上書きを確認するために。
2. 次をクリックします **次へ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FWjTlM7aGXCjRAvYyfNjb%2FUsingBranchOverwriteProtection-S02-01.png?alt=media&amp;token=4001ca0e-c75b-4aff-b6f6-2eefe2888a29" alt="" width="563"><figcaption></figcaption></figure></div>
3. 次をクリックします **追加** 上書きを確認するために、各コンポーネントごとに。
4. （任意）クリック **すべて追加** すべてのコンポーネントを含めるために。 **注意:** 検索、フィルター、並べ替えのオプションは、次の方法で追加されるコンポーネントを制限しません: **すべて追加** ボタンに置き換わります。
5. 次をクリックします **実行**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FWiG0l8ZQhVyjSBDn2ui7%2FUsingBranchOverwriteProtection-S02-02.png?alt=media&amp;token=f3ce5e79-a7ed-426d-bf42-4d2c033f6d1a" alt="" width="563"><figcaption></figcaption></figure></div>
6. 上書き保護ジョブを開始すると、 **アクティビティ** タブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FfiqhWMs4PCLFCYw9NRw8%2FUsingBranchOverwriteProtection-S02-03.png?alt=media&amp;token=73f6463d-de79-41f7-a555-aafb201d8760" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

## 上書き保護結果

{% stepper %}
{% 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%2FzJQ2hwBhFLNAEQuYbhPn%2FUsingBranchOverwriteProtection-Results-S01-01.png?alt=media&amp;token=e2a1b83b-b417-4439-8c09-3a3fd5a3b71f" 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%2FV1Yz0Kw7g5wTL3OVy5tJ%2FUsingBranchOverwriteProtection-Results-S01-02.png?alt=media&amp;token=6aab75c6-3dbc-4699-a24f-69f189cb0fd6" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
コンポーネント一覧は検索およびフィルターできます。たとえば、 **状態** とマークされたコンポーネントのみを表示するように設定できます。 **異なる**.
{% endhint %}

<table><thead><tr><th width="100.333251953125">状態</th><th>説明</th></tr></thead><tbody><tr><td><strong>新規</strong></td><td>そのコンポーネントはブランチには存在しますが、org には存在しません。これらはまだ org に存在しないため、通常は安全にコミットできます。対処は不要です。</td></tr><tr><td><strong>異なる</strong></td><td>そのコンポーネントはブランチと org の両方に存在しますが、内容が異なります。この違いのため、変更が正確であることを確認し、競合に対処する必要があります。</td></tr><tr><td><strong>同じ</strong></td><td>そのコンポーネントはブランチと org の両方に存在し、内容は同一です。対処は不要です。</td></tr></tbody></table>
{% endstep %}

{% step %}

### 差分を確認

とマークされた各コンポーネントを確認して、 **異なる** 差分を特定し、解決方法を判断してください。

1. 次をクリックします **解決**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F15vtlyBdjp3nDpFZi5ot%2FUsingBranchOverwriteProtection-Results-S02-01.png?alt=media&amp;token=09073717-4172-445a-aa5e-884402aaad46" alt="" width="563"><figcaption></figcaption></figure></div>
2. コンポーネントの差分は、 **差分** が強調表示された左右並列のエディターに表示されます。
   1. **受信**: 選択した org バージョンのコンポーネントを表示する読み取り専用エディター。
   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%2FeNfYXDPCKVVHb8P68Mdp%2FUsingBranchOverwriteProtection-Results-S02-02.png?alt=media&amp;token=e076d0bf-76bc-4c43-a927-10d670053275" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 差分を受け入れる

差分を確認した後、 **受信** org の **現在** 値でブランチの値を置き換えることで、org からの差分を受け入れることができます。差分を受け入れる方法は 2 つあります。以下のセクションで例を参照してください。

**すべて受け入れる**

org からのすべての差分を受け入れることは、 **受信** ブランチのすべての変更が **現在** org の値に置き換えられることを意味します。以下の例を参照してください。

1. 次をクリックします **すべてを受け入れる**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FXYNhBwGDKROUyGpESMxF%2FUsingBranchOverwriteProtection-Results-S03-01.png?alt=media&amp;token=98df3bbe-2c29-4da8-96a9-2fe4c12b94d6" alt="" width="563"><figcaption></figcaption></figure></div>
2. のすべての差分は **現在** の **受信** 値に置き換えられます。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F31Fz5cvsEbVGj4XHtNx8%2FUsingBranchOverwriteProtection-Results-S03-02.png?alt=media&amp;token=6b3c26f2-55a2-4fd6-acfa-c269d59c66ff" alt="" width="563"><figcaption></figcaption></figure></div>

**行単位**

org からの特定の差分を受け入れることは、 **受信** ブランチ内の選択した変更のみが **現在** org の値に置き換えられることを意味します。以下の例を参照してください。

1. 次をクリックします **右矢印** 差分を置き換えたい行の **現在** を **受信** 値に置き換えることを意味します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fw0MZkwcBn3JDfYBJpZjo%2FUsingBranchOverwriteProtection-Results-S03-03.png?alt=media&amp;token=938dea10-1d67-4f8d-a6a6-9b5f1ba4eddb" alt="" width="563"><figcaption></figcaption></figure></div>
2. この **現在** 値は **受信** 値に置き換えることを意味します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fxtk5qPUaJscmHRhQTUmR%2FUsingBranchOverwriteProtection-Results-S03-04.png?alt=media&amp;token=19124417-c1f5-4e53-a9f7-295ab29f8f9d" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}

#### 変更を元に戻す

* **すべての変更をリセット**: これにより、 **現在** エディターで行ったすべての変更を元に戻せます。
* **Ctrl** + **Z**: これにより、 **現在** エディターで行った最後の変更を元に戻せます（エディターを選択しておく必要があります）。
  {% endhint %}
  {% endstep %}

{% step %}

### 解決済みにする

差分によって発生した競合を解消するために **現在** ブランチを編集したら、そのコンポーネントを解決済みとしてマークできます。

1. 次をクリックします **解決**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F99vwqdJeUgL3UEB5BXOH%2FUsingBranchOverwriteProtection-Results-S04-01.png?alt=media&amp;token=e951338d-4149-4461-bb0e-360646738edd" alt="" width="563"><figcaption></figcaption></figure></div>
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%2F0xFrMwLNHcwF4pf9hkyE%2FUsingBranchOverwriteProtection-Results-S04-02.png?alt=media&amp;token=fbb322e4-3060-4763-b2c6-c27aad4576df" 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%2FQ1ZVAnncaVPSHYQi6UhW%2FUsingBranchOverwriteProtection-Results-S04-03.png?alt=media&amp;token=d85df869-fc96-4f49-a26b-e7ee33280101" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% 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%2Fm0ybSSaLsqOT2TWR5f3t%2FUsingBranchOverwriteProtection-Results-S05-01.png?alt=media&amp;token=c35366c7-ba08-4cac-b199-cf80370180db" alt="" width="563"><figcaption></figcaption></figure></div>
3. ジョブの統計と実行ログを表示します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FIdJ0lpK3J5fgpzxPFi19%2FUsingBranchOverwriteProtection-Results-S05-02.png?alt=media&amp;token=d157a057-c17d-407e-b334-303681ec7dc5" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
この **接続** このフィールドは、このジョブで確認された org を示します。 **上書き保護** ジョブ。
{% endhint %}
{% endstep %}

{% step %}

### 変更をコミット

差分の解決中にコンポーネントが変更された場合は、それらの変更をブランチにコミットする必要があります。

1. 次をクリックします **変更をコミット**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FAkBejqMkMaIBMCSI5KuN%2FUsingBranchOverwriteProtection-Results-S06-01.png?alt=media&amp;token=9ce7dc4e-f3a8-4bad-9ed8-44aff077450e" alt="" width="563"><figcaption></figcaption></figure></div>
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%2FZ5K5lb1TsSGS1adxGH7z%2FUsingBranchOverwriteProtection-Results-S06-02.png?alt=media&amp;token=8ed916ef-461b-49fd-9bbd-7b489aa964ff" alt="" width="563"><figcaption></figcaption></figure></div>

{% 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/buranchikino.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.
