Extension:Page Forms/Creating query forms/fr

Les formulaires peuvent également être utilisés pour les requêtes, par opposition à l'ajout ou à l'édition de données. To do so, use the  page, which displays a form in a manner similar to , but with no associated 'target page'. Au lieu de cela, lorsque l'utilisateur soumet le formulaire en appuyant sur le bouton, il voit à quoi ressemble le modèle lorsqu'il est affiché avec les valeurs qu'il a entrées.

The template that the form uses should most likely contain one or more queries (using Semantic MediaWiki inline queries, Cargo queries, External Data queries, etc.) to query data using values that the user entered. You can see an example of a query form here.



Bouton Run query
By default, a button called "Run query" shows up at the bottom of forms if they are accessed via. You can change the location and text of this button, using the tag " " (or " ", etc.) within the form definition.

Voir la partie balise standard input (du manuel de Définition des formulaires) pour plus d'informations.



Formulaire de requête en haut
If you add the parameter " " to the  tag, the query input field will show up at the top of the results page, instead of the bottom.



Créer des liens vers les formulaires de requête
Une fois le formulaire de requête créé, vous pouvez le lier en utilisant une syntaxe semblable à :



Cependant, la solution préférée, parce qu'elle est plus facile et plus puissante, est d'utiliser la fonction d'analyse syntaxique. Un appel de base à cette fonction ressemblerait à :



Here's the complete syntax of :



Les paramètres sont presque identiques à ceux utilisés par ; pour une explication complète des paramètres, voir utiliser   (manuel Lier des formulaires).



Inclure des formulaires de requête
Vous pouvez également intégrer un formulaire de requête dans une autre page. Pour faire cela, ajoutez ce qui suit à une page où vous souhaitez que le formulaire de requête apparaisse :



Vous pouvez également intégrer plusieurs formulaires  sur la même page.



Précharger les données de la requête
Si les données de requête doivent être préchargées, le  doit suivre la convention :



Par exemple, comme ceci :



La construction " " pourrait causer un problème avec le balisage du wiki, et donc les crochets —  et   — peuvent être remplacées soit par   et , ou par   et  ).

Finally, make sure that the case in the query string matches the declaration in the form (e.g.,  must match   and   must match.

Par ailleurs, vous pouvez précharger les données en utilisant le paramètre  pour les champs de formulaire.



Afficher les résultats automatiquement
La technique ci-dessus mettra les valeurs prédéfinies dans le formulaire, mais l'utilisateur devra toujours appuyer sur le bouton pour voir les résultats de sa requête. If you want the results to be displayed automatically as well, you simply have to add  to the query string, like the following:



Comme précédemment, la façon recommandée de se lier à une telle page en interne se fait avec ; un tel appel ressemblerait à ceci :