Kuika'da özel aksiyonlar oluşturabilir ve bunları ekranlarınıza entegre edebilirsiniz. Datasources modülünde mevcut veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir ve yönetebilirsiniz.

Adımlar:

1. Kuika platformuna giriş yapın ve Apps ekranından projenizi açın.
2. Üst menüden Datasources modülünü açın.
3. Sol paneldeki Sources alanında Managed DB başlığını genişletin.
4. Actions satırının yanındaki + ikonuna tıklayın.
5. Açılan menüden New SQL Action seçeneğini seçin.
6. Editörün üst kısmındaki isim alanına aksiyonun adını yazın ve yanındaki onay (✓) ikonuna tıklayın.

Aksiyon, altında oluşturulduğu veri kaynağına bağlı olarak oluşturulur. Managed DB altından oluşturulan aksiyonlar, Kuika'nın yönetilen veritabanını kullanır.

Aynı menüde yer alan New Folder seçeneğiyle bir klasör oluşturabilir ve özel aksiyonlarınızı bu klasör içinde düzenleyebilirsiniz. New Select Action seçeneği ise SQL yazmadan seçim tabanlı bir aksiyon oluşturmanızı sağlar.

Örnek Senaryo: Departman Listesi Aksiyonu

Amaç: Uygulamada, personel listesinde yer alan departmanları listeleyen bir aksiyon oluşturmak.

1. Department adında bir tablo oluşturun.
2. Select Department List isimli özel aksiyonu ekleyin.
3. SQL Editor'de aşağıdaki sorguyu yazın:

SELECT * FROM Department
WHERE DepartmentName LIKE @searchFor OR @searchFor IS NULL OR @searchFor = ''
ORDER BY DepartmentName;

4. Sorgunun kullandığı parametreleri sağ paneldeki Parameters sekmesinden görüntüleyin ve gerekirse test değerlerini girin.
5. Sağ üst köşedeki Run butonuna tıklayarak sorguyu test edin. Sonuçları editörün alt kısmındaki Result sekmesinde, olası hata ve uyarıları ise Messages sekmesinde görüntüleyebilirsiniz.
6. CREATE butonuna basarak özel aksiyonu oluşturun.

Oluşturulan aksiyon, sol panelde Actions başlığı altında listelenir. Aksiyonu buradan açarak görüntüleyebilir, düzenleyebilir veya silebilirsiniz.

Herhangi bir modülde kullanılan özel aksiyonlar, ilişkili oldukları modülden kaldırılmadan silinemez. Bu durumda sistem bir hata mesajı gösterebilir.

Kullanım Yerlerinin Görüntülenmesi

Bir SQL Action'ın hangi sayfa ve elementlerde kullanıldığı görüntülenebilir. Bu sayede action üzerinde yapılacak bir değişikliğin uygulamanın hangi noktalarını etkileyeceği, değişiklik yapılmadan önce görülebilir.

Sorguyu Parametreleriyle Birlikte Kopyalama (Copy query with parameters)

Action'ın sağ tık menüsünde, Edit SQL Action seçeneğinin altında Copy query with parameters seçeneği bulunur. Bu seçenek, aksiyonu açmaya gerek kalmadan içindeki sorguyu, ekranda girilmiş parametre değerleri yerine yerleştirilmiş hâlde panoya kopyalar. Kopyalanan sorgu doğrudan bir SQL IDE'ye yapıştırılıp çalıştırılabilir.

• Otomatik yerleştirilen değerler: Fixed Value olarak girilmiş parametreler ve sabit default değerler (null, Empty, Space, True, False, Now, New Guid, Empty Guid). Değerler tipine göre biçimlendirilir: string değerler tek tırnak içinde, sayısal değerler düz, boolean değerler ise datasource tipine göre 1/0 ya da true/false olarak yazılır.
• Yerleştirilmeyen değerler: Bir elemente, Screen Input'a, Bag'e veya başka bir aksiyonun sonucuna bağlı parametreler @parametreAdi / :parametreAdi şeklinde aynen bırakılır. Bu değerler yalnızca çalışma anında belirlendiğinden tasarım aşamasında bilinmez; yanıltıcı olmaması için bu alanların IDE üzerinde manuel doldurulması gerekir.

Kopyalama işleminden sonra çıkan bildirim, kaç parametrenin otomatik doldurulduğunu gösterir (ör. 3 of 8 parameter values filled in.). Böylece manuel doldurulması gereken alan sayısı anında görülebilir.

Kuika'da özel aksiyonları UI Design veya Datasources modülleri üzerinden oluşturabilirsiniz.

Adımlar:

1. UI Design modülünü açın.
2. Custom Actions panelini açarak SQL Action seçimini yapın.
3. Aksiyon ismini belirleyin ve SQL Editor'de sorgunuzu yazın.

SQL Sorguları Oluşturma

Kuika, temel SQL sorgularını hızlıca eklemenizi sağlar:

• Add Select Query: Tablodaki kayıtları listeleme.
• Add Select By Id Query: Belirli bir ID'ye göre veri çekme.
• Add Save Query: Veri ekleme veya güncelleme.
• Add Delete Query: Belirli bir kaydı silme.
• Add Search By Keyword Query: Anahtar kelime ile veri arama.
• Add Search With Pagination Query: Sayfalama ile veri arama.

Kuika AI ile SQL Sorgusu Üretme

SQL Editor'ün sağ panelinde yer alan Kuika AI sekmesi, sorgularınızı yapay zekâ desteğiyle oluşturmanızı sağlar.

1. Sağ paneldeki Kuika AI sekmesini açın.
2. Choose Table menüsünden sorgu oluşturmak istediğiniz tabloyu seçin.
3. Hazır örnek komutlardan birini seçin ya da kendi açıklamanızı yazarak gönderin. Hazır örnekler şunlardır:
   
   • Write a SQL query to fetch all records from this table
   • Filter results created in the last 30 days
   • Select only active records
4. Oluşturulan sorguyu SQL Editor'e ekleyin.

Örnek komut: "Sadece aktif departmanları listeleyen bir sorgu oluştur."

SQL Sorgularını Test Etme ve Kaydetme

1. Sağ üst köşedeki Run butonu ile sorguyu çalıştırın.
2. CREATE butonuna basarak aksiyonu kaydedin.

SQL Editor Geliştirici Araçları

Kuika SQL Editor, sorgu yazım sürecini kolaylaştırmak ve kod kalitesini artırmak için aşağıdaki geliştirici araçlarını destekler:

• SQL Diagnostics: Yazılan sorgudaki sözdizimi hataları ve olası sorunlar gerçek zamanlı olarak tespit edilir. Hatalı alanlar editörde işaretlenir; toplam hata sayısı editörün sağ üst kısmında, hata ayrıntıları ise alttaki Messages sekmesinde gösterilir.
• SQL Completion: Sorgu yazarken tablo adları, sütun isimleri ve SQL anahtar kelimeleri için otomatik tamamlama önerileri sunulur. Bu sayede yazım hataları azalır ve geliştirme süreci hızlanır.
• SQL Formatter: Sorgu otomatik olarak biçimlendirilmez. Editör araç çubuğundaki Tidy Up butonuna tıklandığında sorgu okunabilir bir formata getirilir; girinti, satır düzeni ve anahtar kelime tutarlılığı bu işlemle düzenlenir.

Editör araç çubuğu ayrıca geri al / yinele, kopyala / yapıştır, satır kaydırma ve yazı boyutunu büyütüp küçültme seçeneklerini içerir. İmlecin bulunduğu satır ve sütun bilgisi (ör. Ln 3, Col 25) araç çubuğunun sağ tarafında gösterilir.

Kuika SQL Editor'de DECLARE komutu ile değişken tanımlayabilirsiniz.

Genel DECLARE Formatı

DECLARE @variable_name data_type;

Burada:

• @variable_name: Değişken adı.
• data_type: SQL veri tipi (ör. nvarchar, int, bit).

Örnek Kullanımlar

1. Değişken Tanımlama ve Veri Atama

DECLARE @top1Product nvarchar(256);SELECT TOP 1 @top1Product = productName FROM table_name;

2. Satır Sayısı Hesaplama

DECLARE @rowCount int;SET @rowCount = (SELECT COUNT(Id) FROM table_name);

Kuika AI ile DECLARE Kullanımı

1. Sağ paneldeki Kuika AI sekmesini açın.
2. İhtiyacınıza uygun DECLARE ifadesini oluşturmak için bir komut yazın.

Örnek komut: "Sadece aktif departmanları listeleyen bir DECLARE komutu oluştur."

Kuika'da SQL Action oluştururken aşağıdaki sistem parametreleri kullanılabilir:

• @currentpage: Sayfa numarasını temsil eder.
• @pagesize: Sayfada dönecek kayıt sayısını belirler.
• @kuikausername: Kuika'ya giriş yapmış kullanıcının adını temsil eder.
• @kuikauserid: Kullanıcının kimlik bilgisini (GUID) temsil eder.

Bu parametreleri kullanarak sayfalama, kullanıcı bazlı veri filtreleme ve dinamik SQL sorguları oluşturabilirsiniz. Özellikle büyük veri setleriyle çalışırken @currentpage ve @pagesize parametreleri ile veriyi sayfalara bölerek sorgularınızı optimize edebilirsiniz.