Silk Test 20.5 Silk4NET User Guide Micro Focus The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com © Copyright 1992-2019 Micro Focus or one of its affiliates. MICRO FOCUS, the Micro Focus logo and Silk Test are trademarks or registered trademarks of Micro Focus or one of its affiliates. All other marks are the property of their respective owners. 2019-10-23 ii Contents Licensing Information ........................................................................................9 Silk4NET ............................................................................................................10 Do I Need Administrator Privileges to Run Silk4NET? ......................................................10 Automation Under Special Conditions (Missing Peripherals) ............................................10 Silk Test Product Suite ...................................................................................................... 12 Enabling or Disabling Usage Data Collection ....................................................................13 Contacting Micro Focus .................................................................................................... 14 Information Needed by Micro Focus SupportLine .................................................. 14 What's New in Silk4NET ...................................................................................15 Enhance Security with Java-based Encryption ................................................................. 15 Usability Enhancements ....................................................................................................15 Technology Updates ..........................................................................................................15 Getting Started with Silk4NET .........................................................................17 Working with Silk4NET Projects ..................................................................... 18 Creating a Silk4NET Project ............................................................................................. 18 Creating Silk4NET Tests .................................................................................. 20 Adding a Silk4NET Test to a Project ................................................................................. 20 Recording a Silk4NET Test ............................................................................................... 21 Recording a Test on Microsoft Edge ................................................................................. 22 Recording a Test on Mozilla Firefox .................................................................................. 23 Recording a Test on Google Chrome ................................................................................24 Characters Excluded from Recording and Replaying ....................................................... 25 Actions Available During Recording .................................................................................. 25 Manually Creating a Silk4NET Test ...................................................................................26 Best Practices for Creating Test Scripts ............................................................................26 Adding a Verification to a Script while Recording ..............................................................27 Adding a Locator or an Object Map Item to a Test Method Using the Locator Spy ...........27 Replaying Tests ................................................................................................ 29 Running Silk4NET Tests ................................................................................................... 29 Replaying a Test from the Command Line ........................................................................ 29 Running Tests in Parallel ...................................................................................................30 How Does Silk4NET Synchronize Tests? ..........................................................................31 Enabling the Playback Status Dialog Box ......................................................................... 33 Analyzing Test Results .................................................................................... 34 Analyzing Test Results ...................................................................................................... 34 HTML Reports ...................................................................................................................34 Visual Execution Logs with TrueLog ................................................................................. 34 Enabling TrueLog ................................................................................................... 35 Changing the Location of the TrueLog ................................................................... 35 TrueLog Sections ....................................................................................................36 Capturing the Contents of a Web Page ..................................................................36 Why is TrueLog Not Displaying Non-ASCII Characters Correctly? ........................ 37 Why Does TrueLog Not Write Result Files During Playback? ................................ 37 Silk Test Open Agent ....................................................................................... 38 Starting the Silk Test Open Agent ..................................................................................... 38 Stopping the Open Agent After Test Execution .................................................................38 Agent Options ................................................................................................................... 38 Configuring the Connections Between the Silk4NET Components .................................. 47 Configuring the Port to Connect to the Information Service ..................................48 Contents | 3 Configuring the Port to Connect to the Open Agent ...............................................49 Editing the Properties of the Silk Test Information Service .................................... 50 Replacing the Certificates that are Used for the HTTPS Connection to the Information Service ............................................................................................................................... 51 Remote Testing with the Open Agent ................................................................................52 Testing with a Remote Open Agent ........................................................................52 Base State ......................................................................................................... 53 Modifying the Base State from the User Interface .............................................................53 Modifying the Base State in a Script ................................................................................. 55 Running the Base State .................................................................................................... 57 Application Configuration ............................................................................... 59 Modifying an Application Configuration .............................................................................60 Select Application Dialog Box ........................................................................................... 61 Editing Remote Locations ................................................................................................. 61 Application Configuration Errors ....................................................................................... 62 Troubleshooting Application Configurations ...................................................................... 63 Creating a Test that Tests Multiple Applications ................................................................63 Setting Script Options ..................................................................................... 65 Setting TrueLog Options ....................................................................................................65 Setting Recording Preferences ......................................................................................... 66 Setting Browser Recording Options .................................................................................. 66 Setting Custom Attributes ................................................................................................. 67 Setting Classes to Ignore .................................................................................................. 68 Setting WPF Classes to Expose During Recording and Playback ....................................69 Setting Synchronization Options ....................................................................................... 69 Setting Replay Options ..................................................................................................... 70 Setting UI Automation Options ..........................................................................................71 Setting Advanced Options .................................................................................................71 Silk4NET Sample Tests ....................................................................................73 Object Recognition .......................................................................................... 74 Locator Basic Concepts