1. Kuika platformunda projenizi açın.
2. Apps ekranından çalışacağınız projeyi seçin.
3. UI Design modülünde ilgili ekranı açın.
4. Sağ kenardaki Properties panelinden + ADD ACTION menüsüne tıklayın.

5. + ADD ACTION menüsünden istediğiniz tetikleyici olaya (Initial Actions, OnClick, OnBlur vb.) göre String > Substring aksiyonunu ekleyin.
6. Açılan ayarlar panelinde aşağıdaki alanları doldurun:

• Value: Alt metin çıkarılacak olan tam metin.
• Starting Index: Alt metnin başlayacağı pozisyon (0 tabanlı indeksleme).
• Count: Alt metne dahil edilecek karakter sayısı.

Bu alanlar, Symbol Picker aracılığıyla sabit değerler, form girdileri veya aksiyon sonuçlarından bağlanabilir.

Bir kayıt formunda, kullanıcının girdiği adın ilk 3 harfini alıp kullanıcı kodu üretmek istiyorsunuz.

Senaryo akışı:

• Kullanıcı adı fullname alanına "John" yazdı.
• Substring aksiyonunda:
  
  • Value: FormComponent.fullname
  • Starting Index: 0
  • Count: 3
• Aksiyon sonucu "Joh" olarak döner.
• Bu değer kullanıcı ID’si üretiminde kullanılabilir: ID-Joh-2025

• Dinamik Başlangıç: Başlangıç indeksi, metin içinde bir karakterin konumuna göre belirlenebilir (örneğin, @ karakterinden sonrası).
• Koşullu Alt Metin: Eğer metin uzunluğu belirli bir değeri aşıyorsa, sadece ilk X karakter alınabilir.
• Substring + Concat Kombinasyonu: Substring ile alınan parça başka bir metinle birleştirilerek yeni değerler oluşturulabilir (örneğin, kullanıcı adı + ID).

Teknik Riskler 

• Geçersiz İndeks Hatası: Starting Index ve Count değerlerinin, metnin uzunluğunu aşmamasına dikkat edilmelidir. Aksi halde sistem hata verebilir veya boş değer dönebilir.
• Negatif Değer Kullanımı: Negatif indeksler desteklenmez. Değerlerin sıfır veya pozitif olması gerekir.
• Boş veya Tanımsız Metin: Value alanı boş veya null ise aksiyon çalışmaz. Metnin doluluğu önceden kontrol edilmelidir.
• Tür Uyumsuzluğu: Sayı beklenen alanlara metin girilmesi (veya tam tersi) sistemde beklenmedik hatalara yol açabilir.
• Dil ve Karakter Desteği: Özel karakterler veya çok baytlı karakterler (örneğin: emoji, Türkçe karakterler) bazı sistemlerde beklenenden fazla karakter sayılabilir. Uyum testi önerilir.

Substring, uygulamalarınızda metin tabanlı işlemleri parçalara ayırarak yönetmek ve düzenlemek için ideal, güçlü ve esnek bir aksiyondur. Özellikle form doğrulama, kullanıcı adı üretimi, içerik filtreleme gibi senaryolarda sıklıkla kullanılır.

‍