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

轉換通道範例

以下範例中的 CONVERSIONS 對映與轉換規則集會將傳送到假定通道 tcp_docuprint 的 GIF、JPEG 與 BITMAP 檔案自動轉換成 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

輸出 MIME Content-Type 參數值,對應於 OUT-PARAMETER-NAME-n

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

輸出 MIME Content-Disposition 參數值,對應於 OUT-DPARAMETER-NAME-n

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 內文部分的文件號碼。