Form içinde tablolardan gelen veri/verileri listelemek için kullanılan araçtır.
Araç Kutusundaki Görünümü
|
Free Formdaki Görünümü
|
Responsive Formdaki Görünümü |

|
 |
 |
Uyumluluk
Free Form |
Responsive Form |
Mobile |
 |
 |
 |
Liste aracının özellikleri
|
Type (Alan Türü): Eklenilen form aracının alan türünü gösterir. Burada yer alan değer değiştirilemez.
Name(Alan İsmi): Veri tabanında oluşacak olan alanın ismi yazılır.

Text Size(Metin Boyutu): Metin kutusuna girilecek olan değerlerin boyutu bu alanda belirlenir.

Help Text (Yardım Metni): Form aracı üzerine fare ile gelindiğinde açıklama çıkması için girilen metindir.

Number of Locked Columns(Kilitli sütun sayısı): Listedeki sütunları sola sabitlemek (kilitlemek) mümkündür. (Daha sonra kullanım sırasında, listede sütun listesini göster seçeneği aktif hale gelir ve istenilen sütunlar kilitlenebilir veya kilitleri açılabilir.)

Height/Width(Yükseklik/Genişlik): Liste aracının yüksekliğini ve genişliğini ayarlar (Genişlik alanı Responsive Formlar'dan kaldırılmıştır).

From Left / Top(Soldan/Üstten): Liste Aracının soldan ve üstten mesafesini ayarlar (Bu alan Responsive Formlar'dan kaldırılmıştır).

Image Size(Resim Boyutu): Listede gösterilecek resimlerin yükseklik ve genişlik ayarlaması yapılır.

Row Size(Satır Boyutu): Satırların genişlik ayarı yapılır.

List View on Mobile(Listenin Mobil Görüntüsü): Listenin mobilde nasıl görüneceği seçimi yapılır.

List Header Width on Mobile(Liste Kolonlarının Mobilde Genişliği): Liste kolonlarının mobildeki genişlik ayarlaması yapılır.

SQL Query(SQL Sorgusu): Listelenecek veriler SQL sorgusuna yazılır. Listede gizlemek istediğiniz alanın SQL sorgusunda, alan adının başlangıcı | işareti eklenmelidir. Örneğin; [| İsim]. Listede değiştirilebilir bir alan oluşturmak için SQL sorgusunda alan adına bir $ işareti eklenmelidir. Örneğin, [$ Adı]

- Xpoda Addon (Xpoda Eklenti): Xpoda Platformu'nda, istenilen yerlerde özel olarak geliştirilen kodlar çalıştırılmak istenebilir. Bu maksatla geliştirilecek .NET Class Library'leri kullanılabilir. Bu seçenek seçimi sonrası Kütüphane - Class - Method seçimlerinin yapılması gerekmektedir.

Formatting Field(Biçimlendirme Alanı): Liste satırları ve sütunları dinamik olarak biçimlendirilir. İstenen parametrelerin doğru sırayla gönderilmesi gerekir.
- Alan | Operator | Value | Type | Colors | Cell(0-1) | Colored Area (Optional for Cell value=1)


Tarih format örnekleri; Tarih|@|dd MMMM HH:mm|center sonuç: 5 Haziran 16:43 Tarih|@|MMMM dd|center sonuç: Haziran 05 Tarih|@|MM.dd.yyyy|center sonuç: 06.05.2023 Tarih|@|yyyy/MM/dd|center sonuç: 2023/06/05 Tarih|@|hh:mm tt|center sonuç: 04:43 PM Tarih|@|HH:mm:ss|center sonuç: 16:43:38 Tarih|@|yyyy MMMM|left sonuç: 2023 Haziran Tarih|@|dddd, dd MMMM yyyy|right sonuç: Pazartesi, 05 Haziran 2023 Tarih|@|MM/dd/yyyy HH:mm:ss|left sonuç: 05/06/2023 16:43:38
Rakam değer örnekleri; RakamDeğeri|@|n|right sonuç: 128,14 RakamDeğeri|@|n0|right sonuç: 128 RakamDeğeri|@|n1|right sonuç: 128,1 RakamDeğeri|@|n5|right sonuç: 128,14320 RakamDeğeri|@|c|right sonuç: ₺128,14 RakamDeğeri|@|c0|right sonuç: ₺128 RakamDeğeri|@|c3|right sonuç: ₺128,143 RakamDeğeri|@|c5|right sonuç: ₺128,14320 RakamDeğeri|@|p|left sonuç: %80,12 RakamDeğeri|@|p0|left sonuç: %80 RakamDeğeri|@|p1|left sonuç: %80,1 RakamDeğeri|@|p2|left sonuç: %80,12
Sub Total(Alt Toplam): Listenin altında istenilen sütuna göre ara toplam bilgilerini göstermemizi sağlar. İstenen parametrelerin doğru sırayla gönderilmesi gerekir.
- (Field|operation (count, sum, min, average) I Text)
- (Alan | İşlem (sayım, toplam, min, ortalama) | Metin)

 |
Hide column heading(Sütun başlığını gizle): Rapordaki sütun başlıklarını gizler.
Fit Horizontal (Yatay Sığdır): Kullanıcının ekranında form aracını yatay olarak tam ekrana sığdırır.
Pin Right (Sağa Sabitle): Form aracını sağa sabitler.
Display (): Form aracının Client ekranında görünmemesini sağlar.
Detail Button(Detay Düğmesi): Rapordaki satırlara bir detay düğmesi ekler.
|
Column Width Auto(Otomatik Sütun Genişliği): Bu özellik aktifse kolonlar içinde bulunan metne göre otomatik olarak boyutlandırılır.
Auto Extention(Otomatik Uzantı): Veri geldikçe listenin genişlemesine izin verir.
Paging(Sayfalama): Çok satırlı verilerin hızlı yüklenmesini sağlar.
Page Size(Liste Satır Sayısı): Liste içerisinde kaç satır veri getirileceği bu alandan kontrol edilir. Bu değer alanı boş bırakıldığında liste default olarak 100 satır veriyi getirmektedir. Bu değer Client ekranından tekrar değiştirilebilinir.
File Menu(Dosya Menüsü): Listede listelenecek dosyaların indirilmesine ve görüntülenmesine izin verir. XPODA_FILES tablosundaki verilerin listeden alınması ve FileID ile RecordGuid alanlarının bulunması gerekir.
|
Liste aracının içerisinde kullanabilecek aksiyonlar
Form sayfasında her eklenen form elemanı için farklı aksiyonlar bulunmaktadır. Liste aracı için tanımlanmış olan aksiyonları görüntülemek için öncelikle liste aracı seçilir ardından sağ panelde yer alan aksiyonlar menüsü açılır.

Liste aracı içerisinde kullanabilecek aksiyonlar ve detayları aşağıdaki gibidir.

When the row is selecter(Satır seçildiğinde): Satır değeri değişiklikleri işleyicisinde olduğu gibi bir "Eylem" atayın.
When double clicked on row(Satıra çift tıklandığında): Çift tıklama işleyicisi olarak bir "Eylem" atayın.
Detail is Opened(Ayrıntı açıldığında): Ayrıntı açma işleyicisinde olduğu gibi bir "Eylem" atayın.
Örnek Kullanımı 1:
 |
Liste aracını kullanmak için bir güncelleme değeri gereklidir. Bu işlem bir düğme üzerinde; bir alanı tıkladı; değer veya istediğimiz form değiştiğinde; Form açıldığında ekleyebiliriz. Listedeki değerleri işlem olarak görüntülemek için değer güncelleme işlemini seçmemiz gerekiyor. İşlemin güncellenmesi için değer alanı olarak liste seçilmelidir. İşlemin özelliklerini seçip kaydettikten sonra, form açıldığında liste görüntülenecektir. |
- Bu işlemi bir buton ekleyerek butona tıklandığında liste güncellenecek şekilde yapalım:

Örnek Kullanımı 2:
SQL sihirbazını kullanarak bir sorgu oluşturalım ve XP_TEST tablomuzdan Month(Ay) ve Profit(Kar) bilgilerimizi listeleyelim. Burada “UserTableID” Listede görünmüyor.

 |
Listede " UserTableID " görmek istiyorsanız bir takma ad vermeniz gerekir. |

Örnek Kullanımı 3:
Kriterlere göre renk vermek istiyorsanız Color Style(Renk Stili) özelliğini kullanmalısınız. Burada (aşağıda);
İlk alan, sorgunuzdaki alan adını temsil eder. Alanın bir takma adı varsa, onu kullanmanız gerekir. İkinci alan bir ölçütü <, ==, > , != olarak temsil eder.
Üçüncü alan, ölçüt değerini temsil eder. Dördüncü alan, 1'in arka plan ve 0'ın metin rengi olduğu renk alanını temsil eder.
Beşinci alan, rengi HEX veya RGB veya RGBA veya Renk Adı biçimleri olarak temsil eder.


Örnek Kullanımı 3:
Fare ile tıklanan değerin sütun adını eklediğimiz alana yazdırmak için listenin aksiyonları bölümüne When row is selected aksiyonunu ekliyoruz. Yeni eklediğimiz alanın değerini güncellemek için SQL sorgusu alanına SELECT '$PXpodaGridActiveColName$' yazıyoruz. Bu ismi dilerseniz : (iki noktaya tıklayarak seçim alanından belirleyebilirsiniz.



- Farklı bir kullanım olarak seçilen hücrenin sütun başlığını almak yerine hücre içerisindeki değer bilgisi de alınabilir.
Bu örnek için az önce yapmış olduğumuz örneği biraz değiştirelim.
Az önce SELECT ile sorguladığımız '$PXpodaGridActiveColName$' değerinin tırnaklarını ve sonundaki $ işaretini kaldırarak seçtiğimiz satır ve sütunlardaki değeri bir Textbox nesnesine yazdırabiliriz.



 |
NOT: Bu örnekte liste sorgunuzdaki alanların isimlerine ALİAS verilmemesi, alan isimlerinin aynen kullanılması gerekmektedir. |