摘要：在業務過程系統中集成郵件服務功能發送郵件收取郵件刪除郵件收到郵件時執行操作安裝要求對于嵌入式過程引擎添加作為應用程序依賴如果使用需要添加如下依賴到文件中對于共享過程引擎添加到服務器的目錄中比如還要保證包括下面的依賴
https://github.com/camunda/ca...
在業務過程系統中集成郵件服務.
功能
發送郵件
收取郵件
刪除郵件
收到郵件時, 執行操作
安裝
要求
Camunda BPM >= 7.50
Java 8
對于嵌入式過程引擎
添加 camunda-bpm-mail-core 作為應用程序依賴. 如果使用Maven, 需要添加如下依賴到 pom.xml 文件中:
org.camunda.bpm.extension
camunda-bpm-mail-core
1.1.0
對于共享過程引擎
添加 camunda-bpm-mail-core-1.1.0.jar 到服務器的 lib 目錄中, 比如 apache-tomcat-8.0.24lib. 還要保證包括下面的依賴:
camunda-connect-core >= 1.0.3
JavaMail >= 1.5.5
slf4j-api >= 1.7.21
如果使用 Wildfly, 參考這個特殊說明
如何使用
該擴展構建與 Connectors API 基礎上, 并且提供了一些用于連接到郵件服務器的連接器. 連接可以作為一個服務任務實現用于一個過程當中, 并且通過ID進行引用. 然后使用 Camunda Modeler 來配置:
mail-send
查看 連接器用戶指南 以了解如何配置過程引擎來使用連接器
發送郵件
連接器ID: mail-send
| 輸入參數 |
類型 |
是否要求 |
| 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 |
郵件內容可以使HTML或者純文本, 并且可以通過模板生成(比如, 使用 FreeMarkeer 模板, 可以參考 這個例子)
收取郵件
| 輸入參數 |
類型 |
是否要求 |
| folder |
String(比如: "Inbox" |
NO(從配置讀取) |
| download-attachements |
Boolean |
NO(從配置讀取) |
如果 download-attachements 為 true, 那么存儲附件到配置中指定的位置. 存儲附件的路徑可以通過 Mail 的 Attachment 中獲取
刪除郵件
| 輸入參數 |
類型 |
是否要求 |
| folder |
String(例如: "Inbox") |
NO(從配置讀取) |
| mails |
Mail 列表 |
NO |
| messageIds |
字符串列表 |
NO |
| messageNumbers |
整數列表 |
NO |
mails, messageIds 或 messageNumbers 必須設置.
收取郵件后的自動化操作
該擴展使用 MailNotificationService 來對收取的郵件做響應操作(例如, 啟動一個過程示例, 或關聯一個消息) 你可以注冊處理器/消費者, 當收到一個新的郵件時, 來處理這個郵件. 下面給出一個Java的實際代碼例子:
MailNotificationService notificationService = new MailNotificationService(configuration);
notificationService.registerMailHandler(mail -> {
runtimeService.startProcessInstanceByKey("process",
Variables.createVariables().putValue("mail", mail));
});
notificationService.start();
// ...
notificationService.stop();
如果使用了一個郵件處理器, 并且在配置中啟用了 downloadAttachments, 那么在調用對應的處理器的時候首先存儲附件. 另外, 還可以通過調用 Mail.downloadAttachments() 觸發手動下載.
如何配置
默認情況, 擴展會從CLASSPATH中查找一個名為mail-config.properties的配置文件. 你可以使用環境變量 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
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 找到一些配置示例. 如果使用沒有配置的郵件供應商, 你也可以添加自己的. 可以通過 集成測試 來校驗你的配置.
例子
下面的例子展示了如何使用連接器和服務.
披薩訂單
收取郵件
發送純文本郵件
刪除郵件
打印服務
使用 MailNotificationService
發送帶附件的郵件
任務分配郵件例子
常見問題
JavaMail 項目文檔
Oracle JavaMail 常見問題
關于使用 Gmail 發送郵件的問題
注意 javamail 的版本, 最好用比較新的
參考資料
把郵件服務集成到業務過程中
當一個用戶任務被分配給具體的人, 或一個組時如何發送一個通知郵件
如何通過 Camunda 發送郵件
文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。
轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/70054.html
