Freigeben über

Webressourcen der Webseite (HTML)

  • Artikel

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

Verwendungsmöglichkeiten von HTML-Webressourcen

Da eine HTML-Webressource zum Browser des Benutzenden gestreamt wird, kann sie alle möglichen Inhalte enthalten, die im Browser des Benutzenden 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. Parameter an HTML-Webressourcen übergeben
  • HTML-Webressourcen, die als Steuerelemente in ein Formular eingebettet sind, können unter Umständen aus Leistungsgründen von der Formularlaufzeit nachgeladen werden. Beispielsweise kann die Formularlaufzeit das Steuerelement während der Registerkartennavigation womöglich zerstören und neu initialisieren.

Texteditor für HTML-Webressourcen verwenden

Der im Webressourcenformular bereitgestellte Texteditor ist für 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" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<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 der HTML-Code auf das folgende Beispiel:

<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 der HTML-Code in Webressourcen mithilfe des Texteditors geändert werden kann, verwenden Sie verwaltete Eigenschaften, 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 modellgesteuerten Apps erstellen, die irgendeinen der Webressourcendateitypen verwenden. Wenn Sie darauf achten, immer relative Pfade zu verwenden und jede Webressource mit einer einheitlichen Namenskonvention zu importieren, welche die Ordnerstruktur Ihrer Website widerspiegelt, behält die HTML-Webressource Links zu verwandten CSS-, XML-, JScript-, Bild- und Silverlight-Dateien, die als Webressourcen importiert wurden.

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

  • page.htm

  • [Formatvorlagen]

    • style.css

  • [Skripte]

    • 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.htm-HTML-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, ändern sich die relativen Pfade innerhalb der HTML-Webressourcen nicht.

Anmerkung

  • Eine HTML-Webressource, die einem Formular hinzugefügt wurde, kann keine globalen Objekte verwenden, die von der JavaScript-Bibliothek festgelegt 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. Auf globale Objekte, die über Formularskripts festgelegt wurden, kann jedoch nicht mithilfe des übergeordneten Elements zugegriffen werden. Sie sollten alle Bibliotheken, die eine HTML-Webressource innerhalb der HTML-Webressource benötigen, 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 Benutzende von Dynamics 365 for Microsoft Office Outlook mit Offlinezugang heruntergeladen werden, haben Benutzende Zugriff auf Webressourceninhalte, 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 des Dataflows Eigenschaft
typename Tabelle Name Der Name der Tabelle.
type Tabellentyp-Code Eine ganze Zahl, die eindeutig die Tabelle 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 Tabelle geöffnet werden. Wenn er aktiviert ist, enthält die benutzerdefinierte Hilfe-URL den Wert form oder hierarchychart.
pagemode Nur zur internen Verwendung.
security Nur zur internen Verwendung.
tabSet Nur zur internen Verwendung.

Wenn im Datenparameter mehrere Werte übergeben werden, werden diese automatisch kodiert. Es muss auch eine Logik enthalten sein, um die verschiedenen Parameter mit Hilfe von Skripten in Ihrer HTML-Webressource zu dekodieren. Der Artikel Beispiel: Übergeben mehrerer Werte an eine Webressource mit dem Datenparameter zeigt eine Methode zum Übergeben von mehreren Parameterwerten.

Anmerkung

Alle in der Abfragezeichenfolge enthaltenen Zeichen durchlaufen eine Validierung, um die Gültigkeit der übergebenen Parameter sicherzustellen. Wenn festgestellt wird, dass Parameter nicht gültig sind, schlägt die Anforderung fehl. Beispielsweise wird das Übergeben von Textwerten in spitzen Klammern als ungültiger Parametertyp angesehen.

Siehe auch

Webressourcen
Erstellen von barrierefreien Webressourcen
Webressourcen für Stylesheet (CSS) verwenden
JavaScript-Webressourcen verwenden
Webressourcen für Daten (XML) verwenden
Webressourcen für Bilder (JPG, PNG, GIF) verwenden
Verwendung von Stylesheet (XSL)-Webressourcen