Configure Regression Suite Automation (RSAT) on Tier 1 (One Box) -Cloud Hosted Environment

Hello Everyone, I recently attempted to configure the Regression Suite Automation Tool (RSAT) within the Tier 01 environment, also known as the Development VM or One Box. I managed to automate a test case successfully and wanted to share my experience. I hope it will be beneficial to those interested, even though using RSAT on One Box environments is generally not recommended.

For those unfamiliar with RSAT, the Regression Suite Automation Tool greatly reduces the time and effort associated with user acceptance testing (UAT) for finance and operations applications.

1. Prerequisites

Below are the prerequisites

1. RSAT installation
2. Create BPM Library and Link with Application(Optional)
3. Azure DevOps Setup

1.RSAT installation

Installing RSAT is quite straightforward; simply download it from the provided link and install it with all features enabled.

Download Link: https://bit.ly/4dEK5Qu

2.LCS BPM Setup and Link with Application

Connecting LCS from a one box/dev environment can be a bit tricky; if you go to System Administration >Setup>System Parameters> Help it will prompt you to connect with LCS

but you will often get, an error message stating "Sorry, something went wrong".

We aim to save the Task Recording to the BPM Library in LCS. To do this, follow these steps:

1. Go to the Service Volume (usually the drive letter is K:).

2. Navigate to K:\AosService\WebRoot and locate the web. config file.

3. Create a copy of the file or back it up to another location as a precaution.

4. Open the original file with Notepad or your preferred text editor.

5. Search for the specified line.

<add key="LCS.GettingStartedLibrary" value="" />

6. Replace the above value with any positive Integer value, i've used 123456

<add key="LCS.GettingStartedLibrary" value="123456" />

7. once done, open the command prompt as administrator, type iisreset /noforce command then press enter to restart IIS to take changes effect.

Note: For me, saving the BPM Recording to LCS was not possible as it prompted the same error message. However, by selecting Edit Recording > Open from Lifecycle Service > Select the Lifecycle Services library, I could choose the Process Library associated with the Project. please comment if it worked for you.

3. Azure DevOps Setup

Verify you've configured and linked Azure Deveops under the LCS Project Settings Page

2. Configuring RSAT

Once you installed RSAT The first thing you need to do to fill values under the settings.

you will see 3 icons on your desktop out of that you will see Regression Suite Automation Tool (TRIAL MODE) and Regression Suite Automation tool. The icon with the TRIAL mode is a standalone application and has no connection with Azure DevOps and it does not apply to our case.

click on the "Regression Suite Automation Tool" Icon on your desktop, then click on the Gear Wheel icon on the left side pane

if you look at the above screenshot carefully you will see there are 3 sections we need to complete before using RSAT.

if you look at items under the Azure DevOps tab you will need the following information

Azure DevOps Url: you can copy from the LCS Project Settings Page

Access Token: Go to Azure DevOps using the above URL, then click on the Gear Wheel Icon in the top right corner, then click on Personal access tokens, create a new one then paste it here.

once done click on Test Connection... to validate.

Project Name: Select Correct Project from the Dropdown

Test Plan : Go to Azure DevOps and click on + New Test Plan under Test Plans, then click on drop-down and select the same test plan with the same name.

So now our DevOps parameters are set.

next one is the Finance and Operations Test environment Tab

Host Name & Soap Host Name: Just open Run Dialog type inetmgr and press enter, this will open IIS Manager, then Right Click on AOSService under Sites then go to Edit Bindings

Copy the above two URLs. Paste the first one into the 'Host Name' field, and the second one (which contains 'soap') into the 'Soap Host Name' text boxes in RSAT.

Admin User Name: enter D365Fo Admin Account

Company: By default select USMF, but you can change it if you need

Authentication Method: Certificates

Thumb Print: Click on the New Button, this will ask the location to save the RSAT Authentication Certificate, just locate a secure location to save files then click on Save. when you open the location you will see 2 certificates one RSAT Authentication Certificate.cer and one RSAT Authentication Certificate.pfx

Double-click on the RSAT Authentication Certificate. pfx then install it under Local Machine under Personal Store, then again Under Local Machine > Trusted Root Certification Authorities.

once done select the newly created certificate thumbprint from the drop-down.

The last part is Run Settings

Working Directory: Create a New folder and then map accordingly this folder will used to save, and store Parameter /configuration files

Default Browser: Select the Preferred Browser you are running the D365FO application

there is another important thing to do before proceeding with the next steps.

Go to K:\AosService\WebRoot , open wif.config file ( make a copy of the file before editing for the safe side) using Notepad.

       <authority name="CN=127.0.0.1">
            <keys>
              <add thumbprint="<RSAT Certificatie Thumbprint>" />
            </keys>
            <validIssuers>
              <add name="127.0.0.1" />
            </validIssuers>
          </authority>            

then copy the above code under the below line

<issuerNameRegistry type="Microsoft.Dynamics.AX.Security.SharedUtility.AxIssuerNameRegistry, Microsoft.Dynamics.AX.Security.SharedUtility">

Remember to Add the print of the certificate you've generated in above steps under <add thumbprint =" "/> , once done it should look like the below

once done go back to RSAT and click on Test Connection under the Finance and Operations Test Environment Tab. If you see below Congratulations! you are good to Go.

Now it's time to create a Task Recording and check that our setup is correct. I'm not explaining how to configure BPM libraries here to keep the article simple and short.

I was unable to save the Task Recording directly to the BPM Library, so I downloaded the recording as a .axtr file and then uploaded it manually. you can use the Save to this PC option to download task recordings as .axtr files.

Once downloaded go to LCS then Business Process Modeler Add Process, then mark as reviewed, then upload the downloaded file using the Upload Button

Just go back to Business Process Libraries click on Project Library and then click on 3 dots then click on VSTS sync, once done refresh it will enable the Sync Test Cases option, if you see both options with the Right Mark, then all is good.

Go to Azure DevOps again then go to Boards, then click on Work Items you will see task recording added as a test case with LCS:TestCases Tag

then go to Test Plans click on the down arrow mark just next to the New Test Case Button click on Add Existing test Cases, click on Run Qyery, select Test Case, then click on Add Test case

3. Load and Run Test Case

Once all the steps are completed successfully now it's time to run the test case we've recorded.

go to RSAT and then click on the Load button this will download /Sync test cases from Azure DevOps

select Test case then click on Generate >generate Test Execution files only ( for Testing only), this will generate Test Execution Parameter files into the folder we've mapped under RSAT (in the above steps). Once done you will see the file name under the Parameters File Column.

Once done click on Run Button next to the Generate file to execute the test case. this will open up the D365Fo session Automatically on the browser you've selected and perform the exact steps that you recorded using the task recorder. Once the case is executed it will close itself.

Go back to Azure devops and then test plans unde plan click on view Report, then you can see the Progress of the test case execution.

If you can see above Congratulations!! you've completed the RSAT configuration.

I've aimed to keep the article detailed and concise. Please leave a comment if you encounter any issues while following the steps. Your feedback is always appreciated.

Thank you.

AP