Kuika'nın Config Manager modülünü, geliştirdiğiniz uygulamanın oluşturulması sırasında kullanılacak tanımları yapılandırmak, uygulamayı ön izlemek, test etmek ve yayınlamak için kullanabilirsiniz. Bu eğitim içeriğinde Config Manager modülü aracılığıyla uygulamanızın oluşturulması sırasında kullanılacak tanımları nasıl yapılandırabileceğinizi öğreneceksiniz.
Uygulamanıza Konfigürasyon Ekleyin
Yeni bir konfigürasyon oluşturmak için:
Kuika platformuna giriş yapın.
Apps ekranından çalışacağınız projeyi açın.
Üst menüden Config Manager modülüne tıklayın.
Create a blank configuration kartına tıklayın.
Konfigürasyona bir isim verin ve oluşturma işlemini tamamlayın.
Böylece uygulamanıza yeni bir konfigürasyon eklemiş olursunuz.
Configuration Manager Modülünün Anatomisi
Kuika platformunda üst menüden Config Manager modülüne geçiş yaptığınızda, konfigürasyonlarınızı listeleyebileceğiniz ve yenilerini oluşturabileceğiniz ana ekran karşınıza çıkar.
1. Konfigürasyon Oluşturma Alanı
Create a blank configuration: Test, staging veya production gibi farklı ortamlar için yeni ve boş bir konfigürasyon oluşturmanızı sağlar.
2. Filtreleme ve Arama Alanı
Recently modified: Son düzenlenen konfigürasyonları listeler.
Project: Açık olan uygulamaya özel hazırlanmış konfigürasyonları listeler.
Global: Workspace genelinde kullanılabilen konfigürasyonları listeler.
Search: Konfigürasyonlar arasında isme göre arama yapmanızı sağlar.
3. Konfigürasyon Listesi
Oluşturulan konfigürasyonlar aşağıdaki bilgilerle listelenir:
Scope: Konfigürasyonun kapsamı (Project veya Global).
Status: Konfigürasyonun durumu.
Last modified: Konfigürasyonu son düzenleyen kullanıcı ve düzenleme zamanı.
Henüz bir konfigürasyon eklenmediyse listede No configurations have been added yet. mesajı görüntülenir. Bir konfigürasyonu düzenlemek için listeden adına tıklamanız yeterlidir.
Konfigürasyon Ekranının Anatomisi
Kuika'da geliştirilen bir uygulamayı ön izlemek ve yayınlamak için bir konfigürasyona ihtiyacınız vardır. Bir konfigürasyonu açtığınızda karşınıza aşağıdaki alanlardan oluşan konfigürasyon ekranı çıkar.
Üst Bar
Geri ok: Config Manager ana ekranına dönmenizi sağlar.
İsim alanı: Konfigürasyonun adını gösterir. Yanındaki düzenleme (kalem) ikonuyla adı değiştirebilirsiniz.
Sekmeler: Ayarları platforma göre gruplar: App Settings, Web, iOS, Android ve Desktop App. iOS ve Android sekmeleri mobil uygulama projelerinde görüntülenir.
Save: Yapılandırma ayarlarını kaydeder. Mevcut bir konfigürasyonda bu buton Update olarak görünür.
Sol Panel
Search settings: Ayarlar arasında arama yapmanızı sağlar (kısayol: ⌘F).
Ayar menüsü: Seçili sekmeye ait ayarları kategoriler hâlinde listeler.
Orta Panel
Sol menüden seçilen ayarın alanlarını içerir. Pek çok ayarda kayıtlı yapılandırmalar Choose Configuration açılır menüsünden seçilir; yeni bir yapılandırma ise menünün altındaki Add New bağlantısıyla eklenir. Bağlantının yanındaki sayı, kayıtlı yapılandırma sayısını gösterir.
Sağ Panel
App Settings sekmesinde: Konfigürasyona not ekleyebileceğiniz Description alanı ve seçili ayarla ilgili bilgi veren About alanı yer alır.
Platform sekmelerinde: Platform desteğini açıp kapatabileceğiniz Platform alanı ve ikon, splash gibi platforma özel seçenekler yer alır.
App Settings Modalı Anatomisi
App Settings sekmesi, uygulamanızın tüm platformlarda ortak olarak kullanılan ayarlarını içerir. Ayarlar sol menüde aşağıdaki kategoriler altında gruplanır.
CONNECTIVITY
Connection Settings: Uygulamanızın veritabanı ve backend bağlantı ayarlarını içerir.
DB connection string: Uygulamanızın veritabanına bağlanmak için gereken bilgileri içeren dizidir. Genellikle sunucu adresi, veritabanı adı, kullanıcı adı ve şifre bilgilerini içerir.
Backend URL: Uygulamanızın backend hizmetlerine erişmek için kullanılan URL'dir.
Backend URL ayarları "IP" ve "Port" bilgilerini kabul etmektedir.
File Upload Path: Yüklenen dosyaların sunucuda hangi dizinde saklanacağını belirtir. Örneğin, yüklenen belgeler için /upload/user_documents/ gibi bir yol belirlenebilir.
SAP Service Base URL: Uygulamanızın SAP servislerine bağlanmak için kullandığı temel URL'dir.
Datasource Configurations: Uygulamanızın kullandığı veri kaynaklarına ait bağlantı ayarlarını yapılandırmanızı sağlar.
Rate Limiting: Uygulamanıza belirli bir süre içinde yapılabilecek istek sayısını sınırlandırmanızı sağlar.
STORAGE & SEARCH
Document Management: Uygulamanızdaki doküman yönetimi ayarlarını içerir.
Full-Text Search Engine: Uygulamanızda tam metin arama yapılabilmesi için kullanılacak arama motoru ayarlarını içerir.
Bucket Upload: Uygulama tarafından yüklenen dosyaların bulut ortamında saklanmasını sağlar.
Name: Bucket için verilen isim.
Type: Kullanılacak bulut sağlayıcı (AWS veya Google).
Encryption Key: Dosyaların şifrelenmesi için kullanılan anahtar.
Encryption IV: Şifreleme sırasında kullanılan başlangıç vektörü (Initialization Vector).
Cache Settings: Veri önbellekleme ve hızlı erişim sağlayarak uygulamanın veri performansını artırır.
Name: Cache konfigürasyonu için verilen isim.
Type: Kullanılacak veri sağlayıcı tipi:
Redis: Bellek tabanlı, hızlı veri erişimi ve önbellekleme sağlar.
Mongo: NoSQL, belge tabanlı veritabanıdır. Esnek ve ölçeklenebilirdir.
SQL: İlişkisel veritabanıdır; güçlü sorgulama ve tablo yapısı sunar.
Memory: Veriyi geçici bellekte saklar; uygulama kapatıldığında veriler silinir.
Connection Settings: Cache'in bağlanacağı sunucu ve kimlik doğrulama bilgileri.
Search Service: Uygulamalarınızda veri arama ve yönetim işlemleri için kullanılır.
Name: Oluşturulan konfigürasyon için belirlenen isimdir.
Base Url: Arama servisiyle bağlantı kurulmasını sağlayan temel URL'dir. Uygulamanın Search Service API'si üzerinden arama sorguları gönderip sonuç almasını sağlar.
Vector Database Service Port: Vektör tabanlı veritabanı hizmetinin kullandığı port numarasıdır. Büyük ve karmaşık veri kümelerinde benzerlik tabanlı arama (ör. metin tabanlı aramalar) yapmak için kullanılır.
Python Service Port: Arama servisinin vektör veritabanı ile iletişimini sağlayan Python servisinin kullandığı port numarasıdır. Kaynak ekleme ve arama gibi işlemlerin yerine getirilmesini sağlar.
Storage Path: Arama hizmetine ait verilerin, indekslerin ve sonuçların depolandığı dizini belirtir.
IDENTITY & ACCESS
Authentication & Authorization: Kimlik doğrulama ve yetkilendirme ayarlarını içerir.
Password Policy: Şifrenin uzunluğunu, karmaşıklığını ve değiştirilme sıklığını belirlemenizi sağlar. Bu ekranda yapılan hatalı girişler warning notification olarak görüntülenir; böylece kullanıcı uyarılır ve işlem akışı kesilmez.
Google: Google hesaplarıyla uygulamanızda oturum açılabilmesini sağlar.
Facebook: Facebook hesaplarıyla uygulamanıza giriş yapılabilmesini sağlar.
MSAL: Microsoft hesaplarıyla kimlik doğrulama işlemleri yapılmasını sağlar.
OTP: İki faktörlü doğrulama süreçlerinde kullanılan tek kullanımlık şifredir.
2F Auth: Aktif hâle getirildiğinde kimlik doğrulama süreci iki aşamalı hâle gelir. İlk aşama genellikle bir şifre, ikinci aşama ise OTP güvenlik kodudur.
2 Auth Duration: İki faktörlü kimlik doğrulama sürecinde ikinci aşama olan OTP veya güvenlik kodunun geçerlilik süresidir.
Expire Old Sessions Upon New Login: Bir kullanıcı aynı hesapla yeni bir oturum açtığında, o hesaba ait eski oturumların otomatik olarak sonlandırılmasını sağlayan güvenlik özelliğidir.
Authentication Cookies: Kimlik doğrulama sürecinde kullanılan çerez ayarlarını içerir.
INTEGRATIONS
Mail: E-posta gönderme, alma ve yönetme hizmetlerini sağlar. Farklı e-posta sağlayıcılarını tanımlayarak uygulamanızda güvenli ve yönetilebilir bir e-posta altyapısı kurabilirsiniz. Desteklenen sağlayıcılar:
SMTP: Standart e-posta protokolü ile gönderim sağlar.
AWS (Amazon Web Services SES): AWS Simple Email Service üzerinden gönderim sağlar.
Exchange Server: Microsoft Exchange sunucusu üzerinden gönderim, alma ve yönetim hizmetleri sağlar.
AI: Uygulamanızdaki yapay zekâ fonksiyonları için kullanılacak servislerin ayarlarını içerir. OpenAI, Azure OpenAI, Gemini ve Serper Tool yapılandırmaları bu alandan tanımlanır.
Payment Method: Ödeme yöntemlerini içerir.
Stripe: Çevrimiçi ödeme işlemleri için kullanabileceğiniz uluslararası ödeme platformudur.
Iyzico: Türkiye merkezli, çevrimiçi ödemeleri yönetmenizi kolaylaştıran ödeme platformudur.
Param: E-ticaret siteleri, mobil uygulamalar ve diğer dijital platformlar için çeşitli ödeme yöntemleri sunar.
WhatsApp Business: WhatsApp Business API entegrasyon bilgilerini içerir. WhatsApp Business API, işletmelerin müşterileriyle daha verimli iletişim kurmalarını sağlayan bir hizmettir. Gerekli bilgilere Meta for Developers (Facebook for Developers) platformu üzerinden ulaşabilirsiniz.
WhatsApp Business hesabı ve uygulama bilgileri için:
Bir WhatsApp Business hesabı oluşturun.
Meta for Developers üzerinden bir uygulama (App) oluşturun.
Config Manager'da WhatsApp Business ayarını açın ve Add New bağlantısıyla aşağıdaki bilgileri girin:
Name: Yapılandırmaya verilecek tanımlayıcı isimdir.
Account Id: WhatsApp Business hesabınızı tanımlayan benzersiz kimlik numarasıdır. Tüm WhatsApp konfigürasyonlarında aynı olmalıdır.
App Id: Meta for Developers üzerinden oluşturulan uygulamanın benzersiz kimliğidir ve API'ye erişimde kullanılır.
App Secret: Uygulamanızın güvenliğini sağlamak için kullanılan gizli anahtardır.
Access Token: WhatsApp API'ye erişim sağlamak için kullanılan doğrulama anahtarıdır. Süreli ya da süresiz olarak alınabilir. Süreli olarak alınırsa, süresi dolduğunda Kuika ile oluşturulmuş uygulama üzerinden mesaj gönderilemez.
Phone Number Id: WhatsApp Business hesabınıza bağlanmış telefon numarasının benzersiz kimlik numarasıdır.
Version Number: Kullanılan WhatsApp Business API sürümünü belirtir. Varsayılan değer v21.0'dır.
Mesaj gönderimi ve template kullanımı:
WhatsApp yönetim paneli üzerinden bir mesaj şablonu oluşturulur ve WhatsApp onayı alınır.
Şablon örneği:
Başlık: Teklif Durumu Hakkında
Mesaj: Tebrikler! Süreciniz olumlu sonuçlanmıştır. Teklifimizi kabul edip etmediğinizi belirtmek için aşağıdaki butonlardan birini seçiniz.
Butonlar: Kabul Ediyorum, Reddetmek İstiyorum
Onaylı şablonlar Kuika üzerindeki Send WhatsApp Business Message aksiyonu ile gönderilir. Detaylı bilgi için ilgili içeriğimizi inceleyebilirsiniz.
Template türleri: WhatsApp mesaj şablonlarındaki parametreler, şablon Meta tarafında oluşturulurken seçilir. Bu parametreler Kuika'ya otomatik olarak gelir ve burada ayarlanarak mesaj gönderilebilir.
Butonlu template'ler: Yalnızca dış atamaya sahip adımlarda kullanılabilir.
Butonsuz template'ler: Sürecin her aşamasında kullanılabilir.
Kuika şu anda yalnızca Quick Reply (hızlı yanıt) butonlarını desteklemektedir. Diğer buton türleri kullanılamaz.
Quick Reply kullanımı:
Süreci ilerletmek için kullanılan butonlar Quick Reply (custom) tipinde olmalıdır.
Her buton bir mail interaction ile eşleştirilmelidir.
Invers CloudBoxx: Invers CloudBoxx entegrasyonu için gerekli ayarları içerir.
Google reCAPTCHA: Spam ve kötüye kullanım gibi etkinlikleri önlemek için kullanılır.
Name: reCAPTCHA konfigürasyonu için belirlenen isimdir.
Site Key: reCAPTCHA'nın uygulamanızda çalışmasını sağlayan açık anahtardır.
Secret Key: reCAPTCHA doğrulama işlemlerinde sunucu tarafında kullanılan özel anahtardır.
MCP: Uygulamanızın kullanacağı MCP (Model Context Protocol) sunucularının ayarlarını içerir.
OPERATIONS
Swagger UI: Uygulamanızın API'lerini görüntüleyip test edebileceğiniz Swagger UI arayüzüne ait ayarları içerir.
Elastic APM: Uygulamanın çalışma anındaki (runtime) performansını, transaction sürelerini, hata ve exception kayıtlarını izlemek için kullanılır. Elastic APM (Application Performance Monitoring) ayarları sayesinde uygulama içindeki işlemler servis bazlı olarak takip edilebilir, performans darboğazları analiz edilebilir ve farklı ortamlar (production, development vb.) için ayrıştırılmış izleme yapılabilir. Bu ayarlar uygulama Preview veya Run edildiğinde aktif olur ve Elastic APM Server ile entegrasyon kurularak uygulamanın gerçek zamanlı performans verilerinin merkezi olarak toplanmasını sağlar.
Notify Actions: Uygulamanızdaki bildirimlerin ve uyarıların yönetimini sağlar.
Name: Bildirim konfigürasyonu için verilen addır.
Default Duration: Bildirimlerin varsayılan olarak ekranda ne kadar süre görüntüleneceğini belirler.
Success Duration: Başarıyla tamamlanan işlemler sonrasında gösterilen bildirimlerin ekranda kalma süresini belirtir.
Info Duration: Bilgilendirme amaçlı gösterilen bildirimlerin süresini belirtir.
Warning Duration: Uyarı mesajlarının ne kadar süreyle görüneceğini belirler.
Error Duration: Hata mesajlarının gösterileceği süreyi belirtir.
Deeplink Setting: Uygulamanızın belirli bir ekranına doğrudan bağlantı (deep link) ile erişilebilmesi için gerekli ayarları içerir.
Date & Time Formats: Uygulamada tarih ve saat bilgilerinin hangi formatta gösterileceğini belirler.
Date Format: Tarih sıralamasını belirler. Örnek formatlar:
MM/DD/YYYY (07/09/2025)
DD-MM-YYYY (09-07-2025)
YYYY.MM.DD (2025.07.09)
Time Format: Saatin 24 saatlik veya 12 saatlik (AM/PM) düzende gösterilmesini seçmenizi sağlar. Örnek formatlar:
HH:MM (14:30)
HH:MM AM/PM (02:30 PM)
Uygulamanızı Platform Sekmeleri Aracılığıyla Yapılandırın
Web Uygulamalarınızı Yapılandırın
Config Manager modülünde bir konfigürasyon oluşturun veya mevcut bir konfigürasyonu açın.
Üst kısımdaki Web sekmesine tıklayın.
Sağ paneldeki Platform bölümünde Support Web UI seçeneğinin aktif olduğundan emin olun.
Sol menüdeki WEB APP başlığı altında yer alan ayarları yapılandırın:
Host Settings: Uygulamanın ön yüzü (frontend) farklı bir konumda barındırılıyorsa, barındırıldığı sunucunun URL'sini Frontend Url alanına girebilirsiniz. Bu alan isteğe bağlıdır.
Sessions: Uygulamanızın son kullanıcıları için web uygulamasının oturum zaman aşımı süresini belirlemenizi sağlar.
Maps: Web uygulamanızda harita kullanımı varsa harita ayarlarını oluşturabilir ve harita için gerekli bilgileri girebilirsiniz.
Push Notification: Web uygulamanızda push bildirimleri kullanmak için gerekli ayarları içerir.
KuikAgents Integration: Web uygulamanızın KuikAgents ile entegrasyon ayarlarını içerir.
Meta Description: SEO ve sosyal paylaşım önizlemelerinde kullanılan açıklamadır.
Favicon: Tarayıcı sekmesinde ve yer imlerinde görünen uygulama ikonudur. 32x32 px boyutunda JPG, JPEG, PNG veya ICO dosyası yüklenebilir.
PWA Install:Enable installable PWA seçeneği aktif edildiğinde, kullanıcılar uygulamayı Progressive Web App olarak cihazlarına yükleyebilir.
Save butonuna tıklayarak ayarlarınızı kaydedin.
iOS Uygulamalarınızı Yapılandırın
Config Manager modülünde bir konfigürasyon oluşturun veya mevcut bir konfigürasyonu açın.
Üst kısımdaki iOS sekmesine tıklayın.
Sağ paneldeki Platform bölümünde Support iOS UI seçeneğini aktif edin.
Sol menüdeki ayarları yapılandırın:
APP
Mobile App Settings: Apple App Store'da kullanacağınız uygulama adı (App Name), Bundle ID ve uygulama sürümü (Version) bilgilerini gireceğiniz alandır. Haptic Enabled seçeneği ile uygulamada dokunsal geri bildirimi etkinleştirebilirsiniz.
Apple Sign In Settings: Uygulamanızda Apple hesaplarıyla giriş yapılabilmesi için gerekli ayarları içerir.
App Store Settings: Uygulamanızı App Store'a bağlamak için gerekli ayarları içerir.
Firebase Settings: Firebase platformunun sunduğu hizmetleri ve özellikleri uygulamanıza entegre etmenizi sağlar.
Maps: Android uygulamanızda harita kullanımı varsa harita ayarlarını oluşturabilir ve gerekli bilgileri girebilirsiniz.
Push Notification: Push bildirimleri göndermek için son kullanıcılara gösterilecek izin metnini tanımlayabilirsiniz.
Google reCAPTCHA: Android uygulamanızda kullanılacak reCAPTCHA ayarlarını içerir.
Sağ panelde aşağıdaki alanları düzenleyin:
Options
Orientation: Uygulamanın ekran yönünü belirler. All orientation, landscape ve portrait seçenekleri kullanılabilir.
Devices: Uygulamanın hangi cihaz türlerinde çalışacağını belirler. All, phones ve tablet seçenekleri kullanılabilir.
App Icons: 32x32 px boyutunda PNG dosyası olarak yüklenir. Square (kare) ve Round (yuvarlak) olmak üzere iki ikon tanımlanabilir.
Splash
Image: Uygulama açılışında gösterilecek görseldir.
Fitting: Splash ekranında kullanılan görselin ekran boyutuna nasıl uyarlanacağını belirler. Default ve Stretch seçenekleri kullanılabilir.
Color: Splash ekranında kullanılacak arka plan rengidir.
Save butonuna tıklayarak ayarlarınızı kaydedin.
Desktop Uygulamalarınızı Yapılandırın
Config Manager modülünde bir konfigürasyon oluşturun veya mevcut bir konfigürasyonu açın.
Üst kısımdaki Desktop App sekmesine tıklayın.
Sağ paneldeki Platform bölümünde Support Desktop App seçeneğini aktif edin. Bu seçenek, Windows, macOS ve Linux için platformlar arası masaüstü uygulamaları derlemenizi sağlar.
Sol menüdeki DESKTOP APP başlığı altında yer alan ayarları yapılandırın:
Desktop App Settings: Masaüstü uygulamanız için kullanılacak uygulama adı (App Name), uygulama kimliği (App ID, ör. com.company.myapp) ve sürüm (Version) bilgilerini gireceğiniz alandır.
Target Platforms: Uygulamanın hangi işletim sistemleri için derleneceğini belirlemenizi sağlar. Windows, macOS ve Linux seçenekleri kullanılabilir.
Architectures: Uygulamanın çalışacağı işlemci mimarisini belirlemenizi sağlar. x64 (Intel/AMD 64-bit) ve arm64 (ARM 64-bit) seçenekleri kullanılabilir.
Sağ paneldeki App Icon alanından masaüstü uygulamanızda kullanılacak ana ikon görselini yükleyin. 512x512 px boyutunda ve PNG formatında bir görsel yüklenmesi önerilir. Yüklenen ikon, hedef platformlara uygun formatlara otomatik olarak dönüştürülür.
