`Trigger.new`、`Trigger.newMap`、`Trigger.old`、`Trigger.oldMap` の活用事例（標準オブジェクト）

Apexトリガーでは、レコードの 挿入・更新・削除時のデータを取得するために Trigger.new や Trigger.old などの変数が利用されます。
それぞれの用途を理解し、標準オブジェクト（商談や取引先）を例に活用事例を紹介します。

1. `Trigger.new` の活用例（商談作成時にデフォルトのフォローアップタスクを作成）

🔹 Trigger.new は 新しく作成されたレコードのリスト です。
🔹 before insert / after insert のタイミングで利用できます。

📌 事例: 商談が作成されたとき、自動でフォローアップタスクを作成する

trigger CreateFollowUpTask on Opportunity (after insert) {
    List<Task> tasksToInsert = new List<Task>();

    for (Opportunity opp : Trigger.new) {
        Task newTask = new Task(
            Subject = 'フォローアップ',
            WhatId = opp.Id,
            OwnerId = opp.OwnerId,
            ActivityDate = Date.today().addDays(30), // 30日後のタスク
            Status = 'Not Started',
            Priority = 'High'
        );
        tasksToInsert.add(newTask);
    }

    if (!tasksToInsert.isEmpty()) {
        insert tasksToInsert;
    }
}

✅ ポイント

Trigger.new を使い、新しく作成された商談のリストを取得
after insert トリガーなので、レコードが保存された後 にタスクを作成

2. `Trigger.newMap` の活用例（取引先更新時に関連する商談の「取引先名」を更新）

🔹 Trigger.newMap は 更新後のレコードを ID をキーにして取得できる Map<Id, SObject> です。
🔹 大量データ処理（Bulk処理） の場合、レコードを ID で参照できるため 効率が良い です。

📌 事例: 取引先の「取引先名」が変更されたら、関連する商談の「取引先名」も更新する

trigger UpdateOpportunityAccountName on Account (after update) {
    List<Opportunity> oppsToUpdate = new List<Opportunity>();

    for (Account acc : Trigger.new) {
        Account oldAcc = Trigger.oldMap.get(acc.Id);
        if (acc.Name != oldAcc.Name) { // 取引先名が変わった場合
            for (Opportunity opp : [SELECT Id, Name FROM Opportunity WHERE AccountId = :acc.Id]) {
                opp.Name = acc.Name + ' 商談';
                oppsToUpdate.add(opp);
            }
        }
    }

    if (!oppsToUpdate.isEmpty()) {
        update oppsToUpdate;
    }
}

✅ ポイント

Trigger.oldMap.get(acc.Id) を使い、更新前のデータと比較
取引先名 (Name) が変更されたら、関連する商談の Name も変更
after update で実行し、関連レコードの更新を許可

3. `Trigger.old` の活用例（商談のステージが「成立（Closed Won）」から変更されたら警告）

🔹 Trigger.old は 更新前のレコードのリスト を取得できます。
🔹 before update などで活用し、データ変更の制限 に使えます。

📌 事例: 「成立」済みの商談のステージが変更されそうになったらエラーを出す

trigger PreventStageChange on Opportunity (before update) {
    for (Integer i = 0; i < Trigger.new.size(); i++) {
        Opportunity newOpp = Trigger.new[i];
        Opportunity oldOpp = Trigger.old[i];

        if (oldOpp.StageName == 'Closed Won' && newOpp.StageName != 'Closed Won') {
            newOpp.addError('成立した商談のステージを変更できません。');
        }
    }
}

✅ ポイント

Trigger.old を使い、更新前のデータを取得
Closed Won だった商談のステージを変更させない ように制御
before update の addError を使うことで 画面上でエラーメッセージを表示 可能

4. `Trigger.oldMap` の活用例（取引先削除時に関連する商談をクローズする）

🔹 Trigger.oldMap は 削除されるレコードの ID をキーとした Map<Id, SObject> です。
🔹 大量データ処理でも高速に関連レコードを検索 できます。

📌 事例: 取引先が削除されたら、関連する商談のステージを「Closed Lost」にする

trigger CloseOpportunitiesOnAccountDelete on Account (before delete) {
    List<Opportunity> oppsToUpdate = new List<Opportunity>();

    for (Account acc : Trigger.oldMap.values()) {
        for (Opportunity opp : [SELECT Id, StageName FROM Opportunity WHERE AccountId = :acc.Id]) {
            opp.StageName = 'Closed Lost';
            oppsToUpdate.add(opp);
        }
    }

    if (!oppsToUpdate.isEmpty()) {
        update oppsToUpdate;
    }
}

✅ ポイント

Trigger.oldMap.values() を使い、削除対象の Account のリストを取得
関連する商談 (Opportunity) を検索し、ステージを "Closed Lost" に変更
before delete で実行し、取引先削除前に商談データを更新

まとめ

変数	用途	活用例
`Trigger.new`	新しく作成された or 更新後のレコードのリスト	商談作成時にタスクを追加 (`after insert`)
`Trigger.newMap`	新しく作成・更新後のレコードを ID で取得できる Map	取引先名変更時に商談の取引先名も更新 (`after update`)
`Trigger.old`	更新前 or 削除前のレコードのリスト	商談の成立済みステージ変更を制限 (`before update`)
`Trigger.oldMap`	更新前 or 削除前のレコードを ID で取得できる Map	取引先削除時に関連商談をクローズ (`before delete`)

使い分けポイント

✅ Trigger.new / Trigger.newMap → 新規作成・更新後のデータ処理
✅ Trigger.old / Trigger.oldMap → 更新前・削除前のデータチェックや制約
✅ 大量データを扱う場合 は Map を使うと 効率的に ID 参照できる

SalesforceのApexトリガーでは、これらの変数を使い分けることで、データの整合性を保ちつつ柔軟なビジネスロジックを実装できます！