Apex Recipes サンプルアプリケーションをリリースする
メモ
日本語で受講されている方へ
Challenge は日本語の Trailhead Playground で開始し、かっこ内の翻訳を参照しながら進めていってください。Challenge での評価は英語データを対象に行われるため、英語の値のみをコピーして貼り付けるようにしてください。日本語の組織で Challenge が不合格だった場合は、(1) この手順に従って [Locale (地域)] を [United States (米国)] に切り替え、(2) [Language (言語)] を [English (英語)] に切り替えてから、(3) [Check Challenge (Challenge を確認)] ボタンをクリックしてみることをお勧めします。
翻訳版 Trailhead を活用する方法の詳細は、自分の言語の Trailhead バッジを参照してください。
学習の目的
このプロジェクトでは、次のことを行います。
- Apex Recipes サンプルアプリケーションをリリースする。
- アプリケーションのユースケースについて学ぶ。
- Apex Recipes サンプルアプリケーション実装の詳細を確認する。
Apex Recipes サンプルアプリケーションの概要
このプロジェクトでは、Apex Recipes サンプルアプリケーションをリリースして詳しく見ていきます。Apex Recipes は、Apex で X、Y、Z を実行する適切な方法を示す所定のサンプルセットです。データの安全な照会から持続可能なトリガーを作成する方法まで、すべての操作を実証するレシピが用意されています。このサンプルは、実際のシナリオを反映しながらも、できるだけ簡潔になるように設計されています。開発者にとって、こういったレシピは独自のソリューションを構築するための利用しやすい出発点となるでしょう。
Apex Recipes は多数のフォルダーに分かれています。各フォルダーには、特定のソリューション、つまりソリューションセットに関連するコードが含まれています。たとえば、Trigger Recipes フォルダーには、ご想像のとおり、トリガーを適切に作成するための関連コードが含まれています。Apex Recipes のソースコードを確認すると、次のフォルダーがあります。
- Async Apex Recipes
- Data Recipes
- Integration Recipes
- Invocable Recipes
- Platform Event Recipes
- Security Recipes
- Shared Code
- Trigger Recipes
また、force-app/tests フォルダー内には、同じフォルダー構造に分類された対応する単体テストがあります。
このプロジェクトについて
このクイックスタートプロジェクトでは、サンプルアプリケーションを「Trailhead Sample Gallery (Trailhead サンプルギャラリー)」からインストールします。サンプルアプリケーションには、持続可能な Apexコードの記述の学習に使用できる例が用意されています。また、再利用可能なコードを記述するのに役立つインテリジェントな抽象化を表すコードもあります。
サンプルアプリケーションギャラリーの詳細を確認したい場合は、「クイックスタート: サンプルアプリケーションギャラリーのツアー」を参照してください。
始める前に
このハンズオンプロジェクトの手順を実行する前に、「クイックスタート: Salesforce DX」を完了しておく必要があります。このバッジでは、Salesforce DX 開発環境での設定と作業について説明します。
メモ
このクイックスタートでは、Salesforce DX (Developer Experience) というツールセットが必要です。これには、Salesforce コマンドラインインターフェース (CLI) と Visual Studio Code が含まれおり、Salesforce 拡張機能パックが付属している Visual Studio Code は Salesforce Platform での開発に推奨されるコードエディターです。
サンプルアプリケーションを含むリポジトリをコピーするには、バージョン管理システムである Git を使用します。Git をインストールするには、以下の手順の指示に従ってください。次に、サンプルアプリケーションの readme ファイルの指示に従って、サンプルアプリケーションリポジトリをコピーし、サンプルアプリケーションを Trailhead Playground にリリースします。
新しい Trailhead Playground を作成する
このプロジェクト用に、新しい Trailhead Playground を作成する必要があります。このページの最下部までスクロールし、[Launch (起動)] の横にある下矢印をクリックして [Create a Trailhead Playground (Trailhead Playground を作成)] を選択します。新しい Trailhead Playground を作成するには、通常 3、4 分かかります。
メモ
必ず新しい Trailhead Playground を使用してください。既存の組織や Playground を使用すると、Challenge に取り組んでいるときに問題が発生することがあります。
Trailhead Playground のユーザー名とパスワードを取得する
では始めましょう。Trailhead Playground に移動します。(Playground がまだ開いていない場合は、このページの一番下までスクロールして [Launch (起動)] をクリックします。)組織に [Get Your Login Credentials (ログイン情報を取得する)] というタブが表示されている場合は、ステップ 1 まで進みます。
表示されていない場合は、アプリケーションランチャー (
) で [Playground Starter] をクリックして手順に従います。Playground Starter アプリケーションが表示されない場合は、Trailhead ヘルプの「Find the Username and Password for Your Trailhead Playground (Trailhead Playground のユーザー名とパスワードの調べ方)」を参照してください。
- [Get Your Login Credentials (ログイン情報を取得する)] タブをクリックし、ユーザー名をメモします。
- [Reset My Password (パスワードのリセット)] をクリックします。これにより、ユーザー名に関連付けられているアドレスにメールが送信されます。
- メール内のリンクをクリックします。
- 新しいパスワードを入力し、確認して、[Change Password (パスワードを変更)] をクリックします。
Git コマンドラインを取得する
- Git を https://git-scm.com/downloads からインストールします。デフォルトのインストール設定をすべて受け入れます。
- Git がインストールされていることを確認します。ターミナル (macOS) またはコマンドプロンプト (Windows) で、次のコマンドを入力します。
git
git コマンドのリストが出力されます。
アプリケーションをリリースする
すべてのツールをインストールして統合したところで、Visual Studio Code を使用して Trailhead Playground に Apex Recipes サンプルアプリケーションをリリースします。
- Visual Studio Code を開きます。
- コマンドパレットを開き、[View (表示)] | [Command Palette (コマンドパレット)] をクリックします。
または、Ctrl+Shift+P (Windows) か Cmd+Shift+P (macOS) を押します。 - ターミナルウィンドウを開き、[Terminal (ターミナル)] | [New Terminal (新規ターミナル)] をクリックします。
ここで、次の説明で提供されるコマンドを入力または貼り付けます。 - プロジェクトの readme にある「Installing the App using a Developer Edition Org or a Trailhead Playground via the Salesforce CLI (Developer Edition 組織または Trailhead Playground を使用した Salesforce CLI 経由のアプリケーションのインストール)」セクションの指示に従って、アプリケーションを Trailhead Playground 組織にリリースします。
お疲れさまでした。Apex Recipes サンプルアプリケーションが正常に設定されました。次のステップでは、アプリケーションを詳しく見てみましょう。