Introduction

Whether migrating to a new version of Windows or managing the estate in Business as Usual (BAU) mode, User Acceptance Testing (UAT) is a fundamental part of the application lifecycle that ensures applications are free from error when released to end-users.  MigrationStudio provides the ability to manage the UAT phase, including defining test scenarios, allocating resourcing, scheduling tests, notification and reporting.


When an application test is created, the MigrationStudio administrator has the option to specify which machine the test should be performed on and provide the tester with a shortcut from which to initiate a screen sharing session.

An example of choosing a test machine for UAT.


The shortcut is based on Microsoft's Remote Desktop Protocol (RDP) and is pre-configured with the minimal settings required to connect the user with their UAT desktop.  Organisations that wish to apply an advanced configuration to the test session, for example, disabling the local printer and clipboard or forcing a particular connection performance, can create a custom RDP template to be used in MigrationStudio.  This solution article discusses the steps required to define the custom template and apply it to MigrationStudio.


For more information about how MigrationStudio can help with  testing, pleases refer to the UAT mini-guide:

https://migrationstudio.com/s/Mini-Guide-User-Acceptance-Testing.pdf


Building the Template

For the purposes of this article, the example provided will disable the local printer and clipboard for a Windows 10 user.  Please note, a Windows account with local administrator privileges may be required to save or copy the template to the MigrationStudio IIS folder.


  • Click the Windows Start icon, type Remote and select Remote Desktop Connection from the search results.  If Windows Search is not available, click the Windows Start icon, locate and expand Windows Accessories from the menu, and click Remote Desktop Connection.
  • The Remote Desktop Connection client should open.  Click Show Options at the bottom left of the window to expand the connection options.



  • Once the settings have been applied to the client, switch to the General tab (1) and click Save As... (2) in the Connection settings panel.


  • Name the file tpl_UatMachine.rdp and save it to the MigrationStudio IIS site as [MigrationStudio_Site]\Portal\Customisation\EmailTemplates. For example, C:\inetput\wwwroot\MigrationStudio\Portal\Customisation\EmailTemplates. 


  • All newly issued UAT emails will contain an RDP file with the custom settings embedded.


Validate the RDP Changes

  • In MigrationStudio, create a new application test, ensure that a test machine has been specified and the option to include the RDP file is checked.  Click Finish and choose Send 1 preview email(s) (to me).  For further information on scheduling an application test, please refer to the UAT mini guide.

  • An email should arrive containing details of the scheduled UAT.  Detach the RDP file from the email and save it to the local device (e.g. Downloads).

  • Open the Remote Desktop Connection client using the instructions detail in Building the Template, above.

  • Click Show Options at the bottom left of the window to expand the connection options.


  • Click Open and select the RDP file saved in earlier.


  • The Remote Desktop Connection client should contain the settings defined in the RDP template.  Examine each of the tabs to verify that the new RDP template is effective.


Further Support

If you require further assistance importing HR data, please get in touch with the service desk via support@migrationstudio.com.