Ana içeriğe geç

4.13. Mail Task Yönetimi#

BPMN'de bulunan Mail Task bileşeni, süreç adımında mail yollanması işlemini sağlar.

BPMN uygulaması; Mail Task işleminin yönetimi için iki seçenek sunmaktadır.

  • İlk seçenek; Flowable'in sunduğu Mail Task bileşenin, kendi alanlarıyla (from, to, subject, html, vb.) olduğu gibi kullanılmasıdır. Bu kullanım için Mail Task bileşeni alanlarının doğru bir formatta tanımlanması gerekir. Bu seçenekte; spring konfigürasyonunda tanımlanan mail sunucu bilgileri kullanılır.

  • İkinci seçenek ise; mail gönderimi işleminin Notification uygulaması üzerinden yapılmasıdır. Bu seçeneğin avantajları; mail gönderme işlemi yükünün uygulama tarafından üstlenilmemesi ve Notification uygulamasında tanımlanmış hazır mail template'lerinin, gerekirse runtime'da şablon değişikliği yapılması esnekliği ile kullanılabilmesidir. Bu seçeneğin dezavantajı ise; Notification uygulamasına bağımlılığın olmasıdır. Bu kullanım için aşağıdaki adımlar izlenmelidir:

  • BPMN_NOTIFICATION_ENABLED parametresi true olmalıdır (Süreçlerde Mail Task bileşenlerinde Notification template'i kullanılmayacağından emin olunduğu durumda bu parametre false olmalı ki; template kontrolü mekanizması devre dışı kalsın ve bu kontrol yapılmasın).

  • Süreç tanımında, Mail Task bileşeninin Metin (Text) alanına "HVL_NOTIFICATION_TEMPLATE_CODE:" prefixi ile kullanılmak istenen mail template'inin kodu yazılmalıdır (Örnek kullanım; HVL_NOTIFICATION_TEMPLATE_CODE:BPMN_TEMPLATE).
  • Mail gösterimi, dili ve gönderim yapılacak mail adreslerinin belirlenmesi için süreç değişkenleri kullanılır. Süreç değişkenlerinde;
    • "locale" anahtarı ile mail dili değeri,
    • "addressList" anahtarı ile mailin atılacağı adresler listesi,
    • mail template'inin ihtiyaç duyduğu diğer anahtar-obje değerler bulunmalıdır.

Uyarı

Süreç oluşum değişkenlerinin; Notification uygulamasında mailin istenen formatta doğru bir şekilde hazırlanması için, mail template'inde ihtiyaç duyulan anahtar değerlerin tamamının süreç değişkenlerine eklenmesi gerektiği unutulmamalıdır.