Custom Actions (Özel Aksiyonlar) oluşturun

Kuika ile geliştirdiğiniz bir uygulamada, özel aksiyonlar oluşturabilir ve bu aksiyonları ekranlarınızda kullanabilirsiniz. Datasources modülünün sol menüsünden, geliştirdiğiniz uygulamada bulunan veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir, yeni veri kaynakları, aksiyonlar ve tablolar ekleyebilirsiniz.

1. Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız projeyi açın. 
2. “Datasources’’ (1) modülünde sol kenarda bulunan “Actions’’ başlığı yanındaki “+” ikonuna tıklayın.

3. Açılan menüden “New SQL Action” seçimini yapın.

Eğer Actions alt panelinde yeni bir Custom Action oluşturmak istiyorsanız, New SQL Action seçeneğine tıklayın. Eğer yeni bir klasör oluşturup bu klasör altında Custom Actions oluşturmak istiyorsanız, New Folder seçeneğine tıklayın ve klasörünüzü isimlendirerek oluşturun.

Örnek bir senaryoda, personel listesinde yer alan departmanların listelenmesini sağlayan bir aksiyon oluşturacağınızı düşünelim. Bu aksiyonu oluşturmadan önce, “Department” adında bir tablo oluşturmalısınız. Tablo oluşturma işlemleriyle ilgili detaylı bilgiye içeriğimizden ulaşabilirsiniz.

4. Uygulamanızda departmanları listelemek için “Select Department List” isimli bir özel aksiyon oluşturun. 
5. SQL Editor’de listeleme için gereken SQL sorgusunu yazın.Sorgu ekleme ekranında tablolar özelinde otomatik olarak oluşur. 
6. Tablo özelinde otomatik sorgu eklemek için sol menüdeki tablo isminin yanındaki üç noktaya tıklayın. Kuika, “Select”, “Update” ve “Delete” sorgularını otomatik olarak eklemenize ve üzerinde değişiklik yapmanıza olanak sağlamaktadır. 
7. Select Department List özel aksiyonuyla departmanları listelemek için aşağıdaki sorguyu kullanabilirsiniz:

Copyselect * from Department  WHERE DepartmentName LIKE @searchFor  OR @searchFor is null OR @searchFor = ''  ORDER BY DepartmentName

8. Sorguyu yazdıktan sonra, sağ üst köşede bulunan “TEST” butonu ile sorgunuzu test edin ve ardından “CREATE” butonuna tıklayarak özel aksiyonu oluşturun. 
9. Oluşturduğunuz aksiyonu sol panelde görüntüleyebilir, daha sonra düzenleyebilir, ismini değiştirebilir ve silebilirsiniz. 
10. Aksiyonu düzenlemek için aksiyonun üzerine gidin ve açılan üç noktaya tıklayın.

11. Ardından “Edit” seçimini yapın. 
12. Açılan ekranda, mevcut SQL sorgularını düzenleyebilir ve sağ üstte bulunan “Update” butonuna tıklayarak güncelleyebilirsiniz. 
13. Ayrıca aksiyonu silmek isterseniz, açılır menüde yer alan “Delete” seçeneğine tıklayın ve işlemi tamamlayın. 

Projelerde kullanılan özel aksiyonlar, ilişkili oldukları modül veya işlemlerden kaldırılmadan silinemez ve bu durumda hata mesajı görüntülenebilir. 

Kuika ile geliştirdiğiniz bir uygulamada, özel aksiyonlar oluşturarak uygulamanızın fonksiyonlarını artırabilirsiniz. Bu aksiyonları oluşturmak için “UI Design” modülündeki “Custom Actions” panelini veya “Datasources” modülündeki “Actions” bölümünü kullanabilirsiniz. 

Custom Actions panelini açın ve “SQL Action” seçimini yapın. 

1. Aksiyon İsimlendirme Alanı  

• Aksiyon adını “SQL Actions Name” alanına ekleyebilir veya güncelleyebilirsiniz. İsimlendirme İngilizce alfabe karakterleri ile “-” ve “_” işaretlerini kullanabilirsiniz. 

2. SQL Editor Panelini Tam Ekran Olarak Kullanma

• SQL Editor panelini tam ekran yaparak daha geniş bir alanda çalışabilir ya da standart boyutta kullanabilirsiniz. 

3. SQL Editor Kullanarak Sorgu Yazma

• Özel aksiyona ait SQL sorgusunu SQL Editor alanına yazarak aksiyon oluşturabilirsiniz. Kuika “Select”, “Save” ve “Delete” gibi temel sorguları hızlı bir şekilde eklemenizi sağlar. 

3.1. Add Select Query: Tablodaki kayıtları seçip belirli kriterlere göre listelemek için kullanılır. Örneğin, "SELECT * FROM tablo_adı" gibi bir sorgu oluşturulur.

3.2. Add Select By Id Query: Belirli bir ID’ye göre tablo içindeki tek bir kaydı seçmek için kullanılır. Örneğin, "SELECT * FROM tablo_adı WHERE id = belirli_id".

3.3. Add Save Query: Veritabanına yeni bir kayıt eklemek veya mevcut bir kaydı güncellemek için kullanılır. Öncelikle “Update” sorgusu ile mevcut kaydın varlığı kontrol edilir, ardından yeni veri güncellenir veya eklenir. Eğer kayıt yoksa “Insert Into” komutu devreye girer ve veri tablosunda yeni bir kayıt oluşturulur. 

3.4. Add Delete Query: Veritabanında belirli bir kaydı silmek için kullanılır. Örneğin, "DELETE FROM tablo_adı WHERE koşul ifadesi".

3.5. Add Search By Keyword Query: Tablodaki verileri belirli bir anahtar kelimeye göre aramak için kullanılır. Örneğin, "SELECT * FROM tablo_adı WHERE sütun_adı LIKE '%anahtar_kelime%'".

3.6. Add Search With Pagination Query: Kayıtları anahtar kelimeye göre aramak ve sonuçları sayfalara bölmek için kullanılır. LIMIT ve OFFSET parametreleri ile sayfalama yapılır. Örneğin, "SELECT * FROM tablo_adı WHERE sütun_adı LIKE '%anahtar_kelime%' LIMIT sayfa_boyutu OFFSET başlangıç"

4. Yapay Zeka Asistanı ile SQL Sorguları Oluşturma 

SQL sorgularını yazarken AI Asistanı’ndan yardım alabilirsiniz. “Generate with AI” butonuna tıklayın ve veri tablosunu Select Box üzerinden seçin. Oluşturmak istediğiniz sorguyu tanımlayan bir komut girin. Örneğin, “Öğelerin silinmesini sağlayan bir sorguya ihtiyacım var” şeklinde bir komut girin. Yapay zeka, sorguyu oluşturur ve kopyalayarak SQL Editor alanına yapıştırabilirsiniz. 

5. Sorguların SQL Editor’e Eklenmesi 

Yapay zeka tarafından oluşturulan sorguları SQL Editor alanına kopyalayarak kolayca ekleyebilirsiniz. 

6. Sorgu Sonuç Parametre Paneli 

SQL sorgularına ait parametreleri, sağ üstteki aç/kapat butonuyla Parametre Paneli’nde görüntüleyebilirsiniz. Panel, aksiyonunuzun parametrelerine göre dinamik olarak güncellenir. 

7. SQL Sorgularını Test Etme 

SQL sorgularını “TEST” butonu ile test edebilirsiniz. 

Tüm işlemleri tamamladıktan sonra “CREATE” (8) butonuna tıklayarak özel aksiyon oluşturma işlemini bitirebilirsiniz. 

Kuika platformunda SQL Editor’de “DECLARE” komutunu kullanarak değişken tanımlayabilirsiniz. Bu komut, bir değişkenin adını, veri tipini ve gerekirse başlangıç değerini belirtmenizi sağlar.

Genel DECLARE Formatı 

DECLARE @variable_name data_type;

• Burada, @variable_name adında bir değişken, belirtilen data_type türünde tanımlanır. data_type SQL veri tipidir (örneğin, nvarchar, int, bit vb.).

Değer Atama Yöntemleri 

Değişkene değer atamanın iki yolu vardır: 

1. SELECT ile Atama:‍

SELECT @variable = değer FROM table_name;

2. SET ile Atama:

SET @variable = değer;

Örnek 1: 

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

• Bu örnekte, @top1Product adında bir değişken tanımlanmış ve table_name tablosundan ilk ürün adı bu değişkene atanmıştır.

Örnek 2: 

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

• Bu örnekte, @rowCount adında bir değişken tanımlanmış ve table_name tablosundaki toplam satır sayısı bu değişkene atanmıştır.

Kuika Platformunda DECLARE Kullanımı 

Kuika platformunda SQL Editor’de “DECLARE” komutunu manuel olarak yazabileceğiniz gibi, Yapay Zeka Asistanı’ndan da destek alabilirsiniz. 

“Generate with AI” anahtarını aktifleştirerek, Search Box alanına ilgili tabloyu belirterek bir komut girebilirsiniz. Örneğin: 

• "Sadece aktif departmanları listelemek istiyorum bununla ilgili bir DECLARE komutu yaz" gibi bir komut ile sorguyu oluşturmasını sağlayabilirsiniz. Yapay zeka, ilgili DECLARE fonksiyonunu otomatik olarak üretecektir.

Bu sayede sorgunuzu hızlı ve kolay bir şekilde oluşturabilirsiniz.