Kullanıcı Kılavuzu

Run UI.Vision Macro

Run UI.Vision Macro

Kuika's Run UI Vision Macro action is used to run automated user interface (UI) tests or macros at specific steps in your application. This action simulates user interactions, allowing you to check whether your application works as expected in different scenarios and optimise your processes.

Key benefits:

  • Ensure that UI components work correctly and without errors.
  • Reduce manual testing processes and increase your automation level.
  • Identify errors early to speed up development and testing processes.

The Run UI Vision Macro action is only supported for web applications.

Technical Specifications

  • Web Application Support: Only works with web-based applications.
  • Macro Commands: Macro commands are defined as strings (text) in a format compatible with the UI Vision toolset.
  • Automation Type: Enables automatic repetition of user actions (clicking, typing, selecting, waiting, etc.).
  • Integration: Can be integrated with other actions and triggers within Kuika to create automated test or process steps in complex workflows.

Run UI Vision Macro Action Application Steps

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
  1. 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.
  1. Running the Action
    • When the action is triggered, Kuika automatically runs the specified macro commands and executes the test or automation process.

Use Case: Form Validation with Automated UI Testing

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ı" }  ]}

Run UI Vision Macro Action Advanced Customisations

  • 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.

Other Related Content

No items found.

Glossary

No items found.

Alt Başlıklar