メタデータ API 開発者ガイド
jメタデータ API リリースの特殊な動作
リリースの特定の種類と内容に関する重要な考慮事項
変更を Salesforce 組織にリリースする場合、必要なすべての変更が含まれるように、リリースの個々のコンポーネントがどのように動作するのかを考慮します。次の情報を参考にして、リリースに含めるものや、対象組織での変更の表示方法を決定してください。
- Apex クラスおよび Apex トリガ
- デフォルトでは、Apex ジョブを待機中または処理中にする Apex コードへの変更はリリースできません。これらの変更をリリースするには、次のいずれかを実行します。
- Apex コードへの変更をリリースする前に、Apex ジョブをキャンセルします。リリース後にジョブを再スケジュールします。
- Salesforce ユーザインターフェースの [リリース設定] ページで Apex ジョブによるリリースを有効化します。
- 承認プロセス
-
- メタデータ API と共に Salesforce ナレッジ記事の承認プロセスを使用するには、記事タイプをリリースする必要があります。承認プロセスの記事バージョン (_kav) の場合、サポートされるアクションの種別は、ナレッジアクション、メールアラート、項目自動更新、アウトバウンドメッセージになります。
- 承認プロセスで、カスタム項目を含む投稿テンプレートを参照している場合、変更セットに追加する前にこれらの投稿テンプレートを送信側組織に再保存する必要があります。[設定] から、[クイック検索] ボックスに「投稿テンプレート」と入力し、[投稿テンプレート] を選択します。各投稿テンプレートで、[編集]、[保存] の順にクリックします。
- メタデータには、有効承認プロセスの順序は含まれません。場合によっては、リリース後に対象組織で承認プロセスを並び替える必要があります。
- 変更セットに以前に含まれており別の組織でリリース済みの承認プロセスの [一意の名前] を変更し、変更セット経由で承認プロセスを再送信する場合は、他の組織でリリースされる時点で新しい承認プロセスが作成されます。以前にリリースされた承認プロセスは、変更されません。
- カスタム項目
- API バージョン 30.0 以降、新しいカスタム項目をリリースする場合、プロファイル項目権限の editable 項目と readable 項目のデフォルト値は false です。デフォルト値を上書きするには、新規項目の項目権限をプロファイルに含めます。
- カスタムオブジェクト
- API バージョン 29.0 では、メタデータ API を使用してオブジェクトの sharingModel を変更することはできません。対象組織に対するこのような変更は、ユーザインターフェースを使用して手動で行う必要があります。
API バージョン 30.0 以降、メタデータ API とユーザインターフェースを使用して、内部ユーザ向けにオブジェクトの sharingModel を変更できます。
- 接続アプリケーション
-
- メタデータ API で consumerKey を設定することはできません。これは、情報提供を目的とした取得操作に含まれます。接続アプリケーションを別の組織に移動する場合、組織にリリースする前に consumerKey を .zip ファイルから削除する必要があります。移行先の組織で新しいキーが生成されます。
- 接続アプリケーションのモバイル設定は、変更セットでサポートされていないため、手動で移行する必要があります。
- 指定ログイン情報
-
指定ログイン情報の次のコールアウトオプションは、ユーザインターフェースからのみ設定できます。デフォルト値が対象組織に対して適切ではない場合、その組織のシステム管理者がリリース後に手動で指定ログイン情報を設定する必要があります。
- 認証ヘッダーを生成 — デフォルト: 有効化
- HTTP ヘッダーの差し込み項目を許可 — デフォルト: 無効化
- HTTP 本文の差し込み項目を許可 — デフォルト: 無効化
- ページレイアウト
- ページレイアウトの割り当てを含むリリースでは、対象組織にある既存のすべてのページレイアウトの割り当てが、.zip ファイルで指定された割り当てに置き換えられます。組織の既存のページレイアウトが .zip ファイルに含まれていない場合、それらのページレイアウトはなくなります。すべての必要なレコードタイプの全ページレイアウトを .zip ファイルに必ず含めるようにしてください。
- プロファイル
- 対象組織に存在しない名前のプロファイルがパッケージに含まれている場合、新しいプロファイルはその名前で作成されます。リリースされたプロファイルで権限または設定が指定されていない場合、最終的なプロファイルは標準プロファイルのすべての権限と設定で構成されます。
- 共有
-
- どのオブジェクトを更新するかに関係なく、メタデータ API では、オブジェクトの sharingModel 項目の更新と新しい共有ルールの追加を同時に行うことはサポートされていません。たとえば、組織の共有設定が公開である場合、共有ルールを追加し、その後で sharingModel を更新することができます。その結果、1 回だけ共有が再適用されます。
- リリースしようとしている変更セットに親-子リレーションを持つカスタム項目が含まれるが、同じ変更セット内に主従項目がない場合、エラーが発生することがあります。このエラーを解決するには、組織の共有設定を変更していなくても、主従カスタム項目を変更セットに追加します。
- ワークフロー
- メタデータ API では、フロートリガのテストモードはサポートされていません。システム管理者がワークフロールールを起動したときにフロートリガで最新のフローバージョンを実行する場合は、リリース後にユーザインターフェースでテストモードを有効にします。