1. Defining the Action in UI Design
   
   • Log in to the Kuika platform.
   • Open the project you want to work on from the Apps screen.
   • Go to the UI Design module and select the relevant screen.
2. Adding an Action

• From the ADD ACTION menu, add the List Sources action according to the triggering event (Initial Actions, OnClick, OnBlur, etc.).

3. Optional Parameter Usage
   
   • If you run without entering parameters: The sources in the default collection in the Qdrant system are listed and transferred to the area specified as the Target Variable.
   • If you enter parameters: The sources belonging to the specified collection name are listed.
   • If an incorrect collection name is entered: The action returns an error message.

Scenario 1: Default Usage – Listing All Sources

• Purpose: To allow the user to select all sources in Qdrant with a Select Box.
• Steps:
  
  1. Add a Select Box element to your project screen in the UI Design module.
  2. Then, add the List Sources action from the Add Action button on the right panel and select the Select Box as the Target Variable (sourcesList).
  3. When the action is triggered, all Sources in Qdrant are transferred to the Select Box.
• Expected Result: The user can select from all Sources.

Scenario 2: Using Optional Parameters – Listing Sources Belonging to a Specific Collection

• Objective: List the sources belonging to the collection selected by the user.
• Steps:
  
  1. Enter the collection name as an optional parameter.
  2. The List Sources action is executed and only the sources belonging to the specified collection are transferred to the Target Variable.
  3. If an incorrect collection name is entered, the action returns an error message.
• Expected Result: The user sees only the Sources of the collection they are interested in; an incorrect entry warning message is generated.

Scenario 3: Dynamic Dropdown in Mobile Application

• Purpose: To give the user the right to select a source in the mobile application.
• Steps:
  
  1. The List Sources action is triggered when the page loads.
  2. The source list is displayed in a scrollable Select Box on mobile devices.
  3. After the user makes a selection, other actions (search, filtering, etc.) are performed on the selected source.
• Expected Result: The mobile user experience is consistent with the web experience.

• Dynamic Action Chain: Listed sources can be automatically used in subsequent actions (e.g., Search action or filtering).
• Collection-Based Dynamic Filtering: Sources belonging to a specific collection can be listed using an optional parameter, allowing only relevant data to be presented to the user.
• Coordinated Use with Select Box: Listed sources can be used as dynamic data sources in other actions based on user selections made via the Select Box.
• Error Management and Warnings: Information messages are displayed to the user in cases of incorrect collection names or empty lists, ensuring that actions are managed safely.

Technical Risks

• Empty Source List: If there are no sources in Qdrant, the action returns an empty list.
• Incorrect Target Variable: If the target variable is not defined correctly, the list transfer fails.
• Incorrect Collection Name: If the optional parameter is entered incorrectly, the action returns an error message.