Freigeben über

Webressourcen in modellgesteuerten Apps

  • Artikel

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

Anmerkung

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

Grundsätzlich empfehlen wir, Power Apps component framework und die benutzerdefinierten Seiten zu verwenden, 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 Benutzende von Dataverse für Microsoft Office Outlook mit Offlinezugriff verfügbar, da sie mit den Daten der Benutzenden 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

Bis zu welcher maximalen Größe Dateien hochgeladen werden können, hängt von der Organization.MaxUploadFileSize-Eigenschaft ab. 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. Erfahren Sie mehr zu 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.

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.

Anmerkung

Sofern möglich, sollten Sie die $webresource-Direktive verwenden. Nur Verweise, welche die $webresource-Direktive in den Siteübersichts- oder Menübandbefehlen verwenden, richten Abhängigkeiten ein. Abhängigkeiten werden nicht erstellt, wenn eine Webressource auf eine andere verweist.

$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>

Anmerkung

Wenn Sie die $webresource-Direktive verwenden, erstellt oder aktualisiert Dataverse Lösungsabhängigkeiten.

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, 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. 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 den Schrägstrich (/) verwenden, um eine Ordnerstruktur zu simulieren, die der Webserver berücksichtigt.

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>

Anmerkung

Verwenden Sie keine relative URL mit dem WebResources-Ordner als Stammpfad für die URL. Verwenden Sie beispielsweise nicht /WebResources/<name of web resource>. Wenn ein Benutzender mehr als einer Organisation auf einem Server angehört, verweist dieser Pfad immer auf die Standardorganisation des Benutzenden. Wenn der Benutzende die standardmäßige Organisation nicht verwendet und die erwartete Webressource nicht in der Standardorganisation des Benutzenden enthalten ist, tritt ein „Datei nicht gefunden“-Fehler auf, selbst wenn die Webressource in der Organisation enthalten ist, in welcher der Benutzende 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 verarbeitet diese URL und gibt die Datei mit der aktuellen Version der Webressource zurück. 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.Navigation.openWebResource-Funktion oder die $webresource Directive (wenn möglich), da der Versionswert 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

Anmerkung

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

Ein für die Verwendung einer bestimmten Anzahl von Zeilen konfiguriertes Webressourcensteuerelement weist in einer Unified-Client-Anwendung andere Höhen auf als eine Webclient-Anwendung. Dies liegt daran, dass zwischen der einheitlichen 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 zu von der Community entwickelten Tools finden Sie im Artikel Entwicklertools.

Anmerkung

Die Communitytools sind kein Produkt von Dataverse. Microsoft bietet keinen Support für die Communitytools. 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 Auto-Responders von Fiddler verbessern