Filters

The Filters is a JSON file that specify which controls will be converted to a Page Object.

Filters may be handy when there are User Controls or controls with a lot of sub controls.

Setting Up

First add a new folder with the name Filter in your Recorder Project folder then create a new file with the name Filter.json, you may have a structure like this:

📂 RecorderProjects
┣ 📂 Project1
┃  ┣ 📂 Raw
┃  ┃ ┗ 📄 model.json
┃  ┣ 📂 Filter
┃  ┃ ┗ 📄 Filter.json
┃  ┗ 📜 Project1.rp

The name for folder and files are case sensitive

After Generating QualityMate Solution or using the Test Case Generator you will have the Filter folder and the Filter.json file in the Recorder Project folder.

Filling the Filter.json

Once we have our file, then its time to fill it with the filters that we want. The filter will take into account two properties for each component: ClassName and ControlType. You can identify them using Identyfing Selector.

In the file we need to add the key with the name InnerPageObjectFilters and we will populate it with a list. Inside the list we create an object with our two properties like the following example:

{
  "InnerPageObjectFilters": [
    {
      "ClassName": "MyClassName",
      "ControlType": "MyControlType",
    }
  ]
}

If you need to add more filters create a new object; also you leave one property as an empty field adding the null word or omitting it.

{
  "InnerPageObjectFilters": [
    {
      "ClassName": "MyClassName",
      "ControlType": "MyControlType",
    },
    {
      "ClassName": "MyNewClassName",
      "ControlType": null,
    },
    {
      "ControlType": "MyOnlyControlType",
    },
    {
      "ClassName": "MyOnlyClassName",
    },
  ]
}

Once the file is in the folder the Test Case Generator will use to create Page Objects.