AjaxCommand

 
AjaxCommand elemanı "mor > zpro > ProcessCommand" elemanına benzer ancak farklı olarak işlemler çalıştırdıktan sonra yeni bir sayfa üretilmesini değil güncel sayfanın bölümlerinin Ajax Yenileme İşlemleri yenilenmesi sağlanır.

Eleman bir İşlem Formu içerisine yerleştirilmelidir. Bu eleman sayfa üzerinde kullanıcının verebileceği bir işlem komutunu temsil eder ve komut düğmesine basıldığında hangi işlemlerin çalıştırılacağını belirlemek için kullanılır.

Elemanın özelliklerini belirlemeden önce işlem formu içinde bir ya da daha fazla İşlem Tanım elemanının var olması gerekir.

Özellikler

İşlem Listesi

İşlem Listesi diyaloğunu açmak için, özellik editöründe özelliğin hizasındaki [...] düğmesine tıklayın. İşlem listesi içinde en az bir adet Yenileme İşlem elemanı bulunmalıdır.

Erişim Kontrolü (MScript kullanılabilir)

İşlem listesinde yer alan işlemler ancak oturuma sahip olan kullanıcının yetkisi var ise çalıştırılır. Bu özellikte bir tanım yapılmaz ise sayfanın Erişim Kontrolu özelliğindeki tanım kullanılır. Detaylı bilgi için ana yardım dokümanında "Temel Elemanlar > Eleman "Sayfa" > Özellik "Erişim Kontrol"" bölümüne bakın. "Temel Elemanlar > Eleman "Sayfa" >  Özellik ''Erişim Kontrol'' konusuna bakın.

İşlem Yöneticisi İzleme Seviyesi (MScript kullanılabilir)

İşlem Yöneticisinin adımlarını sistem konsolu üzerinden izlemek için 1 (en az detay) ile 3 (en cok detay) arasında bir değer seçin.

Çalıştırılacak olan işlemlerin izleme ayarları ise "İşlem Listesi" üzerinden belirlenir.

Gönderi Öncesi Fonksiyon

Eğer bu özellikte bir javascript fonksiyonu tanımlanmış ise fonksiyon işlem formu gönderilmeden önce çağrılacak ve form nesnesi parametre olarak geçirilecektir. Eğer fonksiyon false değeri döndürürse gönderme işlemi iptal edilir.

Girişi Doğrula

Çalıştırma düğmesine basıldığında girdi alan doğrulamalarının çalışması isteniyorsa bu özelliğe "true" değeri verilmelidir. Düğmeye basıldığında tüm işlem formu içindeki girdi alanları değil, elemanın "İşlem Listesi" özelliğinde seçilmiş olan işlem tanımlarının içinde bulundukları işlem blokları içinde yer alan girdi alanları doğrulanacaktır.
 

Onay İsteme Mesajı

Bazı durumlarda işlemleri çalıştırmadan önce kullanıcının onayını almak gerekir; örneğin bir kayıt silmeden önce. Bu özelliğe bir değer girilirse bu değer kullanıcının onayının istendiği diyalogda gösterilecek ve işlem formu ancak kullanıcı onay verirse gönderilecektir.

İstek Parametreleri

İşlemler veya veri kaynakları tarafından kullanılacak olan parametreler. Bu tanımlamayı yaparken çağrının AjaxCommand elemanı için üretilecek olan HTML elemanın "Tıklanınca" olay prosedüründen yapılacağı dikkate alınmalıdır.

Meşgul Resmi

Sayfaya yerleştirilen BusyImage elemanının HTML Kimliğine verilen değer yazılmalıdır.

Geri Çağrım Fonksiyonu

Bu özellikte AjaxCommand'ın "İşlem Listesi"ndeki işlemlerin tümü çalıştırıldıktan sonra çağrılması istenen fonksiyonun adı yazılır.

Kullanıcı Verisi

Kullanıcı verisi parametrelerinde bir veri değişkeni atanmış ise nesne geri çağrım fonksiyonuna iletilecektir. "Geri Çağrım Fonksiyonu" ve "Kullanıcı Verisi" parametreleri AjaxCommand'ın tüm işlemleri çalıştırıldıktan sonra özel işlemler yapabilme amacıyla kullanılır.

Hata Kotarıcısı

Eğer "Hata Kotarıcısı" tanımlanırsa, bu fonksiyon; sistem mesaj vermeden önce çağrılacaktır.