摘要：在業(yè)務(wù)過程系統(tǒng)中集成郵件服務(wù)功能發(fā)送郵件收取郵件刪除郵件收到郵件時執(zhí)行操作安裝要求對于嵌入式過程引擎添加作為應(yīng)用程序依賴如果使用需要添加如下依賴到文件中對于共享過程引擎添加到服務(wù)器的目錄中比如還要保證包括下面的依賴
https://github.com/camunda/ca...
在業(yè)務(wù)過程系統(tǒng)中集成郵件服務(wù).
功能
發(fā)送郵件
收取郵件
刪除郵件
收到郵件時, 執(zhí)行操作
安裝
要求
Camunda BPM >= 7.50
Java 8
對于嵌入式過程引擎
添加 camunda-bpm-mail-core 作為應(yīng)用程序依賴. 如果使用Maven, 需要添加如下依賴到 pom.xml 文件中:
org.camunda.bpm.extension
camunda-bpm-mail-core
1.1.0
對于共享過程引擎
添加 camunda-bpm-mail-core-1.1.0.jar 到服務(wù)器的 lib 目錄中, 比如 apache-tomcat-8.0.24lib. 還要保證包括下面的依賴:
camunda-connect-core >= 1.0.3
JavaMail >= 1.5.5
slf4j-api >= 1.7.21
如果使用 Wildfly, 參考這個特殊說明
如何使用
該擴展構(gòu)建與 Connectors API 基礎(chǔ)上, 并且提供了一些用于連接到郵件服務(wù)器的連接器. 連接可以作為一個服務(wù)任務(wù)實現(xiàn)用于一個過程當(dāng)中, 并且通過ID進行引用. 然后使用 Camunda Modeler 來配置:
mail-send
查看 連接器用戶指南 以了解如何配置過程引擎來使用連接器
發(fā)送郵件
連接器ID: mail-send
| 輸入?yún)?shù) |
類型 |
是否要求 |
| from |
String |
NO(從配置讀取) |
| fromAlias |
String |
NO(從配置讀取) |
| to |
String |
Yes |
| cc |
String |
NO |
| bcc |
String |
No |
| subject |
String |
Yes |
| text |
String |
No |
| html |
String |
No |
| fileNames |
字符串列表 (文件路徑) |
Yes |
郵件內(nèi)容可以使HTML或者純文本, 并且可以通過模板生成(比如, 使用 FreeMarkeer 模板, 可以參考 這個例子)
收取郵件
| 輸入?yún)?shù) |
類型 |
是否要求 |
| folder |
String(比如: "Inbox" |
NO(從配置讀取) |
| download-attachements |
Boolean |
NO(從配置讀取) |
| 輸出參數(shù) |
類型 |
| mails |
Mail 類型列表 |
如果 download-attachements 為 true, 那么存儲附件到配置中指定的位置. 存儲附件的路徑可以通過 Mail 的 Attachment 中獲取
刪除郵件
| 輸入?yún)?shù) |
類型 |
是否要求 |
| folder |
String(例如: "Inbox") |
NO(從配置讀取) |
| mails |
Mail 列表 |
NO |
| messageIds |
字符串列表 |
NO |
| messageNumbers |
整數(shù)列表 |
NO |
mails, messageIds 或 messageNumbers 必須設(shè)置.
收取郵件后的自動化操作
該擴展使用 MailNotificationService 來對收取的郵件做響應(yīng)操作(例如, 啟動一個過程示例, 或關(guān)聯(lián)一個消息) 你可以注冊處理器/消費者, 當(dāng)收到一個新的郵件時, 來處理這個郵件. 下面給出一個Java的實際代碼例子:
MailNotificationService notificationService = new MailNotificationService(configuration);
notificationService.registerMailHandler(mail -> {
runtimeService.startProcessInstanceByKey("process",
Variables.createVariables().putValue("mail", mail));
});
notificationService.start();
// ...
notificationService.stop();
如果使用了一個郵件處理器, 并且在配置中啟用了 downloadAttachments, 那么在調(diào)用對應(yīng)的處理器的時候首先存儲附件. 另外, 還可以通過調(diào)用 Mail.downloadAttachments() 觸發(fā)手動下載.
如何配置
默認情況, 擴展會從CLASSPATH中查找一個名為mail-config.properties的配置文件. 你可以使用環(huán)境變量 MAIL_CONFIG 來修改查找路徑. 如果你想在CLASSPATH中查找一個文件, 使用classpath 前綴. (例如: classpath:/my-application.config)
下面是一個配置示例:
# send mails via SMTP
mail.transport.protocol=smtp
mail.smtp.host=smtp.gmail.com
mail.smtp.port=465
mail.smtp.auth=true
mail.smtp.ssl.enable=true
mail.smtp.socketFactory.port=465
mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
# poll mails via IMAPS
mail.store.protocol=imaps
mail.imaps.host=imap.gmail.com
mail.imaps.port=993
mail.imaps.timeout=10000
# additional config
mail.poll.folder=INBOX
[email protected]
mail.sender.alias=User Inc
mail.attachment.download=true
mail.attachment.path=attachments
# credentials
[email protected]
mail.password=PASSWORD
可以在 extension/core/configs 找到一些配置示例. 如果使用沒有配置的郵件供應(yīng)商, 你也可以添加自己的. 可以通過 集成測試 來校驗?zāi)愕呐渲?
例子
下面的例子展示了如何使用連接器和服務(wù).
披薩訂單
收取郵件
發(fā)送純文本郵件
刪除郵件
打印服務(wù)
使用 MailNotificationService
發(fā)送帶附件的郵件
任務(wù)分配郵件例子
常見問題
JavaMail 項目文檔
Oracle JavaMail 常見問題
關(guān)于使用 Gmail 發(fā)送郵件的問題
注意 javamail 的版本, 最好用比較新的
參考資料
把郵件服務(wù)集成到業(yè)務(wù)過程中
當(dāng)一個用戶任務(wù)被分配給具體的人, 或一個組時如何發(fā)送一個通知郵件
如何通過 Camunda 發(fā)送郵件
文章版權(quán)歸作者所有，未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址：http://systransis.cn/yun/70054.html
