EDU-9495: Added code snippets and prompts for the AI-Assisted Diagnostics and Testing for Acumatica Customizations workshop/help guide

Author: MehranQadri

ModernUI/AIAssistedTestingAndDiagnostics/Code Snippets/Lesson2.3_Step1/StartTests.cs

@@ -0,0 +1,36 @@
+using System;
+using AIAssistedDiagnostics.ModernUI.Tests.Tests;
+using Core.Login;
+using Core.TestExecution;
+
+namespace GeneratedWrappers.SOLUTIONNAME
+{
+  internal class StartTests
+  {
+      public void Execute()
+      {
+          PxLogin.LoginToDestinationSite();
+
+          using (TestExecution.CreateTestStepGroup("RS301000 smoke test"))
+          {
+              Console.WriteLine("Starting RS301000 smoke test...");
+
+              var rs301000Tests = new RS301000_LaborQuantityTests();
+              rs301000Tests.RepairWorkOrdersScreen_CanOpenPreparedWorkOrder();
+          }
+
+
+          // TODO: Run the test that verifies that the labor quantity is restored after setting it below the configured value.
+          ///////////// The added code
+          using (TestExecution.CreateTestStepGroup("RS301000 labor quantity validation test"))
+          {
+              Console.WriteLine("Starting RS301000 labor quantity validation test...");
+
+              var rs301000Tests = new RS301000_LaborQuantityTests();
+              rs301000Tests.LaborQuantity_WhenBelowConfigured_RestoresConfiguredQuantity();
+
+          }
+          //////////// The end of the added code
+      }
+  }
+}

ModernUI/AIAssistedTestingAndDiagnostics/Code Snippets/Lesson2.3_Step2/StartTests.cs

@@ -0,0 +1,37 @@
+using System;
+using AIAssistedDiagnostics.ModernUI.Tests.Tests;
+using Core.Login;
+using Core.TestExecution;
+
+namespace GeneratedWrappers.SOLUTIONNAME
+{
+  internal class StartTests
+  {
+      public void Execute()
+      {
+          PxLogin.LoginToDestinationSite();
+
+          using (TestExecution.CreateTestStepGroup("RS301000 smoke test"))
+          {
+              Console.WriteLine("Starting RS301000 smoke test...");
+
+              var rs301000Tests = new RS301000_LaborQuantityTests();
+              rs301000Tests.RepairWorkOrdersScreen_CanOpenPreparedWorkOrder();
+          }
+
+
+          // Run the test that verifies that the labor quantity is restored after setting it below the configured value.
+          ///////////// The modified code
+          // using (TestExecution.CreateTestStepGroup("RS301000 labor quantity validation test"))
+          // {
+              // Console.WriteLine("Starting RS301000 labor quantity validation test...");
+
+              // var rs301000Tests = new RS301000_LaborQuantityTests();
+              
+              // rs301000Tests.LaborQuantity_WhenBelowConfigured_RestoresConfiguredQuantity();
+             
+          // }
+           //////////// The end of the modified code
+      }
+  }
+}

ModernUI/AIAssistedTestingAndDiagnostics/Code Snippets/Lesson2.3_Step3/StartTests.cs

@@ -0,0 +1,36 @@
+using System;
+using AIAssistedDiagnostics.ModernUI.Tests.Tests;
+using Core.Login;
+using Core.TestExecution;
+
+namespace GeneratedWrappers.SOLUTIONNAME
+{
+  internal class StartTests
+  {
+      public void Execute()
+      {
+          PxLogin.LoginToDestinationSite();
+
+          using (TestExecution.CreateTestStepGroup("RS301000 smoke test"))
+          {
+              Console.WriteLine("Starting RS301000 smoke test...");
+
+              var rs301000Tests = new RS301000_LaborQuantityTests();
+              rs301000Tests.RepairWorkOrdersScreen_CanOpenPreparedWorkOrder();
+          }
+
+
+          // Run the test that verifies that the labor quantity is restored after setting it below the configured value.
+          ///////////// The modified code
+          using (TestExecution.CreateTestStepGroup("RS301000 labor quantity validation test"))
+          {
+              Console.WriteLine("Starting RS301000 labor quantity validation test...");
+
+              var rs301000Tests = new RS301000_LaborQuantityTests();
+              rs301000Tests.LaborQuantity_WhenBelowConfigured_RestoresConfiguredQuantity();
+
+          }
+          //////////// The end of the modified code
+      }
+  }
+}

ModernUI/AIAssistedTestingAndDiagnostics/Prompts/Lesson2.1_Step5/Prompt_Inspect_RS301000_wrapper.txt

@@ -0,0 +1,21 @@
+Inspect the generated Modern UI Test SDK wrapper for RS301000.
+
+Do not modify files.
+
+Use these files as context:
+- Wrappers\Generated\RS\RS301000.cs
+- RepairWorkOrdersScreen.cs
+- TestData.cs
+
+Please identify:
+1. The generated screen class and namespace.
+2. The member used for the Order Nbr. field.
+3. The member used for the Labor grid.
+4. The member used for the Labor Quantity field.
+5. The methods used to save and refresh the screen or grid.
+6. The helper methods in RepairWorkOrdersScreen that wrap these generated members.
+7. Any wrapper members that are missing or not confirmed.
+8. Any member names that Copilot should not invent.
+
+Use exact member names from the generated wrapper. 
+If a member does not clearly exist, say that it is missing instead of inventing one.

ModernUI/AIAssistedTestingAndDiagnostics/Prompts/Lesson2.2_Step2/Prompt_Draft_UITest_for_labor_quantity_restoration_validation_.txt

@@ -0,0 +1,40 @@
+Draft a UI test for the Repair Work Orders labor quantity 
+validation scenario.
+
+Target screen:
+RS301000 Repair Work Orders
+
+Scenario:
+Open existing repair work order 000001 whose labor line has a configured/default quantity of 1.
+Change the labor quantity to 0.
+Trigger validation by using the project’s established save/update pattern.
+Verify that the UI restores the labor quantity to 1.
+If the wrapper exposes field warning information, 
+also verify that the QuantityTooSmall warning is shown.
+
+Use the open files as context:
+- The generated RS301000 wrapper class.
+- The RepairWorkOrdersScreen helper class.
+- The TestData helper class.
+- The existing Test SDK test base class or sample test, if available.
+
+Requirements:
+1. Use generated wrapper members where available.
+2. Prefer the RepairWorkOrdersScreen helper methods where possible.
+3. Do not use direct DOM selectors unless the wrappers do not expose the needed element.
+4. Use deterministic test data from TestData.
+5. Open work order 000001.
+6. Change the labor quantity from 1 to 0.
+7. Trigger validation.
+8. Assert that the final labor quantity is 1.
+9. Assert the QuantityTooSmall warning only if the wrapper exposes a reliable way to inspect it.
+10. Use Arrange, Act, Assert comments.
+11. Avoid hardcoded credentials, tenant secrets, local paths, or environment-specific URLs.
+12. Add TODO comments where wrapper names or test data must be verified.
+13. Name the test method as LaborQuantity_WhenBelowConfigured_RestoresConfiguredQuantity
+
+Constraints:
+- Do not invent wrapper members.
+- Do not rewrite existing helpers unless the helper has a clear TODO.
+- Do not modify configuration files.
+- Do not create broad setup logic that distracts from the test scenario.

ModernUI/AIAssistedTestingAndDiagnostics/Prompts/Lesson2.2_Step5/Prompt_Explain_generated_test.txt

@@ -0,0 +1,14 @@
+Explain the generated test.
+
+Do not modify files.
+
+Please cover:
+1. Which repair work order data the test depends on.
+2. How the test opens the screen.
+3. How it opens work order 000001.
+4. How it changes the labor quantity from 1 to 0.
+5. How it triggers validation.
+6. How it verifies that the quantity is restored to 1.
+7. Whether the test can verify the QuantityTooSmall warning.
+8. Which wrapper members or test data values still need SME verification.
+9. Which prepared Test SDK output or log artifact should be used if the live test cannot be run.

ModernUI/AIAssistedTestingAndDiagnostics/Prompts/Lesson2.3_Step6/Prompt_Classify_test_failure.txt

@@ -0,0 +1,39 @@
+Review this Test SDK test failure.
+
+Context:
+- The test uses generated Modern UI Test SDK wrappers.
+- The target screen is Repair Work Orders (RS301000).
+- The test is intended to validate the UI behavior for RSSVWorkOrderLabor.Quantity.
+- The related Unit Test Framework test now passes.
+- Expected UI behavior: after entering quantity 0 for a labor line whose 
+  configured/default quantity is 1, validation restores the quantity to 1.
+  If supported by wrappers, the QuantityTooSmall warning should also be visible.
+
+Test goal:
+Verify that the UI workflow reflects the repaired labor quantity validation behavior.
+
+Relevant test code:
+[Reference the test method or paste the method if needed.]
+
+Relevant wrapper members:
+- WorkOrders_fsColumnAOrder.OrderNbr
+- Labor_gridLabor.Row.Quantity
+- Save()
+- Labor_gridLabor.Refresh()
+
+Failure output:
+[Paste the cleaned failure message, log excerpt, or screenshot description.]
+
+Please classify the likely cause:
+1. Wrapper/member mismatch
+2. Test data issue
+3. Timing/wait issue
+4. Validation not triggered by the test
+5. Application behavior issue
+6. Environment/configuration issue
+
+For each likely cause, suggest the next diagnostic step.
+
+Do not modify files.
+Do not assume the application is defective unless the evidence supports it.
+Do not invent wrapper members or unsupported APIs.

UnitTesting/AIAssistedDiagnosticsAndTesting/Prompts/Lesson1.1_Step3/Prompt_Classify_failure_pattern.txt

@@ -0,0 +1,21 @@
+Classify this Acumatica unit test failure.
+
+Failure output:
+ - Failed assertion: Assert.Equal() 
+ - Expected value: 3
+ - Actual value: 1
+ - Stack Trace: RSSVWorkOrderEntryTests.TestRepairWorkOrdersForm() line 152
+
+Use the open test and implementation files as context.
+
+Please classify the failure as one of the following:
+1. Failed assertion
+2. Runtime exception
+3. Missing dependency/service registration
+4. Setup DAC or test data issue
+5. Implementation defect
+
+Then explain:
+- What evidence supports the classification
+- Which file or method to inspect first
+- What not to change yet

UnitTesting/AIAssistedDiagnosticsAndTesting/Prompts/Lesson1.1_Step4/Prompt_Inspect_the_failure.txt

@@ -0,0 +1,32 @@
+Inspect the failing TestRepairWorkOrdersForm unit test.
+
+Files to review:
+- PhoneRepairShop_Code.Tests/RSSVWorkOrderEntryTests.cs
+- PhoneRepairShop_Code/RSSVWorkOrderEntry.cs
+- PhoneRepairShop_Code/Helper/Messages.cs
+
+The expected rule is:
+When RSSVWorkOrderLabor.Quantity is lower than the configured labor quantity,
+the system should attach the QuantityTooSmall warning and restore the quantity to the 
+configured value.
+
+Observed failure:
+The test sets woLabor.Quantity to 1. The QuantityTooSmall warning is expected, and woLabor.
+Quantity should be restored to 3.
+The test fails at the quantity assertion.
+
+Failing assertion:
+Assert.Equal(3, woLabor.Quantity)
+
+Actual value:
+1
+
+Do not edit files yet.
+
+Please:
+1. Explain what the failing assertion means.
+2. Identify the most likely root cause.
+3. Point to the method or event handler to inspect first.
+4. Explain why the warning can still appear while the quantity is not restored.
+5. Propose the smallest safe fix.
+6. List assumptions I should verify before editing code.

UnitTesting/AIAssistedDiagnosticsAndTesting/Prompts/Lesson1.2_Step2/Prompt_Optional_Copilot_fix_failure.txt

@@ -0,0 +1,12 @@
+The original fix did not make the TestRepairWorkOrdersForm test pass.
+
+Original failure:
+Expected woLabor.Quantity to be 3 after setting it to 1, but it remained 1.
+
+New failure:
+[Paste the new failure output.]
+
+Do not edit files yet.
+
+Please compare the new failure with the original failure and identify 
+whether the fix was incomplete or whether a different assertion is now failing.