電子郵件端點可讓使用者透過傳送一或多個檔案(作為電子郵件附件)至指定的電子郵件帳戶來叫用服務。 電子郵件收件匣可作為附件的收集點。 此服務會監視收件匣並處理附件。 轉換的結果會轉送給端點中定義的使用者。
對於電子郵件端點,授權的使用者可以透過將檔案電子郵件傳送到適當帳戶來叫用程式。 結果將傳回給提交使用者(依預設)或端點設定中定義的使用者。
在設定電子郵件端點之前,請先建立POP3或IMAP電子郵件帳戶以供端點使用。 為每種轉換型別設定個別的帳戶。 例如,一個帳戶可設定為從傳入的檔案附件產生標準PDF檔案,而另一個帳戶則可設定為產生安全的PDF檔案。
每個電子郵件地址都必須僅對應至一個電子郵件端點。 您無法將多個電子郵件端點設定為單一電子郵件地址,即使其他電子郵件端點已停用。
所有電子郵件端點都設定有電子郵件收件匣的授權使用者名稱和密碼,這是叫用服務時必要的。 電子郵件帳戶受到其設定所在的郵件伺服器系統的保護。
如果您的使用者在檔案和轉換路徑名稱中傳送含有西歐語言字元的檔案,他們必須使用支援所需編碼型別(Latin1)的電子郵件應用程式 [ISO-8859-1],西歐 [Windows],或UTF-8)。 如需詳細資訊,請參閱 安裝和部署AEM表單 應用程式伺服器的檔案。
在設定電子郵件端點之前,請先設定電子郵件服務。 (請參閱 設定預設電子郵件端點設定.) 電子郵件服務的設定引數有兩個用途:
您可以設定POP3、IMAP或SMTP為電子郵件端點使用安全通訊端層(SSL)。
在電子郵件伺服器上,根據製造商的檔案為POP3、IMAP或SMTP啟用SSL。
從電子郵件伺服器匯出使用者端憑證。
使用keytool程式將使用者端憑證檔案匯入應用程式伺服器的Java虛擬機器器(JVM)憑證存放區。 此步驟的程式將取決於JVM和使用者端安裝路徑。
例如,如果您在Microsoft Windows Server® 2003上使用預設的OracleWebLogic Server安裝(含JDK 1.5.0),請在命令提示字元中輸入下列文字:
keytool -import -file client_certificate -alias myalias -keystore BEA_HOME\jdk150_04\jre\security\cacerts
出現提示時,輸入密碼(Java的預設密碼為 changeit
)。 您將收到一則訊息,指出憑證已成功匯入。
使用管理主控台將電子郵件端點新增至服務。
在管理控制檯中建立電子郵件端點。 設定端點設定時,請為內送訊息選取「POP3/IMAP SSL已啟用」,為外寄訊息選取「SMTP SSL已啟用」,並相應地變更連線埠屬性。
提示:如果您在使用SSL時遇到問題,請使用電子郵件使用者端(例如Microsoft Outlook)來檢查其是否可以使用SSL存取電子郵件伺服器。 如果電子郵件使用者端無法存取電子郵件伺服器,則此問題與您的憑證或電子郵件伺服器的設定有關。
您可以使用「服務管理」頁面來設定所有電子郵件端點的共同屬性,並提供所有電子郵件端點的預設值。
若要讓表單工作流程接收及處理使用者傳入的電子郵件訊息,您必須為「完成任務」服務建立電子郵件端點。 此電子郵件端點需要其他設定,如所述 建立Complete Task服務的電子郵件端點.
Cron運算式: Quartz用來排程輪詢輸入目錄的cron運算式。
重複間隔: 重複目錄輪詢的次數。 如果未在端點設定中指定此值,則預設的重複間隔為秒。 預設值為 10。此值不能小於10。
重複計數: 輪詢輸入目錄的次數。 如果未在端點設定中指定此值,則使用預設的重複計數。 值為–1表示無限掃描目錄。 預設值為–1。
工作開始時的延遲: 預設值(以秒為單位),代表作業開始掃描端點前的延遲時間。 預設值為 0。
批次大小: 每次掃描接收者為了最佳效能而處理的電子郵件數目。 值–1表示所有電子郵件。 預設值為 2。
非同步: 將呼叫型別識別為非同步或同步。 暫時和同步處理程式只能同步叫用。 預設值為非同步。
網域模式: 用來篩選傳入電子郵件的網域名稱模式。 例如,如果使用adobe.com,則只會處理來自adobe.com的電子郵件;會忽略來自其他網域的電子郵件。
檔案模式: 提供者接受的傳入檔案附件模式。 這包括具有特定副檔名(*.dat、*.xml)、特定名稱(資料)以及名稱和副檔名()中的複合運算式的檔案。[dD][aA]'連線埠')。 預設值為*。*。
成功工作的收件者: 一或多個電子郵件地址,用來傳送電子郵件以指出成功的工作。 依預設,成功的工作訊息一律會傳送給初始工作的傳送者。 最多可支援100個收件者。 若要關閉此設定,請將此欄位留空。
失敗工作的收件者: 用於傳送電子郵件以指出失敗工作的一或多個電子郵件地址。 依預設,失敗的工作訊息一律會傳送給傳送初始工作的傳送者。 最多可支援100個收件者。 若要關閉此設定,請將此欄位留空。
收件匣主機: 要掃描的電子郵件提供者的收件匣主機名稱或IP位址。
收件匣連線埠: 電子郵件提供者要掃描的收件匣連線埠號碼。 如果值為0,則會使用預設的IMAP或POP3連線埠。
收件匣通訊協定: 用於掃描收件匣之電子郵件端點的電子郵件通訊協定。 選項為IMAP或POP3。 收件匣主機郵件伺服器必須支援這些通訊協定。
收件匣逾時: 指定嘗試連線至收件匣時,端點在取消之前等待的時間長度。 如果在達到逾時值之前未取得連線,將不會輪詢收件匣。
收件匣使用者: 登入電子郵件帳戶所需的使用者名稱。 根據電子郵件伺服器和設定,此名稱可能只是電子郵件的使用者名稱部分,也可能是完整的電子郵件地址。
收件匣密碼: 收件匣使用者的密碼。
已啟用POP3/IMAP SSL: 選取時,會啟用SSL。
SMTP主機: 電子郵件提供者用來傳送結果和錯誤訊息的郵件伺服器的主機名稱。 例如, mail.example.com。
SMTP連線埠: 用來連線到郵件伺服器的連線埠。 預設值為 25。
SMTP使用者: 電子郵件提供者在傳送電子郵件以取得結果和錯誤時要使用的使用者帳戶。
SMTP密碼: SMTP帳戶的密碼。 有些郵件伺服器不需要SMTP密碼。
傳送來源: 用來傳送結果和錯誤的電子郵件通知的電子郵件地址(例如,user@company.com)。 如果您未指定「傳送來源」值,電子郵件伺服器會嘗試將「SMTP使用者」設定中指定的值與電子郵件伺服器上設定的預設網域結合,以決定電子郵件地址。 如果您的電子郵件伺服器沒有預設網域,而且您沒有指定[傳送來源]的值,則可能會發生錯誤。 若要確保電子郵件訊息具有正確的寄件者地址,請為「寄件者」設定指定值。
已啟用SMTP SSL: 選取時,會啟用SMTP上的SSL。
將原始電子郵件內文加入為附件: 根據預設,當您傳送電子郵件至Forms伺服器時,訊息的原始文字會包含在訊息的正文中。 若要改為將文字加入為附件,請選取此選項。
對結果電子郵件使用原始主旨列: 依預設,在傳送結果電子郵件訊息時,Forms伺服器會使用成功電子郵件主旨和錯誤電子郵件主旨設定中指定的值作為主旨行。 若要改用與傳送至伺服器之原始電子郵件相同的主旨列,請選取此選項。
成功電子郵件主旨: 傳送電子郵件至電子郵件端點以開始或繼續程式後,您會從AEM Forms伺服器收到傳回電子郵件訊息。 如果電子郵件成功,您會收到一封成功電子郵件。 如果您的電子郵件失敗,您會收到一封失敗電子郵件,通知它失敗的原因。 此設定可讓您指定為此端點傳送的成功電子郵件訊息的主旨行。
成功電子郵件內文: 可讓您指定為此端點傳送的成功電子郵件訊息的正文。
錯誤電子郵件主旨前置詞: 可讓您指定在此端點傳送的失敗電子郵件訊息主旨列開頭所使用的文字。
錯誤電子郵件主旨: 可讓您指定為此端點傳送的失敗電子郵件訊息的主旨行。 此文字會顯示在「錯誤電子郵件主旨前置詞」之後。
錯誤電子郵件內文: 可讓您指定為此端點傳送的失敗電子郵件訊息內文的第一行。
電子郵件摘要資訊: 每則成功或失敗訊息都包含一個區段,其中包含您傳送至Forms伺服器的原始電子郵件文字。 此設定會指定該區段上方顯示的文字。
在建立/更新此端點之前驗證收件匣: 選取此選項時,Forms伺服器會在建立端點之前,先檢查您的SMTP/POP3設定是否正確。 當您按一下[新增]時,會顯示一則訊息,說明收件匣帳戶是否有效。 如果未選取此選項,AEM Forms伺服器會在不驗證收件匣的情況下建立端點。
字元集編碼: 用於電子郵件的編碼格式。 預設值為UTF-8,日本以外的大多數使用者都會使用它。 日本環境中的使用者可以選擇ISO2022-JP。
失敗的電子郵件傳送資料夾: 指定當SMTP郵件伺服器無法運作時,要儲存結果的目錄。
使用下列設定來設定電子郵件端點。
名稱: 識別端點的必要設定。 請勿包含<字元,因為它會截斷Workspace中顯示的名稱。 如果您輸入URL作為端點的名稱,請確保其符合RFC1738中指定的語法規則。
說明: 端點的說明。 請勿包含<字元,因為它會截斷Workspace中顯示的說明。
Cron運算式: 如果電子郵件必須使用cron運算式排程,請輸入cron運算式。
重複計數: 電子郵件端點掃描資料夾或目錄的次數。 值–1表示無限掃描。 預設值為–1。
重複間隔: 接收者用來檢查內送郵件的掃描速率。
工作開始時的延遲: 排程器啟動後等待掃描的時間。
批次大小: 每次掃描接收者為了最佳效能而處理的電子郵件數目。 值–1表示所有電子郵件。 預設值為 2。
使用者名稱: 強制設定,也就是從電子郵件叫用目標服務時使用的使用者名稱。 預設值為SuperAdmin。
網域名稱: 強制設定,即使用者的網域。 預設值為DefaultDom。
網域模式: 指定提供者接受的傳入電子郵件的網域模式。 例如,如果使用adobe.com,則只會處理來自adobe.com的電子郵件;而會忽略來自其他網域的電子郵件。
檔案模式: 指定提供者接受的傳入檔案附件模式。 這包括具有特定副檔名(&ast;.dat、&ast;.xml)、特定名稱(資料)或名稱和副檔名中的複合運算式的檔案(&ast;)。[dD][aA]'連線埠')。
成功工作的收件者: 傳送訊息以指出成功工作的電子郵件地址。 依預設,成功的工作訊息一律會傳送給寄件者。 如果您輸入寄件者,則會將電子郵件結果傳送給寄件者。 最多可支援100個收件者。 使用以逗號(,)分隔的電子郵件地址指定其他收件者。
若要關閉此設定,請將設定保留空白。 某些情況下,您會想要觸發程式,而不想要結果的電子郵件通知。
失敗工作的收件者: 傳送訊息以指出失敗工作的電子郵件地址。 依預設,失敗的工作訊息一律會傳送給寄件者。 如果您輸入寄件者,則會將電子郵件結果傳送給寄件者。 最多可支援100個收件者。 使用以逗號(,)分隔的電子郵件地址指定其他收件者。
若要關閉此設定,請將設定保留空白。 某些情況下,您會想要觸發程式,而不想要結果的電子郵件通知。
收件匣主機: 要掃描的電子郵件提供者的收件匣主機名稱或IP位址。
收件匣連線埠: 電子郵件伺服器使用的連線埠。 POP3的預設值為110,IMAP的預設值為143。 如果啟用SSL,POP3的預設值為995,IMAP的預設值為993。
收件匣通訊協定: 用於掃描收件匣之電子郵件端點的電子郵件通訊協定。 值為IMAP或POP3。 收件匣主機郵件伺服器必須支援這些通訊協定。
收件匣逾時: 電子郵件提供者等候收件匣回應的逾時時間(以秒為單位)。
收件匣使用者: 登入電子郵件帳戶所需的使用者名稱。 根據電子郵件伺服器和設定,此值可能只是電子郵件的使用者名稱部分,也可能是完整的電子郵件地址。
收件匣密碼: 收件匣使用者的密碼。
已啟用POP3/IMAP SSL: 選取此設定以強制電子郵件提供者使用SSL掃描收件匣。 確定您的郵件伺服器支援SSL。
SMTP主機: 電子郵件提供者用來傳送結果和錯誤訊息的郵件伺服器的主機名稱。
SMTP連線埠: SMTP連線埠的預設值為25。
SMTP使用者: 電子郵件提供者傳送結果和錯誤的電子郵件通知時要使用的使用者帳戶。
SMTP密碼: SMTP帳戶的密碼。 有些郵件伺服器不需要SMTP密碼。
傳送來源: 用來傳送結果和錯誤的電子郵件通知的電子郵件地址(例如,user@company.com)。 如果您未指定「傳送來源」值,電子郵件伺服器會嘗試將「SMTP使用者」設定中指定的值與電子郵件伺服器上設定的預設網域結合,以決定電子郵件地址。 如果您的電子郵件伺服器沒有預設網域,而且您沒有指定[傳送來源]的值,則可能會發生錯誤。 若要確保電子郵件訊息具有正確的寄件者地址,請為「寄件者」設定指定值。
已啟用SMTP SSL: 選取此設定以強制電子郵件提供者使用SSL掃描收件匣。 確定您的郵件伺服器支援SSL。
失敗的電子郵件傳送資料夾: 指定當SMTP郵件伺服器無法運作時,要儲存結果的目錄。
非同步: 設定為同步時,會處理所有輸入檔案並傳回單一回應。 設為非同步時,系統會針對已處理的每個檔案傳送回應。
例如,會為接受單一Word檔案並以PDF檔案傳回該檔案的服務建立電子郵件端點。 可以將電子郵件傳送到包含多(3)個Word檔案的端點收件匣。 處理全部三份檔案後,如果端點設定為同步,則會傳送單一回應電子郵件並附上全部三份檔案。 如果端點非同步,在每個Word檔案轉換為PDF後都會傳送回應電子郵件。 結果是三封電子郵件,每封都包含單一PDF附件。
預設值為非同步。
將原始電子郵件內文加入為附件: 根據預設,當您傳送電子郵件至Forms伺服器時,訊息的原始文字會包含在訊息的正文中。 若要改為將文字加入為附件,請選取此選項。
對結果電子郵件使用原始主旨列: 依預設,在傳送結果電子郵件訊息時,Forms伺服器會使用成功電子郵件主旨和錯誤電子郵件主旨設定中指定的值作為主旨行。 若要改用與傳送至伺服器之原始電子郵件相同的主旨列,請選取此選項。
成功電子郵件主旨: 傳送電子郵件至電子郵件端點以開始或繼續程式後,您會從AEM Forms伺服器收到傳回電子郵件訊息。 如果電子郵件成功,您會收到一封成功電子郵件。 如果您的電子郵件失敗,您會收到一封失敗電子郵件,通知它失敗的原因。 此設定可讓您指定為此端點傳送的成功電子郵件訊息的主旨行。
成功電子郵件內文: 可讓您指定為此端點傳送的成功電子郵件訊息的正文。
錯誤電子郵件主旨前置詞: 可讓您指定在此端點傳送的失敗電子郵件訊息主旨列開頭所使用的文字。
錯誤電子郵件主旨: 可讓您指定為此端點傳送的失敗電子郵件訊息的主旨行。 此文字會顯示在「錯誤電子郵件主旨前置詞」之後。
錯誤電子郵件內文: 可讓您指定為此端點傳送的失敗電子郵件訊息內文的第一行。
電子郵件摘要資訊: 每則成功或失敗訊息都包含一個區段,其中包含您傳送至Forms伺服器的原始電子郵件文字。 此設定會指定該區段上方顯示的文字。
在建立/更新此端點之前驗證收件匣: 選取此選項時,Forms伺服器會在建立端點之前,先檢查您的SMTP/POP3設定是否正確。 當您按一下[新增]時,會顯示一則訊息,說明收件匣帳戶是否有效。 如果未選取此選項,AEM Forms伺服器會在不驗證收件匣的情況下建立端點。
作業名稱: 此設定是強制性的。 可指派給電子郵件端點的操作清單。 您在此選取的作業會決定在「輸入引數對應」和「輸出引數對應」區段中顯示哪些欄位。
輸入引數對應: 用來設定處理服務和作業所需的輸入。 兩種輸入型別為常值輸入和變數:
常值: 電子郵件使用在顯示的欄位中輸入的值。
變數: 您可以對應來自電子郵件主旨、內文、標題或寄件者電子郵件地址的字串。 若要這麼做,請使用下列其中一個關鍵字: %SUBJECT%、%BODY%、%HEADER%或%SENDER%。 例如,如果您使用%SUBJECT%,則會使用電子郵件主旨內容作為輸入引數。 若要擷取附件,請輸入電子郵件端點可用來選取附加檔案的檔案模式。 例如,輸入&ast;.pdf會選取任何副檔名為.pdf的附加檔案。 輸入&ast;會選取任何附加的檔案。 輸入example.pdf會選取任何名為example.pdf的附加檔案。
輸出引數對應: 用於設定服務和操作的輸出。 輸出引數對應值中的下列字元會在附件檔案名稱中展開:
%F 代表來源檔案的檔案名稱(不包括副檔名)。
%E 代表來源檔案的副檔名。
任何反斜線()的出現位置都會取代為%%。
注意:如果服務要求訊息包含多個檔案附件,您便無法將%F和%E引數用於端點的輸出引數對應屬性。 如果服務回應傳回多個檔案附件,則無法為多個附件指定相同的檔案名稱。 如果您不遵循這些建議,叫用的服務會建立傳回檔案的名稱,而且這些名稱是不可預測的。
可使用下列值:
單一物件: 電子郵件提供者沒有來源資料夾目的地;結果會以附件傳回。 模式為Result/%F.ps,並傳回Result%%sourcefilename.ps作為檔案名稱附件。
清單: 模式為Result/%F/,並傳回Result%%sourcefilename%%file1作為檔案名稱附件。
對應: 模式為Result/%F/,來源目的地為Result%%sourcefilename%%file1和Result%%sourcefilename%%file2。 如果對應包含多個物件,且模式為Result/%F.ps,則回應檔案附件為Result%%sourcefilename1.ps (輸出1)和Result%%sourcefilename2.ps (輸出2)。
若要讓表單工作流程接收及處理使用者傳入的電子郵件訊息,您必須為「完成任務」服務建立電子郵件端點。
*.*
在相鄰的方塊中。 這會將所有來自傳入郵件訊息的附件傳送至對應變數,以進行完成工作程式。%BODY%
在相鄰的方塊中。%SENDER%
在相鄰的方塊中。 這會將寄件者地址對應到[完成任務]處理資料。results
. 這會導致「完成任務」或「啟動處理」傳回結果字串。