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:

It will be necessary to perform the following steps:

1. Check you have Java Runtime Environment (JRE) installed. In case it is not installed, ask your administrator to install it. This is completely required.
   
2. 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).
   
   
   
3. Restart the PC.
   
4. 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”.
   
   
5. 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/
   
   
6. Create a folder named “AppTast” on the “C:” Drive
   
   
   
   
7. Find drivers of web driver in the following folder:
   P:\Projektdokumente\CE17.390500-Test Automation System Tool TAST\Produban Docs.
   
   
   
   
8. Copy in “C:/AppTast” the folder “seleniumDriver” (no admin rights required).
   
   
9. Find the folder “wget” in the following directory:
   P:\Projektdokumente\CE17.390500-Test Automation System Tool TAST\Produban Docs.
   
   
10. Copy in “C:/AppTast” the folder “wget” (no admin rights required).
    
    
    
    

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

1. Go to the Appium Github: https://github.com/appium/appium-desktop/releases
   
   
2. 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).
   
   
   
   
3. When the download finishes, open it.
   
   
   
   
4. A installer will appear to download the software, choose the most optimal option for you.
   
   
   
   
5. Wait until the installation is completed.
   
   
   
   Now you have Appium installed.
   
   

1. Download the latest version of Android Studio that suits your needs from the following link: https://developer.android.com/studio
   
   
   
   
2. Execute the installer for Android studio, and this will appear on your screen. Click “Next” to proceed.
   
   
   
   
3. Make sure Android Virtual Device is checked and press “Next”.
   
   
   
   
4. 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.
   
   
   
   
5. 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.
   
   

1. Click on “Next” to install it.
   
   
   
   
2. Select “Do not import settings”.
   
   
   
   
3. 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”.
   
   
   
   
4. Select “Standard” and click on “Next” again.
   
   
   
   
5. Select the UI theme you prefer, dark or light. Click on “Next”.
   
   
   
   
6. Click on “Finish” to start downloading the components.
   
   
   
   
7. 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.
   

1. Click on “Create New Project”.
   
   
   
   
2. Select a “No activity” project template and proceed with the default configuration.
   
   
   
   
3. Click on the icon on the top right corner marked in red.
   
   
   
   
4. A pop-up with your available virtual devices will appear. To create a new one click on “Create Virtual Device…”.
   
   
   
5. Now select the hardware you want to emulate, here I am using the “Nexus 5”.
   
   
   
6. 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”.
   
   
   
   
7. Read and accept the license agreement, click on “Next” again.
   
   
   
   
8. And click on “Finish”.
   
   
   
   
9. Proceed with the defaults and click on “Finish”.
   
   
   
   
10. 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).
    
    
    
    
    
    

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.

1. First of all, plug in your device via USB.
   
2. 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”.
   
   
3. Go to settings, and search for “About phone”.
   
   
   
   
4. Go to “Build number”. Tap this repeatedly until a window pops up saying
   
   
   
   “You are now a developer” or “You have enabled developer options.
   
   
5. Once this is enabled, go to “Settings” and tap on “Developer options”.
   
   
   
   
6. Look for an option called “USB Debugging” and activate it.
   
   
   
   
7. 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.
   
   
   
   
8. Now press the Windows key, and type “cmd”. Click on it to execute it. When it is running, type: “adb.exe” and press enter.
   
   
9. Now type “adb devices” and press enter. With this, the list with the android devices plugged to the computer will be shown.
   
   
10. We need to save the ID of our device. In this case it is 6af5991b. With this ID saved go to the Appium application.
    
    
    
    
11. Click en “Start Server”.
    
    
    
    
12. Then click on the magnifying glass (marked in red in the image).
    
    
    
    
13. 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.
    
    
    
    
14. 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.
    
    
15. Now click on “Automatic Server” on the top left and use the “Saved capability set” you just saved and press “Start Session”.
    
    
    
    
16. 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.
    
    

This Will be a guide to obtain and set up the necessary components to execute the 3270 and 5250 adapter with TAST.

1. Go to the directory “M:\PLM\10 TAST” and locate the folder “tk4-_v1.00_current”, and the files “jagacy3270-5.4.0.jar” and “tn5250j-0.7.6-TAST.jar”.
   
   
2. Download these files and copy them to your “C:\AppTast” folder.
   
   
3. Once this is done, to execute the 3270 adapter you need to execute the “mvs.bat” located inside the “tk4-_v1.00_current” folder for each time you want to execute a test. You open it, execute a diagram, and to be able to execute another one, you need to close it and open it again before doing so.
   
   
4. To execute tests with the 5250 adapter, first we need to set up the connection. If you want to test against any server, you can use pub400.com. You need to make an account, and you will receive two e-mails, one where you need to click the link, and another one with your user and password.
   
   
5. When opening the tn5250j the following window will pop up, and you will need to click on “add”:
   
   
   
   
6. A new window will pop up to set up a new connection, you can name it however you want, and go to the TCP/IP tab.
   
   
   
   
7. Here is where we will type the host IP, in our case, pub400.com. If you need another one, you will need to know it beforehand. This will also be used on the diagram. On the “device name” you can name it however you want, or use the “Use PC name as device” checkbox.
   
   
   
   Once this is done, its already set up and you can start executing cases from the TAST client.

Please click on the following link for the installation, set up guide and how to use the Selective Mapping functionality, helpful when mapping messages from diagrams. This is optional:

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

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

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

1. 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.
   
   
   
   
2. Descarga el fichero TASTLOGTEST.xml de este directorio:
   M:\PLM\16 TMO\60. Modeling\01. TAST
   
   
3. Abre Notepad++ y ve a Lenguaje → Lenguaje definido por el usuario → Define tu lenguaje.
   
   
   
   
4. Click en “Import” y elige el fichero TASTLOGTEST.xml que acabas de descargar.
   
   
   
   
5. 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.

For going on with the security allowance procedure, the document below shows a step-by-step guideline.

manual_security_certificate_alm-160_.docx