12-Liste
    • 22 Jul 2024
    • 2 Minutes to read
    • Dark
      Light

    12-Liste

    • Dark
      Light

    Article summary

    Form Bileşenleri - Liste

    Seçme alanı, açılan listede kullanıcılara bir değer listesi görüntüler. Kullanıcılar değerlerden birini seçebilir.

    Veri Kaynağı Türü

    Listenin kaynağı sistem listelerinden, liste elemanları girilerek veya özel bir kaynaktan belirlenir.

    Eğer listeler seçeneği seçilir ise liste kaynaklarından PaperWork listesi seçilebilir. 

    Eğer Sabit Değerler seçilir ise teker teker liste değerleri bu bölümde girilir. 

    Eğer Değişken seçeneği seçilir ise değerler kod ile oluşturularak atanır.

    "Veri Kaynağı Türü: Değişken" tanımlaması yapılırken,

    Kodlamalar, "Global Fonksiyonlar" ve "Yükleme Sonrası" ekranlarında gerekli kodlamaların yapılması gereklidir. 

    Tasarım ekranında kodun çalışmaması, detayın görünmemesine sebep olur. 

    Detay verisi, Ön İzleme ekranlarında görülebilir.

    Liste Kaynağı

    Veri kaynağı tipi liste seçildiğinde hangi PaperWork listesinin kullanılacağı belirlenir.

    Ana Liste Kaynağı

    Bağlı listelerde, bağlanacak liste için ana liste kaynağı seçimi yapılır.

    Liste Filtresi

    Bağlı listelerde, bağlanacak liste için filtrelenecek alan girilir. 

    Bu özelliğin çalışabilmesi için ilişkili (bağlanacak) listenin "Liste Tanımları" ekranındaki "Filtre" alanının da doldurulması gerekir.

    Örneğin Liste Filtresine aşağıdaki gibi S harfi girilirse ilişkili listede yalnızca S harfi ile başlayan başlıklar gelecektir

     

    Lazy Load Url

    Listenin her açılışında tekrar yüklenmesini sağlar.

    Değer Özelliği

    Listeden seçilen nesnenin tabloya kaydedilecek alan bilgisi girilir. Sistem listesi kolonları Key1, Key2, Key3.. gibi isimlendirilir ve ilk harfi büyüktür. Yanlış yazımlarda liste çalışmaz.

    Öğe Şablonu

    Listedeki her bir elemanın görüntüleme şablonu belirlenir. Çok değişik şablonlar kullanılabilir. Sistem listesinde görüntülenmek istenilen kolon <span>{{ item.Key1 }}</span> şeklinde yazılmalıdır. İlk harfin büyük olduğu unutulmamalıdır.

    Sabit Değerler

    Sabit olarak listeye eklenen her bir eleman seçim listesinde görüntülenir. Sistem listesinde görüntülenmek istenilen kolon <span>{{ item.label }}</span> şeklinde yazılmalıdır.

    Önemli !!!
    Veri kaynağı sabit değer ise, üstteki değer <span>{{ item.label }}</span> olarak değiştirilmelidir.

    Limit

    Liste özelliklerinde kullanılan limit, çok kayıtlı listelerin sunucudan tüm kayıtları aynı anda almasını engellemek için kullanılır.

    Örneğin 1000 kayıtlı bir listede  limit 10 olarak girilirse önce 10 kayıt getirilir.

    Özel Değer

    Veri kaynağı tipi değişken seçildiğinde liste elemanları atanabilir.

    Aşağıdaki kod örneğinde ilk önce bir liste oluşturulmuş daha sonra pwselect isimli listeye atanmıştır. Aynı atama yukarıdaki gibi de yapılabilir.

    //------------ Global Fonksiyonlar------------------------
    var userList = [
        { Name:"ali"   , label :"Ali"   },
        { Name:"mehmet", label :"Mehmet"},
        { Name:"yunus" , label :"Yunus" }];
    //--------------------------------------------------------
    
    //------------ Yükleme Sonrası----------------------------
    var  listName = "pwselect";
    var  key      = "Name";
    var  label    = "label"; 
    PwForm.fillList(listName, key, label, "userList");
    //--------------------------------------------------------
    
    Liste Verileri
    Liste veri adedi, hem kullanım kolaylığı hem de performans kriterleri düşünülerek planlanmalıdır. Örneğin liste alanları 5.000-10.000 adet tedarikçi verisi için uygun değildir.
    • Liste verilerinin çok fazla olduğu durumda kullanıcının liste içerisinde seçmesi gereken değeri arayıp bulması zorlaşmaktadır.
    • Liste veri adedinin çok fazla olması durumunda elektronik formun açılması esnasında uzun beklemeler olabilmektedir. Eğer listeler bir web servisinden, SAP veya Logo konnektörü gibi bir entegrasyon katmanından geliyor ise elektronik form çok yavaş açılır. 
    Bu sorunlardan kurtulmak amacı ile çeşitli yöntemler tavsiye edilir;
    1. Liste verisi çok fazla ise elektronik formda 3-4 filtre karakterinin girileceği, giriş ile beraber listenin filtrelenerek geleceği bir mekanizma düşünülebilir.
    2. Liste verileri bir entegrasyon katmanından geliyor ve çok sık değişmiyor ise PaperWork listesi tanımlanabilir. Buna göre bir metod belirli zamanlarda (Örneğin günde 1) entegrasyon katmanını çağırarak liste verisini alır ve PaperWork listesini günceller. Elektronik form da PaperWork listesini kullanabilir. 
    Nasıl Yaparım
    Listeler için Nasıl Yaparım sayfasını inceleyebilirsiniz.