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

TypeScript 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.

TypeScript 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 TypeScript (Custom TypeScript 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. userguidetypescript).
7. CREATE butonuna tıklayarak işlemi tamamlayın. İşlemden vazgeçmek için CANCEL butonunu, dil seçimine geri dönmek için < TypeScript 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.

TypeScript 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 TypeScript veri kaynağının adı (örn. userguidetypescript) TS 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 TypeScript 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 (SOON): Harici kütüphanelerin eklenmesi için ayrılmış alandır. SOON etiketiyle gösterilir; bu özellik henüz aktif değildir ve yakında kullanıma sunulacaktır. Yanındaki yeşil onay ikonu, kodunuzun geçerli olduğunu gösterir.

C. TypeScript Editor

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

Varsayılan örnek yapı:

typescript

class Userguidetypescript {
  static NewFunctionName(parameter1: string): string {
    // Your code here
    return parameter1;
  }
}

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

• Kodlar bir class içerisinde tanımlanır. Sınıf adı, veri kaynağının adından otomatik oluşturulur (örn. userguidetypescript → Userguidetypescript).
• Fonksiyonlar static olarak oluşturulur.
• Parametre alabilir.
• Parametre tipi belirlenebilir.
• Dönüş tipi 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 TypeScript aksiyonlarınız için kod önerisi alabilir, örneklerden yararlanabilirsiniz.

E. Test Console

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

Bu bölümde:

• Metod listesi görüntülenir.
• Parametre giriş alanları oluşur.
• Server / Client seçimi yapılabilir.
• Sonuç çıktısı görüntülenebilir.

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

Manuel Kod Yazma

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

Örnek:

typescript

class Userguidetypescript {
  static ToUpperCase(text: string): string {
    return text.toUpperCase();
  }
}

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 metod oluştur.

Parametre Tanımlama

Fonksiyonlarınıza parametre ekleyebilirsiniz.

Örnek:

typescript

static Sum(value1: number, value2: number): number {
  return value1 + value2;
}

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

Dönüş Tipi Belirleme

Fonksiyon tanımında dönecek veri tipi belirtilmelidir. Örnek tipler: string, number, boolean, object, any.

Test Console ile Metod Test Etme

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

1. Test etmek istediğiniz metodu seçin.
2. Parametre alanlarına örnek veri girin.
3. Server veya Client seçeneğini belirleyin.
4. Metodu çalıştırın.
5. Dönen sonucu kontrol edin.

Örnek:

typescript

static Hello(name: string): string {
  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 TypeScript veri kaynağını kaydedebilirsiniz. Kaydedilen veri kaynağı uygulama içerisinde kullanılabilir hale gelir.

Beklenen Çıktı / Sonuç

Bu adımlar tamamlandığında:

• TypeScript veri kaynağı Sources listesine eklenir.
• Tanımlanan metodlar sistemde kullanılabilir hale gelir.
• Özel iş kuralları kod ile yönetilebilir.
• Tekrar kullanılabilir fonksiyon yapısı oluşturulur.