Load CSV Data
CSV formatındaki Excel verilerinin, form sayfasında yer alan Grid form aracına aktarılmasını sağlayan aksiyondur.
Özellik Panelinde Load CSV Data aksiyonu
Özellikler
Description: Aksiyon için bir açıklama yazılır.
Heading: Form aksiyonu olarak eklendiğinde aksiyon listesindeki adı belirtir.
SQL Query: Bu alanda sorgu yazılırken, .csv dosyasındaki sütun sayısı kadar sorguya sütun eklenmelidir.
Her sütun, dosya içindeki sırasına göre COL1, COL2, COL3 … şeklinde tanımlanmalıdır. Bu ifadeler, .csv dosyasındaki sütunların sırasal konumlarını temsil eder.
Her sütuna, alias (takma ad) kullanılarak grid aracında yer alan alan adlarıyla eşleşen bir ad verilmelidir.
Örneğin:
COL1 AS GridAlan1,
COL2 AS GridAlan2,
COL3 AS GridAlan3
Yukarıdaki örnekte, .csv dosyasındaki birinci sütunda yer alan veri, form sayfasındaki grid aracı içinde GridAlan1 isimli sütuna aktarılacaktır.
Bu eşleştirme sayesinde, .csv dosyasındaki her sütunun, grid aracı üzerinde hangi alana karşılık geleceği tanımlanmış olur. Eşleştirme yapılırken dikkat edilmesi gereken önemli bir husus da, .csv dosyasındaki sütunun veri tipi ile grid aracındaki karşılık gelen alanın veri tipinin uyumlu olması gerektiğidir.
Sorguda kullanılacak tablo adı sabit olarak #XPODA_CSV_TABLE şeklinde yazılmalıdır.
Bracket: Aktarılacak .csv dosyasındaki alanların birbirinden hangi karakter ile ayrıldığını belirlemek için sınırlayıcı bilgisi tanımlanmalıdır. Bu alanda, dosyada kullanılan ayırıcı karakter belirtilir. Bu alana ; karakteri yazılmalıdır.
Start Line: Eğer .csv dosyasında sütun adlarını içeren bir başlık satırı bulunuyorsa, veri okuma işlemi bu satır atlanarak başlatılmalıdır. Bu durumun kontrolü için Start Line alanı kullanılır.
Start Line değeri, verilerin hangi satırdan itibaren işleneceğini belirtir ve satır numaralandırması 0’dan başlar.
.csv dosyasında başlık satırı varsa, bu satırın aktarılmaması için Start Line alanına 1 değeri yazılmalıdır.
Eğer dosyada başlık satırı bulunmuyorsa, veri ilk satırdan itibaren işleneceğinden Start Line alanına 0 değeri yazılmalıdır.
Bu ayar sayesinde yalnızca veri içeren satırlar işlenir ve form üzerindeki Grid aracına doğru şekilde aktarılır.
Line Looking: Line Looking seçeneği, aktarılacak .csv dosyasındaki satırların tek tek işlenip işlenmeyeceğini belirler.
Seçenek aktif hale getirilirse, listedeki her bir satır için işlem ayrı ayrı gerçekleştirilir.
Seçenek pasif ise, veri toplu olarak işlenir ve satır bazlı ayrıştırma yapılmaz.
Bu ayar, satır bazında özel kontroller veya işlemler gerçekleştirilmek istendiğinde kullanılır.
Run Condition: Run Condition alanına girilen sorgunun sonucu, aksiyonun çalışıp çalışmayacağını belirler.
Eğer sorgu sonucunda dönen değer '0' ise, ilgili aksiyon çalıştırılmaz.
Değer '0' dışında bir değer dönerse (örneğin '1'), aksiyon normal şekilde çalıştırılır.
Bu özellik, belirli koşullar altında işlemlerin kontrolünü sağlamak amacıyla kullanılır. Böylece istenmeyen durumlarda aksiyonun devreye girmesi engellenebilir.
Request Confirmation: Aksiyonu çalıştırmadan önce kullanıcıdan onay alınıp alınmayacağı "Onay İste" seçeneği ile belirlenir.
Onay İste seçeneği aktif ise, aksiyon çalıştırılmadan önce kullanıcıdan onay alınır.
Bu durumda, "Onay Mesajı" alanı aktif hale gelir ve kullanıcıya gösterilecek bilgilendirici mesaj bu alanda tanımlanır.
Onay Mesajı, aksiyon öncesinde kullanıcıya gösterilecek uyarı ya da bilgilendirme metnidir. Bu mesaj, işlemin onaylanması için kullanıcıdan açık bir yanıt alınmasını sağlar.
Kullanılan Örnek
Forma bir grid form aracı ve bir buton aracı eklenmiştir. Buton aracına aşağıdaki görseldeki gibi aksiyon eklenmiştir.
Excel verileri, sütun adlarını içeren başlıklar olmadan grid form aracına aktarılmak için hazırlanmıştır.
Excel ekranı
Hazırlanan Excel dosyası CSV formatında kaydedilmelidir. Türkçe ve özel karakter içermeyecek şekilde isimlendirilmelidir. |
Client ekranındaki butona tıklandığında bilgisayardan dosya seçme penceresi açılır.
Açılan pencereden, .csv uzantılı excel dosyası seçilip, aç butonuna tıklandığında grid aracı içerisine excel verileri doldurulur.
Client ekranında görünümü