Freigeben über

openWebResource (Client-API-Referenz)

  • Artikel

Öffnet eine HTML-Webressource in einem neuen Fenster.

Syntax

Xrm.Navigation.openWebResource(webResourceName,windowOptions,data)

Parameter

Name typ Erforderlich Eigenschaft
webResourceName String Ja Name der zu öffnenden HTML-Webressource.
windowOptions Object Nein Fensteroptionen zum Öffnen der Webressource. Das Objekt enthält die folgenden Werte:
- height: (optional) Zahl. Höhe des zu öffnenden Fensters in Pixeln.
- width: (optional) Zahl. Breite des zu öffnenden Fensters in Pixeln.
data String Nein Daten, die in den Datenparameter übergeben werden.

Anmerkungen

Sie müssen diese Methode verwenden, um Webressourcen anstelle der veralteten Xrm.Utility.openWebResource-Methode anzuzeigen.

Eine HTML-Webressource kann die Parameterwerte akzeptieren, die in Durchlaufparameter an HTML-Webressourcen übergeben beschrieben werden. Diese Funktion dient nur zum Übergeben des optionalen Datenparameters. Um Werte für weitere gültige Parameter zu übergeben, müssen Sie sie an den webResourceName-Parameter anfügen.

Anmerkung

Das Xrm-Objekt ist in HTML-Webressourcen nicht verfügbar. Daher werden Skripts, die Xrm.*-Methoden enthalten in HTML-Webressourcen nicht unterstützt. parent.Xrm.* funktioniert, wenn die HTML-Webressource in einem Formularcontainer geladen wird. Für andere Speicherorte, wie etwa beim Laden einer HTML-Webressource als Bestandteil der SiteMap, funktioniert parent.Xrm.* allerdings nicht. Weitere Informationen: GetGlobalContext Funktion und ClientGlobalContext.js.aspx

Beispiele

  • Öffnen Sie eine HTML-Webressource namens „new_webResource.htm“:

    Xrm.Navigation.openWebResource("new_webResource.htm");

  • Öffnen Sie eine HTML-Webressource, indem Sie die windowOptions einstellen:

    var windowOptions = { height: 400, width: 400 };
Xrm.Navigation.openWebResource("new_webResource.htm",windowOptions);

  • Öffnen einer HTML-Webressource und ein einzelnes Element von Daten für den data-Parameter

    Xrm.Navigation.openWebResource("new_webResource.htm",null,"dataItemValue");

Xrm.Navigation