Datasources Modülü

23/9/26

Kuika ile uygulama geliştirirken çeşitli veri kaynaklarını kullanabilirsiniz. MS SQL Server, PostgreSQL ve Oracle gibi veritabanlarına; Swagger, REST, OData ve SAP gibi API ve servislere ve MQTT broker'larına bağlanabilir, C#, TypeScript, Python, Java, Go, Rust veya Google Blockly ile kendi fonksiyonlarınızı yazabilirsiniz.

Datasources Modülünün İncelenmesi

Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
Üst navigasyon çubuğundaki Datasources simgesine tıklayın.

Açılan Datasources ana ekranında:

Üst kısımdaki Create a Database, Create an API ve Create a Function kartları ile yeni bir veri kaynağı oluşturabilirsiniz. (Bkz. Yeni Datasource Oluşturma)
Recently modified sekmesi son düzenlenen veri kaynaklarını, Data sources sekmesi projedeki tüm veri kaynaklarını listeler.
Search by name alanıyla isme göre arama yapabilir, sağdaki açılır menüyle listeyi türe göre filtreleyebilirsiniz.
Listede her veri kaynağının adı (Name), türü (Kind), tipi (Type) ve oluşturulma bilgisi (Created) görüntülenir. Ad sütununda veri kaynağındaki tablo ve aksiyon sayısı da gösterilir (örneğin "70 tables · 0 actions").

Listede varsayılan olarak Kuika tarafından oluşturulan Managed DB yer alır. Managed DB sayesinde ek bir veritabanı sunucusuna ihtiyaç duymadan uygulamanızı geliştirebilir ve yayınlayabilirsiniz.

Sol taraftaki Sources panelinde uygulamanızdaki veri kaynakları listelenir. Managed DB'yi genişlettiğinizde şu alt başlıklar görünür:

Actions: Veri kaynağına ait aksiyonlar. Yanındaki + simgesiyle yeni aksiyon ekleyebilirsiniz.
Tables: Veri kaynağındaki tablolar, şemalara göre gruplanmış olarak listelenir (örneğin dbo). Yanındaki + simgesiyle yeni tablo ekleyebilirsiniz.
Session Variables: Oturum değişkenleri. (Bkz. Session Variables)

Panelde ayrıca Document Parameters başlığı yer alır.

SQL Action Oluşturma

Sol panelde Actions başlığının yanındaki + simgesine tıklayın.
Açılan menüden New SQL Action seçeneğini seçin.

SQL editörü açılır. Sol üstteki alana aksiyon için bir ad girin ve yanındaki ✓ simgesiyle onaylayın.
Editöre SQL sorgunuzu yazın. Editörün araç çubuğunda geri al/yinele, kopyala/yapıştır, sorguyu biçimlendirme, satır kaydırma ve yazı boyutu ayarı seçenekleri bulunur.
Sorguyu kaydetmeden önce test etmek için sağ üstteki Run butonuna tıklayabilirsiniz. Sonuçlar editörün altındaki Result sekmesinde, hata ve bilgi mesajları Messages sekmesinde görüntülenir.
CREATE butonuna tıklayarak aksiyonu oluşturun. Editör boşken bu buton pasiftir.

Kuika AI ile SQL Sorgusu Oluşturma

Editörün sağındaki Kuika AI sekmesinden yapay zeka yardımıyla sorgu oluşturabilirsiniz:

Hazır örnek istemlerden birini seçin (örneğin "Write a SQL query to fetch all records from this table") veya alt kısımdaki alana kendi isteğinizi yazın.
Choose Table alanından sorgunun hangi tablo için oluşturulacağını seçin ve gönderin.
Kuika AI önerdiği sorguyu sağ panelde gösterir. Sorguyu kopyalayabilir veya editöre ekleyebilirsiniz.

Sorguda kullanılan parametreleri sağ paneldeki Parameters sekmesinden yönetebilirsiniz.

Aksiyonu Düzenleme ve Silme

Oluşturulan aksiyon sol panelde Actions başlığı altında görüntülenir.

Düzenlemek için: Aksiyonun üzerine gelip Edit seçeneğini kullanın. SQL sorgusunu düzenledikten sonra Update butonuna tıklayın.
Silmek için: Açılır menüdeki Delete seçeneğini kullanın.

Select Action Oluşturma

Sol panelde Actions başlığının yanındaki + simgesine tıklayın.
Açılan menüden New Select Action seçeneğini seçin.
Açılan pencerede aksiyona bir isim verin.
Veri kaynağını seçmek için + simgesine tıklayın.
Fields, Filter ve Sort Order alanlarında ihtiyacınıza uygun tanımlamaları yapın.

Tablo Oluşturma

Kuika ile veri kaynağına hızlı bir şekilde yeni bir tablo ekleyebilirsiniz.

Sol panelde Tables başlığının yanındaki + simgesine tıklayın.
Açılan ekranda sol üstteki alana tablonun adını girin ve ✓ simgesiyle onaylayın.
Columns sekmesinde tablonun sütunlarını tanımlayın. Her tablo, varsayılan olarak Guid tipinde ve birincil anahtar (PK) olarak işaretlenmiş bir Id sütunuyla başlar.

Tablonun son satırına yeni sütun bilgilerini girin. Her sütun eklendiğinde altında yeni bir boş satır açılır:
- Column Name: Sütun adı
- Type: Veri tipi
- Size: Metin gibi tiplerde maksimum uzunluk. MAX seçeneğiyle sınırsız uzunluk tanımlanabilir.
- Scale: Ondalıklı sayı tiplerinde ondalık basamak sayısı
- Required: Zorunlu alan olup olmadığı
- Unique: Değerin benzersiz olup olmadığı
- Default: Varsayılan değer

CREATE butonuna tıklayarak tabloyu oluşturun.

Sütun tipini yapay zeka önerisiyle belirlemek için Type alanının yanındaki Kuika AI (✦) butonunu kullanabilirsiniz.

Tabloyu Çevrimdışı Kullanıma Açma (Work Offline)

Sağ üstteki WORK OFFLINE anahtarını açarak tablonun mobil cihazlarda çevrimdışı çalışabilmesini sağlayabilirsiniz. Anahtar açıldığında iki seçenek sunulur:

Schema Only: Tablo çevrimdışı veritabanında yalnızca yapısıyla oluşturulur, veri içermez.
With data: Tablo, belirlediğiniz kriterlere göre filtrelenmiş verilerle birlikte oluşturulur.

With data seçeneğini seçtiğinizde şu ayarlar açılır:

Download filter: Sunucudan cihaza hangi kayıtların indirileceğini belirleyen sorgu.
Upload filter: Cihazdan sunucuya hangi kayıtların gönderileceğini belirleyen sorgu.
Filtrelerde @kuikauserid (oturum açan kullanıcının ID'si) ve @kuikausername (kullanıcı adı) parametrelerini kullanabilirsiniz.
Allow offline editing: Açık olduğunda, indirilen kayıtlar cihazda güncellenebilir ve bir sonraki senkronizasyonda sunucuya gönderilir. Kapalı olduğunda kayıtlar salt okunurdur.

Tabloyu Düzenlemek ve Silmek

Tabloyu düzenlemek için: Sol panelde tabloyu seçin ve üç noktaya tıklayın. Edit seçeneğini kullanarak mevcut tabloyu güncelleyebilirsiniz.
Tabloyu silmek için: Aynı menüdeki Delete seçeneğine tıklayın.

Session Variables

Sol paneldeki Session Variables başlığına tıklayarak oturum değişkenlerini tanımlayabilirsiniz. Açılan ekranda:

Key: Değişkenin adı
Value: Değişkenin değeri
Read Only: Değişkenin yalnızca okunabilir olup olmadığı

Tanımlamaları yaptıktan sonra SAVE butonuna tıklayın.

Yeni bir Datasources Oluşturma ve Datasources Tipleri

Yeni bir veri kaynağı oluşturmanın iki yolu vardır:

Datasources ana ekranındaki Create a Database, Create an API veya Create a Function kartlarından birine tıklayarak ilgili kategorideki tipleri listeleyebilirsiniz.
Sol paneldeki Sources başlığının yanındaki + simgesine tıklayarak tüm tipleri tek bir menüde görebilirsiniz.

Menülerde ok tuşlarıyla gezinip Enter tuşuyla seçim yapabilirsiniz.