Automating Tribal SITS with useMango

We are thrilled to announce that useMango has expanded its support to include Tribal SITS, providing you with even more automation capabilities. In this blog, we’ll take you through a simple walkthrough of a sample test to automate Tribal SITS using useMango across both SITS Client and SITS Vision. Let’s dive in and explore the possibilities of this powerful combination!

useMango with Tribal SITS

In September 2022, useMango introduced exciting testing capabilities for Tribal SITS, marking a significant advancement in automation. With this release, a new identifier type called “Image Identifier” was added to support image-based automation, empowering users to leverage images for test automation purposes.

Getting Started

Before diving into test execution, it’s essential to follow some guidelines to ensure a smooth testing experience.

• Make sure to set your system scale to 100%. This can be easily adjusted by navigating to Settings, then System, and finally Display.
• Ensure the Tribal SITS client is on the main display during test execution. 

Creating Image Identifier

An Image Identifier in useMango is used to hold images which will be used by the Tribal SITS components to locate the respective image on the screen and perform desired action.
With the introduction of the image identifier feature, we support image-based automation in Tribal SITS.

Creating an image identifier can be done in two ways:

• Uploading an Image: If you already have the image saved on your system, simply click the upload icon and select the image you wish to use.
  
  
  
• Snipping Tool: For on-the-fly image capture, useMango’s built-in Snipping Tool comes to the rescue. By clicking the snipping icon, you can select the area of the screen you want to capture, and useMango will automatically save the image into the Identifier.
  
  
  

Components

useMango provides a variety of standard components, each supporting various actions needed for effective testing in Tribal SITS. These components serve as the building blocks for your test automation. For a quick description of all Tribal components available in useMango, visit our official documentation at Components :: usemango™ .

Creating Tribal SITS test

Let’s create a Tribal SITS test that automates a real-world scenario of updating a student’s surname on the STU screen. Our test will involve taking a student code, fetching the student details, updating the surname and validating it on the Tribal SITS client.

It is assumed, for the sake of simplicity, that the user is logged in to Tribal SITS. Nevertheless, the process of logging into Tribal SITS can also be automated through useMango.

• To begin, create a new test in useMango and name it “Update Student Surname”.
  
  
  
  

• Next, add a test step (read more Add test Step to a test ) to click on the SITS Menu System using the “Tribal-LeftClick” component (read more Tribal-LeftClick :: usemango™ ). For this purpose,
  • Create a test variable of type “ImageIdentifier” and name it “menu_system.” This variable will hold the image of the Menu field to perform the left-click action (see Creating Image Identifier).
  • Add the test variable “menu_system” to the “Tribal-LeftClick” step (see Assigning a variable to a step).
    
    
    
    
• Next, add the “Tribal-WriteText” component to enter “STU“ in the SITS Menu System (read more Tribal-WriteText :: usemango™ ). For this,
  • Create a test variable of type “Text” named “stu_screen,” and specify the value “STU“.
  • Add the “stu_screen” test variable to the “Tribal-WriteText” step.
    
    
    
    
• Now, let’s use the ShortcutKeys Component to press the Enter key (read more Shortcut Keys :: usemango™ ) which will open the STU (Full Student Details) screen. For this, add value “Enter“ into the Keys field.
  
  
  
  
• Run the test steps 1, 2, and 3 to open the STU (Full Student Details) screen
  
  
  
  
• Now, let’s add a test step to enter the student code in the field, using the Tribal-WriteText Component.
  • For this, create a test variable of type “Secret” named “student_code,” specifying the Student code to be entered.
  • Add the “student_code” test variable to the “Tribal-WriteText” step.
    
    
    
    
• Add a test step to retrieve the Student details using the ShortcutKeys Component as shown in the image below.
  
  
  
• Run test step 4 and 5 to retrieve student details.
  
  Below is the output of running the test steps which fetches the student details for the Student code that was entered
  
  
  
• Now, add a test step to verify if the record was fetched using the Tribal-VerifyImageExists Component (read more Tribal-VerifyImageExists :: usemango™ ) as shown in the image below.
  
  
  
• Run the test step 6 to verify if the details were fetched.
• Next, we’ll add a test step to navigate to the Surname field by pressing the tab key three times using the ShortcutKeys Component.
  
  
  
  
• Once the focus is on the Surname field, we’ll then use the F7 key with the same ShortcutKeys Component to clear the old value in the field.
  
  
  
  
• Add a test step to enter the new surname value using the Tribal-WriteText Component as show below.
  
  
  
  
• Once the new surname is entered, we’re ready to update the details. To accomplish this, use the Component “ShortcutKeys” with the string “ctrl S“ assigned to the Keys field, as shown below.
  
  
  
• Now, let’s add a verification test step to ensure the success of the update action. To achieve this, we’ll use the Tribal-VerifyImageExists component, as shown below.
  
  
  
• Run the test steps 7, 8, 9, 10, and 11 to execute the update process.
  
  
  
• We have done the verification in Tribal SITS, However you may want to do the validation of this test via EVision.  EVision can be automate using useMango’s Web Framework as it is a website. you can refer to “Create your first web test” link to understand how to automate a web site. The steps for automating EVison can be added in the same test and the pseudo steps for doing so will be as below:
  • Log in to the Evision portal using appropriate credentials.
  • Click on the “Find My Students” link to access the student search page.
  • On the student search page, click on the “Student Search” link.
  • Enter the specific Student Code you wish to search for.
  • Click the “Find Student” button to retrieve the student’s information.
  • Verify the student’s Surname matches the one used in the Tribal SITS Client test.
  • Close the browser
    

If you’re interested in exploring the automation capabilities of useMango, including its seamless integration with Tribal SITS, don’t hesitate to start your free trial today.