Transmettre les paramètres vers une URL à l’aide du ruban
Notes
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émentUrl
, utilisez le paramètre PassParams.Utilisez un élément
<Url>
avec un élément<CrmParameter>
. Une fois utilisée à partir d’un élémentUrl
, 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).
Notes
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 que 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.
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’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
Notes
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 vues avec une URL
Définir les règles d’affichage des onglets du ruban
Exemple : Exporter les définitions du ruban
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).