Force.com 移行ツールガイド
jSalesforce 組織への変更のリリース
build.xml ファイルは、取得およびリリースするターゲットを指定します。次のパラメータは、リリースターゲットごとに設定できます。
| 項目 | 説明 |
|---|---|
| username | sessionId が指定されていない場合は必須です。ログイン用の Salesforce ユーザ名。この接続に関連付けられるユーザ名は、「すべてのデータの編集」権限を持っている必要があります。通常、これはシステム管理者のみに有効です。 |
| password | sessionId が指定されていない場合は必須です。このプロジェクトに関連付けられた組織にログインするために使用するパスワード。セキュリティトークンを使用している場合は、パスワードの最後に 25 桁のトークン値を貼り付けます。 |
| sessionId | username および password が指定されていない場合は必須です。有効な Salesforce セッションの ID。セッションは、ユーザがユーザ名とパスワードを使用して正常に Salesforce にログインした後に作成されます。新しいセッションを作成する代わりに既存のセッションにログインする場合に、セッション ID を使用します。 |
| serverurl | 省略可能。Salesforce サーバの URL (空白の場合、デフォルトは login.salesforce.com)。Sandbox インスタンスに接続するには、test.salesforce.com に変更します。 |
| pollWaitMillis | 省略可能。デフォルトは 10000 です。リリース結果をポーリングする場合の待機時間 (ミリ秒単位) です。待機を停止した場合でも、リリースに成功することがあります。 |
| checkOnly | 省略可能。デフォルトは false です。組織で一切の変更を行わず、リリースされたファイルの正当性をチェックするには、true に設定します。この場合、コンポーネントはリリースされず、組織の変更も行われません。 |
| 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 です。有効なオプションは、次のとおりです。
|
| purgeOnDelete | true の場合、destructiveChanges.xml マニフェストファイルの削除されたコンポーネントはごみ箱に保存されません。代わりに、即座に削除の対象となります。このオプションは Developer Edition 組織または Sandbox 組織でのみ機能しますが、本番組織では機能しません。 |
| rollbackOnError | 省略可能。デフォルトは true です。エラーが発生した場合、ロールバックを完了するか (true)、否か (false) を示します。false の場合、エラーなしで実行できるアクションのセットはすべて実行され、残りのアクションではエラーが返されます。本番組織にリリースする場合は、このパラメータは true に設定されている必要があります。 |
| runAllTests | (廃止済みであり、API バージョン 33.0 以前でのみ使用できます。) このパラメータは省略可能で、デフォルトは false です。インストール済みの管理パッケージから作成されたテストを含むすべての Apex テストをリリース後に実行するには、true に設定します。 |
| runTest | 子要素 (省略可能)。リリース後に実行されるテストが含まれた Apex クラスのリストです。詳細は、「リリースでのテストのサブセットの実行」を参照してください。 |
| testLevel |
省略可能。リリースの一環として実行するテストを指定します。テストレベルは、リリースパッケージに存在するコンポーネントの種類に関係なく強制適用されます。有効な値は、次のとおりです。
テストレベルを指定しないと、デフォルトのテスト実行動作が使用されます。「リリースでのテストの実行」を参照してください。 この項目は、API バージョン 34.0 以降で使用できます。 |
| trace | 省略可能。デフォルトは false です。SOAP 要求と応答をコンソールに表示します。これには、ログイン時のユーザのパスワードがプレーンテキストで表示されます。 |
Force.com 移行ツールには、いくつかのリリースターゲットをリストするサンプル build.xml ファイルが含まれています。サンプルターゲットを開始点として使用して、独自のカスタムターゲットを作成できます。次に、サンプルターゲットについて説明します。
- deployUnpackaged — ターゲットで指定されるパッケージ化されていないコンポーネントをリリースします。
- deployCode — ターゲットで指定される codepkg パッケージのコンテンツをリリースします。
- undeployCode — destructiveChanges.xml マニフェストで指定される removecodepkg ディレクトリのクラスとトリガを削除します。このファイルは、package.xml と似ていますが、リストされるのは削除するコンポーネントです。詳細は、「組織からのファイルの削除」を参照してください。
- deployCodeFailingTest — デモ目的のためにのみ、テスト要件を満たしていないコードをリリースします。
- deployCodeCheckOnly — リリースが動作することを確認しますが、コンポーネントのリリースは行いません。