この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Ant 移行ツールを使用した変更のリリース

Visual Studio Code 向け Salesforce 拡張機能に加えて、Apex のリリースにスクリプトを使用することもできます。

Apache の Ant 開発ツールを使用して、Developer Edition または Sandbox を使用している組織から本番組織にメタデータの変更および Apex クラスをファイルベースでリリースする場合は、Ant 移行ツールをダウンロードします。

Ant 移行ツールは Salesforce により提供される、ユーザとパートナーをサポートする無料のリソースですが、Salesforce のメインサービス契約におけるサービスの一部とはみなされません。

メモ

Ant 移行ツールを使うには、次を行います。
  1. http://www.oracle.com/technetwork/java/javase/downloads/index.html にアクセスし、Java JDK をインストールします。

    Ant 移行ツールのバージョン 51.0 以降には、Java バージョン 11 以降が必要です。

    セキュリティを強化するために Ant 移行ツールのバージョン 36.0 から 50.0 を使用している場合、Java 7 以降および Ant 移行ツールの最新バージョン (バージョン 36.0 以降) をお勧めします。バージョン 36.0 以降の Ant 移行ツールは、Java バージョン 7 (1.7) を検出したときに Salesforce との安全な通信に TLS 1.2 を使用します。Java 7 の場合、TLS 1.1 および 1.2 が明示的に有効になります。Java 8 (1.8) の場合、TLS 1.2 が使用されます。Java バージョン 6 の場合は、TLS 1.0 が使用されますが、現在 Salesforce ではサポートされていません。

    または、Java 7 を使用している場合、Ant 移行ツールをバージョン 36.0 以降にアップグレードする代わりに、ANT_OPTS 環境変数に次の設定を追加できます。

    1-Dhttps.protocols=TLSv1.1,TLSv1.2

    この設定によって、ローカルシステムにある他の Ant ツールにも TLS 1.1 および 1.2 が適用されます。

    メモ

  2. http://ant.apache.org/ にアクセスし、Apache Ant のバージョン 1.6 以降をリリースマシンにインストールします。
  3. 環境変数 (ANT_HOMEJAVA_HOMEPATH など) を、http://ant.apache.org/manual/install.html の『Ant Installation Guide』で指定されたように設定します。
  4. コマンドプロンプトを開き、ant –version を入力して、JDK と Ant が正しくインストールされているか確認してください。出力は次のようになる必要があります。
    1Apache Ant version 1.7.0 compiled on December 13 2006
  5. Summer '21 Ant 移行ツールの .zip ファイルをダウンロードします。このダウンロードリンクでは、Salesforce に対する認証は行われません。Salesforce にログインしている場合は、いったんログアウトしてからブラウザでこのリンクにアクセスすることをお勧めします。
  6. ダウンロードしたファイルを、任意のディレクトリに展開します。Zip ファイルには次が含まれます。
    • ツールの使用方法を説明した Readme.html ファイル
    • Ant タスクを含む Jar ファイル: ant-salesforce.jar
    • 次の内容を含むサンプルフォルダ:
      • SampleDeployClass.clsSampleFailingTestClass.cls を含む codepkg\classes フォルダ
      • SampleAccountTrigger.trigger を含む codepkg\triggers フォルダ
      • 例で使用するカスタムオブジェクトを含む mypkg\objects フォルダ
      • 組織から例を削除するための XML ファイルを含む removecodepkg フォルダ
      • build.xml の Ant タスクを実行するための認証情報を指定するサンプル build.properties ファイル
      • deploy および retrieve API コールを実行するサンプル build.xml ファイル
  7. Ant 移行ツールは、配布 ZIP ファイル内にある ant-salesforce.jar ファイルを使用します。以前のバージョンのツールをインストールして ant-salesforce.jar を Ant lib ディレクトリにコピーしている場合は、以前の jar ファイルを削除します。lib ディレクトリは、Ant のインストール先のルートフォルダにあります。この新しい jar ファイルを Ant lib ディレクトリにコピーする必要はありません。
  8. 展開したファイル内のサンプルサブディレクトリを開きます。
  9. build.properties ファイルを編集します。
    1. Salesforce 本番組織ユーザ名およびパスワードを、sf.usersf.password 項目にそれぞれ入力します。
      • Apex を編集するための権限を持っているユーザ名を指定する必要があります。
      • 信頼されないネットワークから Ant 移行ツールを使用する場合、パスワードにセキュリティトークンを追加します。セキュリティトークンについての詳細は、Salesforce ヘルプの「セキュリティトークンのリセット」を参照してください。

      メモ

    2. Sandbox 組織にリリースする場合、sf.serverurl 項目を https://test.salesforce.com に変更してください。
  10. サンプルディレクトリのコマンドウィンドウを開きます。
  11. ant deployCode を入力します。これは、Ant 移行ツールで提供されたサンプルクラスと Account トリガを使用して、deploy API コールを実行します。

    ant deployCode は、build.xml ファイルの deploy という名前の Ant ターゲットをコールします。

    1<!-- Shows deploying code & running tests for package 'codepkg' -->
    2    <target name="deployCode">
    3      <!-- Upload the contents of the "codepkg" package, running the tests for just 1 class -->
    4      <sf:deploy username="${sf.username}" password="${sf.password}" serverurl="${sf.serverurl}" deployroot="codepkg">
    5        <runTest>SampleDeployClass</runTest>
    6      </sf:deploy>
    7    </target>

    詳細は、「deploy について」を参照してください。

  12. ant deployCode の実行の一部として追加されたテストクラスとトリガを削除するには、コマンドウィンドウ ant undeployCode 内で次を入力します。

    ant undeployCode は、build.xml ファイル内で undeployCode という Ant ターゲットをコールします。

    1<target name="undeployCode">
    2      <sf:deploy username="${sf.username}" password="${sf.password}" serverurl=
    3            "${sf.serverurl}" deployroot="removecodepkg"/>
    4</target>
Ant 移行ツールについての詳細は、『Ant 移行ツールガイド』を参照してください。