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

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

    始める前に

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

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

    このタスクについて

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

    手順

    1. 次のように移動する。 All (すべて) > DevOps コンフィグ > DevOps コンフィグワークスペース.
    2. DevOps コンフィグアプリまたはコンポーネントライブラリを開いて、ファイルノードをその構成データモデルに追加します。
      オプションステップ
      アプリへのファイルノードの追加
      1. 左側のナビゲーションペインでアプリアイコン ( DevOps コンフィグアプリアイコン) を選択します。
      2. アプリケーションリストからアプリを選択します。
      3. [ 構成データを編集 ] を選択して 変更セットを開きます。
      コンポーネントライブラリへのファイルノードの追加
      1. 左側のナビゲーションペインでコンポーネントライブラリアイコン ( コンポーネントライブラリアイコン)を選択します。
      2. コンポーネントライブラリを選択して開くか 、または作成します
      3. [ 編集 ] を選択して変更セットを開きます。
      変更セットは、[ 構成データ ] タブが選択された状態で開きます。
    3. 構成データ ツリーで、ファイル ノードを追加するノードの横にあるその他のアクション アイコン ( その他のアクション アイコン) を選択し、メニューから [ ファイルの追加 ] を選択します。
      注:
      アプリでは、コンポーネント、コレクション、または展開可能項目の下のノードにファイル ノードを追加できますが、アプリのコンポーネント、コレクション、または配置フォルダーに直接追加することはできません。共有ライブラリでは、共有コンポーネントの下のノードにファイルノードを追加できます。
    4. ファイルを追加してファイルノードを作成します。
      1. [ファイルの追加] ダイアログ ボックスで、システムからファイルを参照して選択し、[ ファイルの追加] を選択します。
        Now Platformでサポートされている MIME タイプのファイルを、最大ファイルサイズ 5 MB で追加できます。
      2. [ノード名] フィールドに、ファイルノードの名前を入力します。
        デフォルトでは、添付ファイル名はファイルノード名として入力されます。[コンテンツタイプ] フィールドには、添付ファイルのコンテンツタイプも入力されます。
      3. [ ファイルを追加] を選択します。
      選択したノードにファイルノードが追加されます。構成データツリーでファイルノードを選択して、そのメタデータを [ファイル情報] ペインに表示し、ファイルのコンテンツを [ファイルコンテンツ] ペインでプレビューします。
      注:
      コンテンツプレビューは、 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. ファイル ノードの横にあるその他のアクション アイコンを選択し、メニューから 変数の抽出 を選択します。
      2. [変数の抽出] ダイアログボックスで、変数の抽出先のファイルパスを指定します。

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

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

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

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

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