Skip to main content

Locator Store

Locator Store is where Clicknium stores locators.


Clicknium provides locator store to help developers manage locators. Locators will be sent into locator store automatically after captured by Clicknium Recorder. You can edit and manage locators in the store. Python code intelliSense will auto update in real-time. There are two types of locator store: Local Locator Store and Cloud Locator Store. Clicknium supports switching in both types.

Locator Store Type

There are two types of locator store:

  • Local locator Store
  • Cloud locator Store

Local Locator Store

Local locator Store will automatically generated by default when the recorder captured first locator. Local locator store is a file in the project root path that stores the locators. According to the implementation, the store will go with the Python project and cannot be share with another project. It also means that the code can run offline.

local locator store

Cloud Locator Store

Cloud Locator Store is powered by Clicknium. After a successful log-in, cloud locator store will be connected. It can be referenced into the current project. The frequently-used locators are stored in the cloud locator store so they can be shared among different projects by even different person. The Python scripts can run anywhere with the Internet access.

How to choose

Type Pros Cons
Cloud Locator Store - Recorded once and used anywhere across projects/computers.
- If UI changes break the locator, fixing one locator is enough for all projects.
- Need Internet access.
Local Locator Store - Offline run.
- No network latency.
- Need to record each locator for every project.
- Can't be shared cross projects/computers.

Locator Store Management

You can manage the Locator Store in Clicknium Recorder, your projects and Clicknium VS Code panel for the Cloud Store with the same experience. When you modify the locator store, please refresh the locator store in other place to sync the latest version.

Supported Store Operations:

  • Create new store
  • Rename store name: please notice it might break existing code. The store name is one part of identity of locator. The referenced code needs to be updated accordingly.
  • Folder: create/update/delete a new folder under the a store to group locator.
  • Remove Reference:remove the referenced store in the project.
  • Convert to Cloud/Local locator store: locator store can be convert to local or cloud seamlessly.

You can create multiple stores. Folders can be create under a store to manage locator better.

edit store

Local Locator Management

Find Local locator store in VS Code Explorer under LOCATOR tab with the same experience as in cloud locator store.

Cloud Locator Management

Click 'Clicknium Explorer' button in Visual Studio Code Activity Bar to show 'CLOUD LOCATORS' panel.
If you haven't signed in yet, click 'Sign in' button to navigate to Clicknium webpage to sign up or sign in. For more information, please refer to Connect to Cloud.
You can see the cloud locator store lists.
Cloud locator 1

Capture locators

Click 'Capture' button on the right side of one cloud locator store to invoke 'Clicknium Recorder', then you can capture and manage the locators in the locator store.

Cloud locator 2
For more information, please refer to Clicknium Recorder

Reference cloud locator store to project

Click Reference button on the right side of one cloud locator store.

Cloud locator 3
The locator store will be referenced to the current project.

Cloud locator 4