コマンドマクロ

コマンドマクロは、コマンドのセットの名前付きショートカットを提供します。 マクロは、個別のマクロ定義ファイルで定義され、画像カタログまたは既定のカタログに添付できます。

$ *name*$

name

マクロ名。

* * 名前では大文字と小文字が区別されません。また、ASCII文字、数字、「 — 」、「_」、「。」の組み合わせで構成することもできます。文字.

マクロは、リクエスト内で「?」より後の任意の場所、およびcatalog::Modifierフィールドまたはcatalog::PostModifierフィールド内の任意の場所で呼び出すことができます。 マクロは、1つ以上の完全な画像サービングコマンドのみを表し、他のコマンドとは「&」区切り文字で区切る必要があります。

マクロの呼び出しは、解析の初期段階で置換文字列に置き換えられます。 マクロ内のコマンドは、リクエストでマクロを呼び出す前に発生した場合、リクエスト内の同じコマンドを上書きします。 これはcatalog::Modifierとは異なります。要求文字列内のコマンドは、要求内の位置に関係なく、常にcatalog::Modifier文字列内のコマンドを上書きします。

コマンドマクロに引数値は指定できませんが、カスタム変数を使用して要求の値をマクロに渡すことができます。

マクロはネストでき、次の制限があります。マクロは、マクロ定義が解析された時点で定義済みの場合にのみ呼び出すことができます。同じマクロ定義ファイル内に既に存在する場合や、その埋め込みマクロの定義を既定のマクロ定義ファイルに配置する場合です。

マクロは、同じ属性を異なる画像に適用する場合に役立ちます。

http://server/cat/1345?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/1435?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/8243?wid=480&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

共通の属性に対してマクロを定義できます。

view wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

このマクロは次のように使用されます。

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

3番目のリクエストではwid=が異なるので、マクロが呼び出された後の値​**​を上書きします(wid=before $view$を指定しても効果はありません)。

関連項目

catalog::MacroFilecatalog::Modifier、マクロ定義 リファレンス

このページ