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 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. Parameter an HTML-Webressourcen übergeben

  • HTML-Webressourcen, die als Steuerelemente in ein Formular eingebettet sind, können aus Leistungsgründen von der Formularlaufzeit nachgeladen werden. Beispielsweise kann die Formularlaufzeit das Steuerelement während der Registerkartennavigation zerstören und neu initialisieren.

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" "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 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 der HTML-Code 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 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, die die Ordnerstruktur Ihrer Website widerspiegelt, werden Sie feststellen, dass die HTML-Webressource Links zu verwandten CSS-, XML-, JScript-, Bild- und Silverlight-Dateien unterhält, 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, 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 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 Benutzer von Dynamics 365 for Microsoft Office Outlook mit Offlinezugang heruntergeladen werden, haben Benutzer 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 Beschreibung
typename Tabellenname Der Name der Tabelle.
Typ 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.
-Daten 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.
Sicherheit 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. Dieses Beispiel: Übergeben mehrerer Werte an eine Webressource mit dem Datenparameter-Thema zeigt eine Methode zum Übergeben von mehreren Parameterwerten.

Hinweis

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
Verwendung von Style Sheet (CSS) Webressourcen
Verwenden der JavaScript-Webressourcen
Verwenden von Daten (XML) Web-Ressourcen
Verwendung von Bildern (JPG, PNG, GIF) Web-Ressourcen
Verwendung von Stylesheet (XSL)-Webressourcen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).