|
MScriptAction Ajax kütüphane elemanı sunucu tarafında MScript fonksiyonları çalıştırmak için kullanılır. MScript fonksiyonları diğer tüm yenileme aksiyonlarının herhangi bir özelliğinde de kullanılabilse de bu aksiyon sadece bu amaç için tasarlandığı için daha hızlı ve ekonomiktir.
Sunucu tarafında çalıştırılacak olan MScript fonksiyonları bu özellikte belirtilir
MScript fonksiyonları tarafından kullanılacak olan istek parametreleri bu özellikte belirtilmelidir. {p1:'p1val', p2:'p2val'} ? başlangıç değeri ile gönderilecek olan parametrelerin yazım şeklinin vurgulanması amaçlanmaktadır. Eğer bu alanda bir atama yapılmazsa bu başlangıç değeri sayfanın derlenmiş halinde oluşturulmayacağından öyle kalması bir sorun teşkil etmeyecektir.
Bu tanımlamayı yaparken çağrının hangi elemandan yapılacağı dikkate alınmalıdır. Örneğin değer olarak 'ID=' + this.value verildiğinde, this, olay prosedürü içinden çağrının yapıldığı eleman nesnesini temsil eder.
Bu özellikte MScriptAction çalıştırıldıktan sonra çağrılması istenen fonksiyonun adı yazılır. Bu parametre zorunlu değildir.
Kullanıcı verisi parametrelerinde bir veri nesnesi atanmış ise nesne geri çağrım fonksiyonuna iletilecektir. "Geri Çağrım Fonksiyonu" ve "Kullanıcı Verisi" parametreleri yenileme işleminden sonra özel işlemler yapabilme amacıyla kullanılır.
Sistem tarafından yapılan yenileme sonucunun başarısız olması durumuna karşın "Hata Kotarıcısı" tanımlanırsa, bu fonksiyon; sistem mesaj vermeden önce çağrılacaktır.
Özelliklerini belirledikten sonra MScriptAction'ı harekete geçirmenin iki yöntemi vardır.
Sayfaya yerleştirilmiş olan bir MScriptAction elemanı üzerinde fare ile sağ tıklandığında açılan menüden " Panoya Kopyala 'Dinamik Çağrı Tanımı' " seçildiğinde, dinamik çağrı tanımı Windows panosuna kopyalanır. Bu çağrı tanımı daha sonra elemanların olay prosedürleri içine veya Script elemanlarının "Gömülü Script" özelliği içine yapıştırılabilir.
Örnek:
%vof(/myMScriptAction/jscall)
Dinamik çağrı, bir derleme zamanı fonksiyonu sayesinde gerçekleştirilir. Bu nedenle MScriptAction elemanının özelliklerinde yapılan değişiklikler sonuca yansıyacaktır.
Sayfaya yerleştirilmiş olan bir MScriptAction elemanının gerekli tüm özellikleri belirlendikten sonra, üzerine fare ile sağ tıklandığında açılan menüden "Panoya Kopyala 'Javascript Fonksiyon Çağrısı' " seçilirse, AjaxMgr.executeMScript() metod çağrısı tüm parametreleri ile oluşturulup Windows panosuna kopyalanır.
Panoya kopyalanan tanım daha sonra elemanların olay prosedürleri içine veya Script elemanlarının "Gömülü Script" özelliği içine yapıştırılabilir.
Örnek:
AjaxMgr.executeMScript({
actionName : 'myMScriptAction'
,requestParams : {SCART_ID:this.value}
,callbackFunc : durumKontrolu
,errorHandler : hataFonksiyonum
})
|
Önemli: "Dinamik Çağrı" nın aksine, tanımın panodan alınıp yapıştırılarak kullanılması sonrasında, MScriptAction elemanı özelliklerinde yapılan değişiklikler etkili olmayacaktır.
| 
