Partager via

Page CRM (contrôle hébergé)

  • Article

 

Date de publication : novembre 2016

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

Utilisez le type de contrôle hébergé Page CRM pour charger une URL ou une page Dynamics 365. Lorsqu'une page Dynamics 365 est chargée dans un contrôle hébergé de ce type, elle analyse automatiquement la page pour rechercher les données de l'entité, et renseigne automatiquement les paramètres de remplacement.

Ce type de contrôle hébergé présente une série d'événements et d'actions UII qui sont propres à la gestion des fenêtres Dynamics 365, notamment des actions de manipulation des listes et une action de recherche pour afficher une page de recherche rapide ou avancée.

Contenu de la rubrique

Créer un contrôle hébergé Page CRM

Actions UII prédéfinies

Événements prédéfinis

Créer un contrôle hébergé Page CRM

Lors de la création d'un contrôle hébergé, les champs de l'écran Nouveau contrôle hébergé varient selon le type de contrôle hébergé à créer. Cette section fournit des informations sur les champs propres au type de contrôle hébergé Page CRM. Pour obtenir des informations détaillées sur la création d'un contrôle hébergé, voir Créer ou modifier un contrôle hébergé.

Contrôle hébergé Page Dynamics 365

Dans l'écran Nouveau contrôle hébergé :

  • Dans la zone Unified Service Desk, sélectionnez Page CRM dans la liste déroulante Type de composant USD.

  • Dans la liste déroulante Autoriser plusieurs pages, sélectionnez Non (par défaut) pour remplacer la page Dynamics 365 qui est actuellement affichée et mettre à jour l'historique du navigateur lorsque Unified Service Desk reçoit un appel à l'action de navigation ou qu'une page est acheminée vers l'onglet. Sélectionnez Oui pour créer automatiquement une liste déroulante lorsqu'une deuxième URL est appelée ou qu'une règle de navigation dans la fenêtre dirige une page vers l'onglet. Cela permet à l'utilisateur de rapidement rechercher des informations sur les pages Dynamics 365 qui sont associées à ce contrôle. En outre, lorsque vous sélectionnez Oui, un champ supplémentaire, Navigateurs maximum, devient disponible dans laquelle vous pouvez spécifier le nombre maximal de pages à afficher dans la liste déroulante.

  • La liste déroulante Type d'hébergement indique comment vous souhaitez que ce contrôle soit hébergé. Vous pouvez choisir Processus IE (valeur par défaut) ou WPF interne . Pour plus d'informations, voir Sélectionner une méthode d'hébergement pour vos contrôles.

  • Dans la zone Propriétés courantes, activez la case à cocher Application globale pour définir le contrôle hébergé comme global. Les contrôles hébergés globaux peuvent être affichés en dehors de la session client. Des contrôles tels que le tableau de bord, le mur ou la recherche des agents sont des exemples courants de contrôles hébergés globaux. Les contrôles hébergés globaux n'ont pas de statut spécifique à une session, ainsi lorsque vous changez de session, ces mêmes contrôles hébergés globaux demeurent. Si la case à cocher est désactivée, le contrôle hébergé est basée sur la session. Les contrôles basés sur une session existent dans le contexte de la session client. Si l'utilisateur change de session, toutes les pages de session de la session précédente sont masquées.

  • Le champ Afficher le groupe présente le panneau où ce contrôle hébergé sera affiché.MainPanel est le plus courant pour ce type de contrôle hébergé. Pour plus d'informations sur les différents panneaux disponibles dans Unified Service Desk, voir Panneaux, types de panneau, et structures de panneau dans Unified Service Desk.

Pour plus d'informations sur les autres champs Général, voir Créer ou modifier un contrôle hébergé.

Actions UII prédéfinies

Voici les actions prédéfinies pour ce type de contrôle hébergé.

AssociatedView

Cette action charge une vue associée spécifique de Dynamics 365. Ces vues sont généralement accessibles en cliquant sur la flèche vers le bas en regard d'un nom d'enregistrement d'entité dans la barre de navigation, puis en sélectionnant les entités associées.

Paramètre

Description

navItemName

Entité associée à afficher. Exemple : Incidents

ID

ID de l'enregistrement d'entité principal pour lequel afficher les enregistrements d'entités associés.

tabset

Zone de Dynamics 365. Exemples : areaSales ou areaService.

Pour plus d'informations sur l'utilisation de cette action, voir l'étape 5 du Guide pas-à-pas 7 : Configuration de la génération de scripts d'agent dans votre application agent.

Fermer

Cette action permet de fermer le contrôle hébergé. Contrairement à l'action CloseActive, si cet onglet (contrôle hébergé) contient plusieurs pages, elle fermera toutes les pages affichées dans l'onglet de votre application agent.

CloseActive

Cette action permet de fermer la fenêtre active dans ce contrôle hébergé. Si la fenêtre active est la seule fenêtre affichée dans le contrôlé hébergé, le contrôle lui-même est fermé. Pour le type de contrôle hébergé Page CRM qui n'autorise pas les pages multiples (Autoriser plusieurs pages = Non), cette action est équivalente à l'action Fermer.

CloseAndPrompt

Cette action ferme le contrôle hébergé, mais invite l'utilisateur à enregistrer ou abandonner les modifications avant la fermeture.

DisableToolbarButton

Cette action désactive le bouton de barre d'outils spécifié dans la barre d'outils de votre application agent.

Paramètre

Description

Nom du bouton de barre d'outils à désactiver.

EnableToolbarButton

Cette action active le bouton de barre d'outils spécifié dans la barre d'outils de votre application agent.

Paramètre

Description

Nom du bouton de barre d'outils à activer.

Rechercher

Accédez à la vue de la liste de recherche rapide de l'entité spécifiée.

Paramètre

Description

Le paramètre de données doit spécifier le nom logique de l'entité de la vue de la liste de recherche rapide à afficher. Il existe des valeurs spéciales pour les incidents :

  • Utilisez incident ou incident pour afficher la vue de liste de recherche rapide des incidents.

  • Utilisez advfind pour afficher la vue de recherche avancée.

  • Utilisez activités ou activité pour afficher la vue de liste de recherche rapide des activités.

FireEvent

Déclenche un événement défini par l'utilisateur à partir de ce contrôle hébergé.

Paramètre

Description

nom

Nom de l'événement défini par l'utilisateur.

Toutes les paires nom=valeur suivantes deviennent les paramètres de l'événement. Pour plus d'informations sur la création d'un événement défini par l'utilisateur, voir Créer un événement défini par l'utilisateur.

GetSelectedIds

Cette action permet de récupérer les ID sélectionnés dans les listes.

Paramètre

Description

Le paramètre de données doit spécifier le nom de la liste pour capturer les ID sélectionnés.

La valeur renvoyée contient une liste des ID contenant les éléments sélectionnés, séparés par des points-virgules.

GetSelectedCount

Cette action récupère le nombre d'éléments qui sont sélectionnés. Utilisez l'action GetSelectedIds pour obtenir la liste effective des ID de l'entité.

Paramètre

Description

Le paramètre de données doit spécifier le nom de la liste pour récupérer les ID sélectionnés.

La valeur renvoyée contient un nombre représentant la quantité d'éléments sélectionnés.

GoHome

Cette action permet d'accéder à l'URL initiale spécifiée pour cette instance de navigateur.

GoBack

Cette action revient à cliquer sur le bouton Précédent de l'instance de navigateur.

GoForward

Cette action revient à cliquer sur le bouton Suivant de l'instance de navigateur.

LoadArea

Cette action charge une zone spécifique de Dynamics 365. Cela revient à sélectionner une zone du volet de navigation (telle que Ventes, Service et Marketing). Le seul paramètre est le nom de la zone sur laquelle cliquer. Par exemple : areaService.

Paramètre

Description

cadre

Nom du cadre à affecter. Si aucun nom n'est spécifié, il visera automatiquement le premier cadre trouvé dans la page.

LookupInfo

Affiche une boîte de dialogue d'informations de recherche Dynamics 365 pour vous permettre de sélectionner une entité dans une liste.

Paramètre

Description

AllowFilterOff

« 0 » ou « 1 » pour permettre à l'utilisateur de désactiver le filtre

DefaultType

Nom logique de l'affichage par défaut. Il doit correspondre à l'une des valeurs numériques spécifiées dans le paramètre objecttypes.

DefaultViewId

« 0 » ou « 1 » pour afficher la vue par défaut

DisableQuickFind

« 0 » ou « 1 » pour afficher le champ de recherche rapide

DisableViewPicker

« 0 » ou « 1 » pour afficher le sélecteur de vue

LookupStyle

Un seul ou plusieurs

ShowNewButton

« 0 » ou « 1 » pour afficher un nouveau bouton

ShowPropButton

« 0 » ou « 1 » pour afficher le bouton des propriétés

Parcourir

« 0 » ou « 1 » pour utiliser le mode de navigation. Le paramètre suivant est défini sur « 1 » avec celui-ci.

Currentid

GUID de la valeur actuelle.

objecttypes

Liste des types d'objet à afficher. Il s'agit des types etc de Dynamics 365. Exemple : « 1,2 » pour afficher les comptes et les contacts.

MoveToPanel

Cette action déplace un contrôle hébergé Page CRM vers un autre volet au moment de l'exécution.

Paramètre

Description

Le paramètre de données doit spécifier le nom du volet cible vers lequel déplacer le contrôle hébergé. Par exemple : FloatingPanel.

Cette action permet d'accéder à une URL Dynamics 365.

Paramètre

Description

URL

URL à laquelle accéder. Ce paramètre est obligatoire.

Noscan

Si ce paramètre est fourni et qu'il est défini sur Vrai, les paramètres de données ne seront pas capturés à partir de la page.

HideCommandBar

Si ce paramètre est fourni et qu'il est défini sur Vrai, le cadre interne s'affiche sans charger la barre de commandes Dynamics 365.

HideNavigationBar

Si ce paramètre est fourni et qu'il est défini sur Vrai, le formulaire s'affiche sans charger la barre de navigation Dynamics 365.

Cadre

Lorsqu'il y a des cadres dans la page, ce paramètre spécifie le nom du cadre pour la navigation, plutôt que de naviguer via la fenêtre principale.

postdata

Données envoyées au serveur dans le cadre d'une transaction HTTPPOST. Une transaction POST est généralement utilisée pour envoyer les données collectées par une page HTML. Dans Unified Service Desk, ces données peuvent être reçues de tout événement déclenché à l'aide de « http://event/? ». Exemple : [[postdata]+]

Par ailleurs, les données sont transmises en tant que chaîne encodée avec son type d'en-tête au format attendu.

header

Valeur de chaîne contenant des en-têtes HTTP supplémentaires à envoyer au serveur. Lorsque le paramètre postdata est utilisé dans l'action Navigate, vous devez également spécifier la valeur appropriée pour le paramètre header. Exemple : Content-Type:application/x-www-form-urlencoded

Si un événement Unified Service DeskPOST déclenche l'action Navigate, la valeur par défaut de ce paramètre doit être header=[[header]+]

New_CRM_Page

Crée une page for pour créer un nouvel enregistrement Dynamics 365 de l'entité spécifiée et traite la page comme une fenêtre contextuelle de l'hôte hébergé spécifié. Les règles de navigation dans la fenêtre sont évaluées afin de déterminer l'emplacement où la page de création de l'enregistrement d'entité est affichée.

Paramètre

Description

LogicalName

Nom logique de l'entité pour créer une nouvelle instance.

Notes

Le reste des paramètres doit être composé de paires nom=valeur. Il s'agit des autres valeurs préremplies dans le formulaire pour créer un enregistrement pour l'entité spécifiée. Pour plus d'informations sur l'utilisation de cette action, voir l'étape 4 du Guide pas-à-pas 7 : Configuration de la génération de scripts d'agent dans votre application agent.

Open_CRM_Page

Ouvre une instance existante de l'entité spécifiée et identifiée par l'ID, et traite la page comme s'il s'agissait d'une fenêtre contextuelle provenant du contrôle hébergé spécifié. Les règles de navigation dans la fenêtre sont évaluées pour déterminer l'emplacement où la fenêtre contextuelle doit être affichée.

Paramètre

Description

LogicalName

Nom logique de l'entité à ouvrir.

id

ID de l'enregistrement d'entité à ouvrir.

Fenêtre contextuelle

Ouvre une fenêtre contextuelle avec une URL à partir du contrôle hébergé et exécute les règles de navigation dans la fenêtre en fonction de cette URL, pour acheminer la fenêtre contextuelle à l'emplacement approprié.

Paramètre

Description

URL

Achemine une fenêtre contextuelle à partir de ce contrôle hébergé à l'aide de cette URL, comme s'il s'agissait d'une fenêtre contextuelle demandée à partir du contrôle affiché.

cadre

Cadre d'où provient la fenêtre contextuelle.

RealignWindow

Affiche le contrôle hébergé à l'emplacement spécifié sur un moniteur. Vous pouvez afficher le contrôle hébergé sur deux moniteurs au maximum. Cette action s'applique aux instances de contrôle hébergé qui sont configurées pour être placées sur un volet de type USDFloatingPanel ou USDFloatingToolPanel.

Paramètre

Description

écran

Spécifie l'écran sur lequel afficher le contrôle hébergé. Les valeurs valides sont 1 ou 2. Si vous ne spécifiez pas ce paramètre, la valeur 1 est transmise par défaut.

gauche

Spécifie la position, en pourcentage, à partir de la gauche de l'écran sur le moniteur cible où le contrôle hébergé doit être affiché. Les valeurs valides vont de 0 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 0 est transmise par défaut.

haut

Spécifie la position, en pourcentage, à partir du haut de l'écran sur le moniteur cible où le contrôle hébergé doit être affiché. Les valeurs valides vont de 0 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 0 est transmise par défaut.

largeur

Spécifie la largeur, en pourcentage, de la fenêtre du contrôle hébergé sur le moniteur cible. Les valeurs valides vont de 1 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 100 est transmise par défaut.

hauteur

Spécifie la hauteur, en pourcentage, de la fenêtre du contrôle hébergé sur le moniteur cible. Les valeurs valides vont de 1 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 100 est transmise par défaut.

Actualiser

Cette action actualise la page actuelle.

ReRoute

Cette action prend l'URL actuellement affichée et l'envoie via les règles de navigation dans la fenêtre, à partir du contrôle hébergé actuel, comme une fenêtre contextuelle.

RunScript

Cette action injecte JavaScript dans le cadre principal de l'application. Vous devez éviter d'utiliser les appels du Kit de développement logiciel du client Dynamics 365 avec cette action. Utilisez plutôt l'action RunXrmCommand.

Paramètre

Description

Le paramètre de données est le JavaScript qui sera injecté dans le formulaire.

Notes

Les paramètres de remplacement peuvent être utilisés dans le script et ils seront remplacés avant l'exécution du script.

RunXrmCommand

Cette action permet d'injecter un code Javascript SDK Dynamics 365 au formulaire Dynamics 365.

Paramètre

Description

Le paramètre de données est le JavaScript qui sera injecté dans le formulaire.

Notes

Les paramètres de remplacement peuvent être utilisés dans le script et ils seront remplacés avant l'exécution du script.

SetSize

Cette action définit de façon explicite la largeur et la hauteur du contrôle hébergé. Ceci est particulièrement utile lorsque vous utilisez la fonction « automatique » dans vos dispositions de panneau.

Paramètre

Description

width

Largeur du contrôle hébergé.

height

Hauteur du contrôle hébergé.

SaveAndClose

Cette action permet d'enregistrer les données modifiées dans le formulaire Dynamics 365, et ferme le contrôle hébergé.

SaveAll

Cette action enregistre tous les formulaires d'un contrôle hébergé qui permet l'affichage de plusieurs pages (Autoriser plusieurs pages = Oui). Si le contrôle hébergé permet l'affichage d'une seule page (Autoriser plusieurs pages = Non), il est équivalent à l'action Enregistrer.

Enregistrer

Cette action enregistre la page CRM actuelle.

ToggleRibbon

Cette action réduit ou agrandit le ruban. Si vous masquez le ruban dans l'action Naviguer, il n'est pas affiché et cette action ne fonctionne pas. Cette action s'exécute uniquement lorsque le ruban a été initialement chargé.

ToggleNavigation

Cette action réduit ou développe le volet de navigation du panneau gauche de la fenêtre Dynamics 365. La navigation doit contenir un volet de navigation pour que cela fonctionne.

Événements prédéfinis

Les événements prédéfinis suivants sont associés à ce type de contrôle hébergé.

ActiveClosed

Survient lorsque le contrôle hébergé actif est fermé à l'aide de l'action CloseActive.

Paramètre

Description

URL

URL qui était affichée dans le contrôle hébergé lorsqu'il a été fermé.

BrowserDocumentComplete

Survient lorsque le chargement de la page est terminé. Dans un type de contrôle hébergé Page CRM, cet événement se produit lorsque les données ont été enregistrées dans la liste des paramètres de remplacement. Cet événement se produit une seule fois, même si plusieurs cadres ont individuellement déclenché leurs événements BrowserDocumentComplete.

Paramètre

Description

URL

URL de la page dont le chargement est terminé.

PageLoadComplete

Survient à tout moment lorsque le chargement d'un cadre est terminé. Cet événement peut se produire plusieurs fois par chargement de page lorsqu'un iFrame ou un cadre est utilisé dans la page. Cet événement correspond aux événements BrowserDocumentComplete individuels du code.

Paramètre

Description

cadre

Nom du cadre dont le chargement est terminé, si disponible.

URL

URL du cadre dont le chargement est terminé.

PopupRouted

Survient lorsqu'une fenêtre contextuelle a été acheminée par le système.

Paramètre

Description

URL

URL de la fenêtre contextuelle qui a été acheminée.

RefreshRequested

Survient lorsqu'une actualisation est demandée sur la page actuelle. L'actualisation peut être demandée en enfonçant la touche F5 ou en appelant l'action Actualiser par l'application.

Paramètre

Description

URL

URL affichée lorsque l'actualisation a été demandée.

Enregistré

Survient après qu'un enregistrement de la page Dynamics 365 est enregistré.

Paramètre

Description

newId

ID attribué à l'enregistrement récemment créé.

Voir aussi

Dialogue CRM (contrôle hébergé)
Actions UII
Événements
Guide pas-à-pas 3: Affichage d'enregistrements Microsoft Dynamics 365 dans votre application agent
Types de contrôle hébergé et référence d'action/événement
Guide d'administration d'Unified Service Desk pour Microsoft Dynamics CRM

Unified Service Desk 2.0

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