Python veri kaynağı, Kuika platformunda özel fonksiyonlar ve iş mantıkları geliştirmenizi sağlayan entegrasyon yöntemlerinden biridir. Python kullanarak uygulamanız içerisinde özel işlemler tanımlayabilir, parametre alan fonksiyonlar oluşturabilir ve bu fonksiyonları uygulama akışlarında kullanabilirsiniz.

Python veri kaynağı sayesinde hazır aksiyonların dışında kalan ihtiyaçlar için özel kod yazabilir, veri işleme süreçlerini özelleştirebilir ve tekrar kullanılabilir fonksiyonlar oluşturabilirsiniz.

Python veri kaynağı özelliğini kullanabilmek için uygun abonelik planına sahip olmanız gerekebilir. Daha gelişmiş geliştirme araçlarına erişmek için aboneliğinizi yükseltebilirsiniz.

Python ile Uygulamanıza Veri Kaynağı Bağlantısı Ekleyin

1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. Data Sources modülünü açın.

• Burada mevcut veri kaynaklarını görebilir ve yeni veri kaynağı ekleyebilirsiniz.

3. Sol panelde Sources başlığı yanındaki + ikonuna tıklayın.
4. Python seçeneğini belirleyin.
5. Veri kaynağınız için bir isim girin.
6. CREATE butonuna tıklayarak işlemi tamamlayın.

Python Action Modalının Anatomisi

A. Üst Menü

• Başlık (Python Action): Modalın başlığı, oluşturulan veri kaynağının Python tabanlı bir aksiyon olduğunu belirtir.
• CREATE Butonu: Hazırladığınız Python veri kaynağını kaydetmek için kullanılır.
• Kapat Butonu (X): Ekranı kapatmak ve işlemden çıkmak için kullanılır.

B. Üst Ayarlar Alanı

• Name: Fonksiyonunuzun ne işe yaradığına dair açıklama girebileceğiniz bir alandır. Diğer geliştiricilerin veya ileride sizin kodun amacını hatırlamanıza yardımcı olur.
• External Libraries (BETA): Python kodunuzda kullanmak üzere harici kütüphaneler eklemenizi sağlayan alandır. Şu anda BETA etiketiyle sunulmaktadır.

• Python version: Kodunuzun hangi Python (CPython) sürümüyle çalıştırılacağını belirlemenizi sağlayan açılır menüdür. Desteklenen sürümler:
  
  • CPython 3.14.6
  • CPython 3.13.14
  • CPython 3.12.13
  • CPython 3.11.15
  • CPython 3.10.20
• Varsayılan olarak en güncel sürüm (CPython 3.14.6) seçili gelir; ihtiyacınıza göre daha eski bir sürüm seçilebilir.
• Generate with AI: Yapay zekâ desteği ile otomatik Python kodu oluşturmak için kullanılan seçenektir. Açık konuma getirildiğinde sistemden kod önerisi alınabilir.

C. Python Editor

• Kod yazma alanıdır.
• Tüm özel fonksiyonlar burada tanımlanır.
• Varsayılan örnek yapı:

def new_function(parameter1: str) -> str:    # Your code here    return parameter1

Bu yapı aşağıdakileri gösterir:

• Fonksiyonlar def anahtar kelimesi ile tanımlanır.
• Parametre alabilir.
• Parametre tipi type hint (: str) ile belirlenebilir.
• Dönüş tipi -> str şeklinde tanımlanabilir.
• Fonksiyon gövdesinde açıklama satırı (# Your code here) ile kodunuzu yazacağınız alan işaretlenmiştir.

D. TIDY UP Butonu

• Kod editörünün sağ üst bölümünde yer alır.
• Yazılmış kodu düzenlemek, hizalamak ve okunabilir hale getirmek için kullanılır.

E. Test Console

• Ekranın alt kısmında yer alan, yazdığınız fonksiyonları test etmek için kullanılan alandır.
• Bu bölümde:
  
  • Fonksiyon listesi görüntülenir.
  • Parametre giriş alanları oluşur.
  • Sonuç çıktısı görüntülenebilir.

Python Veri Kaynağı Ayarlarını Yapılandırma

Manuel Kod Yazma

Generate with AI kapalıysa tüm kodlar doğrudan editör üzerinden manuel olarak yazılır.

Örnek:

def to_upper_case(text: str) -> str:    return text.upper()

AI ile Kod Oluşturma

Generate with AI özelliğini aktif ederseniz, açıklama yazarak otomatik kod oluşturabilirsiniz.

Örnek komut:

Girilen metni büyük harfe çeviren fonksiyon oluştur.

Python Version Seçimi

Kodunuzun çalışacağı CPython sürümünü Python version açılır menüsünden seçebilirsiniz. Farklı sürümler arasında dil özellikleri veya kütüphane uyumluluğu farklılık gösterebileceğinden, projenizin ihtiyaçlarına uygun sürümü seçmeniz önerilir.

External Libraries Kullanımı (BETA)

External Libraries alanı üzerinden, standart Python kütüphanelerinin dışında ek paketler projenize dahil edilebilir. Bu özellik şu an BETA aşamasındadır.

Parametre Tanımlama

Fonksiyonlarınıza parametre ekleyebilirsiniz.

Örnek:

def sum_numbers(value1: float, value2: float) -> float:    return value1 + value2

Bu fonksiyon iki sayı alır ve toplamını döndürür.

Dönüş Tipi Belirleme

Fonksiyon tanımında dönecek veri tipi -> işareti ile belirtilmelidir.

Örnek tipler:

• str
• int
• float
• bool
• dict
• list
• Any

Test Console ile Fonksiyon Test Etme

Kodunuzu yazdıktan sonra alt bölümdeki Test Console alanını kullanabilirsiniz.

1. Test etmek istediğiniz fonksiyonu seçin.
2. Parametre alanlarına örnek veri girin.
3. Fonksiyonu çalıştırın.
4. Dönen sonucu kontrol edin.

Örnek:

def hello(name: str) -> str:    return "Hello " + name

Parametre: Kuika Beklenen çıktı: Hello Kuika

CREATE ile Veri Kaynağını Kaydetme

Kodunuzu tamamladıktan ve test ettikten sonra CREATE butonuna tıklayarak Python veri kaynağını kaydedebilirsiniz. Kaydedilen veri kaynağı uygulama içerisinde kullanılabilir hale gelir.

Beklenen Çıktı / Sonuç

Bu adımlar tamamlandığında:

• Python veri kaynağı Sources listesine eklenir.
• Tanımlanan fonksiyonlar sistemde kullanılabilir hale gelir.
• Özel iş kuralları kod ile yönetilebilir.