Freigeben über

Webressourcen für Microsoft Dynamics 365

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

In diesem Thema

Verwendungsmöglichkeiten für Webressourcen

Webressourcentypen

Auf Webressourcen verweisen

Verwendungsmöglichkeiten für Webressourcen

Webressourcen sind Dateien, die verwendet werden können, um die Microsoft Dynamics 365-Webanwendung zu erweitern, beispielsweise HTML-Dateien, JavaScript und Silverlight-Anwendungen. Sie können Webressourcen in Formularanpassungen, der 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 Microsoft Dynamics 365 hochgeladen haben.

Da Webressourcen in Microsoft Dynamics 365 gespeichert werden und Lösungskomponenten sind, können sie einfach in lokale Bereitstellungen von Microsoft Dynamics 365 oder Microsoft Dynamics 365 (online) exportiert und dort installiert werden. Webressourcen sind auch online für Benutzer von Microsoft Dynamics 365 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, XSL, and 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 Microsoft Dynamics 365-Daten auszuführen. Weitere Informationen finden Sie unter Verwenden von Dynamics 365-Daten mithilfe von Webressourcen.

Webressourcen sind nur verfügbar, wenn Sie den Sicherheitskontext für Microsoft Dynamics 365-Webanwendungen verwenden. Nur lizenzierte Microsoft Dynamics 365-Benutzer, die über die notwendigen Rechte verfügen, 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

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 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 Microsoft Dynamics 365 Lösungsabhängigkeiten erstellt oder aktualisiert.

Xrm.Utility.openWebResource

Die Xrm.Utility.openWebResource-Funktion ö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 generiert 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 WebResources- 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ändige URL

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

<Microsoft CRM 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:

<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>

Der GUID-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.Utility.openWebResource-Funktion oder die $webresource-Direktive (wenn möglich), da der GUID-Wert automatisch eingefügt wird. Bei umfangreichen Webressourcen wie Silverlight kann es zu signifikanten Leistungsbeeinträchtigungen kommen, wenn Sie nicht die zwischengespeicherte Version der Datei verwenden.

Das folgende Beispiel zeigt eine URL für Microsoft Dynamics 365 (online), wobei MyOrganization der Name Ihrer Organisation ist und new_/test/test.htm 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.

Das folgende Beispiel zeigt eine URL für ein lokales Microsoft Dynamics 365, wobei myServer der Servername ist:

http://myServer/MyOrganization/WebResources/new_/test/test.htm

Wenn Sie Code schreiben, der auf eine Webressource verweist und sowohl für Microsoft Dynamics 365 (online) als auch für ein lokales Microsoft Dynamics 365 gelten muss, sollten Sie die getClientUrl-Funktion verwenden.

Siehe auch

Erweitern von Microsoft Dynamics 365 auf dem Client
JavaScript-Bibliotheken für Microsoft Dynamics 365
Erstellen von barrierefreien Webressourcen
Webressourcen der Webseite (HTML)
Silverlight (XAP)-Webressourcen
Webressourcen für Skripts (JScript)
Bild- (JPG, PNG, GIF, ICO)-Webressourcen
XSL-Webressourcen (Stylesheet)
Webressourcen von Daten (XML)
CSS Webressourcen
WebResource-Entitätsmeldungen und Methoden
Beispiel: Mehrere Werte über den Datenparameter an eine Webressource übergeben
Beispiel: Webressourcen-Dienstprogramm
Beispiel: Importieren von Dateien als Webressourcen
Verwenden von Dynamics 365-Daten mithilfe von Webressourcen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright