Ouvrir des applications, des formulaires, des vues et des rapports avec une URL

Les éléments adressables d’URL vous permettent d’inclure des liens vers des applications basées sur des modèles, des formulaires, des vues et des rapports dans d’autres applications.

Note

Les applications adressables d’URL, les formulaires, les vues et les rapports ne peuvent pas contourner la sécurité. Seuls les utilisateurs autorisés, en fonction de leurs rôles de sécurité, peuvent accéder aux données et aux enregistrements qu’ils voient.

URL d’application

Note

L’incorporation d’une application basée sur un modèle dans un IFrame dans une autre application n’est pas prise en charge. Consultez Intégration d’une application pilotée par modèle.

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

Pour plus d’informations, consultez 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.

Utiliser un nom unique

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

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

Pour ouvrir l’application à l’aide de AppModuleId, ajoutez le appid paramètre de requête à la main.aspx page.

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

Par exemple :

https://myorg.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444

Formulaires et vues accessibles via une adresse URL

La main.aspx page affiche tous les formulaires et vues. Les paramètres de chaîne de requête que vous passez à cette page contrôlent ce qui est affiché. Par exemple :

Pour ouvrir un formulaire d’enregistrement de compte dans lequel 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 :

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

Note

Utilisez Xrm.Navigation.navigateTo ou Xrm.Navigation.openForm lorsque vous ouvrez les formulaires par programmation au sein de l’application en utilisant les ressources web. N’utilisez window.openpas .
En dehors de l’application, où les pages n’ont pas accès aux fonctions ou Xrm.Navigation.openForm aux Xrm.Navigation.navigateTo fonctions, utilisez window.open ou un lien pour ouvrir un enregistrement ou un formulaire spécifique pour une table. L’affichage d’un formulaire dans un IFrame incorporé dans un autre formulaire n’est pas pris en charge.

En règle générale, vous utilisez la méthode getClientUrl pour récupérer l’URL racine de l’organisation pour les applications basées sur des modèles.

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

Astuce

Pour obtenir la valeur d’ID d’un enregistrement, utilisez le bouton Envoyer un lien dans la barre de commandes. L’exemple suivant montre ce qui s’ouvre dans votre application de messagerie :

<https://mycrm/myOrg/main.aspx?etc=4&id=%7b899D4FCF-F4D3-E011-9D26-00155DBA3819%7d&pagetype=entityrecord>.

Le id paramètre passé à l’URL est la valeur d’ID encodée pour l’enregistrement. Dans cet exemple, la valeur d’ID est {899D4FCF-F4D3-E011-9D26-00155DBA3819}. La version encodée du GUID remplace respectivement les crochets ouvrants et fermants { et } par %7B et %7D, respectivement.

Le tableau suivant répertorie les paramètres de chaîne de requête utilisés avec la page main.aspx pour ouvrir des formulaires ou des vues :

Paramètre	Description
`etn`	Nom logique de la table. Important : n’utilisez pas le paramètre etc (code de type de table) contenant un code d’entier pour la table. Ce code de nombre entier varie pour les tables personnalisées dans différentes organisations.
`extraqs`	Facultatif pour les formulaires. Ce paramètre contient des paramètres encodés dans ce paramètre. Utilisez ce paramètre pour passer des valeurs à un formulaire. Pour plus d’informations, voir Définir les valeurs de colonne utilisant les paramètres transmis à un formulaire. Lorsqu’une table a plusieurs formulaires définis, vous pouvez utiliser ce paramètre pour spécifier le formulaire à ouvrir en passant le paramètre `formid` encodé avec la valeur égale à la valeur d’ID du formulaire. Par exemple, pour ouvrir un formulaire avec l’ID « 6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf », ajoutez cette valeur dans le paramètre `extraqs` : `formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A`.
`pagetype`	Type de page. Deux valeurs sont envisageables : - `entityrecord` Affiche un formulaire d’enregistrement. - `entitylist` Affiche une vue.
`id`	Facultatif pour les formulaires. Utilisez ce paramètre lorsque vous ouvrez un enregistrement de table spécifique. Fournissez l’identificateur GUID encodé pour la table. La version encodée du GUID remplace les crochets ouvrants et fermants « { » et « } » par «%7B» et «%7D», respectivement. Par exemple, `{91330924-802A-4B0D-A900-34FD9D790829}` est `%7B91330924-802A-4B0D-A900-34FD9D790829%7D`.
`viewid`	Requis pour les vues Il s’agit de l’ID de l’enregistrement de table `savedquery` ou `userquery` qui définit la vue. Le moyen le plus facile d’obtenir l’URL d’une vue est de la copier. Pour plus d’informations, consultez Copier l’URL d’une vue.
`viewtype`	Définit le type de vue. Les valeurs possibles sont les suivantes : - 1039 À utiliser pour une vue système. `viewid` représente l'ID d'un enregistrement `savedquery`. - 4230 Utilisation à usage personnel. `viewid` représente l'ID d'un enregistrement `userquery`.
`navbar`	Contrôle si la barre de navigation est affichée et si la navigation dans l’application est disponible dans les zones et les sous-zones définies dans le plan de site. -`on` La barre de navigation s’affiche. Il s’agit du comportement par défaut si le paramètre `navbar` n’est pas utilisé. -`off` La barre de navigation ne s’affiche pas. Les utilisateurs peuvent naviguer à l'aide d'autres éléments de l'interface ou des boutons de retour et d'avance. -`entity` Dans un formulaire, seules les options de navigation pour les tables associées sont disponibles. Après la navigation vers une table associée, un bouton Précédent s’affiche dans la barre de navigation pour permettre le renvoi vers l’enregistrement d’origine. Important: Ce paramètre n’est pris en charge que dans les applications basées sur un modèle à session unique. Il n’a aucun effet dans les applications multisession ou d’espace de travail telles que l’espace de travail Service client, l’espace de travail Copilot Service ou Omnichannel pour le service client.
`cmdbar`	Contrôle si la barre de commandes s’affiche. Remarque : cette fonctionnalité prend en charge les exigences liées à l’application Unified Service Desk. L’utilisation de ce paramètre pour afficher un formulaire dans un IFrame incorporé dans un autre formulaire n’est pas prise en charge. -`true` La barre de commandes s’affiche. Il s'agit du paramètre par défaut. - `false` La barre de commandes est masquée.

Copier l’URL d’une vue

De nombreuses vues dans les applications basées sur des modèles vous permettent de copier l’URL d’une vue particulière ou d’envoyer un e-mail avec l’URL d’une vue particulière 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.

Note

N’utilisez pas cette URL pour inclure la vue dans la navigation dans l’application à l’aide de la carte de site. Pour plus d’informations, voir Afficher une vue dans la navigation d’application à l’aide du plan du site.

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

Obtenir l’URL d’une vue

Ouvrez la vue à utiliser.
Dans la barre de commandes, sélectionnez Actions , puis Envoyez un lien par e-mail.
Collez le lien dans Notepad et modifiez-le pour extraire uniquement la partie URL du texte souhaité.

Note

Vous ne pouvez pas copier des vues qui utilisent le contexte utilisateur comme paramètre, comme Mes comptes.
- Le GUID qui représente les vues système pour les tables système est le même pour chaque installation. Le GUID pour les tables personnalisées et les vues personnalisées est unique pour chaque installation.

Lorsque vous personnalisez la navigation de l’application à l’aide de la carte de site, n’utilisez pas l’URL d’affichage que vous avez copiée à partir de l’application en suivant les étapes décrites dans Copier l’URL d’une vue à 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 table dans l’application pour un SubArea, définissez la valeur de colonne de table. Cette valeur 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=11112222-bbbb-3333-cccc-4444dddd5555&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.

Note

Si vous spécifiez l’affichage à l’aide de la /main.aspx page, le sélecteur d’affichage s’affiche toujours. Si l’utilisateur modifie la vue, les applications pilotées par modèle se souviendront de la dernière sélection de l’utilisateur et la vue par défaut initiale s’affichera lorsqu’il fermera et ouvrira de nouveau son navigateur.

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 vous utilisez run, le rapport s’affiche à l’aide des filtres par défaut. Lorsque vous utilisez filter, 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 inclus dans les applications basées sur des modèles, la valeur de ce paramètre permet au bouton d’aide d’afficher le contenu approprié de ce rapport lorsque l’aide sur cette page est choisie. La valeur doit correspondre à la valeur FileName du rapport.

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

Les exemples suivants montrent les URL que vous pouvez utiliser pour ouvrir des rapports dans des applications basées sur des modèles.

Ouvrez le rapport Cas 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

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-04-22

Partager via

Ouvrir des applications, des formulaires, des vues et des rapports avec une URL

URL d’application

Utiliser un nom unique

Utilisation d’AppModuleId

Formulaires et vues accessibles via une adresse URL

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

Copier l’URL d’une vue

Obtenir l’URL d’une vue

Afficher une vue dans la navigation de l’application à l’aide de la carte de site

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

Voir aussi

Commentaires

Ressources supplémentaires