Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
ui_map [2017/04/13 03:15] admin [UI Images] |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | =====UI Map Tab===== | ||
- | |||
- | UI Map allows you to build a layer of indirection between your automation script (MScript or java code) and the UI control on AUT. By defining this mapping, you can reference UI controls by the assigned //uiid// in MScript and // | ||
- | |||
- | UI Map also shows images of UI controls that can be used with [[sikuliplugin | Sikuli plugin]] to identify and interact with the UI. | ||
- | |||
- | {{http:// | ||
- | |||
- | ---- | ||
- | ====Configuration==== | ||
- | UI Map can be stored in a csv file, Excel spreadsheet, | ||
- | |||
- | Besides specifying UIMap in external text file, you can also import UI Pages from [[UIRepo | UI Repository (UIRepo)]]. | ||
- | |||
- | ---- | ||
- | ====UIMap File Format==== | ||
- | //UI Map// file must contain the following columns (note backslashe character " | ||
- | |||
- | Application Window UIID Locator Description | ||
- | |||
- | You may use different names for these columns or order these columns in different order in the file. But if you do, you must position these columns to match the order specified in the expected order. | ||
- | |||
- | For example if you name these columns as uiid, app, win, loc, desc in the Excel sheet, then you will use the following URI definition: | ||
- | |||
- | Excel: | ||
- | |||
- | ---- | ||
- | ==== Importing UIPage from UIRepo ==== | ||
- | If you have built UI Pages in [[UIRepo]], you may import UI Pages into UIMap for the current model. | ||
- | |||
- | All UI Elements for the selected UI Page are automatically imported into UIMap. | ||
- | |||
- | Only UI Pages/ | ||
- | |||
- | |||
- | You may access [[UIRepo]] by clicking on the link //UIRepo// on the header line. | ||
- | |||
- | If you have changed UI Pages that you have imported to the model, you may apply the updates to the current model by re-importing those UI Pages. | ||
- | |||
- | ---- | ||
- | ====Access UI Map==== | ||
- | |||
- | |||
- | In MScript editor, you can bring up the list of //UI Map// items with //Ctrl-U//. You will then use this uiid to replace the normal locator for the element. If uiid is not unique, you can use application and window qualifier with the syntax of // | ||
- | |||
- | You may only use //uiid// if it is unique in the UI Map list. For example if //userID// is unique, you can use // | ||
- | |||
- | ---- | ||
- | ==== UI Images ==== | ||
- | |||
- | UI Images are used by [[sikuliplugin | Sikuli plugin]] to identify UI controls. | ||
- | |||
- | To create a new image: | ||
- | * open AUT and navigate to the window that shows the UI control which you would like to take an image | ||
- | * mouse over //Take Image// button which should pop up a small window | ||
- | * enter an image name (without file extension) | ||
- | * if you have more than one monitors attached to your computer, specify the monitor id | ||
- | * click on //Take Image// button | ||
- | * use mouse to highlight the UI control (hold down left mouse button, drag and release left mouse button) | ||
- | * the image file is created and added to the image list | ||
- | |||
- | {{http:// | ||
- | |||
- | You can delete the image file by mouse over the image file name and click on //x//. | ||
- | |||