Silk Test 20.5 Silk4J 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 Welcome to Silk4J 20.5 ....................................................................................10 Licensing Information ......................................................................................11 Silk4J ................................................................................................................ 12 Do I Need Administrator Privileges to Run Silk4J? ........................................................... 12 Best Practices for Using Silk4J ........................................................................................ 12 Automation Under Special Conditions (Missing Peripherals) ............................................13 Silk Test Product Suite ...................................................................................................... 14 What's New in Silk4J ........................................................................................16 Save Time and Costs with Service Virtualization for Mobile Devices ............................... 16 Enhance Security with Java-based Encryption ................................................................. 16 Usability Enhancements ....................................................................................................16 Technology Updates ..........................................................................................................16 Silk4J Quick Start Tutorial ...............................................................................18 Creating a Silk4J Project ...................................................................................................18 Recording a Test for the Insurance Company Web Application ........................................ 19 Replaying the Test for the Insurance Company Web Application ......................................20 Working with Silk4J Projects .......................................................................... 21 Creating a Silk4J Project ...................................................................................................21 Importing a Silk4J Project ................................................................................................. 22 Creating Tests ...................................................................................................23 Creating a Test for a Web Application ............................................................................... 23 Creating a Test for a Standard Application ........................................................................24 Creating a Test for a Mobile Web Application ................................................................... 24 Creating a Test for a Mobile Native Application .................................................................25 Recording a Test on Microsoft Edge ................................................................................. 26 Recording a Test on Mozilla Firefox .................................................................................. 27 Recording a Test on Google Chrome ................................................................................28 Creating a Test Case Manually ......................................................................................... 29 Best Practices for Creating Test Scripts ............................................................................29 Actions Available During Recording .................................................................................. 30 Adding a Verification to a Script while Recording ..............................................................31 Adding a Locator or an Object Map Item to a Test Method Using the Locator Spy ...........31 Including Custom Attributes in a Test ................................................................................32 Characters Excluded from Recording and Replaying ....................................................... 33 Replaying Tests ................................................................................................ 34 Replaying Tests from Eclipse ............................................................................................ 34 Replaying a Test from the Command Line ........................................................................ 34 Replaying Tests with Apache Ant ......................................................................................35 Troubleshooting when Replaying Tests with Ant .................................................... 37 Replaying Tests from a Continuous Integration Server ..................................................... 37 Running Tests in Docker Containers ................................................................................. 37 Silk Test Image Environment Variables .................................................................. 39 Example: Running Tests on Google Chrome ......................................................... 40 Example: Using docker-compose ...........................................................................41 Limitations when Running Tests in Docker Containers .......................................... 42 Troubleshooting when Running Tests in Docker Containers .................................. 43 Replaying Silk4J Tests from Silk Central ...........................................................................43 Triggering Tests on Silk Central from a Continuous Integration Server .............................44 Replaying Tests in a Specific Order .................................................................................. 45 Running Tests in Parallel ...................................................................................................46 Contents | 3 How Does Silk4J Synchronize Tests? ...............................................................................47 Enabling the Playback Status Dialog Box ......................................................................... 49 Analyzing Test Results .................................................................................... 50 Analyzing Test Results ...................................................................................................... 50 HTML Reports ...................................................................................................................50 Visual Execution Logs with TrueLog ................................................................................. 50 Enabling TrueLog ................................................................................................... 51 Changing the Location of the TrueLog ................................................................... 51 TrueLog Sections ....................................................................................................51 Capturing the Contents of a Web Page ..................................................................52 Why is TrueLog Not Displaying Non-ASCII Characters Correctly? ........................ 52 Silk Test Open Agent ....................................................................................... 53 Starting the Silk Test Open Agent ..................................................................................... 53 Stopping the Open Agent After Test Execution .................................................................53 Agent Options ................................................................................................................... 53 Configuring the Connections Between the Silk4J Components ........................................61 Configuring the Port to Connect to the Information Service ..................................63 Configuring the Port to Connect to the Open Agent ...............................................64 Editing the Properties of the Silk Test Information Service .................................... 65 Replacing the Certificates that are Used for the HTTPS Connection to the Information Service ............................................................................................................................... 66 Remote Testing with the Open Agent ................................................................................67 Testing with a Remote Open Agent ........................................................................67 Configuring the Open Agent to Run Remotely in a NAT Environment .............................. 67 Base State ......................................................................................................... 68 Modifying the Base State from the User Interface .............................................................68 Modifying the Base State in a Script ................................................................................. 70 Running the Base State .................................................................................................... 71 Application Configuration ............................................................................... 73 Modifying an Application Configuration .............................................................................74 Select Application Dialog Box ..........................................................................................