openWebResource (référence de l’API client)

Ouvre une ressource Web HTML dans une nouvelle fenêtre.

Syntaxe

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

Paramètres

Nom Type Nécessaire Description
webResourceName Chaîne Oui Nom de la ressource Web HTML à ouvrir.
windowOptions Objet Non Options de fenêtres pour ouvrir la ressource Web. L’objet contient les valeurs suivantes :
- height : Nombre (Facultatif). Hauteur de la fenêtre à ouvrir en pixels.
- width : Nombre (Facultatif). Largeur de la fenêtre à ouvrir en pixels.
data Chaîne Non Données à transmettre dans le paramètre de données.

Remarques

Vous devez utiliser cette méthode pour afficher les ressources Web au lieu de la méthode Xrm.Utility.openWebResource déconseillée.

Une ressource Web HTML peut accepter les valeurs de paramètre décrites dans Transmettre les paramètres aux ressources Web HTML. Cette fonction assure uniquement le transfert du paramètre de données facultatif. Pour transmettre les valeurs des autres paramètres non valides, vous devez les ajouter au paramètre webResourceName.

Notes

L’objet Xrm n’est pas disponible dans les ressources Web HTML. En conséquence, les scripts contenant les méthodes Xrm.* ne sont pas pris en charge dans les ressources Web HTML. parent.Xrm.* fonctionnera si la ressource Web HTML est chargée dans un conteneur de formulaire. Cependant, pour les autres emplacements, comme le chargement d’une ressource Web HTML dans le cadre de SiteMap, parent.Xrm.* ne fonctionnera pas non plus. Plus d’informations : Fonction GetGlobalContext et ClientGlobalContext.js.aspx

Exemples

  • Ouvrir une ressource Web HTML nommée « new_webResource.htm » :

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

  • Ouvrir une ressource Web HTML, définir windowOptions: :

    var windowOptions = { height: 400, width: 400 };
    Xrm.Navigation.openWebResource("new_webResource.htm",windowOptions);
    
  • Ouvrir une ressource Web HTML, incluant un élément unique des données du paramètre data

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

Xrm.Navigation

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).