Accueil > Sparnatural form > requête JSON du formulaire
Cette page a été traduite automatiquement à partir de la page d’origine en anglais - le 19/11/2026
Référence JSON de requête Sparnatural-form
Une requête de formulaire est un petit objet JSON décrivant un ensemble de valeurs à placer dans les champs d’un formulaire Sparnatural. C’est ce avec quoi le formulaire est pré-rempli, et la même structure est acceptée en trois endroits :
- les
valuesd’une entrée d’un fichier de requêtes prédéfinies (généralementquery-remp.json) ; - le paramètre
queryd’URL ; - la méthode
loadQuery()de l’élément<sparnatural-form>.
Pas la même chose que l’attribut
queryde<sparnatural-form>. Cet attribut pointe vers la requête Sparnatural complète que le formulaire exécute, au format de requête v12. La requête de formulaire décrite ici est la petite structure plate utilisée pour remplir le formulaire.
Structure
Une clé par champ de formulaire, sans imbrication. Celle-ci pré-remplit deux champs du formulaire Productions de SAPA :
{
"Activity_Type_22": {
"label": "production",
"criteria": {
"rdfTerm": {
"type": "uri",
"value": "http://vocab.performing-arts.ch/muwgo"
}
}
},
"Saison": {
"label": "2020",
"criteria": { "search": "2020" }
}
}
Chaque clé est une variable de formulaire, telle que déclarée dans le variable d’une liaison de la spécification du formulaire. Les clés sont mises en correspondance de manière insensible à la casse (une correspondance exacte l’emporte), et une clé ne correspondant à aucun champ de formulaire est ignorée avec un avertissement dans la console.
Chaque valeur est l’une des trois choses suivantes :
| Valeur | Effet |
|---|---|
| un critère étiqueté | remplit le champ avec une valeur |
| un tableau de critères étiquetés | remplit un champ multi-valeurs avec plusieurs valeurs |
| un marqueur d’option | coche l’option “Inconnu” / “N’importe quelle valeur connue” du champ |
Le chargement d’une requête de formulaire réinitialise toujours tout le formulaire d’abord, donc l’état résultant est exactement ce que décrit l’objet : les champs non mentionnés sont laissés vides.
Critère étiqueté
Une seule valeur est une paire { label, criteria } :
{ "label": "2020", "criteria": { "search": "2020" } }
label: le texte affiché dans le champ. Il est utilisé tel quel : dans une requête de formulaire, les libellés ne sont pas résolus automatiquement, contrairement aux paramètres d’URL par variable. Fournissez toujours un libellé, sinon le champ montre une valeur vide.criteria: la valeur elle-même. Sa forme dépend du widget configuré pour le champ.
Il s’agit exactement du critère étiqueté de la requête Sparnatural sous-jacente, les mêmes objets qui vont dans le tableau criterias d’une ligne de requête. Plutôt que de les répéter ici, voir la référence du format de requête v12 :
- Critères étiquetés - la paire
{ label, criteria } - Valeurs des critères - la forme de
criteriapour chaque widget :rdfTerm(URI, ou littéral avec une langue ou un type de données),start/stoppour les dates,min/maxpour les nombres,boolean,search, etcoordType/coordinatespour les cartes
Plusieurs valeurs dans un champ
Certains champs acceptent plus d’une valeur. Passez un tableau de critères étiquetés :
{
"TypeActor": [
{
"label": "Group",
"criteria": {
"rdfTerm": {
"type": "uri",
"value": "http://www.cidoc-crm.org/cidoc-crm/E74_Group"
}
}
},
{
"label": "Legal Body",
"criteria": {
"rdfTerm": {
"type": "uri",
"value": "http://www.cidoc-crm.org/cidoc-crm/E40_Legal_Body"
}
}
}
]
}
Si le champ n’accepte qu’une seule valeur, les valeurs supplémentaires sont ignorées.
Marqueurs d’option : “Inconnu” et “N’importe quelle valeur connue”
Au lieu d’une valeur, un champ peut être défini sur l’une de ses deux options :
{ "Saison": { "notExists": true } }
| Marqueur | Effet |
|---|---|
{ "notExists": true } |
Coche l’option “Inconnu” du champ (FILTER NOT EXISTS en SPARQL). |
{ "anyValue": true } |
Coche l’option “N’importe quelle valeur connue” du champ. |
notExists l’emporte si les deux sont définis. Les équivalents URL sont les mots-clés UNKNOWN et ANY.
Ces options n’existent que sur les champs dont la branche est déclarée optional dans la requête que le formulaire exécute. Si un champ n’a pas une telle option, le marqueur est ignoré et un avertissement est enregistré dans la console.
Exemple complet
{
"Activity_Type_22": {
"label": "production",
"criteria": {
"rdfTerm": {
"type": "uri",
"value": "http://vocab.performing-arts.ch/muwgo"
}
}
},
"TypeActor": [
{
"label": "Group",
"criteria": {
"rdfTerm": {
"type": "uri",
"value": "http://www.cidoc-crm.org/cidoc-crm/E74_Group"
}
}
},
{
"label": "Legal Body",
"criteria": {
"rdfTerm": {
"type": "uri",
"value": "http://www.cidoc-crm.org/cidoc-crm/E40_Legal_Body"
}
}
}
],
"Title": {
"label": "Carmen",
"criteria": { "search": "Carmen" }
},
"Saison": { "notExists": true }
}
Quatre champs du formulaire Productions de SAPA : une URI unique, deux valeurs dans un champ multi-valeurs, une recherche en texte libre, et une option “Inconnu”.
Voir aussi
<sparnatural-form-queries>- où cette structure est utilisée commevalues- Pré-remplissage avec des paramètres d’URL ou une requête JSON - où elle est utilisée comme paramètre
query, et l’alternative plus simple par variable - Format de requête JSON v12 - la référence des critères, et le format de l’attribut
query - Référence JSON de configuration de formulaire - où les variables de formulaire sont déclarées