Aangepaste variabelen custom-variables
Het querygedeelte van aanvragen en vignet::Modifier-tekenreeksen kunnen door de gebruiker gedefinieerde variabelen bevatten.
$ name = value
name
- Naam variabele. Kan bestaan uit elke combinatie van alfa-, cijfer- en veilige tekens, met uitzondering van $
.
value
- Waarde waarop de variabele moet worden ingesteld (tekenreeks).
Variabelen worden op dezelfde manier gedefinieerd als andere serveropdrachten, met behulp van de bovenstaande syntaxis. Variabelen moeten worden gedefinieerd voordat naar deze variabelen kan worden verwezen. Variabelen die worden gedefinieerd in vignette::Modifier
kan in het URL verzoek worden van verwijzingen voorzien, en omgekeerd.
value
moet URL-gecodeerd voor één controle zijn voor veilige HTTP-verzending. Dubbele codering is vereist als value
wordt opnieuw verzonden via HTTP. Dit is het geval wanneer value
wordt vervangen door een geneste externe aanvraag.Er wordt verwezen naar variabelen door de naam van de variabele in te sluiten (ingesloten door een regelafstand en een volgteken) $
) ergens in opdrachtwaarden. Bijvoorbeeld tussen =
na de opdrachtnaam en de volgende &
of het einde van het verzoek. De server vervangt elk exemplaar van $ name$
with string
. Er vinden geen substituties plaats op elk moment van $ name$
in bevelnamen (vóór het gelijke teken van een bevel), en in het weggedeelte van het verzoek.
Aangepaste variabelen kunnen niet worden genest. Alle exemplaren van $ name$
binnen string
niet vervangen. Het aanvraagfragment $var2=apple&$var1=my$var2$tree&text=$var1$
lost aan text=my$var2$tree
.
$
geen gereserveerd teken is; het kan anders in het verzoek voorkomen. Bijvoorbeeld: src=my$texture$file.tif
is een geldige opdracht (er wordt van uitgegaan dat een item of structuurbestand met de naam van een materiaalcatalogus my$texture$file.tif
bestaat), while wid=$number$
is niet, omdat wid=
vereist een numeriek argument.