Verwenden von IFRAME- und Webressourcen-Steuerelementen in einem Formular
Durch IFRAME- und Webressourcensteuerelemente wird der eingebettete Inhalt von einem anderen Ort aus auf den Seiten mithilfe eines HTML-IFRAME-Elements gesteuert.
Hinweis
Die Designs, die Sie für das Formular auswählen, werden auch für den Dynamics 365 for Outlook-Lesebereich und die Formulare verwendet, die von Dynamics 365-Tablets verwendet werden. Webressourcen und IFRAMEs werden nicht mithilfe des Dynamics 365 for Outlook-Lesebereichs angezeigt. Sie werden jedoch in Dynamics 365 für Tablets unterstützt. Wenn der IFRAME vom Zugriff auf das Xrm-Objekt der Seite oder von Formularereignishandlern abhängt, sollten Sie den IFRAME so konfigurieren, dass er standardmäßig nicht sichtbar ist.
Sie können einen IFRAME verwenden, um den Inhalt einer anderen Website in einem Formular anzuzeigen, beispielsweise in einer ASP.NET-Seite.
Es wird empfohlen, die Komponenten des Power Apps Component Frameworks zu verwenden, wenn Sie erwägen, eine Webressource zu verwenden, um Inhalte anzuzeigen, mit denen Benutzer interagieren.
Die Verwendung, um ein Formular in einem IFrame anzuzeigen, das eingebettet in einem anderen Entitätsformular ist, wird nicht unterstützt.
Sie können eine der folgenden Webressourcen verwenden, um den Inhalt von Webressourcen in einem Formular anzuzeigen:
Die folgende Abschnitte beschreiben Ihre Optionen, wenn diese Steuerelemente mehr als statische Inhalte anzeigen sollen.
Auswählen, ob frameübergreifendes Skripting eingeschränkt werden soll
Verwenden Sie die Option Frameübergreifendes Skripting einschränken, wenn unterstützt, wenn Sie dem Inhalt, der in einem IFRAME angezeigt wird, nicht vollständig vertrauen. Wenn diese Option ausgewählt ist, besitzt der IFRAME den Parametersatz, der in der folgenden Tabelle aufgeführt ist.
| Parameter | Beschreibung |
|---|---|
security="restricted" |
Dieser Parameter wird nicht mehr unterstützt. |
sandbox="" |
Für Browser, die diesen Parameter unterstützen, ist der Inhalt im IFRAME im Wesentlichen auf das Anzeigen von Informationen beschränkt. Die folgenden Einschränkungen können angewendet werden: - Browser-Plug-Ins sind deaktiviert. - Skripts und Formulare sind deaktiviert. - Links zu anderen Browserkontexten sind deaktiviert. - Inhalt wird wie aus einer anderen Domänen behandelt, auch wenn die Domäne identisch ist. Dieser Parameter wird durch W3C definiert und wird von den folgenden Browsern unterstützt: - Microsoft Edge - Google Chrome - Apple Safari - Mozilla Firefox Weitere Informationen zum Sandkastenparameter finden Sie unter: - Schutz der Website mit HTML5 Sandbox - Sandbox |
Aktivieren der IFRAME-Kommunikation über Domänengrenzen hinweg
Manchmal möchten Sie die Kommunikation für einen IFRAME aktivieren, der Inhalt auf einer anderen Domäne enthält. Window.postMessage ist eine Browsermethode, die diese Funktion für Google Chrome, Mozilla Firefox und Apple Safari bereitstellt. Weitere Informationen zu postMessage finden Sie in den folgenden Blogbeiträgen:
Übergeben kontextbezogener Informationen zum Datensatz
Sie können kontextbezogene Informationen durch Übergeben von Parametern an die im Steuerelement definierte URL bereitstellen. Die Seite, die im Frame angezeigt wird, muss in der Lage zu sein, übergebene Parameter zu verarbeiten. Alle Parameter in der folgenden Tabelle werden übergeben, wenn der IFRAME oder die Webressource mit der Option Datensatzobjekt-Typcode u. eindeut. Bezeichner als Parameter übergeben konfiguriert ist.
Sie können angeben, ob alle Parameter in der folgenden Tabelle übergeben werden.
| Parameter | Name | Beschreibung |
|---|---|---|
typename |
Tabellenname | Der Name der Tabelle. |
type |
Tabellentyp-Code | Die ganze Zahl, die eindeutig die Tabelle in einer bestimmten Organisation identifiziert. |
id |
Objekt-GUID | Eine GUID, die einen Datensatz darstellt. |
orgname |
Organisationsname | Der eindeutige Name der Organisation. |
userlcid |
Benutzersprachcode | Die Sprachcode-ID, die vom aktuellen Benutzer verwendet wird. |
Sprachcodes sind vierstellige oder fünfstellige Gebietsschema-IDs. Gültige Gebietsschema-ID-Werte finden Sie unter Gebietsschema-ID-Diagramm (LCID).
Hinweis
Es ist empfehlenswert, den Tabellennamen statt des Typcodes zu verwenden, da der Tabellentypcode für benutzerdefinierte Tabellen möglicherweise je nach Microsoft Dataverse-Organisation verschieden ist.
Beispiel
Im folgenden Beispiel wird die URL ohne Parameter gezeigt:
https://myserver/mypage.aspx
Im folgenden Beispiel wird die URL mit Parameter gezeigt:
https://myserver/mypage.aspx?id=%7bB2232821-A775-DF11-8DD1-00155DBA3809%7d&orglcid=1033&orgname=adventureworkscycle&type=1&typename=account&userlcid=1033
Lesen von übergebenen Parametern
Übergebene Parameter werden in der Regel auf der ASPX-Zielseite mithilfe der HttpRequest.QueryString-Eigenschaft gelesen. Auf einer HTML-Seite kann der Zugriff auf die Parameter mit der window.location.search-Eigenschaft in JavaScript erfolgen. Weitere Informationen finden Sie unter HttpRequest.QueryString-Eigenschaft und search-Eigenschaft.
Übergeben von Formulardaten
Verwenden Sie die getValue-Methode für die Spalten, die Daten enthalten, die Sie an die andere Website übergeben möchten, und erstellen Sie eine Zeichenfolge aus den Abfragezeichenfolgenargumenten, die die andere Seite verwenden kann. Verwenden Sie dann Column OnChange event, IFRAME OnReadyStateComplete event oder Tab TabStateChange event und die setSrc-Methode, um Ihre Parameter an die Eigenschaft src des IFRAMEs oder der Webressource anzuüfgen.
Wenn Sie den Datenparameter verwenden, um Daten an eine Silverlight-Webressource zu übergeben, können Sie die getData- und setData-Methoden verwenden, um den Wert zu ändern, der über den Datenparameter übergeben wird. Für Webseiten-Webressourcen (HTML) verwenden Sie die setSrc-Methode, um den querystring-Parameter direkt zu bearbeiten.
Vermeiden Sie die Anwendung des OnLoad-Ereignisses. IFRAMES und Webressourcen werden asynchron geladen und der Frame ist möglicherweise noch nicht vollständig geladen, bevor das Onload-Ereignisskript abgeschlossen wird. Dies kann dazu führen, dass die Eigenschaft src des IFRAMEs oder der Webressource, die Sie geändert haben, durch den Standardwert des IFRAMES oder der Webressourceneigenschaft URL überschrieben wird.
Ändern der URL
Sie möchten möglicherweise das Ziel von IFRAME basierend auf Überlegungen zu den Daten im Formular oder ob der Benutzer offline arbeitet ändern. Sie können das Ziel von IFRAME dynamisch festlegen.
Hinweis
Wenn Sie die Zielseite für den IFRAME ändern, werden Parameter nicht automatisch an den neuen URL-Parameter übergeben. Sie müssen Abfragezeichenfolgenparameter an die URL anfügen, bevor Sie die Methode setSrc verwenden.
Beispiel
Im folgenden Beispiel wird gezeigt, wie die Eigenschaft src für den IFRAME und alle potenziellen Parameter mithilfe des Ereignisses onChange einer Auswahlspalte festgelegt wird.
//Get the value of an option set attribute
var formContext = executionContext.getFormContext();
var value = formContext.getAttribute("new_pagechooser").getValue();
var newTarget = "";
//Set the target based on the value of the option set
switch (value) {
case 100000001:
newTarget = https://myServer/test/pageOne.aspx;
break;
default:
newTarget = https://myServer/test/pageTwo.aspx;
break;
}
//Get the default URL for the IFRAME, which includes the
// query string parameters
var IFrame = formContext.ui.controls.get("IFRAME_test");
var Url = IFrame.getSrc();
// Capture the parameters
var params = Url.substr(Url.indexOf("?"));
//Append the parameters to the new page URL
newTarget = newTarget + params;
// Use the setSrc method so that the IFRAME uses the
// new page with the existing parameters
IFrame.setSrc(newTarget);
Siehe auch
Clientskripting mit JavaScript
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).