This is an old revision of the document!

Computer setup for TAST use

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 this guide:

Guide for basic use of TAST

It will be necessary to perform the following steps:

Check you have Java Runtime Environment (JRE) installed. In case it is not installed, ask your administrator to install it. This is completely required.
Change the two environment variables: Run from the control panel → User Accounts → User accounts → Change my environment variables →

a. If you have PATH, click on “edit” while selecting it. If you don’t have it, click on “new”.

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).
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”.

b. Click on “Add”

c. Add locations:

For SIPSA environment:
https://app.testautomationsystemtool.com/
For TAST1 environment:
https://tast-sbg-tast-dev.appls.boaw.paas.gsnetcloud.corp/
For TAST2 environment:
https://tast-sbg-tast-pre.appls.boaw.paas.gsnetcloud.corp/
Create a folder named “AppTast” on the “C:” Drive
Find drivers of web driver in the following folder:
P:\Projektdokumente\CE17.390500-Test Automation System Tool TAST\Produban Docs.
Copy in “C:/AppTast” the folder “seleniumDriver” (no admin rights required).
Find the folder “wget” in the following directory:
P:\Projektdokumente\CE17.390500-Test Automation System Tool TAST\Produban Docs.
Copy in “C:/AppTast” the folder “wget” (no admin rights required).

Guide for TAST Mobile Adaptor

This will be a guide to install and set up the components required to use the Mobile Adaptor with TAST.

NOTE THAT FOR SOME OF THE SOFTWARE LISTED HERE YOU MAY NEED TO ASK YOUR ADMINISTRATOR TO INSTALL IT FOR YOU

Dowload Appium

Go to the Appium Github: https://github.com/appium/appium-desktop/releases
In this page, you need to download the latest .exe version that matches with your computer’s operative system. If it is a Windows installation, you need to select Appium-windows-1.15.1.exe in this case (you need to download the latest version which is probably not the same as the screenshot below).
When the download finishes, open it.
A installer will appear to download the software, choose the most optimal option for you.
Wait until the installation is completed.

Now you have Appium installed.

Download Android Studio

Download the latest version of Android Studio that suits your needs from the following link: https://developer.android.com/studio
Execute the installer for Android studio, and this will appear on your screen. Click “Next” to proceed.
Make sure Android Virtual Device is checked and press “Next”.
Now choose the location where you want to install Android Studio. By default it is “C:\Program Files\Android\Android Studio”, and we will use this one.
Once it finishes, click on “Next”, then “Finish” (with the box to initiate Android Studio checked).

Android Studio welcome page will appear and you can start setting it up. You will see a message saying that the SDK is missing.

Click on “Next” to install it.
Select “Do not import settings”.
Select what you see in the picture. Make sure the location where it will be installed is “C:\Users\YOURUSER\AppData\Local\Android\Sdk”. Then click on “Next”.
Select “Standard” and click on “Next” again.
Select the UI theme you prefer, dark or light. Click on “Next”.
Click on “Finish” to start downloading the components.
After everything is downloaded, click on “Finish” again.

Now all components are installed, and we can proceed with the set up of the emulator.
NOTE: You may need to have your BIOS modified by your administrator to be able to use the emulator, but you need to follow these steps for the Adaptor to work nonetheless.

Click on “Create New Project”.
Select a “No activity” project template and proceed with the default configuration.
Click on the icon on the top right corner marked in red.
A pop-up with your available virtual devices will appear. To create a new one click on “Create Virtual Device…”.
Now select the hardware you want to emulate, here I am using the “Nexus 5”.
The first time you create a virtual device, it will ask you to download the API, we recommend installing level 28, which is Android 9.0, which is Android Pie. Select it and proceed with the installation clicking on “Next”.
Read and accept the license agreement, click on “Next” again.
And click on “Finish”.
Proceed with the defaults and click on “Finish”.
Now your device is ready. To launch it, click on the “Play” button and the device will appear on your screen (if it is activated on the BIOS).

Change Environment Variables

Press the Windows button, and type “environment”. Click on “Edit environment variables for your account”. This is the same as the first few steps on the Guide for basic use of TAST.

Here you need to make a new variable called ANDROID_HOME. And its value needs to be, if you followed the whole guide: C:\Users\YOURUSER\AppData\Local\Android\Sdk”, where YOURUSER is the username you are currently using.

Then you need to go to the PATH variable and press “Edit”. Press “New” and put in the value “C:\Users\YOURUSER\Appdata\Local\Android\Sdk\platform-tools”.

After all of this is done, restart your computer.

Configure your device to use it with Appium

First of all, plug in your device via USB.
Once it is plugged in, we need to activate the debug mode for it. This will be a default guide to activate it on many phones, this may not work with your phone model. If this is the case, search for “activate developer options in YOURPHONEMODELHERE”.
Go to settings, and search for “About phone”.
Go to “Build number”. Tap this repeatedly until a window pops up saying

“You are now a developer” or “You have enabled developer options.
Once this is enabled, go to “Settings” and tap on “Developer options”.
Look for an option called “USB Debugging” and activate it.
When you activate it, if the following window doesn’t pop up, unplug and plug back in your device. When the window pops up, be sure the box is checked and tap OK.
Now press the Windows key, and type “cmd”. Click on it to execute it. When it is running, type: “adb.exe” and press enter.
Now type “adb devices” and press enter. With this, the list with the android devices plugged to the computer will be shown.
We need to save the ID of our device. In this case it is 6af5991b. With this ID saved go to the Appium application.
Click en “Start Server”.
Then click on the magnifying glass (marked in red in the image).
A new window will pop up. We need to click on “Desired capabilities” and in the JSON Representation something like this:

{
“deviceName”: “YourPhoneModel”,
“platformName”: “Android”,
“platformVersion”: “x.x”,
“udid”: “the id you retrieved before”
}

DeviceName is the name you want to put to your device, we recommend to put the model of your phone (like Samsung Galaxy s10).
PlatformName will be the type of OS, in almost all the cases will be Android.
PlatformVersion is the version the device OS.
And the udid is the ID we got from the adb.exe.
When you have completed this step, click the small save button highlighted in yellow in the image to save the JSON code. Then click on “Save As…” to save the device configuration. We recommend to type the same name you put on “deviceName” in the JSON code.
Now click on “Automatic Server” on the top left and use the “Saved capability set” you just saved and press “Start Session”.
Then a window will pop up, with your device on the left and the inspector options on the right.

NOTES:

If it gives you an error when you are starting session, it might be that your phone is not well connected. Just disconnect it, connect it again and be sure that in “adb devices” it appears as a device, not unauthorized nor unknown. If it is shown as unauthorized be sure you accepted the USB debug connection in your phone screen.

If it gives you an error about JAVA_HOME you have to download jdk1.8.0_151 and install it in C:\Program Files\Java then go to environment variables, and add a system variable called JAVA_HOME (requires admin rights) with the value: C:\Program Files\Java\jdk1.8.0_151.

Guía para Adaptador de Host de TAST (3270/5250)

Esto va a ser una guía para obtener y configurar los componentes necesarios para ejecutar el adaptador 3270 y el adaptador 5250 con TAST.

Ve a la ruta “M:\PLM\10 TAST” y de ahí, descarga la carpeta “tk4-_v1.00_current”, y los archivos “jagacy3270-5.4.0.jar” y “tn5250j-0.7.6-TAST.jar”.
Coge estos archivos y cópialos a tu carpeta “C:\AppTast”.
Una vez hecho esto, para ejecutar el adaptador 3270, hay que ejecutar el “mvs.bat” que hay dentro de la carpeta “tk4-_v1.00_current” por cada vez que se quiera ejecutar un diagrama. Es decir, se abre, se ejecuta un diagrama, y para ejecutar otro, se cierra y se vuelve a abrir antes de ejecutarlo.
Para ejecutar con el adaptador 5250, primero hay que configurar la conexión. Para esto, si quieres hacer pruebas contra algún servidor, se puede usar pub400.com. Esto será usado en el diagrama también. Hay que crearse una cuenta, y llegarán dos correos, primero uno en el que hay que hacer click en el link, y luego otro con tu usuario y tu contraseña.
Al abrir el tn5250j te encontrarás con la siguiente pantalla, y habrá que hacer click en “add”:
Aquí se abrirá una nueva ventana para configurar una conexión, se pone el nombre que se quiera, y después hay que ir a TCP/IP.
Aquí es donde vamos a poner la dirección de nuestro host, en este caso pub400.com, si necesitas otro deberás conocer cuál es de antemano. En el device name se pone lo que se quiera, también se puede marcar el “Use PC name as device”.

Una vez hecho esto, ya está configurado, y se pueden empezar a ejecutar casos desde el cliente de TAST.

Complementos de TAST para funcionalidad Web

Por favor haz click en el siguiente link para la guía de instalación, configuración, y cómo usar la funcionalidad de Selective Mapping, útil para el mapeo de mensajes de diagramas. Esto es opcional:

https://wiki.testautomationsystemtool.com/doku.php?id=es:modeling#selective_mapping

Utilidad para Mapeo de Diagramas en TAST

Para la guía de instalación, configuración y como usar la función de Record & Playback para TAST, que hace el proceso de mapear los pasos de un diagrama existente más fácil, haz click en el siguiente link. Esto es opcional:

https://wiki.testautomationsystemtool.com/doku.php?id=es:record_playback

Guía para Notepad++ con logs con colores

Esto es una guía para instalar Notepad++ y poder ver logs de TAST con diferentes colores. Por favor sigue estos pasos:

Descarga la última versión Portable (zip) de Notepad++ del siguiente link: https://notepad-plus-plus.org/downloads/. Para 32 bits si tu Sistema es de 32 bits, y 64 si tu sistema es de 64.
Descarga el fichero TASTLOGTEST.xml de este directorio:
M:\PLM\16 TMO\60. Modeling\01. TAST
Abre Notepad++ y ve a Lenguaje → Lenguaje definido por el usuario → Define tu lenguaje.
Click en “Import” y elige el fichero TASTLOGTEST.xml que acabas de descargar.
Click en “Guardar como…” y llámalo como quieras, por ejemplo, TASTLanguage, o TAST.

Ahora, cada vez que abras un archivo .log, puedes ir a “Lenguaje” y elegir el que has definido, que está abajo del todo, y el fichero .log tendrá palabras importantes en colores. Si quieres añadir más palabras, puedes editarlo con la misma ruta anterior: Lenguaje → Lenguaje definido por el usuario → Define tu lenguaje.