ファイルノードを使用した構成データモデル内のファイルの管理

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:6分
  • ファイルノードを使用して、CDM アプリの構成データモデルまたはコンポーネントライブラリ内でファイルを追加および管理します。

    始める前に

    重要:
    DevOps コンフィグ は現在廃止されており、新しいアクティベーションのサポートや利用は終了しています。

    必要なロール:cdm_editor または cdm_admin

    このタスクについて

    該当するノードにファイルをアタッチすると、そのノードの下にファイルノードが作成されます。ファイルノードには、構成データを格納する添付ファイルへのリンクが含まれています。たとえば、プロパティファイルやロゴ画像ファイルなどです。
    • アプリでは、コンポーネント、コレクション、または展開可能フォルダーの下のノードにファイルノードを追加できます。コンポーネントをコレクションに含め、コレクションをアプリの展開可能項目に含める場合にも、コンポーネント内のファイルノードが含まれます。他の構成データ項目と同様に、コレクションまたは展開可能レベルに含まれるファイルノードをオーバーライドできます。
    • コンポーネントライブラリでは、共有コンポーネントの下のノードにファイルノードを追加できます。共有コンポーネントがアプリで使用されると、ファイルノードは添付されたファイルとともにコピーされます。
    アプリ開発者とアプリの作成グループのメンバーは、ファイルノードにアクセスしたり、添付ファイルをダウンロードしたりできます。ファイルのコンテンツを手動で検証してから、スナップショットを公開できます。DevOps ユーザーは、エクスポートが実行された ServiceNow インスタンスでホストされている添付ファイルへの URL を持つファイルノードを含む、 検証済みの構成データをエクスポートできます。

    手順

    1. 移動先 すべて > DevOps コンフィグ > DevOps コンフィグワークスペース.
    2. DevOps コンフィグアプリまたはコンポーネントライブラリを開いて、ファイルノードをその構成データモデルに追加します。
      オプションステップ
      アプリへのファイルノードの追加
      1. 左側のナビゲーションペインでアプリアイコン (DevOps コンフィグアプリアイコン) を選択します。
      2. アプリケーションリストからアプリを選択します。
      3. [構成データを編集] を選択して変更セットを開きます。
      コンポーネントライブラリへのファイルノードの追加
      1. 左側のナビゲーションペインでコンポーネントライブラリアイコン (コンポーネントライブラリアイコン) を選択します。
      2. コンポーネントライブラリを選択して開くか、作成します
      3. [編集] を選択して変更セットを開きます。
      [構成データ] タブが選択された状態で変更セットが開きます。
    3. 構成データツリーで、ファイルノードを追加するノードの横にあるその他のアクションアイコン (その他のアクションアイコン)を選択し、メニューから [ファイルを追加]を選択します。
      注:
      アプリでは、コンポーネント、コレクション、または展開可能項目の下のノードにファイルノードを追加できますが、アプリのコンポーネント、コレクション、または展開フォルダーに直接追加することはできません。共有ライブラリでは、共有コンポーネントの下のノードにファイルノードを追加できます。
    4. ファイルを追加して、ファイルノードを作成します。
      1. [ファイルを追加] ダイアログボックスで、システムからファイルを参照して選択し、[ファイルを追加] を選択します。
        ServiceNow AI Platform でサポートされている MIME タイプのファイルを、最大 5 MB まで追加できます。
      2. [ノード名] フィールドに、ファイルノードの名前を入力します。
        デフォルトでは、添付ファイル名がファイルノード名として入力されます。[コンテンツタイプ] フィールドには、添付ファイルのコンテンツタイプも入力されます。
      3. [ファイルを追加] を選択します。
      選択したノードにファイルノードが追加されます。構成データツリーでファイルノードを選択すると、そのメタデータが [ファイル情報] ペインに表示され、ファイルの内容が [ファイルコンテンツ] ペインでプレビューされます。
      注:
      コンテンツプレビューは、次の MIME タイプのファイルで使用できます:text/yaml、text/css、text/csv、text/html、text/javascript、text/plain、text/richtext、text/x-vcard、text/x-vcalendar、application/xml、application/javascript、application/json。追加の MIME タイプファイルのコンテンツを表示するには、それらをカンマ区切りリストとしてシステムプロパティ sn_cdm.attachment.display_mime_types に追加します。プレビューは、オーディオ、画像、ビデオなどのバイナリファイルの MIME タイプでは使用できません。

      コンポーネントノードに追加されるファイルノード。

    5. オプション: ファイルノードが構成データに追加された後、ファイルノードまたはファイルノード内の添付ファイルに対して次のアクションを実行できます。
      注:
      ファイルノードまたはその添付ファイルに対するすべてのアクションは、ファイルノードの [その他のアクション] メニューからのみ実行できます。
      アクションステップ
      ファイルノードの名前の変更
      1. ファイルノードの横にある [その他のアクション] アイコンを選択し、メニューから [名前の変更] を選択します。
      2. [名前の変更] ダイアログボックスの [ノード名] フィールドにファイルノードの新しい名前を入力します。

      ファイルノードがコレクションに含まれている場合は、そこでも名前が変更されます。

      変数の抽出
      1. ファイルノードの横にある [その他のアクション] アイコンを選択し、メニューから [変数を抽出 (Extract variables)] を選択します。
      2. [変数を抽出 (Extract variables)] ダイアログボックスで、変数の抽出先のファイルパスを指定します。

      @@<variableName>@@ としてタグ付けされたファイルノード内のすべての変数が、指定したファイルパスに抽出されます。その後、変数はファイルパスも含まれるように変更されます。

      その後、抽出されたすべての変数を解決できます。抽出された変数を定義し、フォームのコンテキストメニューから [変数を適用] を選択します。このアクションは、ファイルコンテンツ内の抽出されたすべての変数を、定義された変数値に置き換えます。

      ファイルノードの削除
      1. ファイルノードの横にある [その他のアクション] アイコンを選択し、メニューから [削除] を選択します。
      2. [削除] ポップアップで、[削除] を選択します。
      ファイルノードを削除すると、そのノードとその添付ファイルに次のような影響があります。
      • ファイルノードがコレクションに含まれている場合は、そこからも削除されます。オーバーライドされたファイルノードは、直接ファイルノードになります。
      • 現在開いているまだコミットされていない変更セットにファイルノードが作成された場合、ファイルノードとその添付ファイルは完全に削除されます。
      • ファイルノードが以前にコミットされた変更セットで作成され、現在開いている変更セットで削除された場合、ファイルノードは構成データから削除されますが、添付ファイルはシステム内に保持されます。
      添付ファイルのダウンロード ファイルノードの横にある [その他のアクション] アイコンを選択し、メニューから [ファイルのダウンロード] を選択します。

      または、ファイルノードを選択し、[ファイル情報] ウィンドウで [ダウンロード] を選択して、ファイルをダウンロードすることもできます。

      添付ファイルの置換
      1. ファイルノードの横にある [その他のアクション] アイコンを選択し、メニューから [ファイルを置換] を選択します。
      2. [ファイルを置換] ダイアログボックスで、システムからファイルを添付し、[ファイルを置換] を選択します。
      含まれているファイルノードのオーバーライド ファイルノードがコレクションと展開可能項目に含まれている場合は、添付ファイルを新しいファイルに置き換えることでオーバーライドできます。
      1. コレクションまたは展開可能フォルダーに含まれるファイルノードの横にある [その他のアクション] アイコンを選択し、メニューから [ファイルを置換] を選択します。
      2. [ファイルを置換] ダイアログボックスで、システムからファイルを添付し、[ファイルを置換] を選択します。