To use the Run UI Vision Macro action, you must first install UI Vision. For detailed installation information, see ‘How to Run an RPA Process Using Robotic Process Automation Actions’.

1. Project and Screen Selection
   
   • Open the project you are working on in the Kuika platform.
   • Go to the UI Design module and select the screen where you want to run the macro.
2. Add Action
   
   • Select an appropriate trigger on the UI screen, such as a button, event, or page load, that will trigger the automated test.

• In the Properties panel on the right, follow the path below from the + ADD ACTION menu: Initial Actions → Robotic Process Automation → Run UI Vision Macro

3. Configure Action Parameters

• Stringified Macro (String - required): Enter the JSON format text (stringified version) of the macro commands you created with UI Vision here. These commands include UI steps such as clicks, keystrokes, and waits.

4. Running the Action
   
   • When the action is triggered, Kuika automatically runs the specified macro commands and executes the test or automation process.

A team that wants to ensure that a web form works properly in every version can use the Run UI Vision Macro action to automatically test the form.

Steps such as filling in form fields, clicking the save button, and checking the successful registration message are automatically simulated with macro commands.

Add Action to Start UI Test When Form Loads

1. Enter the UI Design module and open the form screen you want to test.
2. From the Elements panel on the left, add an event (e.g., page load) or a test start button that will trigger the form.
3. Click the + ADD ACTION menu in the Properties panel and
4. select Initial Actions → Robotic Process Automation → Run UI Vision Macro.

Configure the Run UI Vision Macro Action

Stringified Macro:

Enter a macro command like the following example. This command fills in the form fields, clicks the save button, and checks the result:

{  "Name": "FormValidationTest",  "CreationDate": "2025-06-30",  "Commands": [    { "Command": "type", "Target": "id=firstName", "Value": "John" },    { "Command": "type", "Target": "id=lastName", "Value": "Doe" },    { "Command": "click", "Target": "id=submitBtn", "Value": "" },    { "Command": "assertText", "Target": "id=successMessage", "Value": "Kayıt başarılı" }  ]}

• Dynamic Macro Commands: You can dynamically change macro commands according to different situations and use variable data with the Symbol Picker.
• Conditional Flows with Macro Results: You can trigger other actions based on the results obtained when the macro is completed.
• Integrated Test Scenarios: Run UI Vision Macro can work with other Kuika actions to create comprehensive UI and RPA (Robotic Process Automation) scenarios.

Technical Risks

• Macro Command Errors: Invalid or incorrect macro commands may cause the action to fail. Commands must be in the correct format and tested.
• Compatibility Restrictions: This action only works on web platforms; it is not supported on mobile applications.
• Performance and Timing: Complex macros can take a long time to run, which can affect application performance. Necessary wait times and timeout settings must be carefully configured.
• Security: Automatically running macros must be appropriate for user permissions; authorisation controls must be provided for sensitive operations.

The Run UI Vision Macro action enables you to perform automated UI tests and macro-based process automations in Kuika applications, significantly accelerating and securing your development and testing processes.