Transmettre les paramètres vers une URL à l’aide du ruban
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Les actions de ruban sont définies dans l’élément <Actions> (RibbonDiffXml) d’un élément <CommandDefinition> (RibbonDiffXml). Il existe plusieurs manières de passer les informations contextuelles Microsoft Dynamics 365 comme paramètres de chaîne de requête à une URL à l’aide du ruban.
Utilisez un élément <Url> (RibbonDiffXml). Dans l’élément Url, utilisez l’attribut PassParams.
Utilisez un élément <Url> (RibbonDiffXml) avec un élément <CrmParameter> (RibbonDiffXml). Une fois utilisée à partir d’un élément Url, la valeur de l’attribut de nom doit être définie.
Utilisez un élément <JavaScriptFunction> (RibbonDiffXml) avec un élément <CrmParameter> (RibbonDiffXml).
Utiliser l’attribut PassParams pour définir des valeurs dynamiques
La transmission de paramètres à l’URL cible à l’aide de l’attribut PassParams fournit des informations à l’application cible sur le contexte de l’enregistrement ou de l’utilisateur. Tous les paramètres sont transmis si le contrôle du ruban est configuré à l’aide de l’attribut PassParams. Le tableau ci-dessous indique les paramètres qui sont transmis.
Paramètre |
Nom |
Description |
|---|---|---|
typename |
Nom de l'entité |
Nom de l’entité. Pour les entités personnalisées, cela inclut le préfixe de personnalisation, par exemple, new_entityname. |
type |
Code de type d’entité |
Entier qui identifie de manière unique l’entité dans l’organisation actuelle. Notes Les valeurs Entity Type Code sont déterminées par l'ordre dans lequel une entité est créée dans une organisation. Les Entity Type Codes pour les entités personnalisées sont généralement différents dans différentes organisations. |
id |
GUID de l’objet |
Identificateur global unique (GUID) qui représente un enregistrement. |
orgname |
Nom de l’organisation |
Nom unique de l’organisation. |
userlcid |
Code de langue de l’utilisateur |
Identificateur du code langue utilisé par l’utilisateur actuel. |
orglcid |
Code de langue de l’organisation |
Identificateur du code de langue représentant la langue de base pour l’organisation. |
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).
Notes
Nous vous suggérons d’utiliser le nom d’entité au lieu du code de type, car le code de type d’entité peut être différent entre les installations Microsoft Dynamics 365.
Exemple
L’exemple suivant montre l’URL sans paramètres :
http://myserver/mypage.aspx
Cet exemple montre les paramètres inclus lorsque le contrôle du ruban est présenté pour l’entité de compte, pour une organisation intitulée « AdventureWorksCycle », lorsque la langue de l’utilisateur et la langue de base de l’organisation est l’anglais, et que le GUID pour l’enregistrement de compte est DBD5DBFB-0666-DC11-A5D9-0003FF9CE217 :
http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D
Utiliser un paramètre Querystring dans l’URL
Vous pouvez inclure un paramètre querystring dans l’attribut URL. Il peut être utile si vous souhaitez ouvrir un enregistrement ou une vue Microsoft Dynamics 365 spécifique à l’aide de Ouvre les formulaires, vues, boîtes de dialogue et rapports avec une URL.
Notes
Vous ne pourrez pas importer le ruban si l’URL contient le caractère & utilisé pour séparer plusieurs paramètres querystring dans l’URL. Ce caractère rend le XML non valide. Vous devez effectuer un échappement au caractère esperluette (&) dans la valeur d’attribut URL avec « & ».
Lecture des paramètres transmis
Les paramètres transmis sont souvent lus dans la page .aspx cible en utilisant la propriété HttpRequest.QueryString.Pour plus d'informations :Propriété HttpRequest.QueryString
Notes
Si la cible de votre URL est une ressource Web, elle peut accepter uniquement les paramètres identifiés dans la rubrique Transmettre les paramètres aux ressources Web HTML. La seule opportunité pour passer des valeurs personnalisées consiste à les inclure dans le paramètre data. La gestion de certains caractères spéciaux est nécessaire pour inclure plusieurs valeurs dans un paramètre unique.Pour plus d'informations :Exemple : Transmettre plusieurs valeurs à une ressource Web via le paramètre de données
Voir aussi
Personnaliser les commandes et le ruban
Ouvre les formulaires, vues, boîtes de dialogue et rapports avec une URL
<Url> (RibbonDiffXml)
Définir les règles d’affichage des onglets du ruban
Exemple : exporter les définitions du ruban
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright