Transmettre les paramètres à une URL à l’aide du ruban

Note

Cette rubrique concerne les commandes classiques.

Il existe une nouvelle façon de définir les commandes. Voir Vue d’ensemble du commandement moderne (Version préliminaire)

Les actions de ruban sont définies dans l’élément <Actions> d’un élément <CommandDefinition>. Il existe plusieurs manières de passer les informations contextuelles des applications pilotées par modèle comme paramètres de chaîne de requête à une URL à l’aide du ruban.

• Utilisez un élément <Url>. Dans l’élément Url, utilisez le paramètre PassParams.
• Utilisez un élément <Url> avec un élément <CrmParameter>. Une fois utilisée à partir d’un élément Url, la valeur du paramètre de nom doit être définie.
• Utilisez un élément <JavaScriptFunction> avec un élément <CrmParameter>.

Utiliser le paramètre PassParams pour définir des valeurs dynamiques

La transmission de paramètres à l’URL cible à l’aide du paramètre 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 du paramètre PassParams. Le tableau ci-dessous indique les paramètres qui sont transmis.

Paramètre	Nom	Description
typename	Nom de table	Nom de la table. Pour les tables personnalisées, cela inclut le préfixe de personnalisation, par exemple, new_tablenam.
type	Code de type d’entité	Entier qui identifie de manière unique la table dans l’organisation actuelle. Note : les valeurs Entity Type Code sont déterminées par l’ordre dans lequel une table est créée dans une organisation. Les Entity Type Codes pour les tables 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).

Note

Nous vous suggérons d’utiliser le nom de table au lieu du code de type, car le code de type d’entité peut être différent entre les installations d’applications pilotées par modèle.

Exemple

L’exemple suivant montre l’URL sans paramètres :

https://myserver/mypage.aspx  

Cet exemple montre les paramètres inclus lorsque le contrôle du ruban est présenté pour la table 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 le GUID pour l’enregistrement de compte est DBD5DBFB-0666-DC11-A5D9-0003FF9CE217 :

https://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’URL. Cela peut être utile si vous souhaitez ouvrir un enregistrement ou une vue spécifique en suivant les instructions de la rubrique Ouvrir des formulaires, vues, dialogues, et rapports avec une URL.

Note

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’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. Informations complémentaires : Propriété HttpRequest.QueryString

Note

Si la cible de votre URL est une ressource Web, elle peut accepter uniquement les paramètres identifiés dans la rubrique Passer des paramètres à des 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 en savoir plus : Exemple : Passer des valeurs multiples à une ressource Web via le paramètre de données

Voir aussi

Personnaliser les commandes et le ruban
Ouvrir les formulaires et les vues avec une URL
Définir les règles d′affichage des onglets du ruban
Exemple : Exporter les définitions du ruban