Utiliser les contrôles IFRAME et de ressource Web dans un formulaire

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Les contrôles IFRAME et de ressource Web intègrent du contenu dans les pages à partir d’un autre emplacement, en utilisant un élément HTML IFRAME.

Vous pouvez utiliser un IFRAME pour afficher le contenu d’un autre site Web dans un formulaire, par exemple, dans une page ASP.NET. L'affichage d'un formulaire d'entité dans un IFrame imbriqué dans un autre formulaire d'entité n'est pas pris en charge.

Vous pouvez utiliser l’une des ressources Web suivantes pour afficher le contenu des ressources Web dans un formulaire :

• Ressources Web Webpage (HTML)

• Ressources Web (XAP) Silverlight

• Ressources Web image (JPG, PNG, GIF, ICO)

Les sections suivantes décrivent les options disponibles si vous souhaitez que ces contrôles affichent d’autres éléments en plus du contenu statique.

Contenu de la rubrique

Indiquer s’il faut restreindre les scripts sur plusieurs cadres

Transmettre des informations contextuelles sur l’enregistrement

Transmettre les données de formulaire

Modifier l’URL

Indiquer s’il faut restreindre les scripts sur plusieurs cadres

Utilisez l’option Restreindre les scripts sur plusieurs cadres en cas de prise en charge lorsque vous ne faites pas totalement confiance au contenu affiché dans un IFRAME. Lorsque cette option est sélectionnée, les attributs de l’IFRAME répertoriés dans le tableau suivant sont définis.

Activation de la communication d’un IFrame sur plusieurs domaines

Vous souhaitez parfois activer la communication d'un IFRAME dont le contenu est issu d'un autre domaine.Window.postMessage est une méthode de navigateur qui fournit cette fonctionnalité pour les versions d'Internet Explorer qui ne sont pas antérieures à Internet Explorer 8.Google Chrome, Mozilla Firefox et Apple Safari la prennent également en charge. Pour plus d’informations sur l’utilisation de postMessage, consultez les billets de blog suivants :

• Appels entre domaines au formulaire CRM 2011 parent

• Messagerie entre documents et RPC

Transmettre des informations contextuelles sur l’enregistrement

Vous pouvez fournir des informations contextuelles en transmettant des paramètres à l’URL définie dans le contrôle. La page affichée dans le cadre doit pouvoir traiter les paramètres qui lui sont transmis. Tous les paramètres contenus dans le tableau ci-dessous sont transmis si l’IFRAME ou la ressource Web est configuré à l’aide de l’option Transm. code type d’objet d’enregistr. et id. unique comme paramètres. L’élément XML du formulaire correspondant est <PassParameters> (FormXml).

Vous pouvez spécifier si tous les paramètres contenus dans le tableau suivant sont transmis.

Les codes de langue sont des ID de paramètres régionaux à quatre ou cinq chiffres. Les valeurs d'ID de paramètres régionaux valides sont disponibles sur la page Tableau des ID de paramètres régionaux (LCID).

Exemple

L’exemple suivant montre l’URL sans paramètres.

http://myserver/mypage.aspx

L’exemple suivant montre l’URL avec les paramètres.

http://myserver/mypage.aspx?id=%7bB2232821-A775-DF11-8DD1-00155DBA3809%7d&orglcid=1033&orgname=adventureworkscycle&type=1&typename=account&userlcid=1033

Lire les paramètres transmis

Les paramètres transmis sont généralement lus dans la page .aspx cible à l’aide de la propriété HttpRequest.QueryString. Dans la page HTML, les paramètres sont accessibles à l’aide de la propriété window.location.search en JavaScript. Pour plus d’informations, consultez Propriété HttpRequest.QueryString et Propriété search.

Transmettre les données de formulaire

Utilisez la méthode getValue sur les attributs contenant les données à transmettre à l’autre site Web, puis composez une chaîne des arguments de chaîne de requête que l’autre page peut utiliser. Utilisez un Événement OnChange de champ, un Événement OnReadyStateComplete IFRAME ou un Événement TabStateChange de l'onglet et la méthode setSrc pour ajouter vos paramètres à la propriété src de l’IFRAME ou de la ressource Web.

Si vous utilisez le paramètre de données pour transmettre les données à une ressource Web Silverlight, vous pouvez utiliser les méthodes getData et setData pour manipuler la valeur transmise via le paramètre de données. Pour les ressources Web (HTML) d’une page Web, utilisez la méthode setSrc pour manipuler directement le paramètre querystring.

Évitez d'utiliser l'Événement OnLoad. Les IFRAMES et les ressources Web sont chargés de manière asynchrone et il est possible que le chargement du cadre ne soit pas terminé avant la fin du script d'événement Onload. Cela peut entraîner le remplacement de la propriété src de l’IFRAME ou de la ressource Web modifié par la valeur par défaut de la propriété URL de l’IFRAME ou de la ressource Web.

Modifier l’URL

Vous pouvez modifier la cible de l’IFRAME en fonction des données du formulaire ou si l’utilisateur travaille hors connexion. Vous pouvez définir la cible de l’IFRAME de manière dynamique.

Exemple

L’exemple suivant montre comment définir la propriété src pour l’IFRAME et les paramètres en utilisant l’événement onChange d’un champ de groupe d’options.

//Get the value of an option set attribute
var value = Xrm.Page.data.entity.attributes.get("new_pagechooser").getValue();
var newTarget = "";
//Set the target based on the value of the option set
switch (value) {
    case 100000001:
        newTarget = "http://myServer/test/pageOne.aspx";
        break;
    default:
        newTarget = "http://myServer/test/pageTwo.aspx";
        break;
}
//Get the default URL for the IFRAME, which includes the 
// query string parameters
var IFrame = Xrm.Page.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);

Voir aussi

Écrire du code pour les formulaires Microsoft Dynamics 365
Utilisation de JavaScript avec Microsoft Dynamics 365
Référence rapide des scripts de formulaires

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright