Verwalten Sie Dateien im Konfigurationsdatenmodell mithilfe von Dateiknoten

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer

    • Fügen Sie Dateien hinzu, und verwalten Sie sie mithilfe von Dateiknoten im Konfigurationsdatenmodell einer CDM -App oder in einer Komponentenbibliothek.

    Vorbereitungen

    Wichtig:
    Ab Release Washington DC wird DevOps Config auf seine künftige Stilllegung vorbereitet. Es wird ausgeblendet und in neuen Instanzen nicht mehr installiert, aber weiterhin unterstützt. Weitere Informationen finden Sie im Artikel Deprecation Process [KB0867184] (Abkündigungsprozess) in der Now Support Knowledge Base.

    Erforderliche Rolle: cdm_editor oder cdm_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie eine Datei an einen entsprechenden Knoten anhängen, wird unter diesem Knoten ein Dateiknoten erstellt. Der Dateiknoten enthält einen Link zur angehängten Datei, in der Konfigurationsdaten gespeichert werden. Zum Beispiel eine Eigenschaftendatei oder eine Logobilddatei.
    • In einer App können Sie den Dateiknoten zu einem Knoten unter der Komponente, Sammlung oder im bereitstellbaren Ordner hinzufügen. Die Dateiknoten in einer Komponente werden auch eingeschlossen, wenn Sie eine Komponente in eine Sammlung und die Sammlung in das bereitstellbare Element in einer App aufnehmen. Sie können die Dateiknoten, die auf Sammlungs- oder bereitstellbarer Ebene enthalten sind, wie jedes andere Konfigurationsdatenelement überschreiben.
    • In einer Komponentenbibliothek können Sie einem Knoten unter einer gemeinsam genutzten Komponente einen Dateiknoten hinzufügen. Wenn die gemeinsam genutzte Komponente in einer App verwendet wird, werden die Dateiknoten zusammen mit der angehängten Datei kopiert.
    App-Entwickler und Mitglieder der Autorengruppe der App können auf die Dateiknoten zugreifen und auch die angehängten Dateien herunterladen. Sie können den Inhalt der Datei manuell validieren und dann den Snapshot veröffentlichen. DevOps-Benutzer können die validierten Konfigurationsdaten exportieren, einschließlich Dateiknoten mit URLs zu den angehängten Dateien, die auf der Instanz ServiceNow gehostet werden, in der der Export ausgeführt wurde.

    Prozedur

    1. Navigieren zu Alle > DevOps Config > DevOps Config-Arbeitsbereich.
    2. Öffnen Sie eine DevOps Config-App oder eine Komponentenbibliothek, um ihrem Konfigurationsdatenmodell einen Dateiknoten hinzuzufügen.
      OptionSchritte
      Hinzufügen eines Dateiknotens in einer App
      1. Wählen Sie im linken Navigationsbereich das Apps-Symbol ( DevOps Config-Apps-Symbol).
      2. Wählen Sie eine App aus der Liste Anwendungen aus.
      3. Wählen Sie Konfigurationsdaten bearbeiten aus, um ein Changeset zu öffnen.
      Hinzufügen eines Dateiknotens in einer Komponentenbibliothek
      1. Wählen Sie im linken Navigationsbereich das Symbol für Komponentenbibliotheken ( Symbol für Komponentenbibliotheken.).
      2. Wählen Sie eine Komponentenbibliothek aus, um sie zu öffnen, oder erstellen Sie eine.
      3. Wählen Sie Bearbeiten aus, um ein Changeset zu öffnen.
      Ein Changeset wird mit ausgewählter Registerkarte Konfigurationsdaten geöffnet.
    3. Wählen Sie in der Konfigurationsdatenstruktur das Symbol für weitere Aktionen ( Symbol für weitere Aktionen.) neben einem Knoten, dem Sie einen Dateiknoten hinzufügen möchten, und wählen Sie dann Datei hinzufügen aus dem Menü aus.
      Hinweis:
      In einer App können Sie einen Dateiknoten zu einem Knoten unter der Komponente, Sammlung oder dem bereitstellbaren Element hinzufügen, jedoch nicht direkt zur Komponente, Sammlung oder zum Bereitstellungsordner in einer App. In einer gemeinsam genutzten Bibliothek können Sie einem Knoten unter einer gemeinsam genutzten Komponente einen Dateiknoten hinzufügen.
    4. Fügen Sie eine Datei hinzu, um einen Dateiknoten zu erstellen.
      1. Suchen Sie im Dialogfeld „Datei hinzufügen“ nach einer Datei in Ihrem System, wählen Sie sie aus, und wählen Sie Datei hinzufügenaus.
        Sie können eine von Now Platform unterstützte MIME-Datei mit einer maximalen Dateigröße von 5 MB hinzufügen.
      2. Geben Sie im Feld Knotenname einen Namen für den Dateiknoten an.
        Standardmäßig wird der Name der angehängten Datei als Dateiknotenname ausgefüllt. Das Feld Inhaltstyp wird auch mit dem Inhaltstyp der angehängten Datei gefüllt.
      3. Wählen Sie Datei hinzufügen.
      Der Dateiknoten wird dem ausgewählten Knoten hinzugefügt. Wählen Sie den Dateiknoten in der Konfigurationsdatenstruktur aus, um seine Metadaten im Dateiinformationsbereich anzuzeigen und eine Vorschau des Dateiinhalts im Dateiinhaltsbereich anzuzeigen.
      Hinweis:
      Die Inhaltsvorschau ist für Dateien mit den folgenden MIME-Typen verfügbar: 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. Um Inhalte für zusätzliche MIME-Typdateien anzuzeigen, fügen Sie sie als kommagetrennte Liste der Systemeigenschaft sn_cdm.attachment.display_mime_typeshinzu. Die Vorschau ist nicht für MIME-Typen von Binärdateien wie Audio, Bild und Video verfügbar.

      Ein Dateiknoten, der einem Komponentenknoten hinzugefügt wird.

    5. Wahlweise: Nachdem der Dateiknoten den Konfigurationsdaten hinzugefügt wurde, können Sie die folgenden Aktionen für den Dateiknoten oder den darin enthaltenen Dateianhang ausführen.
      Hinweis:
      Alle Aktionen für den Dateiknoten oder seinen Dateianhang können nur über das Menü „Weitere Aktionen“ im Dateiknoten ausgeführt werden.
      AktionSchritte
      Benennen Sie den Dateiknoten um
      1. Wählen Sie das Symbol „Weitere Aktionen“ neben dem Dateiknoten und dann Umbenennen aus dem Menü.
      2. Geben Sie im Dialogfeld „Umbenennen“ im Feld Knotenname einen neuen Namen für den Dateiknoten ein.

      Wenn der Dateiknoten in der Sammlung enthalten ist, wird er auch dort umbenannt.
      Variablen extrahieren
      1. Wählen Sie das Symbol „Weitere Aktionen“ neben dem Dateiknoten und dann Variablen extrahieren aus dem Menü.
      2. Geben Sie im Dialogfeld „Variablen extrahieren“ den Dateipfad an, in den Sie die Variablen extrahieren möchten.

      Alle Variablen im Dateiknoten mit dem Tag @@<variableName> @@ werden in den von Ihnen angegebenen Dateipfad extrahiert. Die Variable wird dann so geändert, dass sie auch den Dateipfad enthält.

      Sie können dann alle extrahierten Variablen auflösen. Definieren Sie die extrahierten Variablen, und wählen Sie dann Variablen anwenden im Kontextmenü des Formulars aus. Diese Aktion ersetzt alle extrahierten Variablen im Dateiinhalt durch die definierten Variablenwerte.
      Löschen Sie den Dateiknoten
      1. Wählen Sie das Symbol „Weitere Aktionen“ neben dem Dateiknoten und dann Löschen aus dem Menü.
      2. Wählen Sie im Popup-Fenster „Löschen“ die Option Löschen aus.
      Das Löschen des Dateiknotens hat folgende Auswirkungen auf den Knoten und seinen Dateianhang:
      • Wenn der Dateiknoten in der Sammlung enthalten ist, wird er auch von dort gelöscht. Jeder überschriebene Dateiknoten wird zu einem direkten Dateiknoten.
      • Wenn der Dateiknoten im aktuell geöffneten Changeset erstellt wird, das noch nicht committet wurde, werden der Dateiknoten und sein Dateianhang dauerhaft gelöscht.
      • Wenn der Dateiknoten in einem zuvor committeten Changeset erstellt wurde und im aktuell geöffneten Changeset gelöscht wird, wird der Dateiknoten aus den Konfigurationsdaten gelöscht, der Dateianhang verbleibt jedoch im System.
      Laden Sie den Dateianhang herunter Wählen Sie das Symbol „Weitere Aktionen“ neben dem Dateiknoten und dann Datei herunterladen aus dem Menü.

      Alternativ können Sie die Datei herunterladen, indem Sie den Dateiknoten auswählen und dann Herunterladen im Dateiinformationsbereich auswählen.
      Ersetzen Sie den Dateianhang
      1. Wählen Sie das Symbol „Weitere Aktionen“ neben dem Dateiknoten und dann Datei ersetzen aus dem Menü.
      2. Hängen Sie im Dialogfeld „Datei ersetzen“ eine Datei aus Ihrem System an, und wählen Sie Datei ersetzenaus.
      Überschreiben Sie einen enthaltenen Dateiknoten Wenn ein Dateiknoten in einer Sammlung und in einem bereitstellbaren Element enthalten ist, können Sie ihn überschreiben, indem Sie die angehängte Datei durch eine neue ersetzen.
      1. Wählen Sie das Symbol „Weitere Aktionen“ neben dem enthaltenen Dateiknoten in der Sammlung oder im bereitstellbaren Ordner, und wählen Sie dann Datei ersetzen aus dem Menü aus.
      2. Hängen Sie im Dialogfeld „Datei ersetzen“ eine Datei aus Ihrem System an, und wählen Sie Datei ersetzenaus.