Erstellen oder Bearbeiten von Webressourcen, um eine App zu erweitern

Dieses Thema bezieht sich auf Dynamics 365 Customer Engagement (on-premises). Die Power Apps-Version dieses Themas finden Sie unter: Erstellen oder Bearbeiten von Webressourcen für modellgesteuerte Apps, um eine App zu erweitern

Webressourcen werden in der Regel von Entwicklern verwendet, um eine App mithilfe von Dateien zu erweitern, die in der Webentwicklung verwendet werden. App-Benutzer müssen möglicherweise Webressourcen verwalten, die von einem Entwickler oder Designer bereitgestellt werden.

Tipp

Eine ausführliche Diskussion zu Webressourcen finden Sie unter Webressourcen für Customer Engagement.

Was sind Webressourcen?

Webressourcen sind virtuelle Dateien, die im System gespeichert werden. Jede Webressource hat einen eindeutigen Namen, der in einer URL verwendet werden kann, um die Datei abzurufen. Stellen Sie sich dies folgendermaßen vor: Wenn Sie auf den eigentlichen Webserver zugreifen könnten, auf dem die Web-App ausgeführt wird, könnten Sie Dateien zu dieser Website kopieren. Aber mit den meisten Onlinediensten ist dies nicht möglich. Stattdessen können Sie Webressourcen verwenden, um Dateien zum System hochzuladen und diese dann per Name zu referenzieren, als ob Sie diese als Dateien zum Webserver kopiert hätten.

Wenn Sie beispielsweise eine HTML-Seite als Webressource erstellen, die den Namen "new_myWebResource.htm" hat, könnten Sie diese Seite in einem Browser über eine URL wie die folgende öffnen:

<Dynamics 365 Customer Engagement (on-premises) URL>/WebResources/new_myWebResource.htm

wobei <app URL> die URL ist, die Sie normalerweise verwenden, um die App zu öffnen. Da die Webressource Daten im System sind, können nur lizenzierte Benutzer Ihrer Organisation auf diese auf diese Art zugreifen. Normalerweise sind Webressourcen in Formularen enthalten und werden nicht direkt referernziert. Die häufigste Verwendung besteht in der Bereitstellung von JavaScript-Bibliotheken für Formularskripts.

Da Webressourcen Daten im System und lösungsabhängig sind, können Sie diese zu unterschiedlichen Organisationen verschieben, indem Sie sie im Rahmen einer Lösung exportieren und die Lösung in eine andere Organisation importieren.

Erstellen und Bearbeiten von Webressourcen

1. Öffnen Sie den Lösungs-Explorer, und wählen Sie dann Webressourcen aus.

2. Wählen Sie unter Komponenten die Option Webressourcen.

3. Wählen Sie Neu aus, um eine Webressource zu erstellen.

   Um eine Webressource zu bearbeiten, doppelklicken Sie auf die Webressource, die Sie bearbeiten möchten.

4. Das Formular für Webressourcen hat die folgenden Felder und Funktionen:

   Etikett	Beschreibung
   Name	Erforderlich Dies ist der eindeutige Name für diese Webressource. Sie können diesen nach dem Speichern der Webressource nicht mehr ändern. Dieser Name darf nur Buchstaben, Zahlen, Punkte und einzelne Schrägstriche (“/”) enthalten. Das Anpassungspräfix für den Lösungsherausgeber wird dem Namen der Webressource vorangestellt.
   Anzeigename	Der angezeigte Name, wenn Sie eine Liste von Webressourcen anzeigen.
   Beschreibung	Eine Beschreibung der Webressource.
   Typ	Erforderlich Dies ist der Typ der Webressource. Sie können diesen nach dem Speichern der Webressource nicht mehr ändern.
   Text-Editor	Wenn der Typ der Webressource eine Art von Textdatei ist, wählen Sie diese Schaltfläche aus, um eine Seite zu öffnen und den Inhalt mittels des Texteditors zu bearbeiten.
   Sprache	Ermöglicht die Auswahl einer Sprache. Diese Option kennzeichnet nur den Datensatz, in dem die Webressourcedaten gespeichert sind. Sie ändert nicht das Verhalten der Webressource.
   Datei hochladen	Wählen Sie die Schaltfläche Durchsuchen aus, um eine Datei für den Upload als Webressource auszuwählen. Sie können eine Datei hochladen, wenn Sie eine neue Webressource erstellen oder eine vorhandene Webressource überschreiben. Die Dateinamenerweiterung der Datei muss den zulässigen Erweiterungen entsprechen. Die maximale Größe einer Datei, die als Webressource hochgeladen werden soll, beträgt 5 MB. Dieser Wert kann in Dynamics 365 Customer Engagement (on-premises) mithilfe der Einstellung Systemeinstellungen>E-Mail-Registerkarte >Begrenzung der Dateigröße für Anlagen festlegen geändert werden. Weitere Informationen: Dialogfeld Systemeinstellungen – Registerkarte E-Mail
   URL	Nachdem Sie die Webressource gespeichert haben, wird die URL für die Webressource hier angezeigt. Wählen Sie diesen Link aus, um die Webressource in Ihrem Browser anzuzeigen.

5. Nachdem Sie Ihre Änderungen hinzugefügt haben, wählen Sie Speichern und dann Veröffentlichen.

Notiz

Das Veröffentlichen von Anpassungen kann sich auf den normalen Systembetrieb auswirken. Wir empfehlen, dass Sie Anpassungen veröffentlichen, wenn dies die Benutzer am wenigsten stört.

Korrekte Verwendung des Texteditors

Der Texteditor in der Anwendung für Webressourcen sollte nur für die einfache Bearbeitung von Textdateien verwendet werden. Sie können ihn zur Erstellung und Bearbeitung von HTML-Webressourcen verwenden. Sie sollten jedoch nur HTML-Webressourcen bearbeiten, die mithilfe des Text-Editors erstellt wurden. Der Texteditor wurde für sehr einfache HTML-Inhalte entworfen. Wenn der Inhalt einer HTML-Webressource nicht mithilfe des Texteditors erstellt wurde, verwenden Sie den Texteditor nicht zur Bearbeitung.

Der Texteditor verwendet ein Steuerelement, das die HTML-Quelle so verändert, dass sie bearbeitet werden kann. Diese Änderungen können dazu führen, dass sich die Seite im Browser anders verhält, und komplexerer Code nicht mehr funktioniert. Das Öffnen und Speichern einer HTML-Webressource mit dem Texteditor, ohne Änderungen vorzunehmen, kann einige HTML-Webressourcen beschädigen.

Es wird empfohlen, einen externen Editor für die Bearbeitung von Textdateien zu verwenden und diese lokal zu speichern, bevor sie über die Schaltfläche Datei hochladen hochgeladen werden. So können Sie eine Kopie der Webressource behalten, wenn Sie zu einer früheren Version zurückkehren müssen. Sie können einen einfachen Editor wie Editor verwenden. Es wird jedoch ein Texteditor mit erweiterter Funktionalität empfohlen. Visual Studio Express ist kostenlos und stellt leistungsfähige Funktionen für die Bearbeitung von Dateien bereit, die von textbasierten Webressourcen verwendet werden.

Erstellen und Bearbeiten einer Webressource in einem Formular

Webressourcen können Sie in einem Formular hinzufügen oder bearbeiten, um sie für mehr Benutzer anziehend oder nützlich zu gestalten. Stellen Sie sicher, dass Sie über die Sicherheitsrolle „Systemadministrator“ bzw. entsprechende Rechte verfügen.

Notiz

Sie können keine Webressource in einer Formularkopf- oder -fußzeile mit einschließen.

1. Öffnen Sie den Projektmappen-Explorer.

2. Erweitern Sie unter Komponenten den Ordner Entitäten, und erweitern Sie dann die gewünschte Entität.

3. Wählen Sie Formulare aus, suchen Sie in der Liste ein Formular des Typs „Haupt“, und doppelklicken oder tippen Sie dann auf den Eintrag, um das Formular zu öffnen und zu bearbeiten.

4. Um eine Webressource hinzuzufügen, wählen Sie die Registerkarte aus (beispielsweise Allgemein oder Notizen), auf der Sie die Webressource einfügen möchten, und wählen Sie dann auf der Registerkarte Einfügen die Option Webressource aus.
   -ODER-
   Zum Bearbeiten einer Webressource wählen Sie eine Formularregisterkarte und die zu bearbeitende Webressource aus, und wählen Sie dann auf der Registerkarte Start die Option Eigenschaften ändern aus.

5. Geben Sie im Dialogfeld Webressource hinzufügen oder Webressourceneigenschaften auf der Registerkarte Allgemein, und geben Sie die gewünschten Informationen in die Pflichtfelder ein. Beachten Sie insbesondere Folgendes:

   • Wählen Sie im Feld Webressource das Bild, HTML oder die Silverlight-Webressource, die Sie verwenden möchten.

     Notiz

     Nachdem Sie eine Webressource angegeben haben, erscheint der Abschnitt Webressourceneigenschaften am unteren Rand dieser Registerkarte, und stellt Optionen und bereit, die je nach der Webressource, die Sie hinzufügen, variieren. Diese Optionen umfassen das Angeben benutzerdefinierter Parameter, das Zuweisen eines Datensatzobjekttypcodes als Parameter oder das Angeben alternativen Texts, mit dem die Ressource beschrieben wird, oder die im Fall von Bildern diese für Benutzer zugänglicher macht. Hier einige wichtige Eigenschaften. Eine vollständige Liste finden Sie unter: Webressourceneigenschaften. - Geben Sie im Feld Name einen einzigartigen Namen für das Feld ein. Der Name darf nur alphanumerische Zeichen und Unterstriche enthalten.

   • Das Feld Bezeichnung wird automatisch mit einer Variation des Namens, den Sie angeben, aufgefüllt, stellen Sie jedoch sicher, dass die Beschriftung Ihren Anforderungen entspricht, oder aktualisieren Sie sie.

6. Auf der Registerkarte Formatierung basieren die Optionen auf dem Typ der eingefügten Webressource. Diese Optionen umfassen das Angeben der Anzahl der angezeigten Spalten und Zeilen, das Anzeigen eines Rahmens sowie das Bildlaufverhalten.

7. Wenn die Registerkarte Abhängigkeiten im Dialogfeld Webressource hinzufügen oder Webressourceneigenschaften in der Liste Verfügbare Felder angezeigt wird, wählen Sie die Felder aus, die für die Webressource erforderlich sind. Wählen Sie die Schaltfläche Ausgewählte Datensätze hinzufügen aus, um die ausgewählten Felder in die Liste „Abhängige Felder“ zu verschieben, und wählen Sie dann OK aus, um das Dialogfeld zu schließen.

8. Wenn Sie die Bearbeitung des Formulars abgeschlossen haben, wählen Sie zum Schließen des Formulars auf der Registerkarte Startseite die Option Speichern und schließen aus. So prüfen Sie in einer Vorschau die Darstellung des Hauptformulars und die Funktionsweise der Ereignisse:

   • Wählen Sie auf der Registerkarte Startseite die Option Vorschau aus, und wählen Sie dann Formular erstellen, Formular aktualisieren oder Schreibgeschütztes Formular aus.
   • Wählen Sie zum Schließen des Formulars „Vorschau” im Menü Datei die Option Schließen aus.

9. Sind die Anpassungen vollständig, können sie veröffentlicht werden:

   • Wenn Sie Anpassungen für ausschließlich die Komponente veröffentlichen möchten, die Sie gerade bearbeiten, wählen Sie im Navigationsbereich die Entität aus, an der Sie gearbeitet haben, und wählen Sie dann Veröffentlichen aus.
   • Um Anpassungen für alle nicht veröffentlichten Komponenten gleichzeitig zu veröffentlichen, wählen Sie im Navigationsbereich die Option Entitäten und dann auf der Symbolleiste Aktionen die Option Alle Anpassungen veröffentlichen aus.

Hinzufügen oder Bearbeiten einer Bildwebressource

Webressourcen sind virtuelle Dateien in verschiedenen Formaten, wie etwa HTML-Dateien, JavaScript- und Silverlight-Anwendungen, die im System gespeichert werden und mithilfe einer eindeutigen URL-Adresse abgerufen werden können.

1. Öffnen Sie den Projektmappen-Explorer.

2. Um eine neue Webressource zu erstellen, wählen Sie Komponenten>Webressourcen und dann auf der Aktionssymbolleiste Neu.

3. Tippen oder ändern Sie die Informationen in den Textfeldern.

   • Der im Textfeld Name eingegebene Name wird zusammen mit der Dateierweiterung der Dateiname.

   • Der im Textfeld Anzeigename eingegebene Name wird unter Anzeigename angezeigt.

   • Wählen Sie im Dropdownfeld Typen den gewünschten Dateityp aus.

4. Wählen Sie Durchsuchen, um die Datei auf dem lokalen Computer auszuwählen und hochzuladen.

   • Wählen Sie zur Voranzeige einer hochgeladenen Bild-Webressource Webressource>Vorschau.

   • Wenn Sie eine Textwebressource bearbeiten möchten: Wählen Sie Text-Editor.

   • Wählen Sie zur Voranzeige einer Text-Webressource Webressource>Vorschau.

5. Wenn Sie bereit sind, Ihre Daten zu speichern, wählen Sie Speichern und Schließen.

6. Veröffentlichen Sie Ihre Anpassungen.

   • Nur die bearbeitete Komponente: Wählen Sie Speichern>Veröffentlichen unter Home.

   • Wählen Sie für die Veröffentlichung aller nicht veröffentlichten Komponenten gleichzeitig Alle Anpassungen veröffentlichen.

Notiz

Das Installieren einer Lösung oder Veröffentlichen von Anpassungen kann den normalen Systembetrieb stören. Wir empfehlen, dass Sie einen Lösungsimport planen, wenn er Benutzer am wenigsten stört.

Siehe auch

Eigenschaften von Webressourcen
Erstellen und Gesalten von Formularen
Ersten Schritten mit Anpassung
Webressourcen für Customer Engagement