Webressourcen in modellgesteuerten Apps

Webressourcen sind virtuelle Dateien , die Sie in der Microsoft Dataverse-Datenbank speichern und mithilfe einer eindeutigen URL-Adresse abrufen.

Verwendungsmöglichkeiten für Webressourcen

Webressourcen stellen Dateien dar, mit denen Sie die Dataverse-Webanwendung erweitern können, z. B. HTML-Dateien, JavaScript, CSS und mehrere Bildformate. Sie können Webressourcen in Formularanpassungen, im SiteMapMenüband oder im Anwendungsmenüband verwenden, da Sie mithilfe der URL-Syntax darauf verweisen können.

Die URL-Syntax für Webressourcen ermöglicht relative Pfadverweise. Mithilfe Ihrer Entwicklungstools können Sie eine Gruppe von aufeinander folgenden Dateien auf einem Entwicklungsserver erstellen, indem Sie Dateitypen verwenden, die mit Webressourcen kompatibel sind. Wenn Sie dann eine konsistente Benennungskonvention und relative Pfadverweise verwenden, funktioniert die Website, nachdem Sie alle Dateien in Dataverse hochgeladen haben.

Da Dataverse Webressourcen speichert und sie Lösungskomponenten sind, können Sie sie ganz einfach in andere Dataverse-Organisationen exportieren und installieren. Benutzer von Dataverse für Microsoft Office Outlook mit Offlinezugriff können Webressourcen verwenden, wenn sie offline sind, da sie mit den Daten des Benutzers synchronisiert werden.

Verwenden Sie den Formular-Editor, um Formularfähige Webressourcen zu Ihren Formularen hinzuzufügen und zu konfigurieren.

Da Dataverse Webressourcen als Datensätze in der Datenbank speichert, können Sie sie programmgesteuert verwalten, indem Sie die Standardtechniken zum Erstellen, Abrufen und Aktualisieren von Datensätzen verwenden. Sie können textbasierte Webressourcen (JScript, CSS, XML, XSL, RESX und HTML) in der Anwendung bearbeiten und speichern.

Einschränkungen für Webressourcen

Kein Webressourcentyp unterstützt die Funktionen einer ASP.NET -Seite (.aspx), um Code auf dem Server auszuführen. Webressourcen sind auf statische Dateien oder Dateien beschränkt, die der Browser verarbeitet. Eine Webressource kann Code enthalten, den der Browser verarbeitet, um Webdienstaufrufe für die Interaktion mit Dataverse-Daten auszuführen.

Sie können nur über den Sicherheitskontext der Dataverse-Webanwendung auf Webressourcen zugreifen. Nur lizenzierte Dataverse-Benutzer, die die notwendigen Rechte haben, können darauf zugreifen.

Größeneinschränkungen

Die Organization.MaxUploadFileSize-Eigenschaft bestimmt die maximale Größe von Dateien, die Sie hochladen können. Legen Sie diese Eigenschaft auf der Registerkarte "E-Mail" der Systemeinstellungen in der Dynamics 365-Anwendung fest. Diese Einstellung beschränkt die Größe von Dateien, die Sie an E-Mail-Nachrichten, Notizen und Webressourcen anfügen können. Die Standardeinstellung ist 5 MB. Weitere Informationen finden Sie unter Umgebungseinstellungen und Dateigrößenbeschränkungen.

Webressourcentypen

Sie können zehn Dateiformate verwenden, um Webressourcen zu erstellen. In der folgenden Tabelle sind für jedes Dateiformat die zulässigen Dateierweiterungen und der entsprechende Typwert aufgeführt.

Auf Webressourcen verweisen

Verweisen Sie mithilfe mehrerer Methoden auf Webressourcen.

$webresource-Direktive

Verwenden Sie immer die $webresource Direktive, wenn Sie auf eine Webressource aus einem Menübandsteuerelement oder aus einem SiteMap Unterbereich verweisen. Verwenden Sie die $webresource-Direktive überall dort, wo XML einen URL-Wert ermöglicht. Das folgende Beispiel zeigt, wie dies gemacht wird.

$webresource:<name of Web Resource>  

Xrm.Navigation.openWebResource

Die Xrm.Navigation.openWebResource-Funktion öffnet eine HTML-Webressource in einem neuen Fenster mit Parametern, um den Namen der Webressource, alle Abfragezeichenfolgendaten, die an den Datenparameter übergeben werden sollen, sowie Informationen zur Höhe und Breite des Fensters zu übergeben.

Die generierte URL enthält das eindeutige GUID-Token, sodass die zwischengespeicherte Webressource geladen wird.

Relative URL

Wenn Sie auf eine Webressource aus Bereichen verweisen müssen, welche die Verwendung der $webresource:-Direktive nicht unterstützen, verwenden Sie eine relative URL. Um diesen Ansatz zu ermöglichen, verwenden Sie eine konsistente Benennungskonvention für die Webressourcen, die eine virtuelle Dateistruktur widerspiegeln. Fügen Sie das Anpassungspräfix des Lösungsherausgebers als Präfix zum Namen der Webressource ein. Dieses Präfix kann einen virtuellen "Stammordner" für alle Webressourcen darstellen, die von diesem Herausgeber hinzugefügt wurden. Verwenden Sie den Schrägstrich (/), um eine Ordnerstruktur zu simulieren, die der Webserver berücksichtigt.

Verwenden Sie aus einer anderen Webressource immer relative URLs, um aufeinander zu verweisen. Beispielsweise für die Webseiten-Webressource new_/content/contentpage.htm, um die CSS-Webressource darauf zu referenzierennew_/Styles/styles.css, stellen Sie die Verbindung wie folgt her:

<link rel="stylesheet" type="text/css" href="../styles/styles.css" />  

Damit die Webseiten-Webressource new_/content/contentpage.htm die Webseiten-Webressource isv_/foldername/dialogpage.htm öffnen kann, stellen Sie die Verbindung wie folgt her:

<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>  

Vollständiges URL

Das folgende Beispiel zeigt das Format einer URL, die zur Anzeige von Webressourcen verwendet werden kann.

<Dataverse Environment URL>/WebResources/<name of web resource>  

Die Anwendung verarbeitet diese URL und gibt die Datei zurück, die die neueste Version der Webressource enthält. Diese URL sieht folgendermaßen aus:

<Dataverse Environment URL>/%7B<version value>%7D/WebResources/<name of web resource>  

Der Versionswert wird aktualisiert, wenn Sie Anpassungen veröffentlichen und sicherstellen, dass der Browser die neueste zwischengespeicherte Version der Webressource verwendet. Verwenden Sie deshalb einen relativen Pfad zu einer Webressource, die Xrm.Navigation.openWebResource-Funktion oder die $webresource Directive (wenn möglich), da der Versionswert automatisch eingefügt wird. Wenn die zwischengespeicherte Version der Datei bei großen Webressourcen nicht verwendet wird, kann dies erhebliche Leistungsauswirkungen haben.

Das folgende Beispiel zeigt eine URL für Dataverse, wobei MyOrganization der Name Ihrer Dataverse-Umgebung ist. new_/test/test.htm ist der Name der Webressource:

https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm  

Layoutunterschiede zwischen dem alten Webclient und Einheitliche Oberfläche

Ein Webressourcensteuerelement, das für die Verwendung einer bestimmten Anzahl von Zeilen konfiguriert ist, weist in einer Unified Client-Anwendung im Vergleich zu einer Webanwendung unterschiedliche Höhen auf. Dieser Unterschied besteht, da es einen Unterschied in der Höhe einer Zeile zwischen Unified Interface und Webclient gibt. Wenn sowohl im Webclient als auch in der Einheitlichen Oberfläche ein Formular benötigt wird, können Sie in der Einheitlichen Oberflächen-App und in der Webclient-App unterschiedliche Formulare verwenden, wobei das Steuerelement so konfiguriert ist, dass die entsprechende Anzahl von Zeilen in jedem Formular verwendet wird.

Community-Tools

WebResources Manager ist ein Tool, das die XrmToolbox-Community für Dataverse entwickelt hat. Weitere Informationen zu von der Community entwickelten Tools finden Sie im Artikel Entwicklertools.

Siehe auch

Erstellen von barrierefreien Webressourcen
Webseite (HTML)-Webressourcen
JavaScript-Webressourcen
Bild-Webressourcen
Stylesheet(XSL)-Webressourcen
Daten(XML)-Webressourcen
Stylesheet(CSS)-Webressourcen
Webressourcen-Tabellenreferenz
Beispiel: Mehrere Werte über den Datenparamter an eine Webressource übergeben
Beispiel: Dateien als Webressourcen importieren
Webressourcenentwicklung mithilfe des Auto-Responders von Fiddler verbessern