Previous Versions

How to upgrade previous versions.

From version 6 to version 7

Namespaces

The following are the Find & Replace that you must do:

Find	Replace
Mobilize.Automation.Common	Mobilize.QualityMate.Automation.Entities
Mobilize.Automation.Controls	Mobilize.QualityMate.ControlInterfaces
Mobilize.Automation.Controls.Enums	Mobilize.QualityMate.ControlInterfaces.Enums
Mobilize.Automation.Core	Mobilize.QualityMate.Automation
Mobilize.Automation.Core.Configuration	Mobilize.QualityMate.Automation.Configuration
Mobilize.Automation.Core.Entities	Mobilize.QualityMate.Automation.Entities
Mobilize.Automation.Core.Extensions	Mobilize.QualityMate.Automation.Extensions
Mobilize.Automation.Core.Selectors	Mobilize.QualityMate.Automation.Selectors
Mobilize.Automation.Core.Test.Utilities.Helpers	Mobilize.QualityMate.UiTesting.MsTest
Mobilize.Automation.Core.Utils	Mobilize.QualityMate.Automation.Utils
Mobilize.Automation.Core.Web.Entities	Mobilize.QualityMate.Automation.Web.Entities
Mobilize.Automation.Core.Web.Selectors	Mobilize.QualityMate.Automation.Web.Selectors
Mobilize.Automation.Parser.Definitions	Mobilize.QualityMate.CssParser.Definitions
Mobilize.Automation.Parser.Parser	Mobilize.QualityMate.CssParser.Parser
Mobilize.Automation.Parser.Search	Mobilize.QualityMate.CssParser.Search
Mobilize.Quality.Mate.Core.Annotations	Mobilize.QualityMate.BDD.Annotations
Mobilize.Quality.Mate.Core.Exceptions	Mobilize.QualityMate.Common.Exceptions
Mobilize.Quality.Mate.Core.Logging	Mobilize.QualityMate.BDD.Logging
Mobilize.Quality.Mate.Tools.Comparators	Mobilize.QualityMate.Common.Comparators
Mobilize.Quality.Mate.Tools.Configuration	Mobilize.QualityMate.Common.Configuration
Mobilize.Quality.Mate.Tools.Extensions	Mobilize.QualityMate.Common.Extensions
Mobilize.Quality.Mate.Tools.Utils	Mobilize.QualityMate.Common.Utils

Other Considerations:

• You need to add the namespace using Mobilize.QualityMate.BDD; when inheriting from the Feature class.

• When using XPathSelector add using Mobilize.QualityMate.Automation.Selectors instead of Mobilize.Automation.Core.Web.Selectors this namespace doesn't exist anymore.

Deprecated:

• TestFeature class; use instead UiTest class.

• UiPlayerAdapter class; use instead UiPlayer class.

Here is a guide to know: How to switch from TestFeature to UiTest.

Configuration

In the .runsettings file, change the following parameter names:

Deprecated	New
ApplicationUrl	Application
RunParameters	ApplicationArguments
TestTimeout	ExecutionTimeout
ParametersData	CsvDataPaths
Incognito	RunInPrivate

Only change the name; the value will remain to be the same.

From version 5 to version 6

The following are the Find & Replace that you must do:

Find	Replace
Logger.LogStep	UiPlayer.LogStep
AlertManager	UiPlayer.AlertManager
NavigationManager	UiPlayer.NavigationManager
ExecuteScript	UiPlayer.BrowserManager.ExecuteScript
ExecuteAsyncScript	UiPlayer.BrowserManager.ExecuteAsyncScript
PerformScroll	UiPlayer.BrowserManager.PerformScroll
CloseBrowser	UiPlayer.BrowserManager.Close
WebTestFeature	TestFeature
ConfigurationManager.Instance	ConfigurationManager
Mobilize.Quality.Mate.Core.Configuration	Mobilize.Quality.Mate.Tools.Configuration
MaximizeBrowser	Maximize
MinimizeBrowser	Minimize
GetBrowserUrl	GetUrl
ResizeBrowser	Resize
WebSelector[ \t]*\((.*)\)[ \t]*$	Selector\($1, Technology.Web\)
DesktopSelector[ \t]*\((.*)\)[ \t]*$	Selector\($1, Technology.Desktop\)
VB6Selector[ \t]*\((.*)\)[ \t]*$	Selector\($1, Technology.VB6\)
WinFormsSelector[ \t]*\((.*)\)[ \t]*$	Selector\($1, Technology.WinForms\)

If you are using VB6Selector, DesktopSelector, WinformsSelector or WebSelector, apply the corresponding find&replace. E.g.: WebSelector(“#MyId”) => Selector(“#MyId”, Technology.Web)

Other Considerations:

• SQL methods (ExecuteReader & ExecuteNonQuery) are not included in the TestFeature class anymore. They were simple methods with nothing interesting. You can find the whole implementations downloading the SQL Functions file. It seems they only exist to use a DBConnectionString parameter specified in the .runsettings. If needed, you can copy-paste the implementations and read that same parameter from the ConfigurationManager:

    this.ConfigurationManager.GetSetting<string>("DBConnectionString")

2KB

SQLFunctions.txt

SQL Functions

• RowCount for Web was counting the header before. Now it works in the same way as other grids and does not count the header.

• Make sure you remove Mobilize.Automation.Core.Test.Utilities from the NuGets of the solution

• The Validate method is only available for controls and page objects. Elements of the screen that can change.

  For elements that won't change, you can use a .Net framework Debug.Assert.

• The Wait method has been removed from TestFeature. You should remove Wait with no criteria and replace them with Validate with specific criteria. This will make your TCs faster and less error-prone. If required in exceptional cases (sporadic and not recommended), use Thread.Sleep instead.

From version 4 to version 5

• Deprecated: should() assertions. Use .Validate() instead.

• Deprecated: RightClick, DoubleClick, LeftClick. Use the unique Click() method with the corresponding parameters instead.

For more details of the new features, go to the Changelog section.