Send E-Mail aksiyonu, Xpoda'da form üzerinden belirli kişi veya kişilere e-posta gönderilmesini sağlar. Bu işlem, bilgilendirme, onay alma ya da dosya paylaşımı gibi pek çok senaryoda kullanılabilir.
Send E-mail Aksiyonu Özellikleri:
1. Description (Açıklama): Eylemin ne amaçla kullanıldığını belirten açıklama yazılır. Description alanı, aksiyonu oluşturan kişinin kendisine veya diğer geliştiricilere bırakacağı bir not olarak düşünülebilir.
2. Heading(Başlık): Form Action olarak eklendiğinde aksiyon listesinde buraya yazılan isim belirir.Tasarlanan Send E-mail aksiyonu farklı aksiyonlar içerisinde tetiklenmek istendiğinde seçim alanında gözükecek metni temsil eder.
3.File format: Ekte gönderilecek dosyanın formatı belirlenir. (PDF, XLS vb.)
4.Design File: Mail'e eklenecek form çıktısı var ise çıktının dosya adı veya SQL sorgusu bu alana yazılır.
5.To Whom (Kime): E-posta gönderilecek kişilerin mail adresi direkt yazılır veya SQL sorgusu ile dinamik olarak yazılır.
Örnek:
SELECT Email FROM Staff WITH (NOLOCK) WHERE Role = 'Manager'
Örnek:
SELECT 'emily.waterson@examplemail.com'
6.Information (CC): Mailin bilgilendirme amaçlı gönderileceği ek e-posta adresleri girilir. Bu alana mail adresleri doğrudan yazılabilir veya SQL sorgusu ile belirlenebilir.
7.Subject: Gönderilecek e-postanın konu başlığını belirlemek için kullanılır. Mail konusu bu alana direkt yazılabilir veya SQL sorgusu ile belirlenebilir.
8. ‘Sender mail – 1(*Mail) 2(*Host) 3(*Password) 4(Display Name) 5(UserName) 6(SSL) 7(Port)’: Maili gönderecek kişinin mail adresinin bilgisi yazılır.
| Bu alanın doldurulması zorunlu değildir. Doldurulmazsa sistem parametrelerindeki varsayılan e-posta ayarları kullanılır. Aksiyona özel farklı bir mail adresinden gönderim yapmak istenirse bu alanlar doldurulmalıdır. İlgili dokümana erişmek için tıklayınız. |
Örneğin; aksiyona özel gmail bilgileri ile mail göndermek istiyoruz. Aşağıdaki örnek ekran görüntüsünde olduğu gibi gmail smtp bilgilerini kaydettiğimizde sadece bu aksiyona özel gmail ile mail gönderimi yapılabilir. ( Kullandığınız mail sağlayıcısına göre Host, SSL, Port bilgileri değişebilir. )
Gönderen Mail Bilgileri:
1 - Mail Adresi: Mailin gönderileceği e-posta adresidir.
2 - Host: SMTP sunucu adresi girilir.
3 – Password: Gönderen e-posta hesabının şifresi girilir.
4 – Display Name: Alıcıların göreceği gönderen adıdır.
5 - Kullanıcı Adı: Genellikle mail adresiyle aynıdır, bazı sunucular ayrı kullanıcı adı isteyebilir.
6 - SSL: Güvenli bağlantı için TRUE ya da FALSE olarak belirtilir.
7 - Port: SMTP sunucunun kullandığı port numarası.
9.BCC (Gizli Alıcı): Bir e-postayı başka kişilere görünmeden göndermeyi sağlar, böylece BCC’ye eklenen kişiler, diğer alıcılar tarafından görülmez. Bu alana mail adresleri doğrudan yazılabilir veya SQL sorgusu ile belirlenebilir.
10. Files to be added (Dosya Eki Gönderimi): Mail, dosya eki kontrolü ile forma ekli dosyaları göndermenizi sağlayan bir bölümdür. Dosyalar sorgu tarafından bulunur.
|
Files to be added alanını kullanabilmek için Formda ’Add File’ bileşeni olmak zorundadır.
|
Bu alana aşağıdaki sorgu yazılabilir.
SELECT FileName, FileContent, RecordGuid FROM XPODA_FILES WHERE FormID = $PFormID$
11.Content: Mailin içeriği yazılır. $P kullanılarak formdaki değerler dinamik olarak eklenebilir.Örneğin: $PAdi ifadesiyle formdaki ad alanı mail içine alınabilir.
12.HTML File: Mail gövdesi için tasarlanmış bir HTML dosyası varsa dosyanın adı yazılır. Dosya konumu, programın çalışma dizinindeki Xpoda Client dosyalarınızdaki xpoda.HTML ile aynı klasörde olmalıdır.
| HTML tasarımı değiştirmek ve maile özel HTML kullanmak için kurulum dosyalarınızda bulunan xpoda.HTML'i istediğiniz gibi değiştirebilirsiniz. |
Linkli Mail ve Onay Süreci:
Send Mail aksiyonu sayesinde, kullanıcıları mail içinden bir forma yönlendirebilirsiniz. Bunu sağlamak için aşağıdaki alanlar kullanılır:
13.Confirmation Form: Mail ile onay isteniyorsa onay linkine tıklanarak açılacak formun adı seçilir.
14.Confirmation ID Field: Mail üzerinden gelen bağlantıdaki kaydın hangi alanla eşleştirileceğini belirten formdaki alandır.Genellikle formda kayıtları ayırt etmek için kullanılan benzersiz (unique) bir alan olmalıdır.(Örneğin UserTableID veya formun sistemdeki primary key alanı)
15.Confirmation User / Confirm Password:Giriş yapacak kullanıcı bilgileri girilir. (Adı ve Şifresi)
16. Link Text:E-posta içeriğinde görünecek yönlendirme bağlantısının metnidir. Kullanıcı, bu metne tıklayarak ilgili forma yönlendirilir. Örnek: "Formu Görüntülemek için Tıklayın" gibi dikkat çekici ve açıklayıcı bir ifade girilmesi önerilir.
17. Send to Approval:Bu alan YES olarak işaretlenirse, e-postaya bir onay bağlantısı eklenir. Kullanıcı, bağlantıya tıklayarak belirlenen formda işlem gerçekleştirebilir. Bu alan aktif değilse, e-posta üzerinden form yönlendirmesi çalışmaz.
| Link Gönderimi için Send to Approval ’YES’ olmalıdır. |
18) Info Mail CC:Eğer bu alan “NO” olarak işaretlenirse, aksiyonun içindeki “Information (CC)” alanına yazılan kişilere e-posta gönderilmez. Sadece “To Whom (Kime)” alanındaki adreslere e-posta gider.Bu alanın “YES” yapılması, CC kısmına yazılmış adreslerin de e-posta almasını sağlar.
19)Not Information Message: Eğer bu alan NO olarak seçilirse, gönderilen e-postada bilgilendirme mesajı kullanıcıya gösterilmez. Özellikle sistemsel veya arka planda çalışan süreçlerde, kullanıcının gereksiz bilgilendirme almasının önüne geçmek için tercih edilir. YES olarak ayarlanırsa, işlem sonrası kullanıcıya "Bilgi başarıyla gönderildi" gibi bir mesaj gösterilir.
20. Run Condition (Çalıştırma Koşulu):Aksiyonun belirli bir koşula göre çalışması istendiği durumlarda kullanılır.Sql sorgusu 1 dönerse aksiyon çalışır,0 dönerse çalışmayacaktır.
21. Request Confirmation (Onay İste): Bu özellik aktif hale getirilirse, kullanıcı aksiyonu çalıştırmadan önce bir onay mesajı ile karşılaşır. Kullanıcı onay verirse işlem devam eder, aksi halde iptal edilir.
Send E-mail Örnekleri:
Örnek 1:
Forma eklenmiş olan Send E-mail butonuna tıklayalım . Aşağıdaki numaraları takip ederek aksiyon tanımlayalım. To Whom alanına, maili göndermek istediğiniz kullanıcının mail adresini yazalım Subject alanına metin olarak mailin konusunu girelim.
Content alanına mailin içeriğinde yazmak istediğimiz metni yazalım. Fotoğraf eklemek için ise E-mail içerik butonuna tıklayalım. Açılan Mail Editörüne gelinerek aşağıdaki resimde görüldüğü gibi Resim ekle butonuna (10) tıklayalım.
| Bu aksiyon kullanımında formdaki tüm veriler servise yönlendirilir. Form içerisinde yer alan Resim alanına büyük bir resim eklenilirse servise yönlendirmesi uzun zaman alabilir. Bu doğrultuda send mail aksiyonu kullanımında gecikmeler meydana gelecektir. |
Açılan Pop-up ekranından İnternet adresi alanına $P ile resim alanının formdaki ismi yazılmalıdır.
Ardından mail içerisinde gideceği resim boyutlandırması width - height alanından girilir ve ekle butonuna tıklanır.
Aksiyonumuzu kaydedelim, Formun kendisini de kaydedip run tuşu ile Client ekranına gidelim. Kayıtlı verilerden herhangi birini çağıralım ve Send E-mail butonuna tıklayalım.
Mail gönderimin tamamlandığına dair bir bildiri alacağız. Bu bildiri mailin iletildiğini ifade eder. İletilen mailin görünümü aşağıdaki gibidir.
Örnek 2: (Linkli mail gönderimi)
Öncelikle Confirmation Form alanından link ile gidilmesi istenilen formun adını seçelim, daha sonra Confirmation ID Field alanını dolduralım, Giriş yapacak kullanıcının ismini ve parolasını girelim, Link Text alanına linkin yazısının bulunacağı açıklayıcı ifademizi yazalım, Send to Approval alanını ‘YES’ yapalım.
| Eğer linked list seçilmez ise; Confirmation ID Field alanına yazılan kısımda UserTableID bilgisi iletilir. Kaydedildikten sonrası için mail gönderme işlemi yapılabilir veya forma kayıt çağırılarak mail gönderme işlemi yapılabilir. |
Eğer linked list seçilir ise; formdaki liste sorgusu içinde UserTableID, ProjectID, FormTypeID alanları mutlaka eklenmeli yoksa mail gönderme işlemi gerçekleşmez.
Gerekli bilgiler girildikten sonra aksiyonu kaydedelim, formu da kaydedelim run tuşu ile Client ekranına gidelim. İlgili kaydı çağırıp Send E-mail butonuna tıklayalım.
Gelen mailin görünümü aşağıdaki gibidir.