以下範例中的 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-stream 到 Content-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 內文部分的文件號碼。 |