【Bonita BPM】如何使用Connector 寄 Email

tags: Bonita BPM

Common 基礎知識

1. 通常寄信的功能會寫在：Human Task/Service Task 的 Connectors out

2. 可以在Connectors List 的 Messaging - Email(SMTP) 找到
3. SMTP：Simple Mail Transfer Protocol 簡單郵件傳輸協定

Connection Information 連結資訊

1. SMTP Host：SMTP伺服器位置
2. SMTP Port：SMTP服務的Port，通常是465
3. Security：安全協定有關的設定，也可以自己加入條件
   • SSL(Secure Sockets Layer)：provide a way to encrypt a communication channel between two computers (e.g. your computer and our server)
   • STARTTLS：a way to take an existing insecure connection and upgrade it to a secure connection using SSL/TLS
4. Authentication
   • Username：寄件人的email帳號
   • Password：寄件人的email密碼
5. 上面1、2、4點，推薦使用Parameters，參考連結

Email addressee 收信人

1. From：寄件人的email帳號
2. To(發送給)：你所溝通的對象。但是除了這個人之外，還有可能是直接關聯的人，或是跟這件事有緊密聯繫的人，還可能是你上下游任務接口的人。
3. CC(Carbon Copy，副本)：「希望讓他知道這事，但是跟他並無直接責任關係」的人。通常對方會是你的直屬領導，或者是你To的人的直屬領導；也有可能是橫跨部門、但是不跟此任務直接相關的人，卻是希望他知道的對象。
4. BCC(Blind Carbon Copy，密件副本)：讓特定的他知道、但是又不讓郵件內相關人員知道
5. 如果要寄給多個人，請用 , 分開，e.g.email1, email2, email3

Email message 訊息

1. Subject 主旨
2. Message 內容
3. Attachments 附件
4. Use HTML：這是讓第2點的Message內容中，可以使用HTML的語法去產生Message

String BonitaURL = new StringBuffer("URL: <a href=\"")
    .append("http://")
    .append(host)
    .append(":")
    .append(port)
    .append("/bonita/portal/form/taskInstance/")
    .append(activityInstanceId)
    .append("\">here</a>")
    .toString();

return "Dear " + someone + ",<br/>" +
"您的任务「" + taskName +
"」已于" + submitTime +
"通知您，已超过预定的时间，请尽速，谢谢。<br/>" +
"Bonita网址：" + BonitaURL

5. 可以看到Example不只使用了<br/>，還使用了<a></a>
6. Bonita Portal URLs：官方文件

Adavanced 進階設定

• Character set：編碼設定，通常使用UTF-8
  • Charset=big5 (繁體中文)
  • Charset=GB (簡體中文)
  • Charset=utf-8 (萬用碼)

Reference 參考資料

1. SMTP：https://zh.wikipedia.org/wiki/简单邮件传输协议
2. SSL vs STARTTLS：https://www.fastmail.com/help/technical/ssltlsstarttls.html
3. To, CC, BCC：https://www.thenewslens.com/article/6984
4. Bonita Portal URLs：https://documentation.bonitasoft.com/bonita/7.6/bonita-bpm-portal-urls