TAST DokuWiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== First steps in TAST ======


TAST (Test Automation System Tool) is a tool for automating the testing. It is based on UML diagrams.
It has a user-based system, where every user has a role and, depending on this role, can perform different actions.\\ \\ 


=====Prerequisites for installing TAST=====
For being able to use TAST, it is needed to make a short configuration in the pc to let the program work as expected, be able to use the client, and avoid the security messages to come out every time that the tool is open. First of all, a set up for the client-permissions is needed.\\ \\ The configuration is performed following these steps:\\ 

  - Check you have Java Runtime Environment (JRE) installed. To verify this, open a Windows command console and type: java -version. If you have the JRE installed, it will show which version you have, the version 1.8.0 is required. In case you don't have it installed, download it from the following link: https://www.java.com/en/download/. This step is completely needed.\\ \\ 
  - Change the two environment variables: Run from the control panel -> User Accounts -> User accounts -> Change my environment variables ->\\ \\ {{ :es:imagen1completa.jpg?450 |}}\\ a. If you have PATH, click on “edit” while selecting it. If you don’t have it, click on “new”.\\ \\ {{ :es:imagen2.jpg?350 |}}\\ Add new values to variable PATH:\\ \\ C:\Program Files(x86)\Java\**jre1.8.0_281**\\ C:\Program Files(x86)\Common Files\Oracle\Java\javapath\\ C:\ProgramData\Oracle\Java\javapath\\ \\ (the numbers on the jre should correspond with your jre version).\\ \\ {{ :es:imagen3.jpg?350 |}}\\ 
  - Restart the PC.\\ \\ 
  - Open java options following these steps:\\ a. Click the Windows start button.\\ b. Go to “control panel”.\\ c. Go to “Programs”.\\ d. Click on “Java”.\\ \\ 
  -  Add exception on the “Edit Site List” option on the “Security” tab:\\ a. Click on “edit site list”.\\ \\ {{ :es:imagen4.jpg?350 |}}\\ b. Click on “Add”\\ {{ :es:imagen5.jpg?350 |}}\\ c. Add locations:\\ \\ For SIPSA environment:\\ https://app.cloud1.testautomationsystemtool.com/\\ \\ 
  - Download the TAST drivers folder from this link:\\ [[https://testautomationsystemtool.com/sw/appTAST.zip|appTAST.zip]]  \\ \\ and unzip it to "C:"\\ \\ {{ :es:imagen6.jpg?350 |}}\\ \\ 


=====Prerequisites for automating GUI HTML=====
To be able to automate HTML GUI pages, there are two ways to do it:\\  
  - Through **Selective Mapping**.
  - F12 Browser.\\ 
TAST has created a proprietary tool, **Selective Mapping**, thanks to which, we can obtain the search values in a more efficient way. When using selective mapping, the best search options are suggested from top to bottom. We can search by name, type, xtpath, Css, Css attributes. The options available for the Selective Mapping functionality are:\\ 
  * To pause or continue: <Spacebar>.
  * To copy attribute content or search by: <Click + Control + C>
  * To paste the content of the attribute or search by: <Click + Control + V>
  * To view the html source: [v]
  * To exit: [esc]
   
Here is how to install this tool.



====Selective Mapping====

  - In the browser, open the TAST tool \\  
  - Add this page to Favorites Bar\\ \\ \\  {{ :es:primeros_pasos1.png?500 |}}\\ \\ 
  - Rename this favorite to ‘Selective Mapping’.\\ \\ {{ :es:primeros_pasos2.png?500 |}}\\ \\ 
  - Make visible Selective Mapping in the browser's favourite bar:\\ \\ {{ :es:primeros_pasos_3.png?500 |}}\\ \\ 
  - Positioned in Selective Mapping, right mouse button, and select Properties:\\ \\ {{ :es:mapeo_selectivo_4.png?500 |}}\\ 
  - Copy the following text in the URL:\\ // javascript:prefFile='';void(z=document.body.appendChild(document.createElement('script')));void(z.language='javascript');void(z.type='text/javascript');void(z.src='https://app.testautomationsystemtool.com/test/selectivemapping');void(z.id='tast');\\
In the case of having your own installation, you must replace <https://app.testautomationsystemtool.com/test/selectivemapping>\\ by
<URL_TAST SERVER_ORGANIZATION>
//\\ \\ {{ :es:mapeo_selectivo5.png?250 |}}\\ \\ 
  - After clicking on the Selective Mapping favorite, appears a window similar to the following:\\ \\ {{ :es:mapeo_selectivo_6.png?250 |}}\\ \\  
  - The attributes will change depending on where the focus is in the web page.\\ \\ 
 
===Example of how to work with Selective Mapping===
 
First of all, we are going to create a very simple GUI diagram that will consist of a Google search of TAST SIPSA.
:  Googleis opened -> Accept our Pc'S Cookies message -> Include our Google search criteria -> Click on the button -> Click on the 1st option that appears.\\ \\ Here is a link to the video with the explanation of this test case.\\ \\ 

{{youtube>G7CUuYXRNAg?medium}}\\ 

Now we will explain it step by step.\\ \\  
Access UML Model/UML Diagram from the menu:\\ 

{{ {{ :en:imagen1.png?500 |}}

Select your domain and project      

{{ :es:imagen2.png?500 |}}


Creat a new diagram.

 
{{ :es:imagen3.png?500 |}}

Fill in the fields to create the diagram with the name, description and location where we want to create it.
	
 
{{ :es:imagen4.png?500 |}}

We start by drawing the diagram using the drawing tools found in the menu on the right of the screen.  Press the + sign adn a drop down list will appear.
	
Select the second option: Object

{{ :es:imagen5.png?500 |}}

The first Adapter we need is the User Adapter. This Adapter does not need Properties, but it is necessary, since all messages start from it.

 
{{ :es:imagen6.png?500 |}}

Next select another Adapter, and in this case we need the GUI Adapter, which is the one that allows us to interact with all kinds of web pages, to navigate, extract data, validate, etc...

Accept the change of Adapter.

{{ :es:imagen7.png?500 |}} 

And we can now launch messages

{{ :es:imagen8.png?500 |}}

This Adapter needs the folowing in the Properties tab, indicate the URL and the name of the Search engine, in this case Chrome.\\ \\ The URL and the search engine are necessay. Other parameters are optional.

{{ :es:imagen9.png?500 |}}
 

When then go to the Selective Mapping tab, click twice and open it. To the right of the image, a light gray drop-down will appear with some data, which will vary as we modify our search by pressing the [v] key and the help of a red marker\\ \\ Thanks to this tool, we can obtain the search values, which must be included, by copying and pasting them in the next Object Mapping tab. We can search by: name, type, xtpath, Css attributes, according to what was marked in the SearchBy dropdown. We then paste it in the Element tab.\\ \\ 

{{ :es:imagen10.png?500 |}}\\ {{ :es:imagen11.png?500 |}}\\ {{ :es:imagen12.png?500 |}}\\ {{ :es:imagen13.png?500 |}}\\ {{ :es:imagen14.png?500 |}}\\ 

If we want to document a step, open the message documentation screen and give an explanation of this step. This will appear documented when downloading he evidence document.

{{ :es:imagen15.png?500 |}} 


When the finish giving all the properties to the messages, map the messages and if we want to we document them.


Once we have finished the whole process, we save the diagram and validate it. 

{{ :es:imagen16.png?500 |}}

This diagram is assigned a number by default.


Open the Client, and download the Exe version.

{{ :es:imagen17.png?500 |}}

And it will appear:

{{ :es:imagen18.png?500 |}} 

We look for the test case, execute it, if there are no errors it will be marked in green. \\ \\ The Test case is  launched automatically and we can see how: Google is opened -> Accept our PC's Cookies message -> include our Google search criteria -> click on the button -> then click on the 1st option that appears. \\ \\ Next to the green tab is a folder that contains all the  It is found in our C directory:  


{{ :es:imagen19.png?500 |}}

{{ :es:imagen20.png?500 |}}

{{ :es:imagen21.png?500 |}}
 

Open it and we have all the steps performed, the predefined functions that we have needed for the messages and the result.

 
{{ :es:imagen22.png?500 |}} 

If we want to have this test case documented, we go to Results and click on the download tab.\\  
{{ :es:imagen23.png?500 |}}

{{ :es:imagen24.png?500 |}} 

It creates a Word document with the number of steps performed, the Result, the link to access the diagram and if we have documented the messages, it will also detail them. 
 
{{ :es:imagen25.png?500 |}}\\ \\ 
 

====F12 Browser====

To get the mapping of a message from the GUI adapter we can do it with the F12 key. In this case we are going to search for a type in Google, which is the field where we write the search we want to do in Google.\\ \\ 
We open the page we want to diagram (URL of the GUI adapter). Press the F12 key on the keyboard and the console appears

 
{{ :es:f12imagen1.png?500 |}}
 


We click on the arrow in the image that shows us the elements of the page that we want to select to inspect. 


{{ :es:f12imagen2.png?500 |}} 



It is positioned on the element of which we want to obtain the mapping and it is clicked on it. The F12 screen will show the information of the element.
 
{{ :es:f12imagen3.png?500 |}} 


 
{{ :es:f12imagen4.png?500 |}}
 

On the element, we double click on the field that we want to obtain so that it is selected. In our case, we are going to do the search by "name". We copy the element (Ctrl + C).

 
{{ :es:f12imagen5.png?500 |}}
 

We go back to mapping the message in our diagram. Where we select the search field (name) and the information copied from F12 in the element field.

{{ :es:f12imagen6.png?500 |}} 




If we want to search by Xpath or Css Selector, in the selected element in the console (F12), we right-click / copy / copy selector-copy Xpath. And it is pasted in the element field of the message mapping.

{{ :es:f12imagen7.png?500 |}}\\ \\ 


===== Login and Main Menu =====

The first screen seen when accessing to the tool is the one here below, where the user needs to log in, in order to get into its personal TAST view. This login can be done with the same credentials than for accessing Windows (i.e. LDAP number N000000 or XI000000 and password).

{{ :pantalla_login_eng.png?300 |}}

After clicking the "Sign in" button, the first webpage seen is the DASHBOARD of the tool, where the user can see the main useful information about the tool and its last use.

{{ :menu1_eng.png?nolink&250  |}}
  
For switching between the different functionalities of the application, the user can use the menu at the left side of the screen. This menu can be presented in two ways (collapsed or expanded). In this menu, can be selected the following options: 

  * Dashboard.
  * Settings.
  * Customize. 
      *	Domains & Projects.
      *	Projects & Users.
  * User Roles.
  * Infrastructure.
  * Modeling.
      *	UML Diagram.
      * Data Management.
  * Running.
      *	TS Management.
      * Planning. 
  * Results.

The button 'Modeling' will drive the user to the page that allows to create UML diagrams.

To logout, the user needs to click on its user (upper right) and then will see the Logout button.\\ \\  

===== HTML Client =====
 
The function of the TAST HTML client is to execute the test cases and test sets.

==== Download ====

To be able to use this tool, the first step is to download it from TAST, through the //Client// option that appears in the upper right part of the application.

{{:client_eng_1.png?nolink&800|}}

The HTML client can be downloaded in two formats: exe and jar.

{{:client_eng_2.png?nolink&800|}}

  * With the **'.exe' option**, a 'tast.zip' file is downloaded, which we will have to save somewhere in our computer, and extract the file that appears inside the zip.\\ This file has the format: //tast_vn.nn.nn//, where 'n.nn.nn' is the version of the HTML client (example: tast_v1.20.23.exe).

  * With the **'.jar' option**, a 'tast.jar' file is downloaded, which we will have to save in the path:\\  //C:\AppTast//\\ To be able to use //tast.jar// we must also have in the path //C:\AppTast// the file //TAST.cmd//.

==== Functionality ====

The first screen seen when accessing to the HTML Client is the one here below, where the user needs to log in, in order to get into its personal TAST HTML Client. This login can be done with the same credentials than for accessing TAST (i.e. LDAP number N000000 or XI000000 and password).

{{ :Client_login_eng_1.png?nolink&600  |}}

After clicking the “Login” button, some of the following messages will appear, depending on whether the HTML client version is the last or not:

1- //HTML client version is the last://

{{ :Client_login_eng_4.png?nolink&300  |}}


  * Clicking '**Yes'** button, all the executions (pending or executed) of the logged-in user will appear.

{{ :Client_login_eng_2.png?nolink&800  |}}

  * Clicking '**No'** button, all executions of the HTML client will be deleted, appearing the empty table.

{{ :Client_login_eng_5.png?nolink&700  |}}

2- //HTML client version is not the last://

{{ :Client_login_eng_3.png?nolink&300  |}}

   * Clicking '**Accept**' button, the window of section 1 will appear, with all the executions (pending or executed) of the logged-in user will appear.\\ \\ At the top of the main window of the HTML client, will appear three options:\\ \\
     *  Refresh.\\ 
     *  Delete.\\ 
     *  Schedule.\\ \\ 

==== Refresh Option ====

The HTML client window is updated with all the executions that are in that moment, adding:
  * all the Test Cases launched from the 'Launch Validation' option of [[en:edit_diagram:edit_a_diagram_for_its_update_double_click|Modeling]].
  * all the Test Sets launched from the 'Execute Test Set' option of [[en:running#test_sets_window|Test Set Management]].

==== Delete Option ====

Allows to eliminate the selected test cases and test sets.

{{ :Client_login_eng_6.png?nolink&800  |}}

==== Schedule Option ====

When clicking on this option, the planned executions that are ready to be executed will appear in the window (according to [[en:running#planning|Planning]] functionality).

==== Content of the HTML Client Table ====

In this table appears the following information:

  * **Test Set name:** the name of the Test Case or Test Set.
  * **Exc.Time(ms):** run time of the Test Case or Test Set, expressed in milliseconds.
  * **Step:** it is used to indicate the step in which you want to stop the execution. ([[en:running#debug_mode_execution_in_client_for_tc_validation|Debug Mode]]).
  * **Debug:** the two icons are only enabled when [[en:running#debug_mode_execution_in_client_for_tc_validation|Debug Mode]] is used.
  * **Action:** there are three possible actions:\\  
     * //execute the test case / test set:// can be used when the icon{{:Client_login_eng_8.png?}}appears.
     * //stop the test case / test set:// once the execution has started (the icon{{:Client_login_eng_9.png?}}appears), it can be stopped by clicking on that icon.\\ \\ When the execution stops, will be shown the following window:\\ \\ {{ :Client_login_eng_7.png?nolink&300  |}}\\ 
     * //restart the test case / test set:// once the execution has been paused (appears{{:client_login_eng_10.png?|}}in //Status//). It can be restarted by clicking on the {{:Client_login_eng_8.png?|}}icon.\\ \\ 
  * **Status:** shows the status of the executions. It can contain the values:\\ \\     {{:Client_login_eng_11.png?|}} the test case / test set has not yet been executed.\\ {{:Client_login_eng_12.png?|}} the test case / test set has been executed and finished ok.\\ {{:Client_login_eng_13.png?|}} the test case / test set has been executed and finished ko.\\ {{:Client_login_eng_10.png?|}} the test case / test set has been pause.\\ {{:Client_login_eng_14.png?|}} when the evidences can not be uploaded and recorded correctly in the NAS where the results are stored.\\ \\ 
  * **Logs:** clicking on this option, the client opens an explorer window with the path where are the following files:
    * logs of the execution,
    * screenshots (if previously indicated),
    * other files (if proceeds) result of the execution: excel, scripts,...
TAST DokuWiki

User Tools

Site Tools

Page Tools
