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

A. C# ile Veri Kaynağı Bağlantısı ve Custom Action Oluşturma

C# ile veri kaynağı bağlantısı yapmak ve Custom Action oluşturmak için Kuika’ da çalıştığınız projede Datasources modülüne gidin.

Datasources modülünde bulunan sol menü aracılığıyla 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ğin uygulamaya yeni bir veri kaynağı eklemek için Datasources başlığı karşısında yer alan + ikonuna tıklayın.

Geliştirdiğin uygulamaya C# ile veri kaynağı eklemek ve Custom Action oluşturmak için açılan ekranda Datasource tipi olarak C# seç ve isimlendirin. İsimlendirme işlemini tamamladıktan sonra C# şablonunu seçin. Kuika tarafından sunulan C# şablonları aşağıda verilmiştir.

• Default C# Function
• Custom Authentication Provider
• Custom Authorization Provider
• Verification Code Sender Provider

Şablon seçimi yaptıktan sonra CREATE butonuna tıklayın.

Varsayılan C# fonksiyonları ile veri bağlantısı yapabilir ya da açılan ekranda şablon değişimi yapabilirsiniz.

Template başlığı altında yer alan açılır menü aracılığıyla şablon değişimini gerçekleştirebilirsiniz. Şablon değişimini gerçekleştirmek için Template başlığı altında yer alan açılır menüye tıklayın. Menü içerisinde yer alan şablonlardan ihtiyacına uygun olanı seçin. Seçtiğin şablona uygun olarak C# editörde yer alan kod içeriği şablon özelliklerine göre güncellenecektir.

Özel kimlik doğrulama sağlayıcısı fonksiyonlarını kullanmak için Custom Authentication Provider şablonunu kullanabilirsiniz.

Özel yetki sağlayıcısı fonksiyonlarını kullanmak için Custom Authorization Provider şablonunu kullanabilirsiniz.

Kullanıcıların kimliklerini doğrulamak veya güvenlik amacıyla geçici veya tek kullanımlık kodlar göndermek için Verification Code Sender Provider şablonunu kullanabilirsiniz.

Seçtiğin şablonlara uygun olarak C# programlama dili ile veri bağlantısı ve Custom Action içeriğini yazın ve CREATE butonuna tıklayarak Datasources bağlantısını oluşturun.

C# detay ekranındaki bölümleri inceleyelim. 

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

3. 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. 
4. C# fonksiyonlarının C# Editöre eklenmesi: Kopyalanan fonksiyonun C# Editöre eklenmesi için mavi butona tıklayabilirsiniz.
5. C# fonksiyonlarının kaydedilmesi: C# Editöre fonksiyonlar eklendikten sonra CREATE butonuna tıklayarak hazırladığınız fonksiyonu oluşturabilirsiniz. 

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 (Ö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:

1. Data Sources veri kaynağı tipi olarak “C#” (1) seçin, bir isim (2) girin.
2. Ardından “Custom Authentication Provider” metodunu seçin. 
3. 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, ö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:

1. Data Sources veri kaynağı tipi olarak “C#” (1) seçin, bir isim (2) girin.
2. Ardından “Custom Authorization Provider” metodunu seçin. 
3. 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, 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:

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

1. Data Sources veri kaynağı tipi olarak “C#” (1) seçin, bir isim (2) girin.
2. Ardından “Verification Code Sender Provider” metodunu seçin. 
3. Daha sonra “CREATE” (3) butonuna tıklayın. 

4. 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)
5. Bu bilgiler kullanıcıdan istenmektedir.
6. 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.
7. İ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.

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.