Loading
PHPの脆弱性に関する監視状況について 続きを読む
弊社ヘルプサイトの Agentforce でケース作成フォームが表示されない場合の対応方法続きを読む
メールアドレスがデフォルトのログイン方式となります 続きを読む

本番環境でトリガーを無効にする

公開日: May 16, 2026
説明

Salesforce の Apex トリガーには、挿入、更新、削除、復元などの DML 操作により起動する自動化されたビジネスロジックが含まれています。本番組織にデプロイされたトリガーは、Salesforce の設定ページから直接編集したり、有効化/無効化できません。メタデータツールを使用してデプロイする必要があります。
大規模なデータ移行や緊急修正などの特定の状況では、本番組織で Apex トリガーを一時的または永続的に無効にする必要がある場合があります。この記事では、本番組織でトリガーを無効にするためのサポートされている方法について説明します。
例: 商談オブジェクトの Apex トリガーが、大規模なデータ移行中にエラーを引き起こしています。移行を完了させるには、システム管理者がトリガーを一時的に無効にし、移行を実行してから、トリガーを再度有効にする必要があります。
注: 業務時間中に本番組織でトリガーを無効にする際はその影響を考慮してください。業務時間外に実行することを強くお勧めします。また、メンテナンス期間中は管理者以外のユーザーがアプリケーションにアクセスできないようにしてください。

解決策

本番組織でトリガーを無効にする

 

Salesforce CLI を使用
 

  1. トリガーのメタデータを取得するための package.xml ファイルを作成します。
  2. コマンド sf org login web を使用して、トリガーを無効にする組織を認証します。
  3. sf project retrieve start コマンドを使用して、前に作成した package.xml ファイルを使用してトリガーのメタデータを取得します。
  4. メタデータファイルが取得されたら、ファイルを解凍し、triggername.trigger-meta.xml ファイルで status を [Active] から [Inactive] に変更します。
  5. 次に、sf project deploy start コマンドを実行して、変更を対象組織にリリースします。 

 

変更セットを使用

 

  1. Sandbox 環境でトリガーを無効にします。同じトリガーを含む Sandbox 組織が存在する必要があります。
  2. Sandbox で新しい送信変更セットを作成します。
  3. 無効になったトリガーを変更セットに追加します。
  4. 変更セットを本番組織にアップロードします。
  5. 本番組織で、[受信変更セット] に移動し、アップロードされた変更セットが使用可能になるまで待ちます。
  6. [リリース] をクリックしてテストを実行し、変更を適用します。

この情報を動画形式で参照するには、「How to Disable a Trigger in a Production Org via Change Set」を視聴してください。

 

ワークベンチを使用
 

  1. ワークベンチを使用してトリガーメタデータを取得します。
  2. 取得されたメタデータフォルダを解凍します。
  3. triggername.trigger-meta.xml ファイルで、ステータスを [有効] から [無効] に変更します。 
  4. 次に、フォルダを元の zip に圧縮し、ワークベンチを使用してそれをリリースします。

 

Ant 移行ツールを使用 (廃止済み - 非推奨)
 

  1. Sandbox 環境でトリガーを無効にします。同じトリガーを含む Sandbox 組織が存在する必要があります。
  2. Sandbox を使用して新しいフォルダを作成し、トリガーを含めます (または、既存のフォルダを更新します)。
    1. 代替手段: 既存のプロジェクトで triggername.trigger-meta.xml を編集し、status ノードを  <status>false</status> に変更します。
    2. 変更をローカルに保存します。
    3. トリガーを本番組織にリリースします。
  3. データ読み込みを完了します。
  4. 変更が永続的でないか、またはトリガーを再び有効にしたい場合は、Sandbox またはプロジェクトでトリガーを再び有効にし、本番組織にリリースします。

  • 注：Salesforce Ant 移行ツールは Spring '24 にサポート終了しました。

    重要: Ant 移行ツールは  Spring '24 にサポートが終了し、新機能の追加や更新は行われなくなりました。上記手順は従来の API バージョンで引き続き機能する可能性がありますが、メタデータデプロイに Salesforce CLI を使用することをお勧めします。詳細は 「Salesforce Ant 移行ツールの有効期限」を参照してください。

    その他のリソース

    ・Salesforce CLI によるリリースに関する詳細は以下を参照してください。

    　- ブラウザーを使用した組織の認証

    　- メタデータ API を使用したアプリケーションの構築とリリース

    ・変更セットによるリリースに関する詳細は、「Sandbox から本番環境への変更セットのリリース」の記事を参照してください。

    ナレッジ記事番号

    000385540

     
    読み込み中
    Salesforce Help | Article