Kuika's Get Source action allows you to retrieve a source with a specific correlationId value in a source system. It is used to query previously recorded vector or data objects, particularly in VectorSearch or AI-based content management integrations. The Get Source action provides quick access to a recorded source and makes data flows in the system manageable.
Technical Features
Source Retrieval: Retrieves the source belonging to the specified correlationId from the system.
Optional Parameter Support: Queries can be made from a specific collection using the collectionName parameter.
Validation Check: Data validation checks can be disabled with the Don't trigger validations option.
Web and Mobile Support: The action can be used in both web and mobile applications.
Get Source Action Application Steps
Log in to the Kuika platform.
Open the project you will be working on from the Apps screen.
Go to the UI Design module and select the screen you want to use.
Click on the + ADD ACTION menu via the Properties Panel on the right side.
Select the Vector Search > Get Source action from the menu that opens.
Configure the action parameters.
Configuring Action Parameters
correlationId (String - Required): The unique ID of the source to be retrieved. This value usually belongs to a source previously created with the Save Source action. The value can be entered as a fixed value or dynamically linked via the Symbol Picker.
collectionName (String - Optional): Specifies the name of the collection to which the source belongs. If not specified, the system queries the default collection.
The collectionName parameter should be used when there are multiple collections (e.g., “Users,” “Documents,” “Embeddings”) within the same system.
Usage Scenario: Viewing Source Details
An application administrator wants to view the details of a text vector or user source previously saved in the system.
Scenario Steps:
Create a new screen (e.g., “Source Details”).
Add a Text Input (for correlationId entry) and a Button to the screen.
Add Get Source to the button's action.
Link the value obtained from the user to the correlationId field as a parameter.
Optionally, enter “UserVectors” in the collectionName field.
When the action is triggered, the source with the specified correlationId is fetched from the system and the result is displayed on the screen.
Get Source Action Advanced Customizations
Dynamic correlationId: The correlationId value can be obtained from user input, the result of another action, or an API response.
Collection-Based Filtering: Performance can be improved by searching only specific collections using the collectionName parameter.
Data Preview: Data from the action result can be dynamically displayed in elements such as Label, Table, or ListView.
Automatic Loading: The action can load data automatically by triggering in the Initial Actions section when the page opens.
Technical Risks
Invalid Correlation Id: If the correlationId value is incorrect or does not exist in the system, the action returns an empty result.
Incomplete Collection Information: If collectionName is entered incorrectly, the source may not be found.
Unauthorized Access: If source access is restricted by user role, the action may return an error.
Data Synchronization: If the same correlationId is repeated in different collections, the system may return the last record.
The Get Source action is a powerful query tool used to access sources registered on the Kuika platform and enable dynamic data management. When used in conjunction with the Save Source, List Sources, and Delete Source actions, it creates a comprehensive data lifecycle (CRUD) management system.
