Webressourcen in modellgesteuerten Apps

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

Hinweis

IFRAMing-Inhalte, die sich hinter einer Authentifizierungsgrenze befinden, werden nicht über Webressourcen oder Power Apps component framework unterstützt. Einige eingebettete IFRAMEs funktionieren möglicherweise in einem Browser-Client, wenn sich der Benutzer direkt beim externen Dienst anmeldet. Dies wird jedoch in Mobil- oder Tablet-Anwendungen nicht unterstützt. Das spezifische Szenario zum Einbetten eines Formulars in einen iFRAME, eingebettet in ein anderes Formular, wird nicht unterstützt. Wir empfehlen die Verwendung vom Formular als Bestandteil für solche Szenarien.

Im Allgemeinen wird zur Verwendung des Power Apps Component Framework und die benutzerdefinierten Seiten ermutigt, um konfigurierbare, wiederverwendbare und engere externe Integrationen aufzubauen. Mehr Informationen: IFRAME-Komponente

Verwendungsmöglichkeiten für Webressourcen

Webressourcen sind Dateien, die verwendet werden können, um die Dataverse-Webanwendung zu erweitern, beispielsweise HTML-Dateien, JavaScript und CSS sowie verschiedene Bildformate. Sie können Webressourcen in Formularanpassungen, die SiteMap oder im Anwendungsmenüband verwenden, da auf sie mithilfe der URL-Syntax verwiesen werden kann.

Die URL-Syntax für Webressourcen ermöglicht relative Pfadverweise. Mit den Entwicklungswerkzeugen können Sie eine Gruppe voneinander abhängiger Dateien auf einem Entwicklungsserver erstellen, indem Sie Dateitypen verwenden, die mit Webressourcen kompatibel sind. Wenn Sie dann eine einheitliche Namenskonvention und relative Pfadverweise verwenden, funktioniert die Website, nachdem Sie alle Dateien in Dataverse hochgeladen haben.

Da Webressourcen in Dataverse gespeichert werden und Lösungskomponenten sind, können sie einfach exportiert und in anderen Dataverse-Organisationen installiert werden. Webressourcen sind auch offline für Benutzer von Dataverse für Microsoft Office Outlook mit Offlinezugriff verfügbar, da sie mit den Daten des Benutzers synchronisiert werden.

Sie können den Formular-Editor verwenden, um formularfähige Webressourcen Ihren Entitätsformularen hinzuzufügen und um sie zu konfigurieren.

Da Webressourcen als Datensätze in der Datenbank gespeichert sind, können sie mit den Standardtechniken zum Erstellen, Abrufen und Aktualisieren von Datensätzen programmgesteuert verwaltet werden. Textbasierte Webressourcen (JScript, CSS, XML, SXL, RESX und HTML) können in der Anwendung bearbeitet und gespeichert werden.

Einschränkungen für Webressourcen

Es gibt keinen Webressourcentyp, der die Funktionalität einer ASP.NET-(.aspx)-Seite unterstützt, um Code auf dem Server auszuführen. Webressourcen sind auf statische Dateien begrenzt oder auf Dateien, die im Browser verarbeitet werden. Eine Webressource kann Code enthalten, der im Browser verarbeitet wird, um Webdienstaufrufe zur Interaktion mit Dataverse-Daten auszuführen.

Webressourcen sind nur verfügbar, wenn Sie den Sicherheitskontext für Dataverse-Webanwendungen verwenden. Nur lizenzierte Dataverse-Benutzer, die die notwendigen Rechte haben, können darauf zugreifen.

Größeneinschränkungen

Die maximale Größe für Dateien, die hochgeladen werden können, wird durch die Organization.MaxUploadFileSize-Eigenschaft bestimmt. Diese Eigenschaft wird in der Dynamics 365-Anwendung auf der Registerkarte E-Mail in den Systemeinstellungen festgelegt. Mit dieser Einstellung wird die Größe von Dateien begrenzt, die an E-Mail-Nachrichten, Notizen und Webressourcen angefügt werden können. Die Standardeinstellung ist 5 MB.

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.

Datei	Dateierweiterungen	Typ
Webseite (HTML)	.htm, .html	1
Stylesheet (CSS)	.css	2
Skript (JScript)	.js	3
Daten (XML)	.xml	4
Bild (PNG)	.png	5
Bild (JPG)	.jpg	6
Bild (GIF)	.gif	7
Silverlight (XAP)	.xap	8
StyleSheet (XSL)	.xsl, .xslt	9
Bild (ICO)	.ico	10
Vektorformat (SVG)	.svg	11
Zeichenfolge (RESX)	.resx	12

Auf Webressourcen verweisen

Es gibt mehrere Möglichkeiten, die Sie verwenden können, um auf Webressourcen zu verweisen.

Hinweis

• Sofern möglich, sollten Sie die $webresource-Direktive verwenden. Nur Verweise, welche in den SiteMap- oder Menübandbefehlen die $webresource-Direktive verwenden, richten Abhängigkeiten ein. Abhängigkeiten werden nicht erstellt, indem eine Webressource auf eine andere verweist.
  • Erstellen Sie zum Anzeigen einer Silverlight-Webressource außerhalb eines Entitätsformulars oder eines Diagramms eine HTML-Webressource als Hostseite für die Silverlight-Webressource. Verwenden Sie dann die "$webresource:"-Direktive, um die HTML-Webressource zu öffnen.

$webresource-Direktive

Sie sollten immer die $webresource-Direktive verwenden, wenn Sie auf eine Webressource aus einem Menübandsteuerelement oder 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>  

Hinweis

Bei Verwendung der $webresource-Direktive werden von Dataverse Lösungsabhängigkeiten erstellt oder aktualisiert.

Xrm.Navigation.openWebResource

Die Funktion Xrm.Navigation.openWebResource öffnet eine HTML-Webressource in einem neuen Fenster, wobei als Parameter der Name der Webressource, beliebige Abfragezeichenfolgendaten für den Datenparameter sowie Informationen über Höhe und Breite des Fensters übergeben werden können.

Die generierte URL enthält das eindeutige GUID-Token, so dass 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, können Sie eine relative URL verwenden. Dazu sollten Sie eine einheitliche Namenskonvention für die Webressourcen verwenden, die einer virtuellen Dateistruktur entspricht. Das Anpassungspräfix für den Lösungsherausgeber wird dem Namen der Webressource immer als Präfix vorangestellt. Es kann einen virtuellen "Stamm"-Ordner für alle Webressourcen angeben, die mit diesem Herausgeber hinzugefügt werden. Sie können dann das Schrägstrichzeichen (/) verwenden, um eine Ordnerstruktur zu simulieren, die durch den Webserver berücksichtigt wird.

Von einer anderen Webressource sollten Sie immer relative URLs für Verweise untereinander verwenden. Damit beispielsweise die Webseiten-Webressource new_/content/contentpage.htm auf die CSS-Webressource new_/Styles/styles.css zugreifen kann, 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>  

Hinweis

Verwenden Sie keine relative URL mit dem Webressourcen- Ordner als Stammpfad für die URL. Verwenden Sie beispielsweise nicht Folgendes: /WebResources/<name of web resource>. Wenn ein Benutzer mehr als einer Organisation auf einem Server angehört, wird dieser Pfad immer auf die Standardorganisation des Benutzers verweisen. Wenn der Benutzer die standardmäßige Organisation nicht verwendet und die erwartete Webressource nicht in der Standardorganisation des Benutzers enthalten ist, tritt ein "File not Found"-Fehler auf, selbst wenn die Webressource in der Organisation enthalten ist, in welcher der Benutzer derzeit arbeitet.

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 wird diese URL verarbeiten und die Datei mit der aktuelle Version der Webressource zurückgeben. Diese URL sieht folgendermaßen aus:

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

Der Versionen-Wert wird aktualisiert, wenn Sie Anpassungen veröffentlichen, sodass sichergestellt ist, dass der Browser die zuletzt zwischengespeicherte Version der Webressource verwendet. Verwenden Sie deshalb einen relativen Pfad zu einer Webressource, die Xrm.Naviation.openWebResource-Funktion oder die $webresource Directive (wenn möglichlich) , da der Versionen-Wert automatisch eingefügt wird. Bei umfangreichen Webressourcen kann es zu signifikanten Leistungsbeeinträchtigungen kommen, wenn Sie nicht die zwischengespeicherte Version der Datei verwenden.

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  

Hinweis

Das Einfügen des Zeichens "/" und einer Dateinamenerweiterung im Namen der Webressource ist eine bewährte Methode.
Wenn Sie Code schreiben, der auf eine Webressource verweist, die für Dataverse funktioniert, sollten Sie die getClientUrl-Funktion verwenden.

Layoutunterschiede zwischen dem alten Webclient und Einheitliche Oberfläche

Eine für die Verwendung einer bestimmten Anzahl von Zeilen konfigurierte Webressourcensteuerung weist in einer Unified Client-Anwendung andere Höhen auf als eine Webclient-Anwendung. Dies liegt daran, dass zwischen Einheitliche Oberfläche und dem Webclient ein Unterschied in der Höhe einer Zeile besteht. 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 finden Sie im Thema Entwicklertools für von der Community entwickelte Tools.

Hinweis

Die Communitytools sind kein Produkt von Dataverse, und es wird kein Support für die Communitytools angeboten. Wenn Sie Fragen zu dem Tool haben, setzen Sie sich bitte mit dem Herausgeber in Verbindung. Weitere Informationen: XrmToolBox.

Siehe auch

Erstellen von barrierefreien Webressourcen
Webseite (HTML)-Webressourcen
JavaScript-Webressourcen
Image-Webressourcen
Webressourcen von Stylesheets (XSL)
Webressourcen von Daten (XML)
Webressourcen Stilblatt (CSS)
Webressource der Tabellenreferenz
Beispiel: Mehrere Werte über den Datenparamter an eine Webressource übergeben
Beispiel: Importieren von Dateien als Webressourcen
Webressourcenentwicklung mithilfe des Fiddler-AutoResponder verbessern

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).