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

Salesforce 組織への変更のリリース

Ant 移行ツールは Spring '24 で廃止されます。ツールは今後の API バージョンでは引き続き機能しますが、新機能により更新されることはなく、サポートされなくなります。メタデータの変更を管理するには、Salesforce CLI に切り替えて、最新のサポートされる開発者環境を使用します。

メモ

build.xml ファイルは、取得およびリリースするターゲットを指定します。各リリースターゲットに次のパラメーターを設定できます。

項目	説明
username	sessionId が指定されていない場合は必須です。ログイン用の Salesforce ユーザー名。この接続に関連付けられるユーザー名には、「メタデータ API 関数を使用したメタデータを変更」権限が必要です。
password	sessionId が指定されていない場合は必須です。このプロジェクトに関連付けられた組織にログインするために使用するパスワード。セキュリティトークンを使用している場合は、パスワードの最後に 25 桁のトークン値を貼り付けます。
sessionId	username および password が指定されていない場合は必須です。有効な Salesforce セッションの ID または OAuth アクセストークン。セッションは、ユーザーがユーザー名とパスワードを使用して正常に Salesforce にログインした後に作成されます。新しいセッションを作成するのではなく既存のセッションにログインする場合は、セッション ID を使用します。または、OAuth 認証のためのアクセストークンを使用します。詳細は、Salesforce ヘルプの「OAuth によるアプリケーションの認証」を参照してください。
serverurl	省略可能。Salesforce サーバーの URL (空白の場合、デフォルトは `login.salesforce.com`)。Sandbox インスタンスに接続するには、この URL を `test.salesforce.com` に変更します。
pollWaitMillis	省略可能。デフォルトは `10000` です。リリース結果をポーリングする場合の待機時間 (ミリ秒単位) です。待機を停止した場合でも、リリースに成功することがあります。
checkOnly	省略可能。デフォルトは `false` です。コンポーネントをターゲット組織に保存せずにコンポーネントのテストリリース (検証) を実行するには、`true` に設定します。検証では、リリースで生成されるテストの結果を確認できますが、変更はコミットされません。テストに合格して検証が完了したら、テストを再実行する��となくリリースできます。「最近の検証のリリース」を参照してください。項目種別を「主従関係」から「参照関係」 (またはその逆) に変更しても、checkOnly パラメーターを使用したリリースのテストではサポートされません。データの損失や破損を避けるため、テストリリースではこの変更はサポートされていません。テストリリースでサポートされない変更がリリースパッケージに含まれていると、テストのリリースは失敗し、エラーとなります。リリースパッケージで「主従関係」から参照関係」 (またはその逆) に変更されても、本番組織にリリースする前に変更を検証することは可能です。別のテスト用 Sandbox 組織に対して完全リリースを実行します。完全リリースには、リリースプロセスの一部としての変更の検証が含まれます。メモ
maxPoll	省略可能。デフォルトは `200` です。リリース要求の結果を得るためにサーバーをポーリングする回数です。待機を停止した場合でも、リリースに成功することがあります。
deployRoot	zipFile が指定されていない場合は必須です。リリースするファイルのディレクトリツリーのルートを指定します。zipFile または deployRoot のいずれかの値を定義する必要があります。
zipFile	deployRoot が指定されていない場合は必須です。リリースするメタデータ zip ファイルのパスを指定します。zipFile または deployRoot のいずれかの値を定義する必要があります。
singlePackage	省略可能。デフォルトは `false` です。zipFile または deployRoot パラメーターが、パッケージのセットではなく、1 つのパッケージを持つディレクトリ構造を指し示すことを宣言します。
allowMissingFiles	省略可能。デフォルトは `false` です。ファイルが package.xml では指定されているが、zip ファイルには存在しない場合でもリリースが成功するかどうかを指定します。本番組織へのリリースでは、このパラメーターを使用しないでください。
autoUpdatePackage	省略可能。デフォルトは `false` です。ファイルが zip ファイルには存在するが、package.xml では指定されていない場合でもリリースを継続するかどうかを指定します。本番組織へのリリースでは、このパラメーターを使用しないでください。
ignoreWarnings	省略可能。デフォルトは `false` です。この設定は、警告が発生した場合でもリリースが成功するのか (`true`)、リリースが失敗してロールバックするのか (`false`) を示します。警告ではなくエラーが発生した場合、リリースは常に失敗しロールバックします。
logType	省略可能。テストを実行するときのデバッグログレベル。デフォルトは `None` です。有効なオプションは、次のとおりです。 `None` `Debugonly` `Db` `Profiling` `Callout` `Detail`
purgeOnDelete	`true` の場合、destructiveChanges.xml マニフェストファイルの削除されたコンポーネントはごみ箱に保存されません。代わりに、即座に削除の対象となります。このオプションは Developer Edition 組織または Sandbox 組織でのみ機能します。本番組織では機能しません。
rollbackOnError	省略可能。デフォルトは `true` です。エラーが発生した場合、ロールバックを完了するか (`true`)、否か (`false`) を示します。`false` の場合、エラーなしで実行できるアクションのセットはすべて実行され、残りのアクションではエラーが返されます。本番組織にリリースする場合は、このパラメーターは `true` に設定されている必要があります。以前のバージョンの Ant 移行ツール (Spring '14 以前) では、このパラメーターは build.xml で無視され、Salesforce はこのパラメーターが `true` に設定されているかのように動作します。メモ
runAllTests	(廃止済みであり、API バージョン 33.0 以前でのみ使用できます。)このパラメーターは省略可能で、デフォルトは `false` です。インストール済みの管理パッケージから作成されたテストを含むすべての Apex テストをリリース後に実行するには、`true` に設定します。リリースの一環として実行される Apex テストは、常に順序に従って同期実行されます。メモ
runTest	子要素 (省略可能)。リリース後に実行されるテストが含まれた Apex クラスのリストです。詳細は、「リリースでのテストのサブセットの実行」を参照してください。このオプションを使用するには、testLevel を `RunSpecifiedTests` に設定します。
testLevel	省略可能。リリースの一環として実行するテストを指定します。テストレベルは、リリースパッケージに存在するコンポーネントの種類に関係なく強制適用されます。有効な値は、次のとおりです。 `NoTestRun` — テストは実行されません。このテストレベルは、Sandbox、Developer Edition、トライアル組織など、開発環境へのリリースにのみ適用されます。このテストレベルは、開発環境のデフォルトです。 `RunSpecifiedTests` — runTests オプションで指定したテストのみが実行されます。このテストレベルを使用する場合、コードカバー率要件がデフォルトのカバー率要件とは異なります。リリースパッケージ内にある各クラスおよびトリガーは、実行されたテストによって 75% 以上のコードカバー率でカバーされる必要があります。このカバー率は、クラスおよびトリガーごとに個別に計算され、全体のカバー率とは異なります。 `RunLocalTests` — インストール済みの管理パッケージおよびロック解除済みパッケージから発生したテストを除き、組織のすべてのテストが実行されます。このテストレベルは、デフォルトでは Apex クラスまたはトリガーを含む、本番リリース用です。 `RunAllTestsInOrg` — すべてのテストが実行されます。テストには、管理パッケージのテストを含む、組織内のすべてのテストが含まれます。テストレベルを指定しないと、デフォルトのテスト実行動作が使用されます。「リリースでのテストの実行」を参照してください。リリースの一環として実行される Apex テストは、常に順序に従って同期実行されます。メモこの項目は、API バージョン 34.0 以降で使用できます。
trace	省略可能。デフォルトは `false` です。SOAP 要求と応答をコンソールに表示します。このオプションを選ぶと、ログイン時のユーザーのパスワードがプレーンテキストで表示されます。

Ant 移行ツールでは、名前がピリオド (.) で開始したり、チルダ (~) で終了したりするファイルまたはフォルダーは、ファイルのリリース時に無視されます。Subversion などの一部のリリース元制御システムでは、名前がピリオドで開始するファイルまたはフォルダーが作成されます。これらのファイルは、Salesforce へのリリース時に問題の原因となる可能性があるため、Ant 移行ツールでは無視されます。

メモ

Ant 移行ツールには、いくつか��リリースターゲットが一覧されているサンプル build.xml ファイルが含まれています。サンプルターゲットを開始点として使用して、独自のカスタムターゲットを作成できます。

deployUnpackaged — ターゲットで指定されるパッケージ化されていないコンポーネントをリリースします。
deployCode — ターゲットで指定される codepkg パッケージのコンテンツをリリースします。
undeployCode — destructiveChanges.xml マニフェストで指定される removecodepkg ディレクトリのクラスとトリガーを削除します。このファイルは、package.xml と似ていますが、リストされるのは削除するコンポーネントです。詳細は、「組織からのファイルの削除」を参照してください。
deployCodeFailingTest — デモ目的のためにのみ、テスト要件を満たしていないコードをリリースします。
deployCodeCheckOnly — リリースが動作することを確認しますが、コンポーネントのリリースは行いません。

最大 10,000 ファイルまで同時にリリースまたは取得できます。AppExchange パッケージではさまざまな制限が使用されます。API バージョン 43.0 と 44.0 では、AppExchange パッケージに最大 12,500 件のファイルを含めることができます。API バージョン 45.0 では、AppExchange パッケージに最大 17,500 件のファイルを含めることができます。API バージョン 46.0 では、AppExchange パッケージに最大 22,000 件のファイルを含めることができます。API バージョン 47.0 から 50.0 では、AppExchange パッケージに最大 30,000 件のファイルを含めることができます。API バージョン 51.0 以降では、AppExchange パッケージに最大 31,000 件のファイルを含めることができます。リリースまたは取得する .zip ファイルの最大サイズは 39 MB です。展開したフォルダー内の非圧縮ファイルの場合、サイズ制限は 400 MB です。

Ant 移行ツールを使用して、展開したフォルダーをリリースする場合、まずフォルダー内のすべてのファイルが圧縮されます。展開したフォルダー内の非圧縮コンポーネントの最大サイズは、圧縮率に応じて 400 MB 以下です。ファイルの圧縮率が高い場合、圧縮されたサイズは 39 MB を下回るため、合計およそ 400 MB を移行できます。ただし、バイナリ静的リソースのように、それほど圧縮できないコンポーネントの場合、移行できるのは 400 MB 未満です。
メタデータ API base-64 では、コンポーネントを圧縮後にエンコードします。生成される .zip ファイルが SOAP メッセージの上限の 50 MB を超えることはできません。Base-64 エンコードではペイロードのサイズが増加するため、エンコードする前に、圧縮済みペイロードが約 39 MB を超えることはできません。
インデックスが定義されている Big Object 対してのみ retrieve() コールを実行できます。Big Object が [設定] で作成されていて、インデックスがまだ定義されていない場合、その Big Object を取得することはできません。

メモ

Ant 移行ツールガイド

Salesforce 組織への変更のリリース