Kuika ile uygulama geliştirirken çeşitli veri kaynaklarını kullanabilir ve farklı araçlar yardımıyla Custom Action oluşturabilirsiniz. Bu araçlardan biri de C#’tır. C#, modern uygulama geliştirmede en yaygın kullanılan programlama dillerinden biridir ve Kuika platformunda güçlü bir veri kaynağı entegrasyon aracı olarak kullanılabilir. Bu eğitim içeriği ile C# dilini kullanarak uygulamalarınıza nasıl veri tabanlarına bağlanacağınızı, nesne yönelimli programlamayı nasıl uygulayacağınızı ve performans odaklı uygulamalar geliştirmeyi öğreneceksiniz.
C#'ta Yapay Zeka Asistanı ile uygulamanızı genişletmek için mevcut abonelik planınızı yükseltmeniz gerekmektedir. Aboneliğinizi yükselterek, yapay zeka tabanlı özellikler, gelişmiş entegrasyonlar ve teknik destek gibi avantajlardan faydalanabilirsiniz. Aboneliğinizi yükseltmek için Fiyatlandırma sayfamızı ziyaret edebilirsiniz.
Bu eğitim içeriği aşağıdaki başlıklardan oluşmaktadır:
C# ile veri kaynağı bağlantısı ve Custom Action oluşturma,
C# modülü anatomisi,
Yapay zeka asistanı ile C# fonksiyonları oluşturma,
Custom Authentication Provider,
Custom Authorization Provider,
Custom Verification Code Sender Provider.
C# ile Veri Kaynağı Bağlantısı ve Custom Action Oluşturun
Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız projeyi açın.
“Data Sources” (1) modülüne gidin. Data Sources modülünde, geliştirdiğiniz uygulamada yer alan veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir, yeni bir veri kaynağı, yeni bir aksiyon ve yeni bir tablo ekleyebilirsiniz.
Geliştirdiğiniz uygulamaya yeni bir veri kaynağı eklemek için Data Sources modülünün sol kenarındaki “Sources” başlığı yanında bulunan “+” (2) ikonuna tıklayın.
Data Sources veri kaynağı tipi olarak “C#” (1) seçin, bir isim (2) girin ve kullanacağınız metodu seçin.
Daha sonra “CREATE” (3) butonuna tıklayın.
C# Modülü Anatomisi
C# detay ekranındaki bölümleri inceleyelim.
Aksiyon isimlendirme alanı: C# Actions name alanı ile aksiyon adını ekleyebilir veya güncelleyebilirsiniz. İsimlendirmede İngilizce karakterleri ve ayrıca “-” veya “_” özel karakterlerini kullanabilirsiniz.
C# template alanı: Default C# Function, Custom Authentication Provider ve Custom Authorization Provider gibi C# Datasource şablonları yer almaktadır. Bu alandan ihtiyacınız olan şablonu seçerek editöre eklenmesini sağlayabilirsiniz.
Bu alanda yapacağınız değişiklik Editör içinde öncesinde yazmış olduğunuz scripti siler.
C# fonksiyonları için yapay zeka asistanı: C# fonksiyonlarınızı yazarken AI destekli olarak hızla hazırlayabilirsiniz. Üst bölümden Generate with AI ile chat alanını açın. Oluşturmak istediğiniz fonksiyonu tanımlayın. Yapay zeka ile ilgili fonksiyon hazırlanır. Hazırlanan fonksiyonu kopyalayabilirsiniz.
C# fonksiyonlarının C# Editöre eklenmesi: Kopyalanan fonksiyonun C# Editöre eklenmesi için mavi butona tıklayabilirsiniz.
Yapay Zeka Asistanı ile C# Fonksiyonları Oluşturun
C# fonksiyonlarınızı yazarken, Kuika platformunda AI destekli araçlar kullanarak daha hızlı ve verimli bir şekilde hazırlık yapabilirsiniz. Üst menüde bulunan "Generate with AI" seçeneğini kullanarak chat alanını açın ve burada oluşturmak istediğiniz fonksiyonu yapay zekaya tanımlayın. Örneğin, bir "Hello world rotating function" yazdırmak istiyorsanız, yapay zekaya bu talebinizi iletin. Yapay zeka, bu fonksiyonu hızlı bir şekilde hazırlayıp size sunacaktır.
Yapay zeka tarafından oluşturulan kod, C# dil kurallarına uygun olacak şekilde yazılır ve fonksiyonunuzu belirttiğiniz özelliklere göre optimize eder. Hazırlanan kodu kolayca kopyalayarak projenize ekleyebilirsiniz. Özellikle karmaşık algoritmalar yazarken veya zamandan tasarruf etmek istediğinizde çok faydalıdır. Ayrıca, yapay zeka ile etkileşim kurarak fonksiyonların farklı varyasyonlarını da oluşturabilir, böylece uygulamanıza en uygun çözümleri elde edebilirsiniz.
Custom Authentication Provider
Custom Authentication Provider (Özel Kimlik Doğrulama Sağlayıcısı), standart kimlik doğrulama çözümlerinin yetersiz kaldığı durumlarda, kullanıcıların kimliklerini doğrulamak ve güvenliği sağlamak için özel olarak oluşturulan bir yapıdır. Genellikle, belirli gereksinimler veya işlevler için tasarlanmıştır.
Custom Authentication Provider oluşturmak için şu adımları izleyebilirsiniz:
Data Sources veri kaynağı tipi olarak “C#” (1) seçin, bir isim (2) girin.
Ardından “Custom Authentication Provider” metodunu seçin.
Daha sonra “CREATE” (3) butonuna tıklayın.
Oluşturulan Custom Authentication Provider, ön tanımlı bir sınıf ile birlikte açılmaktadır. Bir C# sınıfını içerir ve özel kimlik doğrulama sağlayıcısını uygulayan bir sınıfın örneğini barındırır. Bu sınıf, kullanıcı kimlik doğrulama işlemleri için özelleştirilmiş işlevselliği sağlar ve bu işlevselliği açıklamak için yorumlar içerir.
Custom Authentication sınıfı, Custom Authentication ara birimini uygular. Bu arabirim, kimlik doğrulama işlevlerini tanımlar. Kod içerisinde aşağıdaki metodlar kullanıcılara hazır durumda verilmiştir:
Login Metodu: Kullanıcıların giriş yapmasını sağlar. İki ayrı sürümü bulunur: biri kullanıcı adı ve şifre ile giriş yaparken, diğeri kullanıcı adı, dışsal bir token ve yenileme token ile giriş yaparken kullanılır. Metot içerisinde kullanıcının giriş işleminin doğrulanması gerekmektedir. Doğrulama işlemi, Rest API veya özel bir veritabanı gibi alanlardan yapılabilir. Bu doğrultuda koda eklemeler yapılması gerekebilir.
Refresh Token Metodu: Süresi dolmuş bir Token’ı yenilemek için kullanılır.
Find Manager Metodu: Bir kullanıcının yöneticisini bulmak için kullanılır. Process Automation içerisinde sıklıkla kullanılabilir.
Logout Metodu: Bir kullanıcının sistemden çıkış yapmasını sağlar. Logout metodunun bir dönüş değeri yoktur. Custom Authentication Provider içerisinde, return null değerlerinin dönmediği alanlar geçerlidir. Kuika içerisinde yer alan değerler geçersiz sayılmaktadır; return null dönen yerlerde ise Kuika içerisinde yer alan değerler geçerli olmaktadır.
Custom Authorization Provider
Custom Authorization Provider, özelleştirilmiş bir kimlik doğrulama ve yetkilendirme sistemi oluşturmak amacıyla kullanılan bir yapıdadır. Kullanıcının uygulama içindeki rollerini belirlemek için kullanılır ve uygulama içerisinde her ekranın açılışında, web veya mobil tarafında kullanıcıların hangi rollere sahip olduğunu farklı sistemlerden (örneğin, Azure, özel veritabanları vb.) alarak belirlemeye olanak tanır.
Custom Authorization Provider oluşturmak için şu adımları izleyebilirsiniz:
Data Sources veri kaynağı tipi olarak “C#” (1) seçin, bir isim (2) girin.
Ardından “Custom Authorization Provider” metodunu seçin.
Daha sonra “CREATE” (3) butonuna tıklayın.
Oluşturduğunuz Custom Authorization Provider, kullanıcı kimlik doğrulama ve yetkilendirme işlemlerini yöneten bir C# sınıfını temsil eder.
Kuika, kullanıcı için Custom Authorization içerisinde hazır bir C# ön tanımlı fonksiyon sunmaktadır. Bu fonksiyon içerisinde aşağıdaki metodlar ve değişkenler yer almaktadır:
Get Roles Metodu:
Get Roles metodu, kullanıcının uygulama içinde hangi rolleri aldığını döndürmektedir. Bu metod aşağıdaki parametreleri alır:
App Id: Uygulamanın benzersiz kimliği (GUID).
App Name: Uygulamanın adı.
Screen Id: Ekrana özgü benzersiz kimlik (GUID).
Screen Name: Ekranın adı.
User Name: Kullanıcının e-posta adresi veya kimliği.
return null; Eğer bu özel kimlik doğrulama sistemi, uygulama rollerini özelleştirmek istemiyorsa, bu satır kullanılmalıdır. Bu durumda, varsayılan sistem davranışı korunur ve kullanıcıya herhangi özel bir rol atanmaz.
Kod içinde sağlanan yorumlar, kodun nasıl kullanılması gerektiğine dair önemli bilgiler içerir. Özellikle, geliştiriciye özel roller tanımlamak isteniyorsa, ilgili kodun açılması ve uygun rollerin listesinin burada belirtilen kod parçası yerine eklenmesi gerektiği belirtilir.
Bir uygulamanın kimlik doğrulama ve yetkilendirme işlemlerini özelleştirmek için kullanılabilir. Örneğin, belirli bir ekranda veya uygulama bölümünde çalışanlar için özel roller tanımlamak isteyebilirsiniz. Bu sınıf, bu tür gereksinimleri karşılamak için kullanılabilir ve geliştiricilere rolleri özelleştirmek için bir başlangıç noktası sağlar.
Verification Code Sender Provider
Verification Code Sender Provider, bir uygulamanın veya hizmetin kullanıcılarına doğrulama kodları göndermek için kullandığı bir hizmettir. Bu tür bir hizmet, kullanıcıların kimliklerini doğrulamak veya güvenlik amacıyla geçici veya tek kullanımlık kodlar göndermek için kullanılır.
Verification Code Sender Provider'ın Temel İşlevleri:
Doğrulama Kodlarını Oluşturma:some text
Kullanıcıların kimliklerini doğrulamak amacıyla SMS veya e-posta yoluyla gönderilen tek kullanımlık doğrulama kodlarını oluşturur.
Kodları Kullanıcılara Gönderme:some text
Oluşturulan doğrulama kodlarını iletmek için farklı iletişim kanallarını kullanabilir. Örneğin; SMS, e-posta, push bildirimleri veya uygulama içi mesajlar gibi.
Kodların Süreçlenmesi ve Takibi:some text
Kullanıcılar tarafından girilen ve doğrulanan kodların sürecini yönetir. Bu, kodların geçerlilik sürelerini izlemeyi, kullanılan kodların kaydedilmesini ve tekrar kullanılmasını önlemeyi içerir.
Hata ve Güvenlik Kontrolleri:some text
Gönderilen kodların doğruluğunu ve güvenliğini sağlamak için kontroller gerçekleştirir. Örneğin; kodun kullanılabilirliğini ve güncelliğini kontrol edebilir.
Kullanıcı Deneyimini İyileştirme:some text
Kullanıcı dostu bir deneyim sağlamak amacıyla kodların iletim sürecini yönlendirebilir. Kullanıcıların kolayca kodları almasını ve kullanmasını sağlamayı içerir.
SMS veya Bildirim ile Doğrulama Kodu Gönderme:
Verification Code’u e-posta dışında SMS veya Notification ile almak için aşağıdaki adımları izleyin:
Data Sources veri kaynağı tipi olarak “C#” (1) seçin, bir isim (2) girin.
Ardından “Verification Code Sender Provider” metodunu seçin.
Daha sonra “CREATE” (3) butonuna tıklayın.
Bu seçimle birlikte, kullanıcı doğrulama kodunu belirlenen yöntemle alacaktır. Oluşturulan datasource içerisinde, aşağıdaki bilgileri parametre olarak alınır:some text
E-posta (User Name)
Kullanıcı adı ve soyadı (First-Last Name)
Kullanıcı Numarası (User Phone)
Bu bilgiler kullanıcıdan istenmektedir.
Kullanıcı, Return False kod bloğunun üstüne hangi yolla (e-posta, bildirim vb.) kodu göndermek istediğini gerekli şekilde doldurmalıdır.
İlgili bilgi girişi tamamlandıktan sonra, işlemi bitirmek için CREATE butonuna tıklayın.
Bu adımlarla birlikte, kullanıcıların doğrulama kodlarını alması sağlanacak ve güvenlik süreçleri desteklenmiş olacaktır.
C# Örneği
Bu örnekte, Calculator adında bir sınıf oluşturarak toplama işlemi gerçekleştiren bir metot içermektedir. Ayrıca her bölüm için açıklamalar eklenmiştir:
Using System
C#’ta temel sistem fonksiyonlarını kullanmak için gerekli olan System kütüphanesini ekler. Örneğin, konsol çıktısı almak için Console sınıfını kullanabilmenizi sağlar.
Calculator Sınıfı
Matematiksel işlemleri gerçekleştirmek için oluşturulmuştur.
Add Metodu:
public int Add(int a, int b) ifadesi, iki tamsayı (int) parametre alarak bunları toplar.
return a + b; ifadesi, a ve b değişkenlerinin toplamını geri döndürür.
Program Sınıfı
Main Metodu:
Programın çalışmaya başladığı yerdir. C#’ta bir programın başlangıç noktası olarak kabul edilir.
Calculator calculator = new Calculator(); ifadesi, Calculator sınıfından bir nesne oluşturur.
int result = calculator.Add(5, 3); ifadesi, Add metodunu çağırarak 5 ve 3 sayılarının toplamını hesaplar ve sonucu result değişkenine atar.
Console.WriteLine($"Sonuç: {result}"); ifadesi, hesaplanan sonucu konsola yazdırır. $ işareti, string interpolasyonu yaparak değişkeni doğrudan yazdırmamıza olanak tanır.
C# dilinde bir sınıf oluşturma, metot tanımlama ve bu metotları kullanarak basit bir hesaplama işlemi yapma sürecini göstermektedir.
