详细介绍
Xpath Evaluator 帮助您查找网页元素的 XPath 和其他属性,并保存这些信息以构建对象库。
OR Manager:功能说明文档
简介
OR Manager 是一款 Google Chrome 扩展程序,可帮助您创建和编辑 JSON 及 XML 格式的现有对象库。
所有自动化工具都根据应用程序对象的属性来识别对象。在自动化中,这些属性称为定位器类型和定位器值。定位器类型可以是 id、name、xpath、css 等,定位器值是其在应用程序中的实际值。所有这些定位器都保存在称为对象库(OR)的文件中。
OR Manager 的主要功能
• 选择网页元素。
• 为选定的网页元素创建对象库。
• 如果元素已存在于对象库中,可在网页上高亮显示或验证该元素。
• 编辑现有对象库文件。
字段及其说明:
1. Element name:
• 这是与文本框关联的标签。
• 此文本框用于输入要在网页中高亮显示的元素名称。
• 检查元素时,此文本框存储最后一个保存到对象库中的元素名称。
• 此文本框可读写。
• 默认情况下,此文本框没有值。
2. Selection:
• 这是与文本框关联的标签。
• 文本框存储最后一个保存到对象库中的元素名称。
• 此文本框为只读。
• 默认情况下,此文本框没有值。
3. Web element:
• 这是一个文本区域,存储最后一个添加到对象库中的元素的定位器属性。
• 此文本区域为只读,大小固定。
• 默认情况下,此文本区域没有值。
4. Object Repository:
• 这是与文本区域关联的标签,该文本区域以 JSON 格式存储所有已添加网页元素及其定位器属性的列表。
• 此文本区域为只读,大小固定。
• 默认情况下,此文本区域没有值。
图标及其说明:
1. Highlight:
• 如果元素已存在于对象库中,此图标用于在网页中高亮显示该元素。
• 在高亮图标前的文本框中输入要高亮显示的元素名称,然后点击高亮图标。
• 高亮图标始终处于启用状态。
2. Inspect:
• 此图标用于检查网页中的元素。
• 默认情况下,检查按钮处于禁用状态。
• 点击检查按钮以启用检查功能。
3. Reset:
• 此图标用于将 Element name 文本框、Selection 文本框和 Web element 文本区域的值重置为默认值。
• 重置图标始终处于启用状态。
4. Stop:
• 此图标用于停止检查。
• 默认情况下,停止图标处于禁用状态。
• 点击检查图标后,停止图标会启用,可用于停止检查。
按钮及其说明:
1. JSON download:
• 此按钮用于以 JSON 格式下载生成的对象库。
2. XML download:
• 此按钮用于以 XML 格式下载生成的对象库。
3. Upload Object Repository:
• 此按钮用于上传现有对象库进行编辑。
4. Cancel:
• 此按钮用于将工具页面重置为默认状态。
创建对象库的步骤
1. 点击扩展程序图标,打开 OR Manager 工具。
2. 点击检查图标,启用检查功能。
3. 将鼠标移至网页上要添加到对象库的元素,然后点击该网页元素。随后会打开弹窗。
如果网页的 HTML 中存在该元素的名称或 ID,弹窗会显示这些信息。这将成为对象库中的对象名称。
用户可以根据需要更改此名称。
4. 点击 OK,以默认名称将对象保存到对象库,或输入自定义名称。
a. 如果元素已添加到对象库,将弹出“Same element with same set of properties already exist”(具有相同属性集的相同元素已存在)。
b. 如果对象库中已存在元素名称相同但属性集不同的元素,将弹出“Element with same name exists. Click 'OK' to update its properties else click 'Cancel”(同名元素已存在。点击“OK”更新其属性,否则点击“Cancel”)。如果要更新属性,请点击“OK”按钮,否则点击 Cancel 按钮。
c. 如果对象库中已存在属性集相同但元素名称不同的元素,将弹出“Same properties are already present with another element. Click 'OK' to create a new Element else click 'Cancel”(另一个元素已具有相同属性。点击“OK”创建新元素,否则点击“Cancel”)。点击“OK”按钮创建新元素,否则点击“Cancel”。
d. 如果元素不存在于对象库中,它将被添加到对象库。
5. 重复步骤 3 和步骤 4,向对象库添加更多元素。
6. 添加所有元素后,点击“JSON download”按钮以 JSON 格式下载对象库,或点击“XML download”按钮以 XML 格式下载对象库。
注意:
• 最后添加的元素可在 Web element 文本区域中查看。
• 所有添加的元素可在 Object Repository 文本区域中查看。
编辑现有对象库的步骤
1. 点击上传对象库按钮。
2. 随后将打开文件资源管理器。选择 JSON 或 XML 文件并点击 OK。
3. 选择 JSON 或 XML 文件并点击 OK。
a. 如果对象库不属于同一页面,将弹出“OR doesn’t match with the current web page”(对象库与当前网页不匹配),数据不会加载到 OR Manager 中进行编辑。
b. 如果对象库不是 XML 或 JSON 格式,将弹出“Please upload a JSON or XML file to process…”(请上传要处理的 JSON 或 XML 文件……),数据不会加载到 OR Manager 中进行编辑。
4. 如果对象库属于同一网页且格式为 JSON 或 XML,对象库将加载到 Object Repository 文本区域中。
5. 成功加载对象库后,点击检查图标进行编辑。
6. 将鼠标移至网页上要添加到对象库的元素,然后点击。随后会打开弹窗。
7. 点击 OK,以默认名称将对象保存到对象库,或输入自定义名称后点击 OK。
a. 如果元素已添加到对象库,将弹出“Same element with same set of properties already exist”(具有相同属性集的相同元素已存在)。
b. 如果对象库中已存在元素名称相同但属性集不同的元素,将弹出“Element with same name exists. Click 'OK' to update its properties else click 'Cancel”(同名元素已存在。点击“OK”更新其属性,否则点击“Cancel”)。如果要更新属性,请点击“OK”按钮,否则点击 Cancel 按钮。
c. 如果对象库中已存在属性集相同但元素名称不同的元素,将弹出“Same properties are already present with another element. Click 'OK' to create a new Element else click 'Cancel”(另一个元素已具有相同属性。点击“OK”创建新元素,否则点击“Cancel”)。点击“OK”按钮创建新元素,否则点击“Cancel”。
d. 如果元素不存在于对象库中,它将被添加到对象库。
8. 重复步骤 6 和步骤 7,向对象库添加更多元素。
9. 完成所有编辑后,点击“JSON download”按钮以 JSON 格式下载对象库,或点击“XML download”按钮以 XML 格式下载对象库。