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

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

    始める前に

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

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

    このタスクについて

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

    手順

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

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

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

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

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

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