Substitutionsvariablen

Substitutionsvariablen werden verwendet, um Werte aus der Anforderungs-URL in in Bildkatalogen gespeicherte Vorlagen zu übertragen. Variablen können auch verwendet werden, um denselben Wert an verschiedene Stellen in einer komplexen Anforderung zu verteilen.

$ * *= *varvalue*

var

Variablenname.

value

Wert, auf den die Variable festgelegt werden soll (Zeichenfolge).

Variablendefinitionen und -verweise können im Bereich der Abfrage der Anforderung, in catalog::Modifier und in catalog::PostModifier auftreten.

Variablen werden wie oben definiert, ähnlich wie andere IS-Befehle. der führende '$' identifiziert den Befehl als Variablendefinition. Variablen müssen definiert werden, bevor sie referenziert werden.

Bei dem Variablennamen var wird nicht zwischen Groß- und Kleinschreibung unterschieden und es kann sich um eine beliebige Kombination aus ASCII-Buchstaben, -Zahlen, -Zeichen, -Zeichen, -Zeichen und -Zeichen handeln.

HINWEIS

value muss für eine sichere HTTP-Übertragung mit einem Pass URL-kodiert sein. Dublette-Codierung ist erforderlich, wenn value über HTTP erneut übertragen wird. Dies ist der Fall, wenn value in eine verschachtelte ausländische Anforderung oder in das href-Attribut eines SVG <image>-Elements ersetzt wird.

Variablenreferenzen bestehen aus dem Variablennamen, der durch das vorangestellte und nachfolgende '$' ($var$) getrennt wird. Verweise können an einer beliebigen Stelle im Wertebereich von IS-Befehlen auftreten (d. h. zwischen dem '=' nach dem Befehlsnamen und dem nachfolgenden '&' oder dem Ende der Anforderung). Benutzerdefinierte Variablen können nicht auf die Befehle layer= und effect= angewendet werden. Im selben Befehlswert sind mehrere Variablen zulässig. Der Server ersetzt jedes Vorkommen von $ *var*$ durch value.

Variablenverweise sind möglicherweise nicht verschachtelt. Vorkommnisse von $ *var*$ innerhalb von value werden nicht ersetzt.

Beispielsweise das Anforderungsfragment:

$var2=apple&$var1=my$var2$tree&text=$var1$

löst Folgendes auf:

text=my$var2$tree

HINWEIS

'$' ist kein reserviertes Zeichen; es kann andernfalls in der Anforderung auftreten. Beispiel: src=my$image$file.tif ist ein gültiger Befehl (vorausgesetzt, dass ein Katalogeintrag oder eine Bilddatei mit dem Namen my$image$file.tif vorhanden ist), wid=$number$ nicht, da wid ein numerisches Argument erfordert.

Variablenverarbeitung in verschachtelten Anforderungen

$ * *$ Variablenverweise können an einer beliebigen Stelle innerhalb der geschweiften Klammern einer verschachtelten Image Serving- oder Image Rendering-Anforderung auftreten, auch links neben dem "?". Trennen des Pfads von der Abfrage. Der Server ersetzt diese Referenzen durch Werte (entweder aus der URL oder aus catalog::Modifier des Hauptbildkatalogs), bevor die verschachtelte Anforderung weiter analysiert und verarbeitet wird.

Darüber hinaus werden alle $ *var*=-Definitionen aus der URL oder catalog::Modifier an alle verschachtelten Image Serving- und Image Rendering-Anforderungen weitergeleitet. Dadurch wird sichergestellt, dass alle Variablendefinitionen unabhängig von der Verschachtelungsebene für alle Vorlagen verfügbar sind.

Unabhängig von der Verschachtelungsstufe muss nur eine HTTP-Kodierung mit einem Durchgang auf Variablenwerte angewendet werden, die an einer beliebigen Stelle in verschachtelten Image Rendering- oder Image Serving-Anforderungen oder den zugehörigen catalog::Modifier-Zeichenfolgen ersetzt werden sollen.

Variablenverarbeitung in eingebetteten ausländischen Anforderungen

$ * *$ Varreferenzen, die an einer beliebigen Stelle innerhalb der geschweiften Klammern einer eingebetteten Fremdanforderung auftreten, werden durch übereinstimmende Variablendefinitionswerte ersetzt. Dadurch können eingebettete ausländische Anforderungen in eine Vorlage in einem Bildkatalog eingefügt werden.

Variablenwerte, die in fremde Anfragen ersetzt werden sollen, müssen in der Regel mit Dubletten kodiert werden, da keine Neukodierung angewendet wird, bevor der Server versucht, die finale ausländische URL zu übertragen.

Variablenverarbeitung in SVG-Dateien

$ *In SVG-Dateien können *$ Variablenverweise in Attributwerten und in <text> Zeichenfolgen auftreten. Image Serving ersetzt diese durch die entsprechenden $ *var*=-Definitionen, die auf der Anforderungsverschachtelungsebene, auf der die SVG-Datei angegeben ist, bekannt sind.

HINWEIS

Jeder Variablenwert, der in einen href-Attributwert ersetzt werden soll, muss URL-kodiert für die Dublette sein. alle anderen müssen einzeln kodiert sein.

Vordefinierte Pfadvariable

Das im Anforderungspfad angegebene object wird der vordefinierten Variablen *$object* zugewiesen. ' $ *object*$' kann an einer beliebigen Stelle in der Anforderung platziert werden, in der Vorlage, auf die die Anforderung verweist, oder in einer verschachtelten/eingebetteten Anforderung, in der ein solches Objekt zulässig ist, einschließlich des Werts src= und mask= sowie des Pfads einer verschachtelten/eingebetteten Anforderung.

Beispielsweise wird in der folgenden Anforderung das im Pfad angegebene Bild als Quelle einer Ebene in einer verschachtelten Anforderung wiederverwendet:

/is/image/a/b?…&layer=3&src=is{…&src=$object$}&…

Dies entspricht

/is/image/a/b?…&layer=3&src=is{…&src=a/b}&…

Die Definition von *$object* kann überschrieben werden, indem $ *object*= explizit mit dem gewünschten Wert angegeben wird.

Die vordefinierte Pfadvariable wird häufig zusammen mit template= verwendet.

Standard

Keine. Nur definierte Variablen werden vom Server ersetzt (mit Ausnahme der vordefinierten Pfadvariablen $object, die immer ersetzt werden). Vorkommnisse von $ *var*$ bleiben literal, wenn *var*nicht mit einer vorhandenen Variablendefinition übereinstimmen kann.

Beispiele

Siehe "Beispiel A"in Vorlagen.

Verwandte Themen

Vorlagen, template=

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free