Skip to main content
Slack の Trailblazer Community がオープンベータを開始しました。ぜひ参加して、リアルタイムで交流しましょう。Slack に参加する

Apex 入門

学習の目的

この単元を完了すると、次のことができるようになります。

  • Apex プログラミング言語の主要な機能を説明する。
  • Apex クラスを保存し、匿名 Apex を使用してメソッドをコールする。
  • Web コンソールを使用してデバッグログを調査する。
メモ

メモ

日本語で受講されている方へ
Challenge は日本語の Trailhead Playground で開始し、かっこ内の翻訳を参照しながら進めていってください。Challenge での評価は英語データを対象に行われるため、英語の値のみをコピーして貼り付けるようにしてください。日本語の組織で Challenge が不合格だった場合は、(1) この手順に従って [Locale (地域)] を [United States (米国)] に切り替え、(2) [Language (言語)] を [English (英語)] に切り替えてから、(3) [Check Challenge (Challenge を確認)] ボタンをクリックしてみることをお勧めします。

翻訳版 Trailhead を活用する方法の詳細は、自分の言語の Trailhead バッジを参照してください。

始める前に

Apex のワクワクする冒険に一緒に出かけましょう。このモジュールでは、プログラミング言語に関する基本的な情報を説明するだけでなく、詳細もすばやく掘り下げていきます。このモジュールで初めて Apex に触れる場合は、まず「クイックスタート: Apex」プロジェクトを参照することを強くお勧めします。その後でまた戻ってきてください。それまでお待ちします。

Apex とは?

Apex は、Java に似た構文を使用し、データベースのストアドプロシージャーのように動作するプログラミング言語です。開発者は Apex を使用して、ボタンのクリックや関連レコードの更新、Visualforce ページなどのシステムイベントにロジックを追加することができます。

言語として、Apex には次のような特徴があります。

  • ホスティング — Apex は、サーバー (Salesforce Platform) 上で保存、コンパイル、実行されます。
  • オブジェクト指向 — Apex は、クラス、インターフェース、継承をサポートします。
  • 強い型付け — Apex は、コンパイル時にオブジェクトへの参照を検証します。
  • マルチテナント型 — Apex はマルチテナントプラットフォームで実行されるため、制限を適用して暴走コードから保護します。こうした制限は、コードが共有リソースを独占しないようにするのに役立ちます。
  • データベースとの統合 — レコードに簡単にアクセスして操作できます。Apex では、レコードとその項目に直接アクセスできます。また、それらのレコードを操作するためのステートメントとクエリ言語が提供されます。
  • データ指向 — Apex では、データベースへのトランザクションアクセスが提供されるため、ロールバック操作が可能です。
  • 使いやすい — Apex は、使い慣れた Java イディオムに基づいています。
  • テストが容易 — Apex には、単体テストの作成、実行、およびコードカバー率のサポートが組み込まれています。
  • バージョン管理 — カスタム Apex コードは、異なるバージョンの API に対して保存できます。

Apex はクラウドベースのプログラミング言語です。

Apex 言語の特長

ほかのオブジェクト指向プログラミング言語と同様に、Apex では次のような言語構成要素がサポートされます。

  • クラス、インターフェース、プロパティ、コレクション (リスト、対応付け、セット)。
  • オブジェクトおよび配列表記。
  • 式、変数、定数。
  • 条件付きステートメント (if-then-else) とフロー制御ステートメント (for ループと while ループ)。

ほかのオブジェクト指向プログラミング言語とは異なり、Apex では次の機能がサポートされます。

  • クラウド開発 (Apex はクラウドで保管、コンパイル、および実行されるため)。
  • トリガー (データベースシステムのトリガーと類似)。
  • 直接データベースコールが可能なデータベースステートメントと、データのクエリと検索を行うためのクエリ言語。
  • トランザクションとロールバック。
  • global アクセス修飾子 (public 修飾子よりも権限が高く、名前空間とアプリケーションの全体でアクセスが可能)。
  • カスタムコードのバージョン管理。

さらに、Apex では大文字と小文字が区別されません。

開発ツール

Visual Studio Code 向け Salesforce 拡張機能を使用して、クライアントコンピューターで Apex を記述してデバッグできます。「Develop with Ease with Salesforce Extensions (Salesforce 拡張機能で容易に開発)」を参照してください。

また、Salesforce ユーザーインターフェースを使用して、ブラウザーで直接 Apex を記述し、デバッグ情報にアクセスすることもできます。Web コンソールは、旧来のレガシーツールと高オーバーヘッドの開発環境の間のギャップを埋めるために設計された、最新の軽量なブラウザーベースの統合開発環境 (IDE) です。詳細は、「Web Console (Web コンソール)」開発者ドキュメントを参照してください。

クイックアクセスメニュー (設定ギアアイコン) から Web コンソールを開くことができます。

Web コンソール

データ型の概要

Apex では、Salesforce 固有のデータ型 (sObject データ型) を含む、さまざまなデータ型がサポートされます。

Apex では、次のデータ型がサポートされます。

  • Integer、Double、Long、Date、Datetime、String、ID、Boolean などのプリミティブ。
  • sObject。汎用 sObject または特定の sObject (Account、Contact、MyCustomObject__c など) のいずれかになります (sObject については後の単元で学習します)。
  • 次のものを含むコレクション
    • リスト - 順序とインデックスを持つ要素のコレクション。リストの要素には、プリミティブ型、コレクション、sObject、ユーザー定義型、システム提供 (組み込み) の Apex 型など、あらゆるデータ型を使用できます。
    • セット - 順序を持たない要素のコレクション。セットの要素もあらゆるデータ型を使用できますが、重複する値を含めることはできません。
    • マップ - あらゆるデータ型を使用できるキーと値のペアのコレクション。
  • 列挙型と呼ばれる型付けされた値のリスト
  • ユーザー定義 (カスタム) の Apex クラス
  • システム提供 (組み込み) の Apex クラス

Apex コレクション: List

リストは、同じ型のデータの順序付けられたコレクションを保持します。

次の 2 つの宣言は同等です。colors 変数が List 構文を使用して宣言されています。

List<String> colors = new List<String>();

または、colors 変数は配列表記を使用して宣言することもできます。

String[] colors = new List<String>();

List.add() メソッドを使用して新しい要素を追加すると、必要に応じてコレクションを増やすことができます。コレクション内の既存の要素をインデックスで参照するには、角括弧の配列表記を使用できます。ただし、角括弧の配列表記で要素を追加することはできません。

次の例は、リスト作成時に要素を追加し、add() メソッドを使用してさらに要素を追加する方法を示しています。

// Create a list and add elements to it in one step
List<String> colors = new List<String> { 'red', 'green', 'blue' };
// Add elements to a list after it has been created
List<String> moreColors = new List<String>();
moreColors.add('orange');
moreColors.add('purple');

List 要素は、角括弧 (配列表記とも呼ばれる) で囲まれたインデックスを指定することで読み込めます。また、get() メソッドを使用して List 要素を読み込むこともできます。次の例は、前の例で作成されたリストに基づいており、いずれかのメソッドを使用して List 要素を読み込む方法を示します。また、list 要素の反復処理方法も示します。

// Get elements from a list
String color1 = moreColors.get(0);
String color2 = moreColors[0];
System.assertEquals(color1, color2);
// Iterate over a list to read elements
System.debug('Print out the colors in moreColors:');
for(String color : moreColors) {
    // Write value to the debug log
    System.debug(color);
}

高度な操作

Apex は、ほかにも 2 つのコレクション型、Set と Map がサポートされます。これらの型については、『Apex 開発者ガイド』の「Collections」セクションを参照してください。

Apex クラス

Apex クラスの利点の 1 つはコードを再利用できることです。クラスメソッドは、トリガーとほかのクラスからコールできます。以降のチュートリアルでは、サンプルのクラスを組織に保存し、そのクラスを使用して取引先の説明を更新して、デバッグログを調べます。

Apex クラスを保存する

AccountProcessor クラスには、updateAccountDescriptions() という公開メソッドがあります。このメソッドは取引先のリストを受け取り、applyStandardFormatting() 非公開ヘルパーメソッドで指定された形式に従って説明を更新します。非公開ヘルパーメソッドは外部からコールすることはできません。クラス内からコールする必要があります。AccountProcessor クラスには、データベースの更新操作の結果を検査する inspectResults() 非公開ヘルパーメソッドも含まれています。

Trailhead 組織に AccountProcessor クラスを保存します。

  1. クイックアクセスメニュー (Setup ギアアイコン) から Web コンソールを開きます。
  2. Web コンソールで、Ctrl+Shift+P (Windows) または ⌘+Shift+P (macOS) を押してコマンドパレットを開きます。
  3. SFDX: Create Apex Class (SFDX: Apex クラスを作成) と入力し、Enter キーを押します。
  4. テンプレートの種別に [DefaultApexClass] を選択し、Enter キーを押します。
  5. クラス名に AccountProcessor と入力し、Enter キーを押します。
  6. 出力ディレクトリに [force-app/main/default/classes] を選択し、Enter キーを押します。
  7. デフォルトのクラス本文を、AccountProcessor クラスの例で置き換えます。
public with sharing class AccountProcessor {
    /**
     * Applies a standard formatting to the descriptions of accounts in the list,
     * and updates each account.
     */
    public void updateAccountDescriptions(List<Account> acctList) {
        if (acctList == null || acctList.isEmpty()) {
            System.debug('Account list is null or empty.');
            return;
        }
        for (Account acc : acctList) {
            applyStandardFormatting(acc);
        }
        Database.SaveResult[] srList = Database.update(acctList,
false,
AccessLevel.USER_MODE);
        inspectResults(srList);
    }
    /**
     * Private helper method to handle the description formatting logic.
     */
    private static void applyStandardFormatting(Account acc) {
        String timestamp = String.valueOf(Datetime.now());
        if (String.isBlank(acc.Description)) {
            acc.Description = 'Account updated on: ' + timestamp;
        } else {
            acc.Description += ' | Last processed: ' + timestamp;
        }
    }
    /*
     * Private helper method to inspect the returned results.
     */
    private static void inspectResults(Database.SaveResult[] results) {
        for (Database.SaveResult sr : results) {
            if (sr.isSuccess()) {
                System.debug('Successfully updated account. Account ID: ' + sr.getId());
            } else {
                for (Database.Error err : sr.getErrors()) {
                    System.debug('The following error has occurred.');
                    System.debug(err.getStatusCode() + ': ' + err.getMessage());
                    System.debug('Account fields that affected this error: ' +
err.getFields());
                }
            }
        }
    }
}
  1. クラスを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。

クラスを保存すると Salesforce によってコンパイルされてリリースされます。

Note

クラスにエラーが含まれている場合、保存しようとするとリリースが失敗します。Web コンソールウィンドウの下部にある [Output (出力)] パネルで、エラーに関する情報を確認できます。

高度な操作

保存したクラスでは、オブジェクト指向プログラミング (OOP) を利用します。このクラスは、メールの管理に関連するメソッドをカプセル化します。完全な OOP の例にするには、クラスにメンバー変数 (属性) とそのような属性にアクセスするためのアクセス機構メソッドも含める必要がありますが、ここでは簡略化のために省略しています。

メソッドをコールして取引先の説明を更新する

公開メソッドを呼び出しましょう。ここでは、匿名 Apex 実行を使用して呼び出します。匿名 Apex を使用すると、コード行をその場で実行でき、特に機能のテストなどで Apex を呼び出す場合に便利です。ほかの Apex 実行と同様に、結果としてデバッグログが生成されます。

Note

トリガーを使用するなど、ほかにも Apex を呼び出す方法があります。トリガーの詳細については、別のモジュールで学習します。

  1. Web コンソールで、Ctrl+Shift+P (Windows) または Cmd+Shift+P (macOS) を押してコマンドパレットを開きます。
  2. SFDX: Create Anonymous Apex Script (SFDX: 匿名 Apex スクリプトを作成) と入力し、Enter キーを押します。
  3. クラス名に UpdateAccounts と入力し、Enter キーを押します。
  4. 出力ディレクトリに [scripts/apex] を選択し、Enter キーを押します。
  5. 次のコードを入力します。
// Create new accounts
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Second New Account'));
// Insert them into the database
try {
    insert as user newAccts;
    System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
    System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Instantiate an AccountProcessor object
AccountProcessor myAcctProcessor = new AccountProcessor();
// Pass the original list to update the account descriptions
myAcctProcessor.updateAccountDescriptions(newAccts);
  1. スクリプトを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。
  2. スクリプトを実行するには、テキストエディターで右クリックし、[SFDX: Execute Anonymous Apex with Currently Open Editor (SFDX: 現在開いているエディターで匿名 Apex を実行)] を選択します。
  3. Salesforce で、My New Account と My Second New Account のレコード詳細ページを開きます。

My New Account の [Description (説明)] 項目は Original Description | Last processed: 2026-01-01 00:00:00、My Second New Account の [Description (説明)] 項目は Account updated on: 2026-01-01 00:00:00 となっているはずです。ただし、タイムスタンプはいずれも、匿名 Apex トランザクションを実行した日時に変わります。

デバッグログを調べる

デバッグログは、コードをデバッグするのに便利です。Apex メソッドが実行されると、コールはデバッグログに記録されます。また、独自のデバッグメッセージをログに書き出すことができ、エラーがある場合のコードのデバッグに役立ちます。updateAccountDescriptions() からコールされる inspectResults() ヘルパーメソッドは、System.debug() メソッドを使用して、データベースの更新操作が成功したかエラーになったかを示すメッセージをログに書き出します。メソッドを実行したときに生成されたデバッグログでこれらのメッセージを検索できます。

  1. Web コンソールで UpdateAccounts スクリプトを実行したら、[Output (出力)] パネルを開きます。
  2. [Debug Only (デバッグのみ)] を選択して、System.debug() ステートメントのログ行のみが表示されるようにログを絞り込みます。
  3. [Output (出力)] パネル上部の [filter (検索条件)] 項目に USER_DEBUG と入力し、System.debug() ステートメントのログ行のみが表示されるようにログを絞り込みます。
  4. デバッグログは .sfdx/tools/debug/logs ディレクトリでも確認できます。

Web コンソールでデバッグメッセージが表示されるようにデバッグログを絞り込む

スクリプトがエラーなく実行された場合、絞り込まれたログビューには次のメッセージが表示されます。

DEBUG|Successfully inserted 2 accounts.
DEBUG|Successfully updated account. Account ID: {id}
DEBUG|Successfully updated account. Account ID: {id}
Note

また、[filter (検索条件)] 項目でキーワードを検索してデバッグログを絞り込むこともできます。ログイベントの種別については、「Debug Log Levels (デバッグログレベル)」を参照してください。

静的メソッドをコールする

ここでは、クラスの updateAccountDescriptions() メソッドはクラスメンバー変数にアクセスしないため、インスタンスメソッドである必要はありません。宣言に static キーワードを追加して、静的メソッドに変更しましょう。静的メソッドは、クラスのインスタンスでコールされる必要がなく、クラス名で直接コールできるため、インスタンスメソッドよりもコールが容易です。

  1. Web コンソールで、AccountProcessor.cls クラスファイルを開きます。
  2. updateAccountDescriptions() 定義の最初の行を変更します。変更点は static キーワードの追加のみです。
public static void updateAccountDescriptions(List<Account> acctList) {
  1. クラスを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。保存するとクラスが再リリースされます。
  2. UpdateAccounts.apex 匿名 Apex スクリプトファイルを開きます。
  3. スクリプトがクラス名で静的メソッドをコールするように、現在のコードを次のコードに置き換えます。
// Create new accounts
// For clarity, use different account names than the ones you used previously
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My Third New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Fourth New Account'));
// Insert them into the database
try {
    insert as user newAccts;
    System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
    System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Pass the original list to update the account descriptions
// The static method is called directly on the class
AccountProcessor.updateAccountDescriptions(newAccts);
  1. スクリプトを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。
  2. スクリプトを実行するには、テキストエディターで右クリックし、[SFDX: Execute Anonymous Apex with Currently Open Editor (SFDX: 現在開いているエディターで匿名 Apex を実行)] を選択します。これで、このメソッドが実行されました。Salesforce で更新された取引先の説明を確認できます。また、必要に応じて、前のステップと同様にデバッグログも確認できます。

リソース

Salesforce ヘルプで Trailhead のフィードバックを共有してください。

Trailhead についての感想をお聞かせください。[Salesforce ヘルプ] サイトから新しいフィードバックフォームにいつでもアクセスできるようになりました。

詳細はこちら フィードバックの共有に進む