Kullanıcı Kılavuzu

C# Veri Kaynağı Ekleme Kullanıcı Kılavuzu

C# Veri Kaynağı Ekleme Kullanıcı Kılavuzu

C# Nedir?

Kuika platformunda uygulama geliştirirken çeşitli veri kaynakları kullanabilir ve Custom Action oluşturabilirsiniz. Bu işlemlerden biri de C# dilini kullanarak gerçekleştirilebilir. C#, modern uygulama geliştirme sürecinde yaygın olarak kullanılan bir programlama dilidir ve Kuika platformunda güçlü bir veri kaynağı entegrasyon aracı olarak kullanılabilir. Bu eğitim içeriğinde, C# ile veri tabanlarına bağlanmayı, nesne yönelimli programlama ilkelerini uygulamayı ve performans odaklı uygulamalar geliştirmeyi öğreneceksiniz.

C#'ın Yapay Zeka Asistanı ile genişletilmesi için abonelik planınızın bu özelliği desteklemesi gerekmektedir. Daha fazla bilgi için Fiyatlandırma Sayfasını ziyaret edebilirsiniz.

Bu eğitim içeriği aşağıdaki başlıklardan oluşur: 

  • 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 (Kimlik Doğrulama Sağlayıcı)
  • Custom Authorization Provider (Yetkilendirme Sağlayıcı)
  • Custom Verification Code Sender Provider (Doğrulama Kodu Gönderici Sağlayıcı)

C# ile Veri Kaynağı Bağlantısı ve Custom Action Oluşturun

  1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
  2. Data Sources modülünü seçin. Burada mevcut veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir veya yeni bir veri kaynağı ekleyebilirsiniz.
  3. Sources başlığı yanındaki + ikonuna tıklayın.
  1. C# veri kaynağını seçin, bir isim belirleyin ve kullanacağınız metodu seçin.
  2. CREATE butonuna tıklayarak veri kaynağını oluşturun.

C# Modülü Anatomisi

C# veri kaynağı ekledikten sonra detay ekranında şu alanlar yer alır:

  • Aksiyon isimlendirme alanı: Aksiyon adını ekleyebilir veya güncelleyebilirsiniz.İsimlendirmede İngilizce karakterleri ve ayrıca “-” veya “_” özel karakterlerini kullanabilirsiniz.
  • C# Template Alanı: Ön tanımlı şablonları (Default C# Function, Custom Authentication Provider vb.) kullanabilirsiniz.
  • External Libraries: Bu alanda, aksiyonunuzda kullanmak istediğiniz harici kütüphaneleri tanımlayabilirsiniz. NuGet paketleri üzerinden erişilebilen kütüphaneler buraya eklenebilir. Örneğin, Newtonsoft.Json, RestSharp gibi popüler kütüphaneler desteklenmektedir. Eklediğiniz kütüphaneler C# kodunuz içinde kullanılabilir hale gelir. Kütüphane sürümlerine dikkat etmek, uyumluluk açısından önemlidir.

Bu alanda yapacağınız değişiklik Editör içinde öncesinde yazmış olduğunuz scripti siler.

  • Yapay Zeka Asistanı: AI destekli fonksiyonlar oluşturabilirsiniz.
  • Tidy Up Butonu Kullanımı:
    • C# editöründe yazdığınız kodun düzenli ve hizalanmış olmasını sağlamak için Tidy Up butonuna tıklayabilirsiniz. Bu buton, kodunuzu otomatik olarak hizalar ve düzenler, böylece kodun okunabilirliği ve görsel anlaşılabilirliği artar.
  • Fonksiyonların Kaydedilmesi: C# Editöründe fonksiyonları oluşturduktan sonra CREATE butonuna tıklayarak kaydedebilirsiniz.

Yapay Zeka Asistanı ile C# Fonksiyonları Oluşturun

  1. Generate with AI seçeneğini kullanarak AI destekli chat alanını açın.
  2. Fonksiyon tanımı yapın ("Hello world rotating function" vb.).
  3. AI tarafından oluşturulan kodu kopyalayarak C# editörünüze ekleyin.

Custom Authentication Provider

Custom Authentication Provider, özelleştirilmiş kimlik doğrulama sistemleri oluşturmanıza olanak tanır.

  1. C# veri kaynağını seçin, bir isim girin.
  2. Custom Authentication Provider metodunu seçin.
  3. CREATE butonuna tıklayın.

Custom Authentication sınıfı, Custom Authentication arayüzünü uygular ve kimlik doğrulama işlevlerini tanımlar. Aşağıdaki metotlar, kullanıcılar için hazır olarak sunulmaktadır:

  • Login Metodu: Kullanıcıların giriş yapmasını sağlar. İki ayrı sürümü bulunur:
    • Kullanıcı adı ve şifre ile giriş yapma.
    • Kullanıcı adı, dışsal bir token ve yenileme token ile giriş yapma.
    • Kullanıcının giriş işlemi doğrulanmalıdır. Bu doğrulama REST API veya özel bir veritabanı üzerinden yapılabilir.
  • 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çinde sıklıkla kullanılır.
  • Logout Metodu: Kullanıcının sistemden çıkış yapmasını sağlar. Bu metodun dönüş değeri yoktur.
    • Custom Authentication Provider içinde return null değeri içermeyen alanlar geçerlidir.
    • Kuika içinde return null içeren alanlar geçersiz sayılır. Bu nedenle, return null dönen yerlerde Kuika içindeki değerler geçerli olur.

Custom Authorization Provider

Custom Authorization Provider, kullanıcıların uygulama içindeki rollerini belirlemek için kullanılır.

  1. C# veri kaynağını seçin, bir isim girin.
  2. Custom Authorization Provider metodunu seçin.
  3. CREATE butonuna tıklayın.

Custom Authorization Sınıfı ve Get Roles Metodu

Kuika, kullanıcılar için Custom Authorization içerisinde hazır bir C# ön tanımlı fonksiyon sunmaktadır. Bu fonksiyon, aşağıdaki metodları ve değişkenleri içerir:

  • Get Roles Metodu: Kullanıcının uygulama içinde hangi rolleri aldığını döndürür.
    • Parametreler:
      • 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.

Eğer özel kimlik doğrulama sistemi uygulanmayacaksa, return null kullanılmalıdır. Bu durumda varsayılan sistem davranışı korunur ve kullanıcıya özel bir rol atanmaz.

Kod içinde sağlanan yorumlar, geliştiricilerin fonksiyonun nasıl kullanılacağını anlamalarına yardımcı olur. Özellikle, özel roller tanımlamak isteyen geliştiriciler için kodun düzenlenebilir alanları belirtilmiştir. Bu yapı, belirli ekranlarda veya uygulama bölümlerinde çalışanlar için özelleştirilmiş roller tanımlamak amacıyla kullanılabilir.

Verification Code Sender Provider

Verification Code Sender Provider, kullanıcılara doğrulama kodları göndermek için kullanılır.

  1. C# veri kaynağını seçin, bir isim girin.
  2. Verification Code Sender Provider metodunu seçin.
  3. CREATE butonuna tıklayın.

Verification Code Sender Provider, bir uygulamanın kullanıcılarına doğrulama kodları göndermek için kullanılır. Kullanıcı kimlik doğrulama süreçlerinde SMS, e-posta veya push bildirimleri gibi farklı iletişim kanallarını kullanarak tek kullanımlık doğrulama kodları oluşturur ve iletir.

Verification Code Sender Provider’ın Temel İşlevleri

  • Doğrulama Kodlarını Oluşturma: Kullanıcıların kimliklerini doğrulamak için SMS veya e-posta yoluyla tek kullanımlık doğrulama kodları oluşturur.
  • Kodları Kullanıcılara Gönderme: SMS, e-posta, push bildirimleri veya uygulama içi mesajlar gibi farklı iletişim kanalları kullanarak kodları iletir.
  • Kodların Süreçlenmesi ve Takibi: Girilen ve doğrulanan kodların sürecini yönetir, kodların geçerlilik sürelerini izler ve tekrar kullanımını önler.
  • Hata ve Güvenlik Kontrolleri: Kodun doğruluğunu ve güvenliğini sağlamak için kullanılabilirlik ve geçerlilik kontrolleri yapar.
  • Kullanıcı Deneyimini İyileştirme: Kullanıcı dostu bir doğrulama süreci sağlayarak kullanıcıların kodları kolayca almasını ve kullanmasını mümkün kılar.

SMS veya Bildirim ile Doğrulama Kodu Gönderme

  1. C# veri kaynağını seçin, bir isim girin.
  2. Verification Code Sender Provider metodunu seçin.
  3. CREATE butonuna tıklayın.

Bu işlem tamamlandığında, doğrulama kodları belirlenen yöntemle gönderilecektir. Oluşturulan veri kaynağı, aşağıdaki bilgileri parametre olarak alır:

  • E-posta (User Name)
  • Kullanıcı adı ve soyadı (First-Last Name)
  • Kullanıcı Numarası (User Phone)

Kullanıcı, doğrulama kodunun hangi yöntemle (e-posta, SMS, push bildirim vb.) iletileceğini seçmeli ve ilgili alanları doldurmalıdır.

Gerekli bilgi girişi tamamlandıktan sonra CREATE butonuna tıklayarak işlemi tamamlayın. Bu adımlar, kullanıcıların doğrulama kodlarını almasını ve güvenlik süreçlerinin desteklenmesini sağlar.

Custom Connection String Provider

Custom Connection String Provider, uygulamanızın farklı ortamlara ya da sistemlere bağlanmasını sağlayan özelleştirilmiş bağlantı cümlelerini (Connection String) tanımlamak için kullanılır. Bu yapı sayesinde, uygulamanızın ortam bağımsız (development, staging, production) şeklinde yapılandırabilir veya farklı veritabanlarına dinamik olarak yönlendirilebilir. 

  1. C# veri kaynağını seçin, bir isim girin.
  2. Custom Connection String Provider metodunu seçin.
  3. CREATE butonuna tıklayın.

Custom Connection String Provider, aynı uygulamanın farklı müşteriler için ayrı veritabanlarına bağlanması, geliştirme ve canlı sistemlerin ayrıştırılması, çoklu tenant destekli sistemlerde dinamik bağlantı değişimi için kullanılır. 

Fonksiyonun Geri Dönüşü:

  • return "connection_string": Dönüş değeri olarak bir bağlantı cümlesi (örneğin SQL Server, PostgreSQL vb.)
  • Kullanıcıya, uygulamaya veya tenant’a özel bağlantılar döndürmek mümkündür.

Dönüş değerinde hassas bilgiler içerdiğinden, string güvenli biçimde oluşturulmalı ve loglanmamalıdı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:

  1. 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.
  2. 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.
  3. 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. 

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar