テンプレートの操作

ベスト・プラクティス

既存の本番環境に転送する予定のアプリケーションをテスト環境で作成している場合、最初に本番環境の現在のスナップショットでテスト環境をリフレッシュしてから、転送するアプリケーションを作成することがベスト・プラクティスです。これにより、プロパティやビューなどのグローバル・オブジェクトが、両方の環境で確実に同じIDを持ちます。

考慮事項

• アプリケーションとディメンションをテンプレートにインポートおよびエクスポートするには、サービス管理者であるか、「移行 - 管理」アプリケーション・ロール(アプリケーションのロールと権限の理解を参照)を持っている必要があります。
• アプリケーションがターゲット環境に転送される場合:
  • ソース環境のアプリケーション所有者がターゲット環境にも存在する場合、それらはターゲット環境のアプリケーション所有者として保持されます。
  • ソース環境のアプリケーション所有者がターゲット環境に存在しない場合、サービス管理者はターゲット環境のアプリケーションに所有者を割り当てる必要があります。
• ソース環境からターゲット環境に新しいアプリケーションまたはディメンションを転送したり、ターゲット環境にすでに存在するアプリケーションまたはディメンションを転送できます。テンプレートのインポート・プロセスでは、まだ存在しないオブジェクトを作成し、ターゲットのアプリケーションまたはディメンションの既存のオブジェクトを変更することにより、ターゲット環境の既存のアプリケーションまたはディメンションを更新します。テンプレートを使用した既存のアプリケーションまたはディメンションの更新を参照してください。
• アクティブなアプリケーションのみを転送できます。
• ソース環境のアーカイブ済オブジェクトがターゲット環境にまだ存在しない場合、アーカイブ済データ・チェーン・オブジェクトをテンプレート・インポートから除外できます。

  Note:

  アーカイブ済オブジェクトに依存するオブジェクトがターゲット環境に存在しない場合、それらもテンプレート・インポートから除外されます。依存オブジェクトが部分的に除外される場合、オブジェクトはテンプレート・プレビューまたはテンプレート・インポートに表示されますが、インポートできないことを示す警告メッセージが表示されます。

  たとえば、インポート時にアーカイブ済ディメンションを除外し、このディメンションがターゲット環境にまだ存在しない場合、ディメンション・バインド、ノード・タイプ、ポリシー、抽出などのオブジェクトがターゲット環境にまだ存在しない場合は、これらもテンプレート・インポートから除外されます。

• 単一のテンプレート・ファイルで、複数のアプリケーションを転送できます。ディメンション・レベルで転送する場合、単一のテンプレート・ファイルで複数のディメンションを転送することはできません。
• ディメンションを転送するときは、そのディメンションを含むアプリケーションがターゲット環境に存在する必要があります。
• 環境間でアプリケーションまたはディメンションを転送するには、両方の環境のリリース・バージョンが同じである必要があります。
• テンプレートをインポートする際、ユーザーまたはグループがソース環境とターゲット環境の両方に存在する場合、関連付けられたオブジェクトに対する次のユーザーおよびグループの参照がインポートされます:
  • 権限
  • ポリシー・ユーザーおよびグループ
  • サブスクリプション担当者
  • ユーザーおよびグループのビュー・フィルタ

  ソース環境のユーザーまたはグループがターゲットに存在しない場合、関連付けられたユーザーまたはグループの参照は転送されません。ターゲット環境に欠落しているユーザーおよびグループと、インポートされなかった関連するオブジェクトを示すメッセージが表示されます。

• ノード・タイプ・コンバータおよびサブスクリプションをインポートするには、ソースおよびターゲットの両方のアプリケーションまたはディメンションがターゲット環境に存在する必要があります。同じテンプレート・ファイル内のソースおよびターゲットの両方のアプリケーションを転送するか、ターゲットのアプリケーションまたはディメンションのインポート時にコンバータおよびサブスクリプションが作成されるように、コンバータおよびサブスクリプションのソースのアプリケーションまたはディメンションを最初にインポートするようにしてください。
• ノード・データ型を使用して他のディメンションを参照するプロパティを持つディメンションを転送する場合は、それらのソース・ディメンションがターゲット・システムにすでに存在している必要があります。そうでない場合は、それらのソース・ディメンションを最初に転送するか、アプリケーション・テンプレートを使用して同じテンプレート・ファイル内のすべてのディメンションを転送します。
• 同じ名前で異なるIDを持つオブジェクトがターゲット環境にすでに存在する場合、次のグローバル・オブジェクトをインポートすると、一意にするためにターゲット環境のソース・オブジェクトの名前が変更されます:
  • プロパティ
  • ビュー
  • 参照セット
  • グローバル接続
• アプリケーションまたはディメンションをテンプレートにエクスポートした後、.jsonビューアでテンプレート・ファイルのコンテンツを確認できます。

  Caution:

  テンプレート・ファイルの手動編集はサポートされていません。