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

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 Dynamics 365 for Customer Engagement 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 l’attribut PassParams.

• Utilisez un élément <Url> avec un élément <CrmParameter>. 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> avec un élément <CrmParameter>.

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. Note : 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).

Hinweis

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 Dynamics 365 for Customer Engagement.

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 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 :

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

Hinweis

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

Hinweis

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 plus d'informations : 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

Hinweis

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é).