CustomRefreshAction

 
CustomRefreshAction Ajax kütüphane elemanı veri kaynağından elde edilen sonucu özel bir Yanıt Kotarıcısı kullanarak işlemek için kullanılır.

Bakın CustomRefreshProcess

Özellikler

Veri Kaynağı Adı (dataSource) (MScript kullanılabilir)

Bir veri kaynağı elemanının (örneğin: RelDBQueryDataSource) adı.

Şifrelenecek Düğümler (nodesToEncrypt) (Virgülle ayrılmış, MScript kullanılabilir)

Veri kaynağının döndüreceği sonuç kümesi içinde bulunan alanlardan hangilerinin şifreleneceği (encrypt) bu özellikte belirtilir. Alan adları virgüller ile ayrılarak verilmelidir.

İstek Parametreleri (requestParams)

Veri kaynakları 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.

Meşgul Resmi (busyImage)

Bu özellikte sayfaya yerleştirilen BusyImage elemanının HTML Kimliğine verilen değer yazılmalıdır. BusyImage elemanı sayfaya ilk yerleştirildiğinde "BI1" html kimlik değeri varsayılan olarak atanmıştır. "Meşgul Resmi" özelliği de "BusyImage Listesi" penceresinden seçilebilir.

Yanıt Kotarıcısı (responseHandler) (MScript kullanılabilir)

Bu özellikte ilgili Ajax Servisinden alınmış olan AjaxResponse yanıtını işleyecek olan Javascript fonksiyonunun adı verilmelidir. Fonksiyona parametre olarak AjaxResponse nesnesi iletilir.

Kullanıcı Verisi (userData)

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.

Hata Kotarıcısı (errorHandler)

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.

CustomRefreshAction Çağırma Yöntemleri

Özelliklerini belirledikten sonra CustomRefreshAction'ı harekete geçirmenin iki yöntemi vardır.

Dinamik Çağrı Tanımı
 
Sayfaya yerleştirilmiş olan bir CustomRefreshAction 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(/myCustomRefreshAction/jscall)

Dinamik çağrı, bir derleme zamanı fonksiyonu sayesinde gerçekleştirilir. Bu nedenle CustomRefreshAction elemanının özelliklerinde yapılan değişiklikler sonuca yansıyacaktır.

Fonksiyon Çağrısı

Sayfaya yerleştirilmiş olan bir CustomRefreshAction 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.customRefresh() 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:

Önemli: "Dinamik Çağrı" nın aksine, tanımın panodan alınıp yapıştırılarak kullanılması sonrasında, CustomRefreshAction elemanı özelliklerinde yapılan değişiklikler etkili olmayacaktır.