Vervangende variabelen
Vervangende variabelen worden gebruikt om waarden van verzoekURL naar samenstellende malplaatjes over te brengen die in beeldcatalogi worden opgeslagen. U kunt ook variabelen gebruiken om dezelfde waarde over te brengen naar verschillende plaatsen in een complexe aanvraag.
$ *var*= *value*
De veranderlijke definities en de verwijzingen kunnen in het vraaggedeelte van het verzoek voorkomen, in catalog::Modifier, en in catalog::PostModifier.
Variabelen worden als hierboven gedefinieerd, net als andere IS-opdrachten. De regelafstand '$' geeft de opdracht aan als een variabele definitie. Variabelen moeten worden gedefinieerd voordat er naar wordt verwezen.
De variabelenaam var is niet hoofdlettergevoelig en kan bestaan uit een combinatie van ASCII-letters, -cijfers, '-', '_' en '.'.
OPMERKINGvalue 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 in een geneste buitenlandse aanvraag of in het href-kenmerk van een SVG <image> element.Variabele-verwijzingen bestaan uit de variabelenaam gescheiden door het regelafstand en het nakomen '$' ($)var$). Verwijzingen kunnen overal in het waardegedeelte van om het even welke bevelen van IS voorkomen (namelijk tussen '=' na de bevelnaam en verdere '&' of het eind van het verzoek). Aangepaste variabelen kunnen niet worden toegepast op de layer= en effect= opdrachten. Meerdere variabelen zijn toegestaan in dezelfde opdrachtwaarde. De server vervangt elke instantie van $ *var*$ with value.
Variabeleverwijzingen mogen niet genest zijn. Alle exemplaren van $ *var*$ binnen value niet vervangen.
Het aanvraagfragment:
$var2=apple&$var1=my$var2$tree&text=$var1$
lost op aan:
text=my$var2$tree
OPMERKINGsrc=my$image$file.tif is een geldige opdracht (ervan uitgaande dat een item of afbeeldingsbestand met de naam van een catalogus my$image$file.tif bestaat), while wid=$number$ is niet, omdat wid vereist een numeriek argument.Variabele verwerking in geneste aanvragen
$ *var*$ verwijzingen kunnen overal binnen de krullende steunen van een genestelde Beelddienst of Beeld teruggeven verzoek voorkomen, met inbegrip van links van '?? het pad scheiden van de query. De server vervangt deze verwijzingen door waarden (van de URL of van catalog::Modifier (van de hoofdafbeeldingscatalogus) voordat de geneste aanvraag verder wordt geparseerd en verwerkt.
Bovendien $ *var*= definities van de URL of catalog::Modifier worden doorgestuurd naar alle aanvragen voor geneste beeldservers en het renderen van afbeeldingen. Dit zorgt ervoor dat alle veranderlijke definities aan alle malplaatjes, ongeacht het nestelen niveau beschikbaar zijn.
Ongeacht het nestniveau moet alleen HTTP-codering met één controle worden toegepast op variabelewaarden die overal in geneste aanvragen voor het renderen van afbeeldingen of de bijbehorende verzoeken moeten worden vervangen catalog::Modifier tekenreeksen.
Variabele verwerking in ingesloten externe verzoeken
$ *var*$ verwijzingen die ergens binnen de accolades van een ingesloten extern verzoek voorkomen, worden vervangen door overeenkomstige waarden voor de definitie van variabelen. Hierdoor kunnen ingesloten externe verzoeken in een sjabloon in een afbeeldingscatalogus worden geplaatst.
De veranderlijke waarden die in buitenlandse verzoeken moeten worden vervangen moeten typisch dubbel-gecodeerd zijn, aangezien geen hercodering wordt toegepast alvorens de server probeert om definitieve buitenlandse url over te brengen.
Variabele verwerking in SVG-bestanden
$ *var*$ verwijzingen kunnen voorkomen in SVG dossiers in attributenwaarden en in <text> tekenreeksen. In afbeeldingsserver worden deze vervangen door de overeenkomende $ *var*= definities die bekend zijn op het nestingniveau van het verzoek waarop het SVG-bestand wordt opgegeven.
OPMERKINGhref kenmerkwaarde moet dubbel-URL-gecodeerd zijn; alle anderen moeten afzonderlijk worden gecodeerd.Vooraf gedefinieerde padvariabele
De object opgegeven in het aanvraagpad wordt toegewezen aan de vooraf gedefinieerde variabele *$object*. ' $ *object*$' kan ergens in de aanvraag worden geplaatst, in de sjabloon waarnaar door de aanvraag wordt verwezen, of in een geneste/ingesloten aanvraag waar een dergelijk object is toegestaan, inclusief de waarde van src= en mask=en het pad van een geneste/ingesloten aanvraag.
In het volgende verzoek wordt bijvoorbeeld de afbeelding die in het pad is opgegeven, opnieuw gebruikt als bron van een laag in een geneste aanvraag:
/is/image/a/b?…&layer=3&src=is{…&src=$object$}&…
Dit is gelijk aan
/is/image/a/b?…&layer=3&src=is{…&src=a/b}&…
De definitie van *$object* kan worden overschreven door expliciet $ *object*= met de gewenste waarde.
De vooraf gedefinieerde padvariabele wordt doorgaans gebruikt in combinatie met template=.