テンプレートの操作

ベスト・プラクティス

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

考慮事項

• アプリケーションとディメンションをテンプレートにインポートおよびエクスポートするには、サービス管理者であるか、「移行 - 管理」の詳細な役割(詳細な役割と権限の理解を参照)を持っている必要があります。
• アプリケーション・エクスポートには、アプリケーションまたはディメンション全体とすべての依存アーティファクト(グローバル接続など)が含まれます。詳細なエクスポートには、選択したメタデータ・オブジェクトのみが含まれ、すべての依存関係が自動的に含まれるわけではありません。詳細なエクスポートを使用する場合は、インポート・エラーを回避するために、必要な依存オブジェクトがターゲット環境に存在するか、テンプレートに含まれていることを確認してください。
• アプリケーションがターゲット環境に転送される場合:
  • ソース環境のアプリケーション所有者がターゲット環境にも存在する場合、それらはターゲット環境のアプリケーション所有者として保持されます。
  • ソース環境のアプリケーション所有者がターゲット環境に存在しない場合、サービス管理者はターゲット環境のアプリケーションに所有者を割り当てる必要があります。
• 新規または既存のアプリケーション、ディメンションあるいはサポートされているメタデータ・オブジェクトを転送できます。テンプレート・インポート・プロセスでは、まだ存在しないオブジェクトを作成し、既存のオブジェクトを変更することにより、ターゲット環境の既存のアプリケーション、ディメンションまたはメタデータ・オブジェクトを更新します。テンプレートを使用した既存のアーティファクトの更新を参照してください。
• アクティブなアプリケーションのみを転送できます。
• ソース環境のアーカイブ済オブジェクトがターゲット環境にまだ存在しない場合、アーカイブ済データ・チェーン・オブジェクトをテンプレート・インポートから除外できます。

  Note:

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

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

• 単一のテンプレート・ファイルでアプリケーションとディメンションの両方を転送できます。たとえば、PlanningアプリケーションからGLアプリケーションと2つのディメンションを選択できます。ただし、アプリケーションを選択すると、そのアプリケーションのすべてのディメンションが自動的に含められることに注意してください。アプリケーションを選択してから、そのアプリケーション内のディメンションのサブセットのみを選択することはできません。したがって、GLアプリケーションに3つのディメンションがある場合、2つのディメンションを単独で選択できますが、アプリケーション全体を選択すると、3つのディメンションがすべて自動的に含まれます。

  Tip:

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

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

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

  Caution:

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