C#'ta Yapay Zeka Asistanı ile uygulamanızı genişletin

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# editörüne eklenen yapay zeka asistanına uygun promptu girerek saniyeler içinde C# fonksiyonlarını hiç kod yazmadan hazırlayabilirsiniz.

Datasources modülünden yeni veri kaynağına eklediğiniz C# başlığı altından yeni bir C# Action oluşturun.

C# name alanına fonksiyon adını yazın. C# editöre direkt sorguyu yazmaya devam edebilirsiniz.

Genel anlamda C# Actions Editör üzerinde yaptığımız iyileştirmeler aşağıda verilmiştir;

1. Aksiyon isimlendirme alanı
2. C# template alanı
3. C# fonksiyonları için yapay zeka asistanı
4. C# fonksiyonlarının C# Editöre eklenmesi
5. C# fonksiyonlarının Kaydedilmesi

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 Ekranı

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 AI asistanını kullanın

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.

"Hello world rotating function”

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şturabilir, kayıtlı bir fonksiyonu açtığınızda ise UPDATE butonu ile güncelleyebilirsiniz.

Custom Authentication Provider, özel veya özelleştirilmiş kimlik doğrulama sağlayıcısıdır.Genellikle, standart kimlik doğrulama çözümleri için uygundur, ancak bazı özel gereksinimler veya işlevler için standart doğrulama yöntemleri yetersiz olabilir. Bu nedenle, özelleştirilmiş kimlik doğrulama sağlayıcısı, kullanıcıların kimliklerini doğrulamak ve güvenliği sağlamak için özel olarak oluşturulan bir yapıdır.

Custom Authentication Provider oluşturmak için Header aracılığıyla Datasources modülünü açın. Açılan ekranda sol panelde bulunan + ikonuna tıklayın. Ardından Select Type alanından C#’ı seçin.

Oluşturduğunuz Datasource’u isimlendirin. Selectbox içerisinden Custom Authentication Provider’ı seçin ve Create butonuna tıklayın.

Oluşturulan Custom Authentication Provider ön tanımlı bir sınıf ile birlikte açılmaktadır. Bu kod, bir C# sınıfını içerir ve bir özel kimlik doğrulama sağlayıcısını uygulayan bir sınıfın örneklemesini 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 arabirimini uygular. Bu arabirim, kimlik doğrulama işlevlerini tanımlar.

Kod içerisinde Login, Refresh Token, Find Manager ve Logout 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. Login metodu içerisinde kullanıcın giriş işleminin doğrulanması gerekmektedir. Bu doğrulama işlemini Rest API veya Custom DB gibi alanlardan yapabilir. Bu doğrultuda koda eklemeler yapılmalıdır.
• 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. Bu işlevin nasıl özelleştirilebileceğini belirten açıklamalar bulunur. Process Automation içerisinde bu method sıklıkla kullanılabilir.
• Logout metodu, bir kullanıcının sistemden çıkış yapmasını sağlar. Bu metodu özelleştirmek için açıklamalar sağlanır. 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.

Açıklamalar, kodun kullanımını ve özelleştirmesini kolaylaştırmak için yazılmıştır. Kodun kullanıcı kimlik doğrulama işlemlerini özelleştirmek isteyen geliştiricilere yol göstermek amacıyla eklenmiştir. Bu şekilde, geliştiriciler bu kodu kullanarak belirli bir uygulamanın veya sistemin kimlik doğrulama mantığını istedikleri gibi uygulayabilirler.

Custom Authorization Provider, Bir özelleştirilmiş kimlik doğrulama ve yetkilendirme sistemi oluşturmak amacıyla kullanılmaktadır.

Custom Authorization Provider oluşturmak için Header alanından Datasources’e tıklayın. Açılan ekranda solda + ikonuna tıklayın. Ardından Select Type alanından C#’ı seçin. Oluşturduğunuz Datasource’u isimlendirin. Selectbox içerisinden Custom Authorization Provider’ı seçin ve Create butonuna tıklayın.

Custom Authorization Provider özel kimlik doğrulama sınıfını temsil eder. Kullanıcının uygulama içindeki rollerini almak için kullanılır.Uygulama içerisinde her ekranın açılışında Web veya Mobil tarafında ekranda her kullanıcı için hangi rollere sahip olunduğunu farklı sistemlerden (Azure, Custom DB..) alınmasına Custom Authorization olanak sağlamaktadır.

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:

GetRoles 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:

• appId: Uygulamanın benzersiz kimliği (GUID).
• appName: Uygulamanın adı.
• screenId: Ekrana özgü benzersiz kimlik (GUID).
• screenName: Ekranın adı.
• userName: Kullanıcının e-posta adresi veya kimliği.
• return null; satırı: Eğer bu özel kimlik doğrulama sistemi, uygulama rollerini özelleştirmek istemiyorsa, bu satırın kullanılması gerekecektir. Bu durumda, varsayılan sistem davranışı korunur ve kullanıcıya herhangi özel bir rol atanmaz.

Kod içinde verilen yorumlar, kodun nasıl kullanılması gerektiğine dair önemli bilgiler içerir. Özellikle, geliştiriciye, eğer özel roller tanımlamak isteniyorsa, ilgili kodun açılması ve uygun rollerin listesinin burada belirtilen kod parçası yerine eklenmesi gerektiği söylenir.

Bu kod, 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 temelde aşağıda yer alan işlevleri yerine getirebilmektedir.

• Doğrulama Kodlarını Oluşturma: Doğrulama kodlarını (örneğin, SMS veya e-posta yoluyla gönderilen tek kullanımlık kodlar) oluşturur. Bu kodlar, kullanıcıların kimliklerini doğrulamak için kullanılır.
• Kodları Kullanıcılara Gönderme: Oluşturulan doğrulama kodlarını kullanıcılara 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: Doğrulama kodlarının kullanıcılar tarafından girilip doğrulandığı süreci yönetir. Bu, kodların geçerlilik sürelerini izlemeyi, kullanılan kodların kaydedilmesini ve tekrar kullanılmasını önlemeyi içerebilir.
• Hata ve Güvenlik Kontrolleri: Gönderilen kodların doğruluğunu ve güvenliğini sağlamak için kontroller yapabilir. Örneğin, kodun kullanılabilirliğini ve güncelliğini kontrol edebilir.
• Kullanıcı Deneyimini İyileştirme: Kullanıcı dostu bir deneyim sağlamak için kodları iletim sürecini yönlendirebilir. Bu, kullanıcıların kolayca kodları almasını ve kullanmasını sağlamayı içerebilir.

Verification Code’u e-posta dışında SMS veya Notification ile almak için Header aracılığıyla Datasources görünüm modunu açın.

Bu ekranda yeni bir veri kaynağı oluşturmanız gerekmektedir. Bunun için solda yer alan + ikonuna tıklayın. Açılan ekrandan C# seçimini yapın. Ardından aynı ekranda yer alan Selectbox içerisinden Custom Verification Code Sender Provider’i seçin.

Bu seçim ile Verification Code gönderimini kullanıcı yapmış olacaktır. Oluşturulan Datasource içerisinde e-postası (User Name), Kullanıcı adı ve soyadı (First-Last Name), Kullanıcı Numarası (User Phone) bilgileri parametre olarak gelmektedir. Bu bilgiler kullanıcıdan istenmektedir.

Kullanıcı Return False kod bloğunun üstüne hangi yolla (e-posta,bildirim..) kodu göndermek istiyorsa gerekli şekilde doldurulmalıdır.

İlgili bilgi girişi sonrası CREATE butonuna tıklayarak işlemi tamamlayın.