Ana içeriğe geç

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ç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ö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ç çizimindeki Mail 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.

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.