4.11. 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çinMail 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österiminde kullanılacak değerlerin belirlenmesi için süreç değişkenleri kullanılır. Bu kullanım iki farklı şekilde yönetilebilir:
- Süreç değişkenlerine;
MAIL_PROPERTY_URL_mailComponentId
formatında bir süreç değişkeni anahtarı eklenir.mailComponentId
; süreç çizimindekiMail Task
bileşeninin ID'si olmalıdır. Bu anahtarın değeri olarak; notification uygulamasının mail değişkenlerini çekeceği istek ucu tanımlanır. - Üstte belirtilen süreç değişkeni formatında bir tanımlama yapılmazsa; süreç oluşumu değişkenleri olduğu gibi notification uygulamasına aktarılır.
- Süreç değişkenlerine;
Uyarı
Süreç oluşum değişkenlerinin tamamının aktarılması durumunda; Notification uyulaması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.
Uyarı
Bu seçeneğin kullanılması durumunda; süreç çizimindeki Mail Task bileşeninin Metin (Text) alanı dışındaki alanların doldurulmasına gerek yoktur. Çünkü bu alanlar Notification uygulamasındaki mail template'inde tanımlıdır ve bu template'e göre mailler yönetilecektir.