Rapise Packaged Application Testing Testing Microsoft Dynamics Applications with Rapise

Size: px

Start display at page:

Download "Rapise Packaged Application Testing Testing Microsoft Dynamics Applications with Rapise"

Gertrude Christine Clarke
5 years ago
Views:

1 Rapise Packaged Application Testing Testing Microsoft Dynamics Applications with Rapise Last Updated: March 2nd, 2018

2 Contents Introduction Testing Dynamics AX Testing Dynamics CRM Testing Dynamics Testing Dynamics NAV Introduction Rapise is a next generation software test automation tool that leverages the power of open architecture to improve application quality and reduce time to market. Microsoft Dynamics is a line of enterprise resource planning (ERP) and customer relationship management (CRM) software applications from Microsoft. The Microsoft Dynamics focus industries are retail, service, manufacturing, financial services, and the public sector. Microsoft Dynamics offers support for small, medium, and large businesses. Rapise has special extensions included out of the box that allow it easily test and validate Microsoft Dynamics implementations, reducing the time to regression test customizations and configurations. Rapise includes include out of the box support for testing Dynamics AX, Dynamics CRM, and Dynamics 365. For information on using Rapise itself, please refer to the Rapise User Guide. Page 1 of 37

1. Testing Dynamics AX Microsoft Dynamics AX (formerly Axapta) - multi-language, multi-currency enterprise resource planning (ERP) business software with global business management features for

3 1. Testing Dynamics AX Microsoft Dynamics AX (formerly Axapta) - multi-language, multi-currency enterprise resource planning (ERP) business software with global business management features for financial, human resources, and operations management as well as additional industry capabilities for retailers, professional service industries, financial service businesses, manufacturers, and public-sector organizations Rapise includes specialized libraries for testing Dynamics AX applications that are built-upon the standard Microsoft Windows UIAutomation library with special extensions for handling unique AX controls such as treeviews, the navigation explorer and the various grids used to edit data. In addition Rapise can test the following extensions to Dynamics AX: Dynamics AX Management Reporter - Rapise can test this extension using its Generic Windows library Dynamics AX Web Portals - Rapise can test the various web portals using its web browser libraries Overview In this section, we describe how to master tests for Dynamics AX application using Rapise. Rapise provides a complete automated testing solution that can handle all of your technologies in one environment. With support for web, mobile and desktop applications and a wide variety of third-party component libraries. Microsoft Dynamics AX 2012 is an ERP system for mid-size to large enterprises. It is the most robust, scalable, and functionally rich enterprise resource planning system in the Microsoft Dynamics family of products. The system was originally known as Axapta, owned by the Danish software company Damgaard Start Recording a New Test First you need to create a new Basic test and start recording session. Choose Dynamics AX from the list of applications: Page 2 of 37

4 Then press Select button to start recording. Rapise will automatically plug the UIAutomation and DynamicsAX libraries. Microsoft UI Automation is the new accessibility framework for Microsoft Windows, available on all operating systems that support Windows Presentation Foundation (WPF). UI Automation provides programmatic access to most user interface (UI) elements on the desktop, enabling assistive technology products such as screen readers to provide information about the UI to end users and to manipulate the UI by means other than standard input. UI Automation also allows automated test scripts to interact with the UI. DynamicsAX library supports set of controls specific to Microsoft Dynamics AX 2012 application. When recording is completed you can see attached libraries in the code of test.js file: g_load_libraries=["uiautomation", "DynamicsAX"]; 1.3. Automatic Adjustment of Window Title Object Property Main window title of Dynamics AX is dynamic by nature. It contains not only application name but also domain and AOS information and session Id. So it can be different at the time of test recording and test playback. To cope with this problem Rapise automatically replaces actual window title with a regular expression in object properties. Here it is: regex:.microsoft Dynamics AX.* So recorded object properties automatically adjusted as Page 3 of 37

Also Rapise automatically sets Record Title in test settings to the same regular expression so you do not need to choose the Dynamics AX main window during subsequent recording sessions. 1.4.

But the good news is you need to do this for one object only in every such window. For further learned objects Rapise will change the window title property automatically.

5 Also Rapise automatically sets Record Title in test settings to the same regular expression so you do not need to choose the Dynamics AX main window during subsequent recording sessions Titles of Child Windows Child windows of Dynamics AX also may have dynamic titles. Rapise does not know all the available patterns, so for child windows you need to write regular expressions yourself. But the good news is you need to do this for one object only in every such window. For further learned objects Rapise will change the window title property automatically. In other words when Rapise learns a new object and it's window title is matched by a regular expression of a previously learned object then the title property is automatically replaced by this regular expression Object Location Object location property has the form of id1/id2/id3... where ids refer to parent objects along the path to the top window object. Sometimes such ids also can be dynamic, e.g.: Dimensions display (1 - k13) - Sales order: S , CE15P, Sales order: S /InventDimParmFixed/Pane/View/Style In this case change dynamic parts by corresponding regular expressions. In the above example updated location looks like: Page 4 of 37

6 regex:dimensions display.*/inventdimparmfixed/pane/view/style Here is updated location in the property grid: 1.6. How to Launch Dynamics AX Client If in your test you want to check that Dynamics AX application is installed and running use the code: var fso = new ActiveXObject("Scripting.FileSystemObject"); var pffolder = Global.GetSpecialFolderPath("ProgramFilesX86"); var dynamicspath = pffolder + "\\Microsoft Dynamics AX\\60\\Client\\Bin\\Ax32.exe" if(!fso.fileexists(dynamicspath)) { Tester.Message("Dynamics AX Client is not installed on this computer"); return; } var windows = g_util.findwindows("regex:.microsoft Dynamics AX.*", "AxMainFrame"); if (windows.length == 0) { Tester.Message("Dynamics AX Client is not started. Please start it manually and re-run the test."); return; } To start the application use Global.DoLaunch(dynamicsPath); 1.7. Recording Actions and Learning Objects During recording while you interact with Dynamics AX controls Rapise captures actions and displays them in the recording dialog. Page 5 of 37

$Test() { //User clicks at: 28, 30 in 'Hire new worker' SeS('Hire_new_worker').DoLClick(28, 30); //User clicks at: 20, 8 in 'First name' SeS('First_name').$ DoLClick(20, 8); //Do SetText("John") on First name SeS('First_name').DoSetText("John"); //User clicks at: 26, 11 in 'Middle name' SeS('Middle_name').

DoLClick(20, 8); //Do SetText("John") on First name SeS('First_name').DoSetText("John"); //User clicks at: 26, 11 in 'Middle name' SeS('Middle_name').

7 After this recording session corresponding UI area looks as follows: When recording is finished Rapise automatically generates the test code: function Test() { //User clicks at: 28, 30 in 'Hire new worker' SeS('Hire_new_worker').DoLClick(28, 30); //User clicks at: 20, 8 in 'First name' SeS('First_name').DoLClick(20, 8); //Do SetText("John") on First name SeS('First_name').DoSetText("John"); //User clicks at: 26, 11 in 'Middle name' SeS('Middle_name').DoLClick(26, 11); //Do SetText("A") on Middle name SeS('Middle_name').DoSetText("A"); //User clicks at: 22, 10 in 'Last name' SeS('Last_name').DoLClick(22, 10); Page 6 of 37

8 } //Do SetText("Smith") on Last name SeS('Last_name').DoSetText("Smith"); //Item selected:'cto' SeS('Job').DoSelectItem("CTO"); If Rapise does not capture any interaction or captures it wrongly then try to learn the object. In this case Rapise will add it to the object tree but will not capture the action and you'll add the code to the test manually later. To learn an object during recording session place mouse cursor over it and press Ctrl- 2 shortcut. It makes sense to pause recording before learning objects. This will prevent Rapise from intersecting mouse and keyboard and attempting to record interactions you do. Pause/Resume button is located at the right side of the Recording dialog Tips for Interacting with Objects Text Box To allow Rapise to capture the entered text interact with a text box in two steps: 1. Click into the edit box 2. Type text using keyboard ComboBox Dynamics AX has several types of combo boxes. Standard combo box like Job in the Hire New Worker example above. Rapise treats such combo boxes as atomic objects. To set a value in such a combo use the DoSelectItem action: SeS('Job').DoSelectItem("CTO"); Table filter combo is recognized as a pair of objects: MenuItem and DropDown. The MenuItem is used to open the DropDown. Here is the code generated on recording: //User clicks at: 115, 7 in 'Scope' SeS('Scope').DoLClick(115, 7); //DropDown item selected:'personnel number' SeS('DropDown').DoSelectItem("Personnel number"); o Lookup field consists of an edit box, open button and a dropdown table. This is the case when Rapise can record edit box interaction only. To make a choice from the table learn open button and then learn the table. Page 7 of 37

9 This is the code to lookup a value: // Press open button SeS('Default_company_lookup_button').DoClick(); // In the first column select a cell with value 'DAT' SeS('Grid').DoClickCell("DAT", 0); // Or alternatively select the first row in the first column SeS('Grid').DoClickCell(0, 0);``` Address Bar Learn the address bar control using Ctrl-2 shortcut. Set the path using DoSetText action in your code: SeS('AddressBarContainer').DoSetText('DAT/Retail essentials/employees/users'); Menu Rapise supports both recording and learning of the main menu. When recording make sure you click on every component along the path. E.g. you want to navigate to File > View > Modules > General ledger. During recording click on File, View, Modules andgeneral ledger. Generated code looks like: //Menu item selected:'general ledger' SeS('File').DoMenu("File;View;Modules;General ledger"); Rapise captures menu as top level object (File in the example above). Notice that menu path components are separated with ;. If you want for example to open the menu File > Tools > Telephone list then write: Page 8 of 37

10 SeS('File').DoMenu("File;Tools;Telephone list"); Table To work with a table/grid learn it first and then write the code. // To click on the cell at first column and first row // First column contains checkboxes. First row is 'Administrator' record. SeS('Grid').DoClickCell(0, 0); // To click on 'contoso.com' in 'Network domain' column SeS('Grid').DoClickCell("contoso.com", "Network domain"); // Get column name by index (returns 'Network domain') var columnname = SeS('Grid').GetColumnName(3); // Click on column header (clicks on the checkbox to select all rows in the table) SeS('Grid').DoClickColumn(0); Infolog In some case Dynamics AX can report an error using Infolog window. Page 9 of 37

// Get the number of messages in the infolog. // For the presented example it returns 2. var messagecount = SeS('Tree').

11 To obtain text of the messages in this window learn the Tree object - place cursor over the error text and press Ctrl-2 shortcut. In the case of infolog tree - all tree nodes are immediate children of the root. So in the example shown on the image above the tree contains two child nodes of the tree node. // Get the number of messages in the infolog. // For the presented example it returns 2. var messagecount = SeS('Tree').GetChildrenCount(); // Get second message text, returns "Field 'User ID' must be filled in." var messagetext = SeS('Tree').GetNodeText(1); Type to filter Field Almost each standard grid in Dynamics AX has a text field for filterring grid data. When you learn this field it has a name Type to filter. Page 10 of 37

However when this field gets focus it's name changes to Text box. To enable Rapise to find this field during playback set Ignore Object Name property of the object to True. 1.8.

12 However when this field gets focus it's name changes to Text box. To enable Rapise to find this field during playback set Ignore Object Name property of the object to True Dynamics AX Useful Tips & Tricks Maximize/Minimize/Restore Window You can maximize a window using any object inside it as a starting point. SeS('AddressBarContainer').getDesktopWindow().Maximized = true; To minimize use SeS('AddressBarContainer').getDesktopWindow().Maximized = false; // or SeS('AddressBarContainer').getDesktopWindow().Iconic = true; Page 11 of 37

SeS('Last_Record').DoAction(); // or SeS('Last_Record').

13 For restoring (to go back to a smaller window from maximized or minimized state) use SeS('AddressBarContainer').getDesktopWindow().Iconic = false; Scroll to the Bottom of a Grid If your grid looks like this and you want to scroll to the last record of it learn the Last Record button and click on it during test playback: SeS('Last_Record').DoAction(); // or SeS('Last_Record').DoClick(); Scroll and Click on a Cell in a Grid If you know the value of a cell in a grid then Rapise will automatically scroll the grid before clicking: Let's assume that you want to click on a cell with value W9 W9 in a column Search name. This cell is not visible on the picture and requires scrolling to show up. The following code performs the click: SeS('Grid').DoClickCell("W9 W9", "Search name"); If you do not know the value of a cell you can get it this way: var cellvalue = SeS('Grid').GetCell(9, "Search name"); Page 12 of 37

14 Where 9 is row number References 1. Rapise home page: 2. Contact Inflectra: Page 13 of 37

2. Testing Dynamics CRM Microsoft Dynamics CRM is a customer relationship management application from Microsoft, that provides sales, service, and marketing capabilities.

15 2. Testing Dynamics CRM Microsoft Dynamics CRM is a customer relationship management application from Microsoft, that provides sales, service, and marketing capabilities. Microsoft sells Microsoft Dynamics CRM separately from the ERP products. CRM is available either as on-premises software or as a software-as-a-service offering called "Microsoft Dynamics CRM Online". Rapise can be used to test installations of Dynamics CRM both on premise and cloud hosted. Both versions of Dynamics CRM (server and online) are completely web-based and use a web browser to access the user interface. Therefore when recording a test using Rapise, you use the same web browser libraries that you use to record other web tests: Most of the Dynamics CRM user interface will be tested using the standard browser library for your web browser of choice (e.g. Internet Explorer HTML, Firefox HTML, and Chrome HTML). Page 14 of 37

16 In addition, there are special controls inside CRM that Rapise has specialized support for. For that reason, you'll also see the DomDynamicsCrm library added to your test as well as the browser one. This DomDynamicsCrm library adds additional rules that identify certain CRM objects to make testing easier Recording a Dynamics CRM Test Both versions of Dynamics CRM (server and online) are completely web-based and use a web browser to access the user interface. Therefore when recording a test using Rapise, you use the same web browser libraries that you use to record other web tests: o Most of the Dynamics CRM user interface will be tested using the standard browser library for your web browser of choice (e.g. Internet Explorer HTML, Firefox HTML, and Chrome HTML). o In addition, there are special controls inside CRM that Rapise has specialized support for. For that reason you'll also see the DomDynamicsCrm library added to your test as well as the browser one. This DomDynamicsCrm library adds additional rules that identify certain CRM objects to make testing easier. When you record your first test, you'll see the following library selection code generated automatically by Rapise: g_load_libraries=["%g_browserlibrary:internet Explorer HTML%", "DomDynamicsCrm"]; If you don t see the DomDynamicsCrm library listed in your test, then you will need to manually add it Recording and Learning Objects During recording while you interact with Dynamics CRM, Rapise captures actions and displays them in the recording dialog: Page 15 of 37

17 Some of these objects will be standard HTML DOM objects (e.g. hyperlink): and others will be specific to Dynamics CRM: Page 16 of 37

2.3. Tips for Interacting with Objects The following unique objects are available within Dynamics CRM that Rapise has special support for: Dynamics CRM Grid One of the most important UI elements

18 2.3. Tips for Interacting with Objects The following unique objects are available within Dynamics CRM that Rapise has special support for: Dynamics CRM Grid One of the most important UI elements inside Dynamics CRM is the sortable, filterable grid: The Dynamics CRM Grid is used in lots of different screens inside Dynamics CRM (e.g. Contacts, Accounts, etc.) and it is very common to need to interact with it in test scripts. When you record operations on such a grid or simply learn the entire grid using CTRL+2 you will learn the DynamicsCrmGrid object: Page 17 of 37

In additional to the standard HTML object methods and properties, you have the following special functions that you can perform on the grid: o DoClickCell() - Clicks the specified cell when you

19 In additional to the standard HTML object methods and properties, you have the following special functions that you can perform on the grid: o DoClickCell() - Clicks the specified cell when you specify the x-index, y-index, the type of click (leftclick, right-click, etc.) o DoFullText() - Returns the textual representation of the entire table o GetCell - Gets the text of the specified cell. o GetColumnCount - Gets the number of columns in grid o GetColumnName - Gets the caption of a column. o GetRowCount - Gets the number of rows in grid o GetSelectedRow - Gets the index of the selected row. o GetSelectedRowCount - Gets the number of selected rows. o GetSelectedRows - Gets the selected rows. Page 18 of 37

20 3. Testing Dynamics 365 Microsoft has created a new cloud-based SaaS-only combined ERP/CRM solution called Microsoft Dynamics 365. This provides a new web-based version of Dynamics AX (renamed Dynamics 365 for Operations), combined with a new web based version of Dynamics NAV (called Dynamics 365 for Financials) and an updated Microsoft Dynamics CRM Online. This new integrated, ERP/CRM is provided solely through Microsoft Azure and is completely web-based. There are two main modules that Rapise has specialized support for: 1. Dynamics 365 for Operations this is the subject of this section, please read on if you are testing these modules. 2. Dynamics 365 for Sales this is a rebrand of Dynamics CRM and is covered in section 2 above Recording a Dynamics 365 for Operations Test Dynamics 365 for Operations is completely web-based (unlike Dynamics AX) and you use a web browser to access the user interface. Therefore when recording a test using Rapise, you use the same web browser libraries that you use to record other web tests: o Most of the Dynamics 365 user interface will be tested using the standard browser library for your web browser of choice (e.g. Internet Explorer HTML, Firefox HTML, and Chrome HTML). o In addition, there are special controls inside Dynamics 365 that Rapise has specialized support for. For that reason you'll also see the DomDynamicsAx library added to your test as well as the browser one. This DomDynamicsAx library adds additional rules that identify certain Dynamics 365 objects to make testing easier. When you record your first test, you'll see the following library selection code generated automatically by Rapise: g_load_libraries=["%g_browserlibrary:internet Explorer HTML%", "DomDynamicsAx"]; If you don t see the DomDynamicsAx library listed in your test, then you will need to manually add it. Page 19 of 37

recording dialog: Some of these objects will be standard HTML DOM

21 3.2. Recording and Learning Objects During recording while you interact with Dynamics 365, Rapise captures actions and displays them in the recording dialog: Some of these objects will be standard HTML DOM objects (e.g. hyperlink): and others will be specific to Dynamics 365: Page 20 of 37

3.3. Tips for Interacting with Objects One of the most important UI elements inside Dynamics 365 is the multi-level menu bar: The Dynamics 365 menu bar is used to quickly and

When you click on entries in the menu bar or simply learn the entire menu using CTRL+2 you will learn the DomDynamicsAXMenuBar object: In additional to the standard HTML object

22 3.3. Tips for Interacting with Objects One of the most important UI elements inside Dynamics 365 is the multi-level menu bar: The Dynamics 365 menu bar is used to quickly and easily navigate between different parts of the application and it is very common to need to interact with it in test scripts. When you click on entries in the menu bar or simply learn the entire menu using CTRL+2 you will learn the DomDynamicsAXMenuBar object: In additional to the standard HTML object methods and properties, you have the following special functions that you can perform on the grid: o DoMenu(path, separator) selects the menu entries in specified path, using the specified separator (or semicolon if none specified). Page 21 of 37

23 Here is a sample test that was recorded using Dynamics 365 for Operations and Rapise: function Test() { //Get the sample data from the database var conn = 'Provider=Microsoft.ACE.OLEDB.12.0;Data Source=SampleData.accdb'; var sql = 'SELECT TEST_VALUE FROM TEST_DATA'; Database.DoAttach(conn, sql); do { var testvalue = Database.GetValue('TEST_VALUE'); if (testvalue) { SeS('MenuBar').DoMenu("Modules;Procurement and sourcing;purchase orders;all purchase orders"); StartNewPurchaseOrder(); FillPurchaseOrderForm(testValue); SeS('MenuBar').DoMenu('', ''); } } while (Database.DoSequential()) } g_load_libraries=["%g_browserlibrary:internet Explorer HTML%", "DomDynamicsAX"]; StartNewPurchaseOrder*/ function StartNewPurchaseOrder() { Global.DoWaitFor('New1'); SeS('New1').DoClick(); } FillPurchaseOrderForm*/ function FillPurchaseOrderForm(data) { Global.DoWaitFor('DIV1'); SeS('DIV1').DoClick(); SeS('DIV2').DoClick(); } //Click on DIV SeS('DIV3').DoClick(); //Learned Vendor account SeS('Vendor_account1').DoClick( ); //Set Text datss in datss SeS('dat').DoSetText(data); SeS('OK').DoClick(); Page 22 of 37

4. Testing Dynamics NAV 4.1. Overview Microsoft Dynamics NAV (formerly Navision) is an enterprise resource planning (ERP) software suite for midsize organizations.

24 4. Testing Dynamics NAV 4.1. Overview Microsoft Dynamics NAV (formerly Navision) is an enterprise resource planning (ERP) software suite for midsize organizations. The system offers specialized functionality for manufacturing, distribution, government, retail, and other industries. Microsoft Dynamics NAV offers applications for financial management, human resources management, manufacturing, multiple and international sites, project management, sales and marketing, service management, supply chain management and business intelligence. The functionality is particularly designed for manufacturing and distribution sector. Rapise includes specialized libraries for testing Dynamics NAV applications that are built-upon the standard Microsoft Windows UIAutomation library with special extensions added to its DynamicsNav library capable of handling unique NAV controls such as the various grids used to edit data Start Recording a New Test First you need to create a new Basic test and start recording session. Choose Dynamics NAV from the list of applications: Page 23 of 37

Application Chooser Dialog Then expand the list of libraries and select UIAutomation and DynamicsNAV libraries.

Microsoft UI Automation is the new accessibility framework for Microsoft Windows, available on all operating systems that

UI Automation provides programmatic access to most user interface (UI) elements on the desktop, enabling assistive

25 Application Chooser Dialog Then expand the list of libraries and select UIAutomation and DynamicsNAV libraries. UIAutomation Library Selected DynamicsNAV Library Selected Then press Select button to start recording. Microsoft UI Automation is the new accessibility framework for Microsoft Windows, available on all operating systems that support Windows Presentation Foundation (WPF). UI Automation provides programmatic access to most user interface (UI) elements on the desktop, enabling assistive technology products such as screen readers to provide information about the UI to end users and to manipulate the UI by means other than standard input. UI Automation also allows automated test scripts to interact with the UI. Page 24 of 37

DynamicsNAV library supports set of controls specific to Microsoft Dynamics NAV application. When recording is completed you can see attached libraries in the code of test.

26 DynamicsNAV library supports set of controls specific to Microsoft Dynamics NAV application. When recording is completed you can see attached libraries in the code of test.js file: g_load_libraries=["uiautomation", "DynamicsNAV"]; 4.3. Automatic Adjustment of Window Title Object Property Main window title of Dynamics NAV is dynamic by nature. DynamicsNAV Main Window Title Example It may contain not only application name but also name of currently active page or information about currently opened record. So it can be different at the time of test recording and test playback. To cope with this problem replace actual window title with a regular expression in object properties. Here it is: regex:.*microsoft Dynamics NAV So recorded object properties look like this: Object Properties Also adjust Record Title in test settings to the same regular expression so you do not need to choose the Dynamics NAV main window during subsequent recording sessions. Page 25 of 37

Test Settings Titles of Child Windows Child windows of Dynamics NAV also may have dynamic titles. DynamicsNAV Window Title Example So for child windows you need to write regular as well.

27 Test Settings Titles of Child Windows Child windows of Dynamics NAV also may have dynamic titles. DynamicsNAV Window Title Example So for child windows you need to write regular as well. But the good news is you need to do this for one object only in every such window. For further learned objects Rapise will change the window title property automatically. In other words when Rapise learns a new object and it's window title is matched by a regular expression of a previously learned object then the title property is automatically replaced by this regular expression How to Launch Dynamics NAV Client If in your test you want to check that Dynamics NAV application is installed and running use the code: var fso = new ActiveXObject("Scripting.FileSystemObject"); var pffolder = Global.GetSpecialFolderPath("ProgramFilesX86"); var dynamicspath = pffolder + "\\Microsoft Dynamics NAV\\100\\RoleTailored Cl ient\\microsoft.dynamics.nav.client.exe" if(!fso.fileexists(dynamicspath)) { Tester.Message("Dynamics NAV Client is not installed on this computer"); return; } var windows = g_util.findwindows("regex:.*microsoft Dynamics NAV", "regex:win dowsforms10.*"); if (windows.length == 0) { Tester.Message("Dynamics NAV Client is not started. Please start it manua lly and re-run the test."); Page 26 of 37

$} return; To start the application use var pffolder = Global.GetSpecialFolderPath("ProgramFilesX86"); var dynamicspath = pffolder + "\\Microsoft Dynamics NAV\\100\\RoleTailored Cl ient\\microsoft.$

28 } return; To start the application use var pffolder = Global.GetSpecialFolderPath("ProgramFilesX86"); var dynamicspath = pffolder + "\\Microsoft Dynamics NAV\\100\\RoleTailored Cl ient\\microsoft.dynamics.nav.client.exe" Global.DoLaunch(dynamicsPath); 4.5. Recording Actions and Learning Objects During recording while you interact with Dynamics NAV controls Rapise captures actions and displays them in the recording dialog. Recording Dialog After this recording session corresponding UI area looks as follows: Page 27 of 37

29 Create New Customer When recording is finished Rapise automatically generates the test code: function Test() { SeS('_New').DoLClick(9, 27); SeS('OK').DoAction(); SeS('Name').DoLClick(29, 7); SeS('Name').DoSetText("CONTOSO"); SeS('Address').DoLClick(109, 3); SeS('Address').DoSetText("1200 Market St"); } If Rapise does not capture any interaction or captures it wrongly then try to learn the object. In this case Rapise will add it to the object tree but will not capture the action and you'll add the code to the test manually later. To learn an object during recording session place mouse cursor over it and press Ctrl-2 shortcut. It makes sense to pause recording before learning objects. This will prevent Rapise from intersecting mouse and keyboard and attempting to record interactions you do. Pause/Resume button is located at the right side of the Recording dialog. Page 28 of 37

4.6. Tips for Interacting with Objects Text Box To allow Rapise to capture the entered text interact with a text box in two steps: 1. Click into the edit box 2.

30 4.6. Tips for Interacting with Objects Text Box To allow Rapise to capture the entered text interact with a text box in two steps: 1. Click into the edit box 2. Type text using keyboard ComboBox Dynamics NAV combo box consists of three elements: edit box, open button and a dropdown table. Combo Box For reliable recording of combo box interactions follow these steps: click on the edit box, click on the open button, click on a cell in the table. Rapise will record this as: // Click on the edit box SeS('City').DoLClick(115, 10); // Click on the open button SeS('City1').DoAction(); // Select city in the table, choose "Gmunden" value in the column 1 (zero-bas ed) SeS('DataGridView').DoClickCell("Gmunden", 1); Page 29 of 37

31 Table Rapise has complete support for Dynamics NAV grids/tables. It can record user clicks on cells and also provides API to get the number of rows, columns, get column name by index, etc. API reference is available in the Rapise Help file. Here is an example of interacting with grid. var grid = SeS('DataGridView'); var cell = grid.getcell(3, "Name"); Tester.Message(cell); var colvalues = grid.getcolumnvalues(2, 10); Tester.Message(colValues.join(',')); grid.doclickcell("bilabankinn", "Name"); grid.doclickcolumn(1); grid.doclickcolumn("name"); var rowcount = grid.getrowcount(); Tester.Message(rowCount); var colcount = grid.getcolumncount(); Tester.Message(colCount); for(var i = 0; i < colcount; i++) { var colname = grid.getcolumnname(i); Tester.Message("\"" + colname + "\""); var colindex = grid.getcolumnindex(colname); Tester.Message(colIndex); } 4.7. Dynamics NAV Cook Book Maximize/Minimize/Restore Window You can maximize a window using any object inside it as a starting point. SeS('Refresh').getDesktopWindow().Maximized = true; To minimize use SeS('Refresh').getDesktopWindow().Maximized = false; // or SeS('Refresh').getDesktopWindow().Iconic = true; For restoring (to go back to a smaller window from maximized or minimized state) use SeS('Refresh').getDesktopWindow().Iconic = false; Page 30 of 37

32 Scroll to a Specific Row of a Grid Generally Dynamics NAV grids do not allow accessing cells which are not currently visible on screen. Using scrolling it is possible to make a specific row of a grid visible. This is a multi-step process. Step 1 Scroll to the top of the grid. Step 2 // Get a reference to the grid var grid = SeS('DataGridView'); // Send Ctrl+HOME combination to scroll to the top of the grid grid.dosendkeys('^{home}'); Scroll line by line to a given row. 'Line down' scroll button is an object with dynamic location. Line Down ilafter each button click it's location changes. At the beginning it can be (... - means skipped part of the location which is not important for illustration):.../_gridvscrollbar/no id[1] After first click it is:.../_gridvscrollbar/no id[2] So using this button is unreliable since it won't be found second time during test playback. Instead we suggest to use scroll bar itself and click on it's low end. It is not possible to learn the scroll bar directly because under cursor we always get it's child parts (buttons, slider, etc.). Learn scroll bar using Spy. Start recording and launch Spy from Recording Activity Dialog. Page 31 of 37

33 Spy In Spy start tracking by pressing Ctrl-G, place mouse over Line down button and press Ctrl-G again. Line down object will be displayed in the UI Automation panel. Line down in Spy Page 32 of 37

34 Right click on it and choose Parent. Then click on ScrollBar object and press Learn Object button. ScrollBar in Spy ScrollBar will be added to the Recording Activity Dialog. Default captured name of the object is UIAutomation. Change it to ScrollBar. Page 33 of 37

var sb = SeS('ScrollBar'); // We want row 50 to be visible var scrolltorow = 50; for(var i = 0; i < scrolltorow; i++) { // Click on the low end

35 Object Rename Finish recording and ScrollBar will be added to the object tree of the test opened in Rapise. ScrollBar Object Now we can write scrolling code. var sb = SeS('ScrollBar'); // We want row 50 to be visible var scrolltorow = 50; for(var i = 0; i < scrolltorow; i++) { // Click on the low end of the scroll bar, this is where line down button is located // Use underscore in '_DoClick' to exclude this action from report sb._doclick(10, sb.getheight() - 10); } Sometimes it is needed to scroll through all row to the bottom. Here is complete solution. Page 34 of 37

36 var grid = SeS('DataGridView'); var sb = SeS('ScrollBar'); grid.dosendkeys('^{home}'); var rowcount = 1; for(var i = 0; i < rowcount; i++) { // Recalculate total number of rows since Dynamics NAV may sometimes repo rt greater number in the beginning and then change its mind rowcount = grid.getrowcount(); } // Scroll one line sb._doclick(10, sb.getheight() - 10); Page 35 of 37

37 Legal Notices This publication is provided as is without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. This publication could include technical inaccuracies or typographical errors. Changes are periodically added to the information contained herein; these changes will be incorporated in new editions of the publication. Inflectra Corporation may make improvements and/or changes in the product(s) and/or program(s) and/or service(s) described in this publication at any time. The sections in this guide that discuss internet web security are provided as suggestions and guidelines. Internet security is constantly evolving field, and our suggestions are no substitute for an up-to-date understanding of the vulnerabilities inherent in deploying internet or web applications, and Inflectra cannot be held liable for any losses due to breaches of security, compromise of data or other cyber-attacks that may result from following our recommendations. SpiraTest, SpiraPlan, SpiraTeam, Rapise and Inflectra are registered trademarks of Inflectra Corporation in the United States of America and other countries. Microsoft, Windows, Explorer and Microsoft Project are registered trademarks of Microsoft Corporation. All other trademarks and product names are property of their respective holders. Please send comments and questions to: Technical Publications Inflectra Corporation 8121 Georgia Ave, Suite 504 Silver Spring, MD U.S.A. support@inflectra.com Page 36 of 37

Rapise Quick Start Guide Testing Qt Framework Applications with Rapise

Rapise Quick Start Guide Testing Qt Framework Applications with Rapise Date: May 8th, 2017 Contents Introduction... 1 1. Testing the Sample Qt Application 2 1.1. Using the Object Spy... 5 2. Testing Your