Webressourcen für Customer Engagement

  • Artikel

Webressourcen sind virtuelle Dateien, die in der Dynamics 365 Customer Engagement (on-premises)-Datenbank gespeichert sind und die Sie mithilfe einer eindeutigen URL-Adresse abrufen können.

Verwendungsmöglichkeiten für Webressourcen

Webressourcen sind Dateien, die verwendet werden können, um die Dynamics 365 Customer Engagement (on-premises)-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 Dynamics 365 Customer Engagement (on-premises) hochgeladen haben.

Da Web-Ressourcen in Dynamics 365 Customer Engagement (on-premises) gespeichert werden und Lösungskomponenten sind, können sie problemlos exportiert und in Lokalen Bereitstellungen von Dynamics 365 Customer Engagement (on-premises) oder in Dynamics 365 for Customer Engagement installiert werden. Web-Ressourcen sind auch für Benutzer von Dynamics 365 for Microsoft Office Outlook mit Offline Access verfügbar, wenn sie offline sind, 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 Dynamics 365 Customer Engagement (on-premises)-Daten auszuführen. Weitere Informationen finden Sie unter Verwenden von Customer Engagement-Daten mithilfe von Webressourcen.

Webressourcen sind nur verfügbar, wenn Sie den Sicherheitskontext für Dynamics 365 Customer Engagement (on-premises)-Webanwendungen verwenden. Nur lizenzierte Dynamics 365 Customer Engagement (on-premises)-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.

Notiz

  • 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 Richtlinie $webresource:, 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>

Notiz

Bei Verwendung der $webresource-Direktive werden von Dynamics 365 Customer Engagement (on-premises) 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>

Notiz

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.

<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<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 Dynamics 365 for Customer Engagement, wobei MyOrganization der Name Ihres Unternehmens und new_/test/test.htm der Name der Webressource ist:

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

Notiz

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 lokales Dynamics 365 Customer Engagement (on-premises), wobei myServer der Servername ist:

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

Wenn Sie Code schreiben, um auf eine Web-Ressource zu verweisen, die entweder für Dynamics 365 for Customer Engagement oder lokal Dynamics 365 Customer Engagement (on-premises) funktionieren muss, sollten Sie die Funktion getClientUrl verwenden.

Community-Tools

Webressourcen-Manager ist ein Tool, das die XrmToolbox-Community für Dynamics 365 Customer Engagement (on-premises) entwickelt hat. Weitere Informationen finden Sie im Thema Entwicklertools für von der Community entwickelte Tools.

Notiz

Die Communitytools sind kein Produkt von Microsoft Dynamics, 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

Schreiben von Client-Anwendungs-Erweiterungen für Dynamics 365 Customer Engagement
Erstellen von barrierefreien Webressourcen
Webseite (HTML)-Webressourcen
Silverlight (XAP)-Webressourcen
Webressourcen für Skripts (JScript)
Bildwebressourcen
XSL-Webressourcen (Stylesheet)
Webressourcen von Daten (XML)
Webressourcen Stylesheet (CSS)
Entitätsmeldungen und Methoden für Ressourcen
Beispiel: Mehrere Werte über den Datenparameter an eine Webressource übergeben
Beispiel: Webressourcen-Dienstprogramm
Beispiel: Importieren von Dateien als Webressourcen
Verwenden von Webdienstdaten in Webressourcen
Webressourcenentwicklung mithilfe des Fiddler-AutoResponder verbessern