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 een willekeurige combinatie van alpha-, 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 in vignette::Modifier worden gedefinieerd, kunnen in de URL-aanvraag worden vermeld, en omgekeerd.

Er wordt verwezen naar variabelen door de naam van de variabele (ingesloten door een regelafstand en een navolgend $ ) ergens in de opdrachtwaarden in te sluiten. Bijvoorbeeld tussen de = die volgt op de opdrachtnaam en de daaropvolgende & of het einde van de aanvraag. De server vervangt elk exemplaar van $ name$ door string . Er vinden geen substituties plaats op plaatsen waar $ name$ voorkomt in opdrachtnamen (vóór het gelijkteken van een opdracht) en in het padgedeelte van de aanvraag.

Aangepaste variabelen kunnen niet worden genest. Elke keer dat $ name$ in string voorkomt, wordt niet vervangen. Het aanvraagfragment $var2=apple&$var1=my$var2$tree&text=$var1$ wordt bijvoorbeeld omgezet in text=my$var2$tree .

$ is geen gereserveerd teken; dit kan zich anders voordoen in de aanvraag. src=my$texture$file.tif is bijvoorbeeld een geldige opdracht (ervan uitgaande dat een item in een materiaalcatalogus of een structuurbestand met de naam my$texture$file.tif bestaat), terwijl wid=$number$ dat niet doet, omdat wid= een numeriek argument vereist.