Variabili personalizzate

La parte query delle richieste e delle stringhe di vignettatura::Modificatore può includere variabili definite dall'utente.

$ *[!DNL name]*= *[!DNL value]*

name Nome variabile. Può essere costituita da qualsiasi combinazione di caratteri alfa, cifra e sicuri, ad eccezione di '$.'

value Valore a cui impostare la variabile (stringa).

Le variabili sono definite in modo simile ad altri comandi del server, utilizzando la sintassi indicata sopra. Le variabili devono essere definite prima di poter fare riferimento a esse. Nella richiesta URL è possibile fare riferimento alle variabili definite in vignette::Modifier e viceversa.

NOTA

value devono essere codificati URL a passaggio singolo per una trasmissione HTTP sicura. La doppia codifica è necessaria se value viene ritrasmessa via HTTP. Questo è il caso in cui value viene sostituito in una richiesta esterna nidificata.

Alle variabili viene fatto riferimento incorporando il nome della variabile (racchiuso da un valore iniziale e finale $) ovunque nei valori dei comandi. Ad esempio, tra '=' che segue il nome del comando e il successivo '&' o la fine della richiesta. Il server sostituisce ogni occorrenza di $ name$ con string. Non si verificheranno sostituzioni nelle occorrenze di $ name$ nei nomi dei comandi (prima del segno uguale di un comando) e nella parte del percorso della richiesta.

Le variabili personalizzate non possono essere nidificate. Tutte le 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; può verificarsi altrimenti nella richiesta. Ad esempio, src=my$texture$file.tif è un comando valido (supponendo che esista una voce di catalogo di materiali o un file di texture denominato my$texture$file.tif), mentre wid=$number$ non lo è, perché wid= richiede un argomento numerico.

In questa pagina