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