Befehlsmakros command-macros
Befehlsmakros bieten benannte Tastaturbefehle für Befehlssätze.
Makros werden in separaten Makrodefinitionsdateien definiert, die an Bildkataloge oder den Standardkatalog angehängt werden können.
Makros können in einer Anfrage an einer beliebigen Stelle nach dem "?“ und an einer beliebigen Stelle in einem catalog::Modifier
aufgerufen werden. Makros können nur einen oder mehrere vollständige Bildbereitstellungsbefehle darstellen, daher müssen sie von "&"-Trennzeichen eingeschlossen werden (außer wenn am Anfang oder Ende der Modifikatorzeichenfolge steht).
Makroaufrufe werden durch ihre Ersatzzeichenfolgen frühzeitig während der Analyse ersetzt. Befehle in Makros überschreiben dieselben Befehle in der Anfrage, wenn sie vor dem Makroaufruf in der Anfrage auftreten. Dieser Fluss unterscheidet sich von catalog::Modifier
, bei dem Befehle in der Anfragezeichenfolge unabhängig von der Position in der Anfrage immer Befehle in der catalog::Modifier
überschreiben.
Makros können verschachtelt werden. Ein Makro kann jedoch nur aufgerufen werden, wenn es zum Zeitpunkt der Analyse der Makrodefinition bereits definiert ist. Dieser Fluss wird erreicht, indem entweder zuvor in derselben Makrodefinitionsdatei angezeigt wird oder indem die Definition für ein solches eingebettetes Makro in der standardmäßigen Makrodefinitionsdatei platziert wird.
Makros können nützlich sein, wenn dieselben Attribute auf verschiedene Bilder angewendet werden sollen.
http://server/cat/1345?wid=240&fmt=pdf&imageRes=300
http://server/cat/1435?wid=240&fmt=pdf&imageRes=300
http://server/cat/8243?wid=480&fmt=pdf&imageRes=300
Sie können ein Makro für die allgemeinen Attribute definieren:
view wid=240&fmt=pdf&imageRes=300
Das Makro würde wie folgt verwendet:
http://server/cat/1345?$view$
http://server/cat/1435?$view$
http://server/cat/8243?$view$&wid=480
Da wid=
für die dritte Anfrage anders ist, überschreiben Sie einfach den Wert nachdem das Makro aufgerufen wurde (die Angabe von wid=
vorher $view$
hat keine Auswirkung).