Configurer un formulaire pour accepter des paramètres de chaîne de requête personnalisés

Les paramètres de chaîne de requête personnalisés vous permettent de transmettre des valeurs attendues aux formulaires d’application pilotés par modèle lors de la validation des noms de paramètres et des types de données. Cet article explique comment configurer les paramètres autorisés afin de pouvoir définir en toute sécurité les valeurs par défaut lors de la création d’enregistrements.

Par défaut, les applications pilotées par modèle permettent qu’un ensemble spécifié de paramètres de chaîne de requête soit transmis à un formulaire. Vous utilisez ces paramètres pour définir les valeurs par défaut lorsque vous créez un enregistrement dans l’application. Chaque paramètre doit utiliser une convention d’affectation de noms standard qui inclut une référence au nom logique de la colonne. Pour plus d’informations, voir Définir les valeurs de colonne utilisant les paramètres transmis à un formulaire.

Dans vos applications, vous pouvez passer des paramètres de chaîne de requête personnalisés à un formulaire. Cet article fournit des informations sur la façon dont vous pouvez définir un ensemble de noms de paramètres et de types de données spécifiques que vous pouvez accepter pour un formulaire spécifique.

Définir les paramètres de chaîne de requête autorisés

Il existe deux façons de spécifier les paramètres de chaîne de requête que le formulaire accepte :

• Modifier les propriétés du formulaire avec l’éditeur classique
• Modifier un formulaire XML

Modifier les propriétés d’un formulaire

Lorsque vous modifiez un formulaire à l’aide de l’éditeur de formulaires moderne, comme décrit dans Ouvrir l’éditeur de formulaires de l’application pilotée par modèle, sélectionnez les points de suspension dans le menu, puis sélectionnez Passer en mode classique.

1. Sous l’onglet Accueil , dans le groupe Formulaire , sélectionnez Propriétés du formulaire.

   

2. Dans la boîte de dialogue Propriétés du formulaire, cliquez sur l’onglet Paramètres.

   

   Utilisez cet onglet pour modifier les noms et les types de données que le formulaire autorise.

Pour en savoir plus :

• Éditeur de formulaire classique
• Propriétés du formulaire d’application pilotée par modèle

Modifier FormXml

Dans le fichier customizations.xml de la solution exportée, juste après l’élément de pied de page, vous pouvez ajouter un élément <formparameters>. Dans l’élément <formparameters> , ajoutez <querystringparameter> des éléments pour spécifier les paramètres autorisés.

Le tableau suivant décrit les paramètres d’élément querystringparameter et nametype:

name

Chaque colonne de nom doit contenir au moins un caractère de soulignement (_), mais le nom du paramètre de chaîne de requête ne peut pas commencer par un trait de soulignement. Le nom ne peut pas non plus commencer par crm_. Utilisez le préfixe de personnalisation de l’éditeur de solution comme convention d’affectation de noms. N’utilisez pas pour le querystringparameter le même nom que celui d’une colonne de la table. Une valeur de nom valide querystringparameter est myISV_contact_specialvalue.

Type

Mettre en correspondance les valeurs de type de données avec les valeurs de paramètre afin que le paramètre ne passe pas de données non valides. Les types de données suivants sont valides :

• Boolean
• DateTime
• Double
• EntityType
• Integer
• Long
• PositiveInteger (Inclut « 0 » dans la plage de valeurs valides)
• SafeString
• UniqueId
• UnsignedInt

Voir aussi

Définir les valeurs des colonnes en utilisant les paramètres transmis à un formulaire
Ouvrir les formulaires et les vues avec une URL
Vue d’ensemble de l’éditeur de formulaire classique
Propriétés du formulaire de l’application pilotée par modèle