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 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. Üst menüden Datasources modülünü açın.
3. Açılan Datasources ekranında mevcut veri kaynaklarınızı Recently modified ve Data sources sekmeleri altında görüntüleyebilir, Search by name alanı ile arama yapabilirsiniz.
4. Ekranın üst kısmındaki kartlardan Create a Function kartına tıklayın. Bu kart C#, TypeScript, Python, Java, Go ve Rust ile özel fonksiyon oluşturmanızı sağlar.
5. Açılan Development listesinden Python (Custom Python functions) seçeneğini belirleyin. Listede gezinmek için ↑/↓ tuşlarını, seçim yapmak için Enter tuşunu da kullanabilirsiniz.

6. Name alanına veri kaynağınız için bir isim girin (örn. userguidepython).
7. CREATE butonuna tıklayarak işlemi tamamlayın. İşlemden vazgeçmek için CANCEL butonunu, dil seçimine geri dönmek için < Python bağlantısını kullanabilirsiniz.

Not: Sol paneldeki Sources başlığının yanında yer alan + ikonu ile de yeni veri kaynağı ekleme işlemini başlatabilirsiniz.

Python Editör Ekranının Anatomisi

A. Üst Menü

• Geri Butonu (←): Datasources ekranına geri dönmenizi sağlar.
• Veri Kaynağı Adı: Oluşturduğunuz Python veri kaynağının adı (örn. userguidepython) Python ikonu ile birlikte görüntülenir. Yanındaki açılır ok ile veri kaynakları arasında geçiş yapabilir, kalem ikonu ile adı düzenleyebilirsiniz.
• CREATE Butonu: Hazırladığınız Python veri kaynağını kaydetmek için kullanılır.

B. Editör Araç Çubuğu

• Geri Al / Yinele: Yapılan değişiklikleri geri almanızı veya tekrar uygulamanızı sağlar.
• Kopyala / Yapıştır: Kodu kopyalamak ve editöre yapıştırmak için kullanılır.
• Kodu Düzenle (Tidy Up): Sihirli değnek ikonu ile yazılmış kodu düzenleyebilir, hizalayabilir ve okunabilir hale getirebilirsiniz.
• Satır Kaydırma (Word Wrap): Uzun satırların editör genişliğine göre alt satıra kaydırılmasını açıp kapatır.
• Yazı Boyutu (− 12 +): Editördeki yazı boyutunu küçültüp büyütmenizi sağlar; yanındaki ikon ile varsayılan boyuta dönebilirsiniz.
• External Libraries (BETA): Python kodunuzda kullanmak üzere harici kütüphaneler eklemenizi sağlayan açılır menüdü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. Menünün yanındaki yeşil onay ikonu, kodunuzun seçili sürümle geçerli olduğunu gösterir.

C. Python Editor

Kod yazma alanıdır. Tüm özel fonksiyonlar burada tanımlanır.

Varsayılan örnek yapı:

python

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. Kuika AI Paneli

Ekranın sağ tarafında yer alan yapay zekâ asistanıdır. Type here... alanına ihtiyacınızı yazarak Python aksiyonlarınız için kod önerisi alabilir, örneklerden yararlanabilirsiniz.

E. Test Console

Ekranın alt kısmında yer alan, yazdığınız fonksiyonları test etmek için kullanılan alandır. Sağındaki ok ile açılıp kapatılabilir.

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

Kodlarınızı doğrudan editör üzerinden manuel olarak yazabilirsiniz.

Örnek:

python

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

Kuika AI ile Kod Oluşturma

Sağ paneldeki Kuika AI alanına 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ü araç çubuğundaki PYTHON açılır menüsünden seçebilirsiniz (bkz. python_2.png ve python_1.png). 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 açılır menüsü ü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:

python

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ı açarak 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:

python

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 sağ üstteki 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.