Partager via


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.

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 « &amp; ».

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