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.

.



Bouton Run query
Par défaut, le bouton apparaît au bas des formulaires si vous accédez par. Vous pouvez modifier l'emplacement et le texte de ce bouton, en utilisant la balise " " (ou " ", etc.) dans la définition du formulaire.

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



Formulaire de requête en haut
Si vous ajoutez le paramètre " " à la balise, le champ d'entrée de la requête apparaîtra en haut de la page de résultats, au lieu du bas.



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



Voici la syntaxe complète de  :



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

Enfin, assurez-vous que la casse dans la chaîne de la requête correspond bien à ce qui est déclaré dans le formulaire (par exemple,  doit correspondre à   et   doit correspondre à  ).

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. Si vous voulez aussi que les résultats soient affichés automatiquement, il suffit d'ajouter  à la chaîne de la requête, ainsi :



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 :