Sun Java System Messaging Server 6 2005Q4 管理指南

转换通道示例

以下示例中所示的 CONVERSIONS 映射和一组转换规则使 GIF、JPEG 和 BITMAP 文件被发送到假设的通道 tcp_docuprint 中,并被自动转换为 PostScript。其中几个转换使用假设的 /usr/bin/ps-converter.sh 进行该转换。还包含一个将 WordPerfect 5.1 文件转换为 Microsoft Word 文件的附加规则。


CONVERSIONS  

    IN-CHAN=*;OUT-CHAN=tcp_docuprint;CONVERT    Yes

out-chan=ims-ms; in-type=application; in-subtype=wordperfect5.1; 
  out-type=application; out-subtype=msword; out-mode=block; 
  command="/bin/doc-convert -in=wp -out=msw   ’INPUT_FILE’  ’OUTPUT_FILE’"

out-chan=tcp_docuprint; in-type=image; in-subtype=gif; 
  out-type=application; out-subtype=postscript; out-mode=text; 
  command="/bin/ps-convert -in=gif -out=ps   ’INPUT_FILE’  ’OUTPUT_FILE’"

out-chan=tcp_docuprint; in-type=image; in-subtype=jpeg; 
  out-type=application; out-subtype=postscript; out-mode=text; 
  command="/bin/ps-convert -in=jpeg -out=ps  ’INPUT_FILE’  ’OUTPUT_FILE’"

out-chan=tcp_docuprint; in-type=image; in-subtype=bitmap; 
  out-type=application; out-subtype=postscript; out-mode=text; 
  command="/bin/ps-convert -in=bmp -out=ps   ’INPUT_FILE’  ’OUTPUT_FILE’"

转换参数如下所示:

表 13–6 转换参数

参数 

说明 

限定参数(指定邮件被转换之前必须匹配的参数

OUT-CHAN,OUT-CHANNEL

执行转换所需匹配的输出通道(允许使用通配符)。仅当邮件被发送到指定的通道时,才执行此条目指定的转换。 

IN-CHAN,IN-CHANNEL

执行转换所需匹配的输入通道(允许使用通配符)。仅当邮件来自指定的通道时,才执行此条目指定的转换。 

IN-TYPE

执行转换所需匹配的输入 MIME 类型(允许使用通配符)。仅当此字段与主体部分的 MIME 类型匹配时,才执行指定的转换。 

IN-SUBTYPE

执行转换所需匹配的输入 MIME 子类型(允许使用通配符)。仅当此字段与主体部分的 MIME 子类型匹配时,才执行此条目指定的转换。 

IN-PARAMETER-NAME-n

必须与转换匹配的输入 MIME Content-Type 参数名称;n= 0、1、2.... 此参数可以与 IN-PARAMETER-VALUE-n 配合使用,以通过其所包含的名称和值明确标识参数。

IN-PARAMETER-VALUE-n

必须与转换匹配的相应 IN-PARAMETER-NAME 的输入 MIME Content-Type 参数值。仅当此字段与主体部分的 Content-Type 参数列表中的相应参数匹配时,才执行此条目指定的转换。允许使用通配符。

IN-PARAMETER-DEFAULT-n

未提供参数时,输入 MIME Content-Type 参数的默认值。主体部分中未指定此类参数时,该值被用作 IN-PARAMETER-VALUE- n 测试的默认值。

IN-DISPOSITION

要与转换匹配的输入 MIME Content-Disposition

IN-DPARAMETER-NAME-n

必须与转换匹配的输入 MIME Content-Disposition 参数名称;n= 0、1、2.... 此参数可以与 IN-DPARAMETER-VALUE-n 配合使用,以通过其所包含的名称和值明确标识参数。

IN-DPARAMETER-VALUE-n

必须与转换匹配的相应 IN-DPARAMETER-NAME 的输入 MIME Content-Disposition 参数值。仅当此字段与主体部分的 Content-Disposition: 参数列表中的相应参数匹配时,才执行此条目指定的转换。允许使用通配符。

IN-DPARAMETER-DEFAULT-n

未提供参数时,输入 MIME Content-Disposition 参数的默认值。主体部分中未指定此类参数时,该值被用作 IN-DPARAMETER-VALUE-n 测试的默认值。

IN-DESCRIPTION

要与转换匹配的输入 MIME Content-Description

IN-SUBJECT

来自封闭 MESSAGE/RFC822 部分的输入 Subject

TAG

输入标记,由邮件列表 CONVERSION_TAG 参数所设置。

输出参数(指定主体部分的转换后输出设置。

OUT-TYPE

输出 MIME 类型(如果与输入类型不同)。 

OUT-SUBTYPE

输出 MIME 子类型(如果与输入子类型不同)。 

OUT-PARAMETER-NAME-n

输出 MIME Content-Type 参数名称;n= 0、1、2...

OUT-PARAMETER-VALUE-n

OUT-PARAMETER-NAME-n 相对应的输出 MIME Content-Type 参数值。

PARAMETER-COPY-n

要从输入主体部分的 Content-Type 参数列表复制到输出主体部分的 Content-Type: 参数列表的 Content-Type 参数列表; n=0、1、2... 使用与要复制的 MIME 参数相同的名称,这与 IN-PARAMETER-NAME- n 子句相匹配。

OUT-DISPOSITION

输出 MIME Content-Disposition(如果与输入 MIME Content-Disposition 不同)。

OUT-DPARAMETER-NAME-n

输出 MIME Content-Disposition 参数名称;n=0、1、2...

OUT-DPARAMETER-VALUE-n

OUT-DPARAMETER-NAME-n 相对应的输出 MIME Content-Disposition 参数值。

DPARAMETER-COPY-n

要从输入主体部分的 Content-Disposition: 参数列表复制到输出主体部分的 Content-Disposition: 参数列表的 Content-Disposition: 参数列表;n=0、1、2... 将要复制的 MIME 参数的名称当作参数,这与 IN-PARAMETER-NAME-n 子句相匹配。可以在该参数中使用通配符。特别是,参数 * 表示复制所有原始 Content-Disposition: 参数。

OUT-DESCRIPTION

输出 MIME Content-Description(如果与输入 MIME Content-Description 不同)。

OUT-MODE

读取和存储被转换文件所使用的模式。应该为 BLOCK(二进制文件和可执行文件)或 TEXT

OUT-ENCODING

重新组合邮件时要对被转换文件应用的编码。 

操作参数(指定要对邮件部分执行的操作。

COMMAND

执行转换所需执行的命令。执行转换所需执行的命令。此参数是必需的;如果未指定命令,将忽略条目。使用 / 指定路径,而不是 \。例如:command="D:/tmp/mybat.bat"

DELETE

0 或 1。如果设置该标志,将删除邮件部分。(如果被删除的是邮件中唯一的部分,将使用一个空文本部分进行替换。) 

RELABEL

RELABEL=1 将把 MIME 标签重新标记为输出参数指定的内容。Relabel=0 不进行任何操作。通常在标记错误的部分中进行重新标记(例如:从 Content-type: application/octet-streamContent-type: application/msword),以便用户可以“双击”打开一个部分,而无需将该部分保存到文件中,然后再用程序打开。

SERVICE-COMMAND

SERVICE-COMMAND=command 将执行站点提供的步骤,这些步骤将对整个 MIME 邮件(MIME 标题和内容主体部分)进行。此外,与其他 CHARSET-CONVERSION 操作或转换通道操作不同,service-command 需要自己进行 MIME 分解、解码、重新编码和重新组合。请注意,此标志将使条目在 conversion 通道处理期间被忽略,而在字符集转换处理期间执行 SERVICE-COMMAND 条目。使用 / 指定路径,而不是 \。例如:command="D:/tmp/mybat.bat"

信息传递参数(用于在通道和站点提供的程序之间传递信息。

DPARAMETER-SYMBOL-n

将在其中存储 Content-disposition 参数值(如果存在)的环境变量;n= 0、1、2... 在执行站点提供的程序之前,将从 Content-Disposition: 参数列表中按顺序提取每个 DPARAMETER-SYMBOL-n(n=0 是第一个参数,n=2 是第二个参数,等等),并将其置于指定的环境变量中。

PARAMETER-SYMBOL-n

将在其中存储 Content-Type 参数值(如果存在)的环境变量;n= 0、1、2... 在执行站点提供的程序之前,将从 Content-Type: 参数列表中按顺序提取每个 PARAMETER-SYMBOL-n(n=0 是第一个参数,n=2 是第二个参数,等等),并将其置于名称相同的环境变量中。将 MIME 参数要转换成的变量的名称作为参数,这与 IN-PARAMETER-NAME-n 子句相匹配。

MESSAGE-HEADER-FILE

将邮件的全部或部分原始标题写入由环境变量 MESSAGE_HEADERS 指定的文件,或者不写入邮件的原始标题。如果设置为 1,将把直接封闭的主体部分的原始标题写入由环境变量 MESSAGE_HEADERS 指定的文件。如果设置为 2,则将邮件的原始标题作为一个整体(最外层的邮件标题)写入该文件。

ORIGINAL-HEADER-FILE

0 或 1。如果设置为 1,将把封闭的 MESSAGE/RFC822 部分(不只是主体部分)的原始标题写入由环境变量 ORIGINAL_HEADERS 表示的文件

OVERRIDE-HEADER-FILE

0 或 1。如果设置为 1,conversion 通道将从环境变量 OUTPUT_HEADERS 中读取 MIME 标题行,这将覆盖封闭的 MIME 部分中的原始标题行。

OVERRIDE-OPTION-FILE

如果 OVERRIDE-OPTION-FILE=1,conversion 通道将从 OUTPUT_OPTIONS 环境变量中读取选项。

PART-NUMBER

以点分隔的整数:a. b. c... MIME 主体部分的编号。