"HTMLMailProcess" Elemanı

HTMLMailProcess Elemanı; İşlem Yönetim Çatısı yapısı ile kullanılmak üzere tasarlanmıştır. O nedenle elemanı verimli kullanabilmek için, İşlem Yönetim Çatısı yapısını iyi bilmek gerekir.

HTMLMailProcess Elemanını, kullanıcılara dinamik içerikli HTML postaları göndermek için kullanabilirsiniz. Bu elemanı, işlem bloğu veya işlem formu içine yerleştirin ve özelliklerini belirleyin.

Özellikler

Kime, Kopyası, Gizli Kopyası (MScript kabul eder)

Bunlar; posta alıcılarını belirleyen standart parametrelerdir.

Konu (MScript kabul eder)

Bu özelliğe, posta konusunu direkt olarak yazabileceğiniz gibi, "TITLE_OF_TEMPLATE" özel kelimesini kullanarak, e-posta konusunun, şablon sayfanın "Sayfa Başlığı"  özelliğinden alınmasını da sağlayabilirsiniz.

Şablon Sayfa (MScript kabul eder)

Bu özellik; gönderilecek olan e-postaların türetileceği şablon sayfanın adını belirler. Şablon sayfa statik veya dinamik olabilir. Statik şablon sayfalar, alıcılara oldukları gibi gönderilirlerken; dinamik şablon sayfalar, sunucu tarafında XSLT işlemine tabi tutulup, HTML e-postalar üretildikten sonra alıcılara gönderilirler. XSLT işlemi için gerekli olan XML verisi, "Dahil Edilecek Alanlar" özelliğinde belirtilen alanlardan oluşturulur.

Not:

Eğer HTML, posta olarak gönderilecek sayfa harici kaynaklar içeriyor ise (resim dosyaları, harici javascript dosyaları, vs.); sayfanın "Köprü Tabanı" özelliği belirtilmelidir. Bu özelliğe, bu harici dosyaların bulunduğu web sitesinin URL'i verilmelidir.

Örnek:

Köprü Tabanı: http://www.mycomp.com

XML İçerik (Virgülle ayrılmış semboller) (MScript kabul eder)

Eğer postalanacak şablon sayfamız dinamik ise; yani bir XSL sayfası ise, XML verisi sağlayacak olan kaynakları belirten MScript sembolleri bu özellik ile belirtilir. Kullanılabilecek olan MScript Sembolleri :

1. İşlem Kayıt Alanları: Örnek: f:Name

2. Normal Girdi Alanları:  Örnek: i:Stock

3. Havuz Değişkenleri: Örnek: v:Status

Birden fazla alan belirleyebilmek için aralarında virgül kullanın.

Örnek: f:Name, i:Stock, v:Status, LastWeekOrders

XML Alanları:

İşlem Kayıt Alanları veya Havuz Değişkenleri içinde XML verisi de saklanabilir.  mor > ADOM > AMLProcess elemanını kullanarak ToXML fonksiyonu ile, bellekteki ADOM nesneleri XML verisine dönüştürülebilir ve  İşlem Kayıt Alanlarına veya Havuz Değişkenlerine atanabilir.

Belirlenen alanlardan oluşturulan XML verisinin yapısı:

"Dahil Edilecek Alanlar" özelliğinde belirlenmiş olan alanlardan oluşturulan XML verisinin yapısını bilmek, dinamik şablon sayfalar geliştirirken, bu sayfalar içinde kullanılan elemanların özelliklerini, bu XML verisinin düğümlerine doğru şekilde bağlayabilmek için önemlidir.

"f:Name, i:Stock, v:Status, LastWeekOrders" örneğinde belirtilen alanların, HTMLMailProcess tarafından işleneceğini ve bu alanların o anki değerlerinin aşağıdaki gibi olduğunu var sayalım.

f:Name       i:Stock     v:Status    LastWeekOrders

-----------  ---------   ----------  ---------------------------------------

Printer      12          Discounted  <item>

                                       <custid>5</custid>

                                       <qty>5</qty>

                                     </item>

                                     <item>

                                       <custid>33</custid>

                                       <qty>20</qty>

                                     </item>

HTMLMailProcess, bu alanlardan aşağıdaki XML verisini oluşturacak, bu veriyi XSLT işleminde kullanacak ve sonuçta üretilen HTML sayfasını e-posta alıcısına gönderecektir.

Ekler (Virgülle ayrılmış) (MScript kabul eder)

Bu özellikte e-posta eklerini oluşturacak olan dosyaların adları virgüller ile birbirinden ayrılarak tanımlanabilir. Dosya adları web uygulaması kök dizinine göreceli olarak veya tam dosya adı olarak tanımlanabilir.

Söz dizimi:

[ek-adı | ] dosya-adı [, [ek-adı | dosya-adı ] ]

ek-adı : 

E-Postada görülecek olan ek adı. Bu parametre isteğe bağlıdır ve tanımlanmaz ise, ek adı olarak dosya-adı kullanılır.

dosya-adı : 

E-Postaya eklenecek olan dosyanın adı. Dosya adı tam dosya adı olarak verilebilir veya uygulama kök dizinine göreceli tanımlanabilir.

Dosya adı yerine bir işlem bloğu alan adı veya havuz değişkeni adı da verilebilir. Bu durumda işlem bloğu alanı veya havuz değişkeni ek olarak gönderilecek olan dosyanın Dosya Nesnesini içermelidir. Bu şekilde, örneğin "mor > Fop > FopProcess" işlemi bir pdf dokümanını oluşturup, dokümanın Dosya Nesnesini  bir havuz değişkeninde saklayabilir ve HTMLMailProcess işlemi de değişken adı üzerinden dosya nesnesine ulaşarak onu bir e-posta eki olarak gönderebilir.

Örnekler:

Gönderme Şekli

E-postalar ön planda veya arka planda gönderilebilir. Gönderilecek olan e-posta miktarına bağlı olarak kullanıcı ekranını meşgul tutmamak için e-postaları arka planda göndermek için "2." seçeneğini seçin.

Arka plan gönderici miktarı

"Gönderme Şekli" özelliğinde yapılan seçim "2." ise e-postalar arka planda bir yada daha fazla gönderici kullanılarak gönderilebilir. Bu özellik, gönderilecek e-posta miktarının çok olması durumunda gönderme zamanını kısaltmak için kullanılabilir.

Kütük Dosyası (MScript kabul eder)

Bu özellikte bir kütük dosyası belirlenerek başarılı ve başarısız gönderimlerin kaydedilmesi sağlanabilir. Dosya adı mutlak veya web uygulaması kök dizinine göreceli olarak verilebilir.

Gönderim Durumu Hedef Sembolü (MScript kabul eder)

Burada tanımlanan sembole, her bir mail gönderiminden sonra gönderim durumunu belirten bir kod atanacaktır. Sonraki işlemler bu kod değerine göre kendi işletimlerini yönlendirebilirler.

f:SEND_STATUS varsayılan semboldür. Bu özellik "1. Ön planda" durumunda geçerlidir.

Durum Kodları:

00: Gönderim başarılı
04: Gönderim kısmen başarılı. Alıcı adreslerinden en az bir tanesi hatalı.
08: Gönderim başarısız. Tüm alıcı adresleri hatalı.
 12: Gönderim başarısız. MessagingException istisnası oluştu.

İşlem Sonuç Kodu

Bu işlem; aşağıdaki işlem sonuç kodlarını döndürür:

 0: Normal sonuç.

12: E-Posta gönderirken bir hata oluştu (Geçersiz SMTP Hesabı, Şifresi, vs.).