Datasources Modülünde SQL Editor ile Özel Aksiyonlar Oluşturun

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.