Kuika’nın Get Source aksiyonu, bir kaynak (Source) sisteminde belirli bir correlationId değerine sahip kaynağı getirmenizi sağlar. Özellikle VectorSearch veya AI tabanlı içerik yönetimi entegrasyonlarında, daha önce kaydedilmiş vektör veya veri nesnelerini sorgulamak için kullanılır. Get Source aksiyonu, kayıtlı bir kaynağa hızlı erişim sağlar ve sistemdeki veri akışlarını yönetilebilir hale getirir.

Teknik Özellikler

• Kaynak Getirme: Belirtilen correlationId’ye ait kaynağı sistemden çeker.
• Opsiyonel Parametre Desteği: collectionName parametresi ile belirli bir koleksiyon içinden sorgulama yapılabilir.
• Doğrulama Kontrolü: Don’t trigger validations seçeneği ile veri doğrulama kontrolleri devre dışı bırakılabilir.
• Web ve Mobil Desteği: Aksiyon, hem web hem mobil uygulamalarda kullanılabilir.

Get Source Aksiyonu Uygulama Adımları

1. Kuika platformuna giriş yapın.
2. Çalışacağınız projeyi Apps ekranından açın.
3. UI Design modülüne geçin ve kullanmak istediğiniz ekranı seçin.

4. Sağ kenardaki Properties Panel üzerinden + ADD ACTION menüsüne tıklayın.
5. Açılan menüden Searching > Get Source aksiyonunu seçin.
6. Aksiyon parametrelerini yapılandırın.

Aksiyon Parametrelerini Yapılandırma

• correlationId (String - Zorunlu): Getirilecek kaynağın benzersiz kimliğidir. Bu değer, genellikle daha önce Save Source aksiyonu ile oluşturulmuş bir kaynağa aittir. Değer sabit (Fixed Value) olarak girilebilir ya da dinamik olarak Symbol Picker aracılığıyla bağlanabilir.

• collectionName (String - Opsiyonel): Kaynağın ait olduğu koleksiyonun adını belirtir. Eğer belirtilmezse sistem varsayılan koleksiyon üzerinden sorgulama yapar.

collectionName parametresi, aynı sistem içinde birden fazla koleksiyon (örneğin “Users”, “Documents”, “Embeddings”) bulunduğunda kullanılmalıdır.

Kullanım Senaryosu: Kaynak Detaylarını Görüntüleme

Bir uygulama yöneticisi, sistemde daha önce kaydedilmiş bir metin vektörünü veya kullanıcı kaynağını detaylı olarak görüntülemek istiyor.

Senaryo Adımları:

1. Yeni bir ekran oluşturun (örneğin “Kaynak Detayları”).
2. Ekrana bir Text Input (correlationId girişi için) ve bir Button ekleyin.
3. Butonun aksiyonuna Get Source ekleyin.
4. Parametre olarak correlationId alanına, kullanıcıdan alınan değeri bağlayın.
5. Opsiyonel olarak collectionName alanına “UserVectors” yazın.
6. Aksiyon çalıştırıldığında, belirtilen correlationId’ye sahip kaynak sistemden çekilir ve sonuç ekranda gösterilir.

Get Source Aksiyonu İleri Seviye Özelleştirmeler

• Dinamik correlationId: correlationId değeri, kullanıcı girişinden, başka bir aksiyonun sonucundan veya API cevabından alınabilir.
• Collection Bazlı Filtreleme: collectionName parametresiyle sadece belirli koleksiyonlarda arama yaparak performans artırılabilir.
• Veri Önizleme: Aksiyon sonucundaki veriler, Label, Table veya ListView gibi elementlerde dinamik olarak görüntülenebilir.
• Otomatik Yükleme: Aksiyon, sayfa açıldığında Initial Actions bölümünde tetiklenerek otomatik olarak veri yükleyebilir.

Teknik Riskler

• Geçersiz Correlation Id: correlationId değeri yanlış veya sistemde bulunmuyorsa, aksiyon boş sonuç döndürür.
• Eksik Koleksiyon Bilgisi: collectionName yanlış girildiğinde, kaynak bulunamayabilir.
• Yetkisiz Erişim: Kaynak erişimi kullanıcı rolüyle kısıtlanmışsa, aksiyon hata dönebilir.
• Veri Senkronizasyonu: Aynı correlationId farklı koleksiyonlarda tekrarlandığında, sistem son kaydı döndürebilir.

Get Source aksiyonu, Kuika platformunda kayıtlı kaynaklara (Source) erişmek ve dinamik veri yönetimini sağlamak için kullanılan güçlü bir sorgulama aracıdır. Save Source, List Sources ve Delete Source aksiyonlarıyla birlikte kullanıldığında, tam kapsamlı bir veri yaşam döngüsü (CRUD) yönetimi oluşturur.