RefreshBlocksAction

 
RefreshBlocksAction Ajax kütüphane elemanı bir ya da daha fazla işlem bloğunu (ProcessBlock) yenilemek için kullanılır.

Önemli: Seçilen blokların "Kayıtlara Müdahale Edilebilir" özelliklerinin değerleri true olmalıdır ve bloklar içindeki tüm elemanlar Ajax uyumlu işlem alanları olmalıdır.

Bakın RefreshBlocksProcess

Özellikler

Veri Kaynağı Adları (dataSources) (Virgülle ayrılmış, MScript kullanılabilir)

Bir Data Source elemanı (örnek: RelDBQueryDataSource) ile tanımlanmış olan ve yenilenecek işlem blokları için veri sağlayacak olan kaynağın ya da kaynakların adları yazılır. "Datasource Listesi" penceresinden seçilebilir.

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

Veri kaynakları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 ve ikinci veri kaynağı belirtilmişse ikinci veri kaynağının şifrelenecek düğümleri noktalı virgülden sonra yazılmalıdır.

Hedef Bloklar (targetBlocks) (Virgülle ayrılmış, MScript kullanılabilir)

Yenilenecek olan işlem bloklarının HTML kimlikleri. Hedef Bloklar "ProcessBlock Listesi" penceresinden seçilebilir. Birden fazla seçim yapabilmek için CTRL tuşunu kullanınız.

Alan Eşlemeleri (fieldMap) (Virgülle ayrılmış, MScript kullanılabilir)

Bloklar içinde yer alan işlem kaydı alanlarının değerleri aksi belirtilmedikçe alan adları ile aynı ada sahip veri kaynağı düğümlerinden alınır. Bu kurala uymayan durumlar için bu özellikte

 işlem_kaydı_alanı:veri_düğümü_adı[, işlem_kaydı_alanı:veri_düğümü_adı ...]

yapısında eşlemeler yapılmalıdır.

Örnek:

SIPARIS_NO:NO, MUSTERI_ADI:AD  

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

Geri Çağrım Fonksiyonu (callbackFunc)

Bu özellikte RefreshBlocksAction çalıştırıldıktan sonra, ya da diğer bir deyişle işlem blokları 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.

Not: RefreshBlocksProcess elemanı kullanılarak bir işlem bloğu yenilenecekse, ilgili işlem bloğunun (ProcessBlock) "Kayıtlara Müdahele Edilebilir" özelliğinin değeri true olmalıdır.

RefreshBlocksAction Çağırma Yöntemleri

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

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

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

Fonksiyon Çağrısı

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