C# Adding a Data Source User Guide

1. After logging into the Kuika platform, open the project you will work on from the “Apps” screen.
2. Go to the “Data Sources” (1) module. In the Data Sources module, you can view the data sources, actions and tables in the application you have developed, add a new data source, a new action and a new table.
   

       3. To add a new data source to your application, click the “+” (2) icon next to the “Sources” heading on the left side of the Data Sources module.

4. Select “C#” (1) as the Data Sources data source type, enter a name (2) and select the method to use.
5. Then click on the “CREATE” (3) button.
   

Let's examine the sections on the C# detail screen.

1. Action naming field: With the C# Actions name field you can add or update the action name. You can use English characters in the naming and also the special characters “-” or “_”.
2. C# template field: There are C# Datasource templates such as Default C# Function, Custom Authentication Provider and Custom Authorization Provider. You can select the template you need from this field and add it to the editor.

The change you make in this field deletes the script you previously wrote in the Editor.

3. AI assistant for C# functions: When writing your C# functions, you can quickly prepare them with AI support. Open the chat area with Generate with AI from the top section. Define the function you want to create. The function is prepared with artificial intelligence. You can copy the prepared function.
4. Adding C# functions to C# Editor: You can click the blue button to add the copied function to the C# Editor.
5. Saving C# functions: After adding the functions to the C# Editor, you can create the function you prepared by clicking the CREATE button.

When writing your C# functions, you can prepare faster and more efficiently by using AI-powered tools on the Kuika platform. Open the chat area using the “Generate with AI” option in the top menu and define the function you want to create here to the AI. For example, if you want to print a “Hello world rotating function”, tell the AI your request. The AI will quickly create this function and present it to you.

The code generated by the AI is written in accordance with C# language rules and optimizes your function according to the features you specify. You can easily copy the generated code and add it to your project. This is especially useful when writing complex algorithms or when you want to save time. You can also create different variations of the functions by interacting with artificial intelligence, so you can get the best solutions for your application.

A Custom Authentication Provider is a specially created structure to authenticate users and provide security when standard authentication solutions are insufficient. It is usually designed for specific requirements or functions.

You can follow these steps to create a Custom Authentication Provider:

1. Select “C#” (1) as the Data Sources data source type, enter a name (2).
2. Then select the “Custom Authentication Provider” method.
3. Then click on the “CREATE” (3) button.

The created Custom Authentication Provider opens with a predefined class. It contains a C# class and an instance of a class that implements the custom authentication provider. This class provides the customized functionality for user authentication and contains comments to describe this functionality.

The Custom Authentication class implements the Custom Authentication interface. This interface defines the authentication functions. The following methods are provided in the code ready for users:

• Login Method: Allows users to log in. There are two versions: one for logging in with username and password, the other for logging in with username, an external token and a refresh token. Within the method, the user's login process needs to be validated. The validation can be done from fields such as the Rest API or a custom database. Accordingly, additions may need to be made to the code.
• Refresh Token Method: Used to refresh an expired token.
• Find Manager Method: It is used to find the manager of a user. It can be used frequently in Process Automation.
• Logout Method: Allows a user to log out of the system. Logout method does not have a return value. In Custom Authentication Provider, fields where return null values are not returned are valid. The values in Kuika are considered invalid; when a null is returned, the values in Kuika are valid.

Custom Authorization Provider is a structure used to create a customized authentication and authorization system. It is used to determine the user's roles within the application and allows you to determine which roles users have on the web or mobile side at the opening of each screen within the application by taking from different systems (for example, Azure, custom databases, etc.).

You can follow these steps to create Custom Authorization Provider:

1. Select “C#” (1) as the Data Sources data source type, enter a name (2).
2. Then select the “Custom Authorization Provider” method.
3. Then click on the “CREATE” (3) button.

The Custom Authorization Provider you created represents a C# class that manages user authentication and authorization.

Kuika provides a ready-made C# predefined function in Custom Authorization for the user. This function contains the following methods and variables:

Get Roles Method:

The Get Roles method returns which roles the user has in the application. This method takes the following parameters:

• App Id: The unique ID (GUID) of the app.
• App Name: The name of the app.
• Screen Id: Unique screen-specific ID (GUID).
• Screen Name: The name of the screen.
• User Name: The user's email address or ID.

return null; This line should be used if this particular authentication system does not want to customize application roles. In this case, the default system behavior is preserved and no custom role is assigned to the user.

The comments provided in the code contain important information about how the code should be used. In particular, they indicate that if it is desired to define developer-specific roles, the relevant script should be opened and the list of appropriate roles should be inserted instead of the code fragment specified here.

It can be used to customize the authentication and authorization processes of an application. For example, you may want to define special roles for workers on a particular screen or application partition. This class can be used to meet such requirements and provides developers with a starting point for customizing roles.

Verification Code Sender Provider is a service that an application or service uses to send verification codes to its users. This type of service is used to authenticate users or to send temporary or single-use codes for security purposes.

Basic Functions of Verification Code Sender Provider:

1. Generating Verification Codes:some text
   • Generates single-use verification codes that are sent via SMS or email to authenticate users.
2. Sending Codes to Users:some text
   • It can use different communication channels to transmit the generated verification codes. For example, SMS, email, push notifications or in-app messages.
3. Processing and Tracking of Codes:some text
   • Manages the process of codes entered and verified by users. This includes tracking validity periods of codes, recording used codes and preventing reuse.
4. Error and Security Checks:some text
   • Performs checks to ensure the accuracy and security of submitted codes. For example, it can check the availability and currency of the code.
5. Improving User Experience:some text
   • Can guide the transmission process of scripts to ensure a user-friendly experience. This includes ensuring that users can easily receive and redeem codes.

Sending Verification Code via SMS or Notification:

Follow the steps below to receive Verification Code via SMS or Notification other than email:

1. Select “C#” (1) as the Data Sources data source type, enter a name (2).
2. Then select the “Verification Code Sender Provider” method.
3. Then click on the “CREATE” (3) button.

4. With this selection, the user will receive the verification code with the specified method. In the created datasource, the following information is taken as a parameter:some text
   • E-mail (User Name)
   • Username and surname (First-Last Name)
   • User Number (User Phone)
5. This information is requested from the user.
6. The user should fill in the Return False code block with the way (e-mail, notification, etc.) he/she wants to send the code.
7. After the relevant information entry is completed, click the CREATE button to finish the process.

With these steps, users will receive verification codes and security processes will be supported.

In this example, we create a class called Calculator and include a method that performs addition. Also, explanations are added for each section:

1. Using System
   • Adds the System library, which is necessary to use basic system functions in C#. For example, it allows you to use the Console class to get console output.
2. Calculator Class
   • Created to perform mathematical operations.
   • Add Method:
     • public int Add(int a, int b) takes two integer (int) parameters and adds them.
     • The expression return a + b; returns the sum of the variables a and b.
3. Program Class
   • Main Method:
     • This is where the program starts running. It is considered the starting point of a program in C#.
     • Calculator calculator = new Calculator(); creates an object of the Calculator class.
     • The expression int result = calculator.Add(5, 3); calls the Add method to calculate the sum of 5 and 3 and assigns the result to the result variable.
     • Console.WriteLine($“Result: {result}”); prints the calculated result to the console. The $ sign allows us to print the variable directly by string interpolation.

This example shows the process of creating a class in C#, defining methods and using those methods to perform a simple calculation.