Command macros command-macros

De macro's van het bevel verstrekken genoemde kortere weg voor reeksen bevelen.

Macro's worden gedefinieerd in afzonderlijke macrodefinitiebestanden, die kunnen worden gekoppeld aan afbeeldingscatalogi of de standaardcatalogus.

Macro's kunnen overal in een verzoek na '?', en overal binnen een catalog::Modifier gebied worden aangehaald. Macro's kunnen slechts één of meerdere volledige bevelen vertegenwoordigen van de Dienstverlening van het Beeld, daarom moet het door (&) separators worden ingesloten (behalve wanneer aan het begin of het eind van het bepalingskoord).

Macro-aanroepen worden tijdens het parseren vervangen door hun vervangende tekenreeksen. Opdrachten binnen macro's overschrijven dezelfde opdrachten in de aanvraag als deze vóór de macroactivering in de aanvraag worden uitgevoerd. Deze flow is anders dan in catalog::Modifier , waar opdrachten in de aanvraagtekenreeks altijd opdrachten in de catalog::Modifier -tekenreeks overschrijven, ongeacht de positie in de aanvraag.

Macro's kunnen worden genest. Een macro kan echter alleen worden aangeroepen als deze al is gedefinieerd op het moment dat de macrodefinitie wordt geparseerd. Deze stroom wordt verwezenlijkt of door vroeger in het zelfde macrodefinitiedossier te verschijnen, of door de definitie voor zulk een ingebedde macro in het standaard macrodefinitiedossier te plaatsen.

Macro's kunnen handig zijn als dezelfde kenmerken op verschillende afbeeldingen moeten worden toegepast.

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

U kunt een macro definiëren voor de algemene kenmerken:

view wid=240&fmt=pdf&imageRes=300

De macro wordt als volgt gebruikt:

http://server/cat/1345?$view$

http://server/cat/1435?$view$

http://server/cat/8243?$view$&wid=480

Omdat wid= voor het derde verzoek verschillend is, treedt u eenvoudig de waarde met voeten nadat de macro wordt aangehaald (specificerend wid= alvorens $view$ geen effect heeft).