Ouvrir les applications, formulaires, vues, boîtes de dialogue et rapports avec une URL

Les éléments accessibles via une adresse URL vous permettent d’inclure des liens vers des applications pilotées par modèle, formulaires, vues, boîtes de dialogue et rapports dans d’autres applications.

URL d’applications

Vous pouvez ouvrir n’importe quelle application pilotée par modèle à l’aide des valeurs AppModule.UniqueName ou AppModule.AppModuleId.

Vous pouvez récupérer ces valeurs à l’aide de l’API web via la requête suivante :

GET [Organization URI]/api/data/v9.1/appmodules?$select=appmoduleid,uniquename

Plus d’informations : Interroger les données à l’aide de l’API Web

Vous pouvez utiliser les paramètres de requête appname ou appid avec les valeurs Nom unique ou AppModuleId respectivement, mais vous ne pouvez pas utiliser les deux en même temps.

Utilisation du nom unique

Pour ouvrir l’application en utilisant le nom unique, ajoutez le paramètre de requête appname à la page main.aspx.

https://myorg.crm.dynamics.com/main.aspx?appname={UniqueName}

Par exemple, si le nom unique est msdyn_SolutionHealthHub, vous pouvez ouvrir cette application à l’aide de cette URL :

https://myorg.crm.dynamics.com/main.aspx?appname=msdyn_SolutionHealthHub

Utilisation d’AppModuleId

Ajoutez le paramètre de requête appid à la page main.aspx pour ouvrir l’application en utilisant AppModuleId.

https://myorg.crm.dynamics.com/main.aspx?appid={AppModuleId}

Par exemple :

https://myorg.crm.dynamics.com/main.aspx?appid=12fd1cf3-e06e-e911-a95f-000d3a13c42a

Formulaires et vues accessibles via une adresse URL

Tous les formulaires et toutes les vues de table s’affichent dans la page main.aspx. Les paramètres de chaîne de requête transmis à ce contrôle de page s’affichent. Par exemple :

Pour ouvrir un formulaire d’enregistrement de compte où l’ID est {91330924-802A-4B0D-A900-34FD9D790829} :

https://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D  

Pour ouvrir la vue Opportunités fermées pour :

https://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039  

Pour ouvrir la vue Contacts actifs sans la barre de navigation ni la barre de commandes

https://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false  

Vous utiliserez généralement la méthode getClientUrl pour extraire l’URL racine de l’organisation pour les applications pilotées par modèle.

Paramètres de chaîne de requête pour la page Main.aspx

Voici les paramètres de chaîne de requête utilisés avec la page main.aspx pour ouvrir les formulaires de table :

Copier l’URL d’une vue

Plusieurs vues dans les applications pilotées par modèle permettent à un utilisateur de copier l’URL d’une vue spécifique ou d’envoyer un e-mail avec l’URL d’une vue spécifique incorporée dans le message. Cette fonctionnalité facilite la communication entre les utilisateurs et permet d’accéder à une URL d’une vue que les utilisateurs peuvent inclure dans une autre application, comme un site SharePoint.

La page affichée par l’URL inclut la vue complète. Elle contient le ruban mais pas la navigation dans l’application.

Obtenir l’URL d’une vue

1. Ouvrez la vue à utiliser.

2. Dans la barre de commandes, sélectionnez Actions, puis sélectionnez Envoyer un lien par e-mail.

3. Collez le lien dans Notepad et modifiez-le pour extraire uniquement la partie URL du texte souhaité.

Afficher une vue dans la navigation d’application à l’aide du plan du site

Lorsque vous modifiez la navigation d’application au moyen du plan du site, n’utilisez pas l’URL de la vue que vous avez copiée de l’application avec la procédure fournie dans Copier l’URL d’une vue pour la définir comme URL. Cette URL affiche une page qui inclut le ruban et produit des résultats indésirables en cas d’utilisation dans un paramètre d’URL <SubArea>.

Pour afficher une liste d’enregistrements de tables dans l’application pour une sous-zone (SubArea), définissez la valeur de colonne de table. Cette opération affiche la vue par défaut de cette table et fournit le titre et l’icône appropriés.

Toutefois, si vous souhaitez utiliser un élément SubArea qui utilise une vue par défaut initiale spécifique, utilisez le modèle URL suivant.

Url="/main.aspx?appid=e2bc1066-488f-eb11-b1ac-000d3a56ead9&pagetype=entitylist&etn=account&viewid=%7b<GUID value of view id>%7d"

Lorsque vous utilisez cette URL, vous devez également spécifier les valeurs appropriées pour <Titles> et <Descriptions>, et spécifiez une icône pour la table.

Ouverture d’un processus de dialogue à l’aide d’une URL

Une personnalisation courante consiste à permettre à un utilisateur d’ouvrir un processus de dialogue spécifique dans le contexte d’un enregistrement spécifique. Par exemple, vous pouvez ajouter un bouton personnalisé au ruban pour une table spécifique à l’aide de la valeur d’ID pour l’enregistrement actif en tant que paramètre d’entrée pour le processus de dialogue.

Pour ouvrir un dialogue, vous avez besoin de ce qui suit :

• L’identificateur unique du dialogue.

• Le nom logique de la table pour laquelle le dialogue est créé.

• L’identificateur unique pour l’enregistrement pour lequel vous souhaitez disposer du dialogue.

Cet exemple montre les paramètres d’URL et de chaîne de requête permettant d’ouvrir un dialogue :

[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[table logical name]&ObjectId=[unique identifier for the record]  

Par exemple, pour ouvrir le dialogue avec l’ID ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} avec l’ID d’enregistrement de compte = {40C9ADFD-90A8-DF11-840E-00155DBA380F}, utilisez l’URL dans l’exemple suivant.

[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d  

Vous pouvez créer une fonction JavaScript pour ouvrir le dialogue comme illustré dans l’exemple suivant :

function openDialogProcess(dialogId, entityName, objectId)  
{  
 var url = Xrm.Page.context.getClientUrl() +  
  "/cs/dialog/rundialog.aspx?DialogId=" +  
  dialogId + "&EntityName=" +  
  entityName + "&ObjectId=" +  
  objectId;  
 window.open(url);  
}  

Ouverture d’un rapport à l’aide d’une URL

Vous pouvez ouvrir un rapport en transmettant les valeurs de paramètres appropriées dans l’URL suivante : [organization url]/crmreports/viewer/viewer.aspx.

Cette URL accepte les paramètres suivants :

action
Les deux valeurs possibles pour ce paramètre sont run ou filter. Lorsque run est utilisé, le rapport s’affiche en utilisant les filtres par défaut. Lorsque filter est utilisé, le rapport affiche un filtre que l’utilisateur peut modifier avant de choisir le bouton Exécuter le rapport pour afficher le rapport.

helpID
Ce paramètre est facultatif. Pour les rapports qui sont inclus avec les applications pilotées par modèle, la valeur de ce paramètre permet au bouton Aide d’afficher le contenu approprié relatif à ce rapport lorsque Aide sur cette page est sélectionné. La valeur doit correspondre à la valeur FileName du rapport.

id
Ce paramètre est la valeur ReportId du rapport.

Les exemples suivants illustrent les URL permettant d’ouvrir les rapports dans les applications pilotées par modèle.

Ouvrez le rapport Incidents négligés à l’aide du filtre par défaut :

[organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d  

Ouvrez le rapport Premiers articles de la Base de connaissances et invitez l’utilisateur à définir des valeurs de filtre :

[organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d  

La fonctionnalité suivante montre comment encoder correctement les valeurs de l’URL :

function getReportURL(action,fileName,id) {  
 var orgUrl = GetGlobalContext().getClientUrl();  
 var reportUrl = orgUrl +   
  "/crmreports/viewer/viewer.aspx?action=" +  
  encodeURIComponent(action) +  
  "&helpID=" +  
  encodeURIComponent(fileName) +  
  "&id=%7b" +  
  encodeURIComponent(id) +  
  "%7d";  
 return reportUrl;  
}  

Voir aussi

Définir les valeurs des colonnes en utilisant les paramètres transmis à un formulaire
Xrm.Navigation.openUrl
Configurer un formulaire pour accepter les paramètres de chaîne de requête personnalisés
Personnaliser le ruban
Création de scripts client à l’aide de JavaScript
Ressources Web
Modifier la navigation dans l’application à l’aide du plan de site