Webressourcen der Webseite (HTML)

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Verwenden Sie von Webressourcen der Webseite (HTML), um Benutzeroberflächenelemente für Clienterweiterungen zu erstellen.

In diesem Thema

Verwendungsmöglichkeiten von HTML-Webressourcen

Einschränkungen bei HTML-Webressourcen

Texteditor für HTML-Webressourcen verwenden

Bearbeiten von Webressourcen für verwaltete Lösungen verhindern

Von einer HTML-Webressource auf andere Webressourcen verweisen

Parameter an HTML-Webressourcen übergeben

Verwendungsmöglichkeiten von HTML-Webressourcen

Da eine HTML-Webressource einfach nur zum Browser des Benutzers gestreamt wird, kann sie alle möglichen Inhalte enthalten, die im Browser des Benutzers gerendert werden.

Einschränkungen bei HTML-Webressourcen

  • Eine HTML-Webressource kann keinen Code enthalten, der auf dem Server ausgeführt werden muss.ASP.NET-Seiten können nicht als HTML-Webressourcen hochgeladen werden.

  • HTML-Webressourcen können nur eine begrenzte Anzahl von Abfragezeichenfolgenparametern annehmen.Weitere Informationen:Parameter an HTML-Webressourcen übergeben

Texteditor für HTML-Webressourcen verwenden

Der im Webressourcenformular bereitgestellte Texteditor ist für sehr einfache HTML-Bearbeitungsaktionen vorgesehen. Bei anspruchsvolleren HTML-Dokumenten sollten Sie den Code in einem externen Editor bearbeiteten und über die Schaltfläche Durchsuchen den Inhalt der Datei hochladen.

Eine komplexere HTML-Seite, die Skripte benötigt, um die Inhalte der Seite zu rendern, beginnt beispielsweise wie das folgende Beispiel.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
 <title></title>
 <script src="Script/Script.js" type="text/javascript"></script>
 <link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
 <div id="results" />
</body>
</html>

Nachdem das Dokument im Texteditor geöffnet und gespeichert wurde, ändert sich die HTML wie folgt:

<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
 <LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>

Bearbeiten von Webressourcen für verwaltete Lösungen verhindern

Da die HTML in Webressourcen mithilfe des Texteditors geändert werden kann, wird empfohlen, dass Sie verwaltete Eigenschaften verwenden, um festzulegen, dass komplexe HTML-Webressourcen bei verwalteten Lösungen nicht angepasst werden können. Öffnen Sie bei der Anzeige von Webressourcen im Lösungsfenster das Dialogfeld Verwaltete Eigenschaften, um die Eigenschaft Anpassbar auf false festzulegen.

Von einer HTML-Webressource auf andere Webressourcen verweisen

Sie können einen Satz zugehöriger Dateien außerhalb von Microsoft Dynamics 365 erstellen, der irgendeinen der Webressourcendateitypen verwendet. Wenn Sie achtgeben, dass Sie immer relative Pfade verwenden und jede Webressource mit einer konsistenten Namenskonvention importieren, die die Ordnerstruktur Ihrer Website widerspiegelt, werden Sie feststellen, dass die HTML-Webressource Links zu verwandten CSS, XML, JScript-, Bild- und Silverlight-Dateien, die als Webressourcen importiert wurden, beibehält.

Beispiel: Sie erstellen ein Webanwendungsprojekt, das die folgende [Ordner]/Dateistruktur verwendet:

  • page.htm

  • [Styles]

    • style.css

  • [Scripts]

    • script.js

Wenn Sie diese Dateien als Webressourcen importieren, können Sie folgende Benennung wählen, wobei das Lösungsherausgeberanpassungspräfix "Neu" lautet:

  • new_/page.htm

  • new_/Styles/style.css

  • new_/Scripts/script.js

Wenn Sie sich an dieses Muster halten, kann Ihre new_/page.htmHTML-Webressource auf herkömmliche Art und Weise auf die anderen Dateien verweisen und dabei relative Pfade verwenden, wie das folgende Beispiel veranschaulicht.

<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />

Das Lösungsherausgeberanpassungspräfix wird ein virtueller Stammverzeichnisordner für alle Webressourcen in der Lösung. Wenn Sie das Anpassungspräfix ändern, werden die relativen Pfade innerhalb der HTML-Webressourcen nicht geändert.

Hinweis

  • Eine HTML-Webressource, die einem Formular hinzugefügt wurde, kann keine globalen Objekte verwenden, die von der JavaScript-Bibliothek definiert werden, die im Formular geladen wird. Eine HTML-Webressource kann mit den Xrm.Page- oder Xrm.Utility-Objekten innerhalb des Formulars kommunizieren, indem parent.Xrm.Page oder parent.Xrm.Utility verwendet wird, aber auf globale Objekte, die über Formularskripts definiert wurden, kann nicht mithilfe des übergeordneten Elements zugegriffen werden. Sie sollten alle Bibliotheken, die eine HTML-Webressource innerhalb der Webressource HTML benötigt, laden, damit sie nicht von den Skripts abhängig sind, die im Formular geladen werden.

  • Verweise, die im Code zwischen der Webressourcen enthalten sind, werden als Lösungsabhängigkeiten nicht nachverfolgt.

Da Webressourcen auch für Benutzer von Microsoft Dynamics CRM für Microsoft Office Outlook mit Offlinezugriff heruntergeladen werden, haben die Benutzer auch Zugriff auf den Webressourceninhalt, während sie offline arbeiten.

Parameter an HTML-Webressourcen übergeben

Eine HTML-Webressource kann nur Parameter annehmen, die in der folgenden Tabelle aufgeführt werden.

Parameter

Name

Beschreibung

typename

Entitätsname

Der Name der Entität.

type

Entitätstypcode

Eine ganze Zahl, die eindeutig die Entität in einer bestimmten Organisation identifiziert.

id

Objekt-GUID

Die GUID, die einen Datensatz darstellt.

orgname

Organisationsname

Der eindeutige Name der Organisation.

userlcid

Benutzersprachcode

Die Sprachcode-ID, die vom aktuellen Benutzer verwendet wird.

orglcid

Organisationssprachcode

Die Sprachcode-ID, die die Ausgangssprache für die Organisation darstellt.

data

Optionaler Datenparameter

Ein optionaler Wert, der übergeben werden kann.

formid

Formular-ID

Die GUID, die eine Formular-ID darstellt.

entrypoint

Eingangspunkt

Ein Zeichenfolgenwert. Dieser Parameter ist dazu bestimmt, als optionaler Wert an Webressourcen übergeben zu werden, die als die benutzerdefinierter Hilfeinhalt für eine Entität geöffnet werden. Bei Aktivierung enthält die benutzerdefinierte Hilfe-URL den Wert “form” oder “hierarchychart”.Weitere Informationen:Hinzufügen von benutzerdefiniertem Hilfeinhalt

pagemode

Nur zur internen Verwendung.

Sicherheit

Nur zur internen Verwendung.

tabSet

Nur zur internen Verwendung.

Um mehr als einen Wert im Datenparameter zu übergeben, müssen Parameter im Wert des Datenparameters codieren und dann Logik hinzufügen, um die vielen Parameter mithilfe von Skript in der HTML-Webressource zu decodieren. Im Thema Beispiel: Mehrere Werte über den Datenparameter an eine Webressource übergeben wird eine Methode zum Übergeben mehrerer Parameterwerte veranschaulicht.

Siehe auch

Webressourcen für Microsoft Dynamics CRM 2015
Erstellen von barrierefreien Webressourcen
CSS Webressourcen
Webressourcen für Skripts (JScript)
Webressourcen von Daten (XML)
Bild- (JPG, PNG, GIF, ICO)-Webressourcen
Silverlight (XAP)-Webressourcen
XSL-Webressourcen (Stylesheet)

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright