構成データを格納するノードを新しい CDM アプリケーションに追加する

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • アップロードされた構成データを適切なノードに受け入れるデータ構造を新しいアプリケーションに追加します。

    始める前に

    重要:
    Washington DC リリース以降、DevOps コンフィグ は将来の廃止に備えて準備されます。これは非表示になり、新しいインスタンスにはインストールされなくなりますが、引き続きサポートされます。詳細については、Now Support ナレッジベースの「Deprecation Process (廃止プロセス) [KB0867184]」の記事を参照してください。

    必要なロール：CDM アドミン [sn_cdm.cdm_admin]

    このタスクについて

    システムが新しいアプリケーションを作成するとき、アプリケーションには最上位レベルの構造 ( コンポーネント、 コレクション、 および展開可能 フォルダー) のみが含まれます。この手順では、アップロードされた構成データを受け入れるコンポーネント、コレクション、および 展開可能 ノードを追加します。既存の構成データをアプリケーションにアップロードすると、CDMアプリケーションのデータ構造内の適切なノードでデータが [name:value] ペア (構成データアイテム - CDI) としてマッピングされます。詳細については、「CDMデータモデル」を参照してください。
    注:

    バージョン 4.2 以降 構成データ管理 、スラッシュ (/) を含む任意の UTF-8 文字を使用してノードを定義できます。

    手順

    1. コレクションに含めるコンポーネントを作成します。
      詳細については、「コンポーネントの定義または更新」と「アプリケーションでのコレクションの定義または更新」を参照してください。
    2. コレクションを 1 つまたは複数の 展開可能項目に追加します。
      1. ツリー内のコレクションノードで、メニューアイコン ( [メニュー] アイコン) を選択し 、[展開可能項目に含める (Include in deployables)] を選択します。
      2. コレクションを含めるすべての 展開可能項目 を選択し、[ 含める] を選択します。
        注:
        コレクションまたはその子孫がまだ含まれていない 展開可能項目 のみがリストに表示されます。コレクションの名前が既存のノードと同じ場合、そのコレクションは上書きまたはオーバーレイに変換されます。
        コレクションは、選択した各 展開可能に含まれます。

      コレクションを 展開可能に追加すると、 エディター パネルには含まれているコレクション名が表示されますが、そのコンテンツは表示されません(オーバーライドまたはオーバーレイは表示されます)。この戦略により、煩雑さが軽減され、構造が明確になります。完全に解決されたデータの内容を表示するには、[ プレビュー] パネルを表示します。

    3. コレクションに含めるコンポーネントを作成します。
    4. オプション: コンポーネントまたはコレクションの設定を上書きまたはオーバーレイする CDI を 展開可能 に追加します。
      注:
      アップロードされたデータ項目は、特定の項目をすばやく見つけることができるように、構造フォルダー内でアルファベット順に並べ替えられます。
      構成データアイテム (CDI) の数には、次の制限があります。
      • アプリケーションには、最大合計 100,000 の CDI を含めることができます。
      • 1 つの 展開可能 には、最大 10,000 個の CDI を含めることができます。
      sn_cdm.max_allowed_cdi_per_applicationおよびsn_cdm.max_allowed_cdi_per_deployableプロパティ設定の構成については、CDM のシステムプロパティを参照してください。
      詳細については、「 コンポーネントの定義または更新」、「 アプリケーションでのコレクションの定義または更新」、または「 変数 CDI の作成または更新」を参照してください。
    5. [保存] を選択して変更セットの変更を保存し、変更セットの変更をコミットする準備をします。
      [エディター] パネル、[リストビュー]、および [プレビュー] パネルが更新され、変更セットの解決済みステータスが反映されます。変更セットは更新されますが、アプリケーションは更新されません。変更は [ アクティビティ ] タブに表示されます。アプリケーションの構成データを更新するには、変更セットをコミットする必要があります。保存後、他のアクティビティに進み、後で変更セットに戻って編集できます。
    6. オプション: [ コミット] を選択します。
      [変更セットのコミット] ダイアログボックスが開き、変更の影響を受ける各 展開可能 が一覧表示されます。
      注:
      変更セットをコミットした後は、変更セットを変更できません。
      システムは、変更の影響を受ける各 展開可能 のスナップショットを生成します。ダイアログボックスには、次の 追加アクションがあります。
      • 変更の影響を受ける 展開可能項目 がない場合は、[ No additional actions] を選択します。システムはアプリケーションを更新して変更を保持します。
        • [ スナップショットを検証 ] を選択して、生成されたすべてのスナップショットに対して次の操作を実行します。
          • 関連付けられた展開可能に静的または動的にマッピングされたすべてのポリシーが実行されます。
          • スナップショットがすべてのポリシーに合格すると、[検証ステータス] の値は [合格 ] に設定され、[ 検証結果 ] タブにエントリは表示されません。[有効な公開を公開] オプションを使用して検証が呼び出された場合、有効なスナップショットが自動公開されます。
          • ポリシーで問題が発生した場合、[検証ステータス] の値は [失敗] に設定されます。[ 検証結果 ] タブには、ポリシーによって返されたすべての失敗または警告が表示されます。
          • ポリシーの実行が完了まで失敗した場合、[検証ステータス] の値は [実行エラー ] に設定され、[ 検証結果] タブにエラーが原因で検証が失敗したことが示されます。
        • [スナップショットの検証 と公開 ] を選択して、[ スナップショットの検証 ] アクションの説明に従って検証を実行します。検証に合格したスナップショットのみが公開されます。公開されたスナップショットのみエクスポートできます。
        [ コミット] を選択します。
        • 構成データへの変更を保持するために、アプリケーションが更新されます。
        • 変更セットのステータスが [コミット済み] に変更されます。
        • 変更セットは変更できません。
        • スナップショットが作成された場合、確認メッセージにはスナップショットへのリンクが含まれます。
        • コミット プロセス中にエラーが発生した場合、変更セットの状態は [コミットに失敗しました] に設定されます。

    次のタスク

    アプリケーションにはまだ構成データが含まれていないため、次のステップでは、既存の構成データをアプリケーションの適切なノードにインポートします。「構成データのアップロード」を参照してください。