Salesforceのリリースをもっとスムーズに：VisualStudioCode + CLIによる実践的アプローチ

2025.05.29

#Salesforce #VisualStudioCode + CLI

Salesforce管理者の皆さん、リリース作業で頭を悩ませた経験はありませんか？変更セットの作成に時間がかかり過ぎる、複数環境へのリリースが大変、急なリリース依頼への対応に苦労する…。これらは、多くの現場で共通する課題です。
私も以前は、大規模なプロジェクトでのリリース作業に追われる日々を過ごしていました。特に、複数のコンポーネントが絡み合う変更セットの作成には、膨大な時間を費やしていました。そんな中で出会ったのが、Visual Studio CodeとSalesforce CLIを組み合わせたアプローチです。

この記事では、私たちの現場で実践している効率的なリリース手法をお伝えします。コマンドラインに馴染みがない方でも実践できるよう、基礎から丁寧に解説していきます。
第1章では効率的なリリース環境の準備について、第2章ではメタデータとpackage.xmlの基礎知識について、そして第3章では具体的なリリース手順について説明します。この方法を活用することで、リリース作業の時間を大幅に削減し、より確実な展開が可能になります。

第1章：効率的なリリース環境の準備

開発環境の整備は、スムーズなリリース作業の土台となります。ただツールを入れればよいというわけではありません。それぞれのツールの役割を理解し、適切に設定することで、後の作業がスムーズになります。

必要なツールとその役割

まず準備するのは、Visual Studio CodeとSalesforce CLIです。Visual Studio Codeは単なるコードエディタではありません。Salesforce開発に特化した拡張機能を導入することで、強力な開発環境となります。

特に重要なのは「Salesforce Extension Pack」です。これにより、メタデータの参照や操作が視覚的に行えるようになります。また、「Salesforce Package.xml Generator」を導入することで、リリース対象の選択が格段に楽になります。
Salesforce CLIは、コマンドラインからSalesforce組織を操作するためのツールです。最初は馴染みがないかもしれませんが、基本的なコマンドはそれほど多くありません。むしろ、変更セットよりも確実で効率的なリリースが可能になります。

環境設定のポイント

開発環境の設定では、以下の点に注意が必要です。まず、Salesforce CLIのインストール後、認証情報の設定を行います。これは、組織への安全なアクセスを確保するための重要なステップです。

Visual Studio Codeの設定では、プロジェクトごとに作業ディレクトリを分けることをお勧めします。これにより、複数の組織やプロジェクトを同時に管理する際も混乱を避けることができます。

チームでの活用に向けて

開発環境の整備は、個人の作業効率化だけでなく、チーム全体の生産性向上にもつながります。チーム内で同じ環境を使用することで、手順の標準化や知見の共有が容易になります。
また、Git等のバージョン管理システムと組み合わせることで、より安全で効率的な開発フローを構築できます。これについては、チームの規模や開発プロセスに応じて検討するとよいでしょう。
次の章では、この環境を使って実際にメタデータを扱う際の基礎知識について説明します。特に、package.xmlの役割と効果的な使い方について詳しく見ていきましょう。

第2章：リリースの基礎知識

Salesforceでリリース作業を行う際、メタデータとpackage.xmlの関係を理解することは非常に重要です。これらの基礎知識があると、リリース作業の意図が明確になり、より確実な作業が可能になります。

メタデータとは

Salesforceにおけるメタデータは、組織の設定や構成を定義するものです。カスタムオブジェクト、項目、ページレイアウト、Apexクラスなど、私たちが日々扱う設定の多くがメタデータとして管理されています。

たとえば、商談オブジェクトに新しい項目を追加する場合、この変更はメタデータとして管理されます。リリース時には、このメタデータを適切に選択し、移行する必要があります。

package.xmlの役割

package.xmlは、リリースするメタデータを指定するためのマニフェストファイルです。このファイルには、どのメタデータをリリースするかという情報が記載されています。
例えば、以下のような構造になっています。

----------------------------------------------------
xml
Copy
<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
       	<members>Opportunity.CustomField__c>
        <name>CustomField</name>
    </types>
    <version>57.0>
</Package>
----------------------------------------------------

このファイルは、単なるメタデータのリストではありません。メタデータ間の依存関係も考慮する必要があります。たとえば、カスタム項目をリリースする場合、その項目が使用されているページレイアウトも含める必要があるかもしれません。

Salesforce DXプロジェクトの構造

Salesforce DXプロジェクトは、これらのメタデータを効率的に管理するための枠組みを提供します。プロジェクトのフォルダ構造は、メタデータの種類ごとに整理されています。

特に重要なのが「force-app/main/default」フォルダです。ここには、リリース対象のメタデータファイルが種類ごとに整理されて格納されます。この構造を理解することで、必要なファイルの場所を素早く特定できます。

メタデータの依存関係

メタデータ間の依存関係を理解することは、安全なリリースのために欠かせません。例えば、

• カスタムオブジェクトと、それに紐づく項目の関係
• 数式項目と、その中で参照している他の項目との関係
• Apexクラスと、それが参照する他のクラスやオブジェクトとの関係

これらの依存関係を適切に把握し、package.xmlに反映することで、リリース時のエラーを防ぐことができます。
次の章では、これらの知識を踏まえた上で、実際のリリース手順について詳しく説明していきます。

第3章：実践！スムーズなリリースの手順

ここまでの準備と基礎知識を踏まえて、実際のリリース手順を見ていきましょう。この章では、プロジェクトの作成から検証、最終的なリリースまでを、実務で使える形で説明します。

プロジェクトの作成とリリース元組織の設定

まず、Visual Studio Codeでコマンドパレットを開きます（Windows: Ctrl+Shift+P、Mac: Cmd+Shift+P）。「SFDX: マニフェストファイルを使用してプロジェクトを作成」を選択します。

ここで重要なのは、プロジェクト名の付け方です。たとえば「リリース日_目的」のような命名規則を決めておくと、後々の管理が楽になります。「salesforce_20240110_feature_update」といった具合です。
次に、リリース元組織の認証を行います。この際、本番組織から取得する場合は、必ず「本番環境」を選択してください。これにより、誤って開発環境のメタデータを取得するリスクを防げます。

package.xmlの効率的な作成

package.xmlの作成には、「Salesforce Package.xml Generator」を活用します。このツールの真価は、GUIでメタデータを選択できる点にあります。

メタデータを選択する際の重要なポイントは以下の通りです。

 
たとえば、カスタムオブジェクトをリリースする場合、関連する項目、ページレイアウト、リストビューなども必要になることがあります。

メタデータの取得と検証

選択したメタデータを取得する際は、まず検証を行います。ターミナルで以下のコマンドを実行します。

----------------------------------------------------
bash
Copy
sf project deploy validate -x manifest/package.xml -l RunLocalTests
----------------------------------------------------

このコマンドには重要な意味があります。validateオプションを使うことで、実際のリリースを行わずに問題点を確認できます。また、RunLocalTestsにより、影響を受ける可能性のあるテストが実行されます。

検証が成功したら、実際のリリースに進みます。

----------------------------------------------------
bash
Copy
sf project deploy quick --job-id 【検証時に表示されたJobID】
----------------------------------------------------

トラブルシューティング

リリース作業中によく遭遇する問題とその対処法をまとめておきましょう。

 
このような問題に備え、リリース前には必ず検証を行い、十分な時間的余裕を持って作業を進めることをお勧めします。

まとめ：より確実で効率的なリリースに向けて

ここまで、Visual Studio CodeとSalesforce CLIを使用したリリース手法について説明してきました。この方法の最大の利点は、作業の自動化と標準化にあります。特に大規模な変更や、定期的なリリースが必要なプロジェクトでは、大きな効果を発揮します。
ポイントを整理すると、以下の点に注意を払うことで、より確実なリリースが可能になります。

 
また、この手法は単にリリース作業を効率化するだけでなく、チーム全体の開発プロセスを改善する機会にもなります。バージョン管理との連携や、CI/CDパイプラインの構築など、さらなる改善の可能性も広がっています。

この記事で紹介した方法を、ぜひ皆さんの現場でも試していただければと思います。最初は戸惑うことがあるかもしれませんが、一度習得すれば、リリース作業の負担は大きく軽減されるはずです。

Note リリース作業は、システムの安定性に直接影響を与える重要な作業です。新しい手法を導入する際は、まず小規模な変更から始めて、徐々に範囲を広げていくことをお勧めします。

次のステップとして、以下のような発展的な取り組みも検討してみてください。

 
最後に、この手法を実践する中で気づいた改善点やノウハウは、ぜひチーム内で共有してください。それが、よりよい開発プロセスを築いていく第一歩となります。

＜Salesforce＞
弊社ではSalesforceをはじめとするさまざまな無料オンラインセミナーを実施しています！
＞＞セミナー一覧はこちら

また、弊社ではSalesforceの導入支援のサポートも行っています。ぜひお気軽にお問い合わせください。
＞＞Salesforceについての詳細はこちら
＞＞Salesforceの導入支援実績はこちらからご覧いただけます！

医療業界に特化した営業支援、顧客管理(SFA/CRM)のコンサルティングも提供しております。こちらもぜひお気軽にお問い合わせください。
＞＞顧客管理(SFA/CRM)のコンサルティングの詳細はこちら