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. Lo primero, conecta tu dispositivo al ordenador por USB.
   
2. Una vez conectado, hay que activar el modo de depuración . Esto es una guía para activarlo en la mayoría de teléfonos, pero puede que no funcione con tu modelo. Si este es el caso, busca “activar opciones de desarrollador en TUMODELOAQUÍ”.
   
   
   
   
3. Ve a “Opciones”, y busca “Sobre el teléfono”.
   
   
4. Ve a “Build number”. Haz tap repetidamente hasta que salga una Ventana diciendo “Ahora eres un desarrollador” o “Has activado las opciones de desarrollador”.
   
   
   
   
5. Una vez activado, go to “Opciones” y haz tap en “Opciones de desarrollador”.
   
   
   
   
6. Busca una opción llamada “Depuración por USB” y actívala.
   
   
   
   
7. Cuando la actives, si la siguiente ventana no aparece, desconecta y reconecta tu dispositivo. Cuando aparezca la ventana, asegúrate de que la caja está marcada y haz tap en OK.
   
   
   
   
8. Ahora haz click en el botón de Windows , y escribe “cmd”. Haz click para ejecutarlo. Cuando esté ejecutando, escribe: “adb.exe” y presiona intro.
   
   
9. Ahora escribe “adb devices” y presiona intro. Con esto, la lista con los dispositivos android conectados al ordenador se mostrará.
   
   
   
   
10. Tenemos que guardar el ID de nuestro dispositivo. En este caso es 6af5991b. Con este ID guardado ve al programa Appium.
    
    
11. Click en “Start Server”.
    
    
    
    
12. Después click en la lupa (marcada en rojo en la imagen).
    
    
    
    
13. Una nueva ventana se abrirá. Hay que hacer click en “Desired capabilities” y en la “JSON Representation” algo como esto:
    
    {
    “deviceName”: “YourPhoneModel”,
    “platformName”: “Android”,
    “platformVersion”: “x.x”,
    udid”: “the id you retrieved before”
    }
    
    DeviceName es el nombre que le quieres dar a tu dispositivo, recomendamos poner el modelo de tu dispositivo (como SamsungGalaxyS10).
    PlatformName es el tipo de Sistema operativo, en la mayoría de casos será Android.
    PlatformVersion es la versión del Sistema operativo del dispositivo.
    Y el udid es el ID guardado previamente del adb.exe.
    
    
    
    
14. Cuando hayas completado este paso, haz click en el pequeño icono de guardado marcado en amarillo en la imagen para guardar el código JSO. Después click en “Save As…” para guardar la configuración del dispositivo. Recomendamos poner el mismo nombre que en el deviceName en el código JSON.
    
    
15. Ahora haz click en “Automatic Server”
    
    
    
    en la esquina superior izquierda y usa el “Saved capability set” que acabas de guardar y click en “Start Session”.
    
    
16. Una ventana aparecerá, con tu dispositivo en la izquierda y las opciones del inspector en la derecha.
    
    
    
    NOTAS:
    
    Si te da un error al iniciar la sesión, puede ser que tu teléfono no esté bien conectado. Desconéctalo, conéctalo de nuevo y asegúrate de que en “adb devices” aparece como un dispositivo, no “unauthorized” o “unknown”. Si sale como “unauthorized” asegúrate de que has aceptado la depuración por USB en tu teléfono.
    
    Si te da un error sobre JAVA_HOME tienes que descargar el jdk1.8.0_151 e instalarlo en C:\Program Files\Java, después ir a las variables de entorno, y añadir una variable de sistema llamada JAVA_HOME (requiere de permisos de administrador) con el valor: C:\Program Files\Java\jdk1.8.0_151.
    
    

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.

1. 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”.
   
   
2. Coge estos archivos y cópialos a tu carpeta “C:\AppTast”.
   
   
3. 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.
   
   
4. 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.
   
   
5. Al abrir el tn5250j te encontrarás con la siguiente pantalla, y habrá que hacer click en “add”:
   
   
   
   
6. 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.
   
   
   
   
7. 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.

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

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.

Para continuar con el procedimiento de seguridad, el siguiente documento muestra una guía paso a paso.

manual_security_certificate_alm-160_.docx

tast_release_notes_v1.3.pdf

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

manual_security_certificate_alm-160_.docx