Direkt zum Hauptinhalt

Eine Webressource erstellen

Ziel​

Eine Webressource hinzufügen – eine Anwendungsdatei wie ein JavaScript-Bundle, ein Stylesheet, ein HTML-Fragment, ein Logo oder ein SVG –, die die Plattform in der Datenbank speichert und mit Ihrer Lösung packt, sodass sie überallhin mitreist, wo die Lösung importiert wird.

Eine Webressource ist für die Dateien gedacht, aus denen eine Anwendung gebaut ist. Ein großes Dokument, das ein Benutzer zur Laufzeit hochlädt, ist keine Webressource – es gehört in den Dateispeicher. Eine Größenbegrenzung pro Datei hält beides auseinander.

Voraussetzungen​

  • Sie sind beim Admin Control Center angemeldet.
  • In der oberen Leiste ist eine Umgebung ausgewählt, und Sie haben eine Lösung geöffnet (siehe Eine Lösung erstellen).

Schritte​

  1. Wählen Sie in der geöffneten Lösung in der linken Navigation Webressourcen aus.
  2. Wählen Sie Neu aus.
  3. Geben Sie einen Anzeigenamen und einen logischen Namen ein. Der logische Name trägt das Herausgeberpräfix und ist pfadartig aufgebaut – zum Beispiel par_/dashboard/app.js oder par_/logo.svg.
  4. Wählen Sie den Typ (JavaScript, CSS, HTML, JSON, XML, Text, PNG, JPEG, GIF, SVG, Symbol oder Sonstiges/Binär).
  5. Stellen Sie den Inhalt bereit:
    • Bei einem Texttyp (JavaScript, CSS, HTML, JSON, XML, Text, SVG) können Sie ihn entweder direkt im Editor bearbeiten oder eine Datei hochladen.
    • Bei einem Bild- oder Binärtyp laden Sie eine Datei hoch (es gibt nichts einzutippen).
  6. Wählen Sie Speichern aus. Die Datei wird mit der Lösung gespeichert und kann von der Plattform ausgeliefert werden.
  7. Die Liste zeigt für jede Datei die Adresse, unter der die Plattform sie ausliefert. Öffnen Sie sie in einem neuen Tab oder kopieren Sie sie mit der Schaltfläche daneben, um sie an das weiterzugeben, was die Datei abruft.

Einen Ordner mit Dateien hochladen, die aufeinander verweisen​

Eine Seite, die ihr Stylesheet, ihr Skript und ihre Bilder über relative Adressen einbindet, braucht alle diese Dateien nebeneinander. Statt sie einzeln anzulegen:

  1. Zippen Sie die Dateien: die Dateien selbst, keinen Ordner darum.
  2. Wählen Sie unter Webressourcen die Option Ordner hochladen.
  3. Geben Sie einen Anzeigenamen und einen Ordner unter dem Präfix Ihres Herausgebers an, zum Beispiel par_/badge.
  4. Wählen Sie die ZIP-Datei und dann Hochladen.

Jede Datei wird unter diesem Ordner mit ihrem relativen Pfad angelegt, sodass badge.html mit einem Verweis auf badge.css die Datei par_/badge/badge.css findet.

Ein erneuter Upload in denselben Ordner ersetzt dessen Inhalt und entfernt Dateien, die die neue ZIP-Datei nicht mehr enthält. So veröffentlichen Sie eine Änderung, denn eine Webressource wird nicht direkt bearbeitet. Dateien, die die Plattform nicht ausliefert, etwa eine .map, werden übersprungen, und das Ergebnis nennt sie.

Eine benutzerdefinierte App oder ein Steuerelement wird hier nicht hochgeladen. Beides ist ein einzelnes Paket, installiert unter Benutzerdefinierte Apps oder Benutzerdefinierte Steuerelemente (siehe Ein benutzerdefiniertes Steuerelement registrieren).

Was im Hintergrund passiert​

Die Bytes der Datei werden in der Plattformdatenbank gespeichert und als Komponente Ihrer Lösung erfasst. Beim Exportieren der Lösung wird die Datei also mitgenommen, und beim Importieren wird sie in der Zielumgebung neu angelegt. Die Plattform validiert die Metadaten der Datei, prüft, ob der logische Name mit dem Präfix Ihres Herausgebers beginnt, und weist eine Datei ab, die die Größenbegrenzung überschreitet – eine große Datei gehört stattdessen in den Dateispeicher. Anschließend kann die Plattform die Datei von ihrer eigenen Adresse mit dem richtigen Inhaltstyp ausliefern.

Die Adresse in der Liste lautet …/environments/<Umgebung>/webresources/<logischer Name> und antwortet jedem, ohne Anmeldung: Deshalb können eine Seite, ein Drucker oder eine E-Mail die Datei laden. Legen Sie nichts in eine Webressource, das Sie nicht veröffentlichen würden.

Fehlerbehebung​

  • „…muss mit dem Herausgeberpräfix … beginnen…“ – Der logische Name muss mit dem Präfix Ihres Herausgebers gefolgt von _ beginnen (zum Beispiel par_).
  • „Das Webressourcen-Manifest ist ungültig…“ – Der logische Name muss kleingeschrieben sein und darf nur Buchstaben, Ziffern, _, ., / oder - enthalten (keine Leerzeichen).
  • „…überschreitet die Obergrenze von …. Große Dateien gehören in den Objektspeicher…“ – Die Datei überschreitet die Größenbegrenzung pro Ressource; speichern Sie große Dateien im Dateispeicher, nicht als Webressource.
  • „In dieser Umgebung existiert bereits eine Webressource ‚…‘.“ – Eine Ressource mit diesem logischen Namen ist bereits vorhanden; wählen Sie einen anderen Namen.
  • „Der Bundle-Eintrag ‚…‘ hat einen Pfad, der aus seinem Ordner herausführen würde.“ – Die ZIP-Datei enthält ein ..-Segment oder einen absoluten Pfad. Zippen Sie die Dateien selbst, nicht einen Pfad darüber.
  • „Das Bundle enthält keine Dateien, die die Plattform ausliefern kann.“ – Nichts in der ZIP-Datei hat einen Typ, den die Plattform ausliefert. Prüfen Sie, ob Sie die Dateien gezippt haben und nicht einen anderen Ordner.
  • „Das Bundle enthält … Dateien; die Grenze liegt bei 200.“ – Fast sicher wurde der falsche Ordner gezippt (am wahrscheinlichsten node_modules).

Verwandte Szenarien​

  • Eine Lösung erstellen.
  • Eine benutzerdefinierte React-App registrieren.