Variabili personalizzate custom-variables
La porzione di query delle richieste e delle stringhe di vignettatura::Modifier può includere variabili definite dall'utente.
$ name = value
name
- Nome variabile. Può essere costituito da qualsiasi combinazione di caratteri alfanumerici, numerici e di sicurezza, escluso $
.
value
- Valore su cui deve essere impostata la variabile (stringa).
Le variabili sono definite in modo simile ad altri comandi server, utilizzando la sintassi precedente. Le variabili devono essere definite prima di poter essere referenziate. Le variabili definite in vignette::Modifier
possono essere referenziate nella richiesta dell'URL e viceversa.
value
deve avere un URL con codifica single-pass per una trasmissione HTTP sicura. È necessaria la doppia codifica se value
viene ritrasmesso tramite HTTP. Ciò si verifica quando value
viene sostituito in una richiesta esterna nidificata.Per fare riferimento alle variabili, incorpora il nome della variabile (racchiuso tra $
iniziale e finale) ovunque nei valori del comando. Ad esempio, tra =
dopo il nome del comando e il successivo &
o la fine della richiesta. Il server sostituisce ogni occorrenza di $ name$
con string
. Nessuna sostituzione eseguita per le occorrenze di $ name$
nei nomi dei comandi (prima del segno di uguale di un comando) e nella parte relativa al percorso della richiesta.
Le variabili personalizzate potrebbero non essere nidificate. Eventuali occorrenze di $ name$
in string
non vengono sostituite. Ad esempio, il frammento di richiesta $var2=apple&$var1=my$var2$tree&text=$var1$
viene risolto in text=my$var2$tree
.
$
non è un carattere riservato. È possibile che la richiesta non contenga alcun carattere riservato. src=my$texture$file.tif
, ad esempio, è un comando valido (supponendo che esista una voce di catalogo dei materiali o un file di trama denominato my$texture$file.tif
), mentre wid=$number$
non lo è, perché wid=
richiede un argomento numerico.