RefreshFieldsAction

 
RefreshFieldsAction Ajax kütüphane elemanı bir ya da daha fazla DOM elemanının niteliklerini yenilemek için kullanılır.

Bakın RefreshFieldsProcess

Özellikler

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

Bir Data Source elemanı (örnek: RelDBQueryDataSource) ile tanımlanmış olan ve yenilenecek alanlar için veri sağlayacak olan kaynağın adı. "Datasource Listesi" penceresinden seçilebilir.

Ş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.

Veri Düğümleri (dataNodes) (Virgülle ayrılmış)

Veri kaynağının döndüreceği sonuç kümesi içinde bulunan alan adları virgüller ile ayrılarak verilmelidir.

Hedef Eleman Kimlikleri (targetElements) (Virgülle ayrılmış)

Nitelik değerleri yenilenecek olan DOM elemanlarının HTML kimlikleri virgüller ile ayrılarak verilmelidir. ProcessField elemanları "ProcessField Listesi" penceresinden seçilebilir. Birden fazla seçim yapabilmek için CTRL tuşunu kullanınız.

Hedef Eleman Nitelikleri (targetElementAttrs) (Virgülle ayrılmış)

DOM elamanların yenilenecek olan niteliklerinin adları virgüller ile ayrılarak verilmelidir. value, boş bırakılan nitelik adları için varsayılan değerdir.

İstek Parametreleri (requestParams)

Veri kaynağı tarafından kullanılacak olan istek parametreleri bu özellikte belirtilmelidir. 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)

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.

Geri Çağrım Fonksiyonu (callbackFunc)

Bu özellikte RefreshFieldsAction çalıştırıldıktan sonra, ya da diğer bir deyişle elemanın seçenekleri yenilendikten sonra çağrılması istenen fonksiyonun adı yazılır. Bu parametre zorunlu değildir.

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.

RefreshFieldsAction Çağırma Yöntemleri

RefreshFieldsAction elemanını kullanıp özelliklerini belirledikten sonra RefreshFieldsAction'ı harekete geçirmenin iki yöntemi vardır.

Dinamik Çağrı

Sayfaya yerleştirilmiş olan bir RefreshFieldsAction 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(/myRefreshFieldsAction/jscall)

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

Fonksiyon Çağrısı

Sayfaya yerleştirilmiş olan bir RefreshFieldsAction 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.refreshFields() 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, RefreshFieldsAction elemanı özelliklerinde yapılan değişiklikler etkili olmayacaktır.