es:modeling_2.0 [TAST DokuWiki ]

User Tools

Site Tools


Sidebar

Primeros pasos en TAST

Que es UML

Configuración del sistema para el uso de TAST

Preguntas más frecuentes

Problemas reconocidos

Indice de la herramienta TAST

Adaptadores de TAST

Ejemplos de adaptadores

TAST Integraciones

Características de interés

Documentación de administración técnica

Recomendaciones para modelar

Formación en la herramienta TAST

es:modeling_2.0

Modelado 2.0

Esta opción de la herramienta TAST permite al usuario administrar diagramas UML. También podrá gestionar los datos y gestionar los repositorios de los casos de prueba que se diseñen.



Diagrama UML 2.0

Esta opción de la herramienta TAST permite al usuario gestionar todos los tratamientos asociados con los diagramas UML.

Como crear un diagrama UML

Los diagramas UML son completamente necesarios para la creación de los casos de prueba. Esto se debe a que cada mensaje del diagrama representa una acción que se llevará a cabo en la prueba (click o escriba, por ejemplo). En los párrafos siguientes, se explica cómo se puede crear un diagrama UML.

Cuando haya iniciado sesión en la herramienta, el usuario puede ver un menú en el lado izquierdo (consulte First steps in TAST para obtener más información). En este menú, el usuario hará click en el botón “Modelo”.



Una vez en la página Modelado, el usuario puede proceder de tres maneras:

  • Seleccionar y modificar uno de los casos de prueba ya creados.
  • Crear un nuevo caso de prueba.
  • Importar un caso de prueba creado con cualquier otra herramienta de diseño UML.



  • Si el usuario elige modificar un diagrama UML existente (lado izquierdo de la captura de pantalla superior), habrá 4 colores diferentes para los casos de prueba: verde para los casos donde el mapeo se ha completado y ejecutado correctamente, amarillo para los casos en los que el mapeo se ha completado pero no ejecutado, rojo en los casos donde el mapeo se ha completado y ejecutado con error y gris para los casos que están vacíos.
  • Si elige crear un nuevo diagrama UML, es necesario hacer click en el icono (+) “Nuevo diagrama” de la pestaña situada en el lado superior derecho. Después de esto, se abrirá una nueva ventana como se muestra a continuación:


    Donde tendrá que ir cumplimentando los siguientes campos:

    • Dominio: este es el dominio al que pertenecerá el caso de prueba.
    • Proyecto: seleccione el proyecto al que se vinculará el caso de prueba.
    • Carpeta: carpeta del sistema donde se almacenará el caso de prueba.
    • Nombre del diagrama.
    • Descripción del diagrama.
    • Usar plantilla de diagrama.
    • Copiar el mapeo de validación.
    • Visibilidad como plantilla:
      • Público.
      • Dominio.
      • Proyecto.
      • Privado.
      • Ninguno.

        IMPORTANTE: Los proyectos y dominios deben crearse antes de la realización del caso de prueba y, además, el usuario debe asignarse al dominio y al proyecto. De lo contrario, el usuario no podrá ver ni el dominio del proyecto, ni los casos de prueba que ya se hayan creado. Para obtener más información sobre la creación del dominio y el usuario, consulte la página customize._domains_and_projects.
  • Si el usuario elige importar un caso de prueba ya creado, pulsará el botón de “Importar” que está cerca del botón de “Nuevo diagrama”.



    y se abrirá una nueva ventana con información sobre donde guardar este diagrama (consulte la página diagram_import_export ).

Editar un diagrama

Esta opción de la herramienta TAST permite crear/modificar un diagrama.

A continuación vemos la pantalla o lienzo en blanco para editar un diagrama. Es el Canvas 2.0. En la parte superior derecha (marcada en rojo), esta la barra de herramientas del Canvas, que ofrece diferentes opciones para el diseño del diagrama. Vamos a verlas a continuación:


  • Seleccionar los elementos a incluir en el diagrama a través del icono '+':

  • Borrar elementos: permite borrar el o los objetos del diagrama que se hayan seleccionado utilizando el icono de la 'papelera'.
  • Acciones de diagrama: agrupa una serie de acciones que se pueden realizar a nivel de diagrama:

  • Asistentes: muestra una lista con los asistentes disponibles:

  • Visualizar mapa del diagrama: pulsando este botón, se muestra una miniatura del diagrama actual (a una escala de 4:1) que aparecerá en un recuadro en la parte superior derecha del Canvas.
  • Lupa: permite realizar búsquedas de texto libre en todos los elementos del diagrama, y también permite acotar las búsquedas sobre aquellos elementos que nos interesen en un momento dado.
  • Recargar repositorios: nos permite recargar archivos YML o TXT, los cuales contienen una serie de claves que podremos usar en los diagramas.
  • Descargar imagen del diagrama: haciendo click en el icono de 'imagen', se genera una imagen “al vuelo” tal y como es el diagrama actual, es decir se crea un preview del diagrama y se descarga a un fichero .png
  • Validar mapeo: valida los mapeos incluidos en el diagrama usando el icono 'validar mapeo'.
  • Ejecutar validación: ejecuta la validación del diagrama con el icono de 'reproducción'.
  • Mostrar ayuda del Canvas: aparece un modal con 3 pestañas (Atajos de teclado, Variables globales, Guía de Colores) donde se muestra la ayuda básica del Canvas.
    • Pestaña “Atajos de teclado”: muestra todos los atajos de teclado que equivalen a acciones realizadas bien a través de opciones de menú o de botones:



    • Pestaña “Variables globales”: muestra las variables globales estándar disponibles en cualquier diagrama:



    • Pestaña “Guía de Colores”: se refiere a los distintos colores que podemos encontrar ahora en los objetos del diagrama:



Comprobación en la pestaña de propiedades del objeto

El objeto u objetos (Adaptadores), es el elemento principal a la hora de crear un diagrama. Dos pestañas ayudan a definir el nombre del objeto, sus propiedades y los parámetros de inicialización o configuración, para poder interactuar con páginas web, archivos, API, scripts, remotos, BBDD.



Comprobación en la pestaña de propiedades del mensaje

En un mensaje, tras hacer doble click, es posible indicar el tipo de acción que se hará cuando el paso deba ejecutarse, según los siguientes campos:


  1. Mensaje bloqueante: Si el mensaje falla, la ejecución del paso fallará y el caso de prueba no continua; termina en este punto.
  2. Paso Opcional: Si está marcado, el resultado de este paso no impactará en el resultado final.
  3. Comentario: Si está marcado, el mensaje no se ejecutará.
  4. Punto de ruptura: La comprobación del punto de ruptura se utiliza para detener la ejecución de la prueba en este paso. Es útil durante la creación del diagrama.

Guardia

Una guardia es una condición lógica que se puede incluir en cualquier mensaje dentro de los diagramas UML. Cuando esta condición se cumple el mensaje se ejecuta, cuando esta condición no se cumple, el mensaje NO se ejecuta. Una guardia es muy útil cuando una acción debe ejecutarse o no, dependiendo de un condicionante.



Las condiciones dentro de una guardia pueden ser del tipo:

  • Sencillas: por medio de operadores lógicos, < (menos que), > (mayor que), == (igual a), != (distinto de), < = (menos o igual que), >= (mayor o igual que).
  • Complejas: concatenando condiciones sencillas por medio de operadores lógicos como: AND (y), OR (or), && (y exclusivo), || (o exclusivo)

A continuación, algunos ejemplos sobre condiciones simples y complejas en una guardia:

  • #numCol < 25
    En este caso, el mensaje se ejecutará cuando, la variable tipointeger numCol sea inferior de 25.
  • #myFavoriteApp == “TAST”
    En este el mensaje se ejecutará cuando la variable tipo String myFavoriteApp sea igual al String “TAST”. Debe ser considerado que los String deben compararse con el símbolo de comillas ””.
  • #fahrzeugtypTestData ==“Gebrauchtwagen”||#fahrzeugtypTestData==“Vorf-hrwagen” ||#fahrzeugtypTestData”Tageszulassung”
    En este caso, el mensaje se ejecutará cuando la variable tipo String fahrzeugtypTestData, contenga uno de los siguientes valores: Gebrauchtwagen, Vorf-hrwagen, Tageszulassung.
  • #str1 ==“TAST” AND #str2==“TaaS” AND #str3==“SIPSA”
    En este caso el mensaje se ejecutará cuando la variable tipo String str1 sea igual a TAST y cuando la variable str2 sea igual a TaaS y cuando la variable str3 sea igual a SIPSA.

Texto de varias líneas

En la asignación de un mensaje, es posible incluir un valor con salto de línea. Para ello, hay una casilla de verificación 'Texto multilínea':

Si la casilla de verificación está seleccionada, aparecerá un editor para incluir el texto:



Mensaje de respuesta

Este mensaje tiene que estar vinculado a otro mensaje entre dos objetos y se traza en la dirección opuesta al vínculo. Los dos mensajes forman un conjunto y no se tratan por separado.


  • La única función permitida en el mensaje de respuesta es la aserción, que tiene como parámetros de entrada stepResult (resultado del mensaje anterior) y puede tener más parámetros. El parámetro de salida también es stepResult.
  • Este mensaje nos permite variar el resultado del paso anterior comprobando algunas condiciones. Este proceso se realiza utilizando un javascript.

    GESTION DE DATOS: Permite modificar el javascript de cada uno de los diagramas.


Gates

Esta opción de la herramienta TAST permite al usuario pasar información entre diagramas de secuencia. Las Gates pueden ser una forma sencilla de modelar el paso de información entre un diagrama de secuencia y su contexto. Una Gate es simplemente un mensaje que se ilustra con un extremo conectado al borde del marco del diagrama de secuencia y el otro extremo conectado a una lifeline y representa otro diagrama.

Puntos importantes a tener en cuenta sobre las Gates:

  • La posición del adaptador dentro de la Gate es muy importante para el comportamiento correcto porque la Gate también está relacionada con el Adaptador que planea instanciar. Por lo tanto, debe poner la Gate no sólo en el paso de número, sino también en la lifeline donde puede continuar la ejecución de la prueba. Por ejemplo, si quiere utilizar una Gate a un Adaptador GUI HTML, debe colocar la gate en la misma línea del adaptador GUI HTML en el diagrama Padre.
  • El comportamiento Aislado siempre instanciará todos los adaptadores.
  • El comportamiento No aislado: mapea los mensajes del primer adaptador de la Gate que tiene el mismo tipo que el adaptador del padre donde se dibuja; el resto de los adaptadores serán instanciados.
  • El concepto de Aislado / No Aislado se configura internamente en TAST. Actualmente, ese concepto solo se aplica a estos adaptadores: Adaptador GUI y Adaptador Web Services.
  • Para las Gates del Usuario: todas las Gates de las lifelines pertenecientes a los objetos de Usuario son mapeadas se asignan al objeto de Usuario del diagrama Padre.

Cómo crear un Gate:

En la barra de herramientas, seleccione la Gate y dibuje en la misma línea. Haga doble click y abra las propiedades de la Gate, donde elija el dominio, el proyecto y el diagrama que desea copiar.



El diagrama seleccionado se puede visualizar haciendo click en el icono de la imagen.



Al hacer click en el mapeo de la Gate, se mostrará una pantalla cómo la siguiente:

Esta pantalla no he podido cambiarla, abro mapeo de la gate de mi diagrama y no me aparece igual a la antigua



GESTION DE DATOS: Permite asignar datos de casos de prueba a cada Gate incluida en los diagramas.



EJECUCIÓN DE PRUEBA ESTABLECIDA CON GATES: Se crea y ejecuta un conjunto de pruebas que contiene Gates.



Fragmentos combinados

Esta opción de la herramienta TAST permite al usuario manejar bifurcaciones y loops (bucles).

TAST permite los siguientes tipos de fragmentos combinados:

Falta cambiar 1 pantalla de propiedades del fragmento a español (FOR EACH)

  • Para manejar bifurcaciones:
    • CF ALT: si la condición indicada en la Guard del Fragmento Combinado es verdadera, se ejecutarán los pasos de la primera parte del ALT; de lo contrario, los pasos ejecutados serán los de la parte 'else':




  • Para manejar bucles:
    • CF Loop do while: mientras que la condición indicada en las propiedades del fragmento combinado es verdadera, los pasos del fragmento combinado serán ejecutados. La condición se comprueba después de ejecutar los pasos, por lo que el loop do while garantiza la ejecución del loop al menos una vez:




  • CF Loop while: este bucle es similar a loop do while. La diferencia es cuando se evalúa la condición de salida del ciclo. En el loop while esta evaluación se realiza antes de entrar en el ciclo, lo que significa que el bucle puede no ser ejecutado:



  • CF Loop for: Todos los pasos incluidos en este bucle se ejecutarán varias veces, de acuerdo con los parámetros indicados en la pestaña de propiedades del fragmento:
    Guard: este campo indica la condición que debe cumplir la variable especificada para ejecutar los pasos del loop for. Esta variable aparecerá en la sección 'Variable para iteración'.
    Case start: contiene el valor inicial que la variable tomará para la iteración dentro del loop.
    Tipo de incremento: tipo de incremento de la variable. Puede ser incremental (+) o decremental (-).



  • CF Loop for each: Permite iterar uno por uno (desde 1 … n) la fila o columna seleccionada de una tabla introducida como variable. Permite manejar una a una la información seleccionada de forma vertical u horizontal.





    Para obtener datos del objeto, hay que utilizar el nombre de la tabla, seguido de la palabra “Row”, usando el método getCellValue(n).



    En el caso de la columna, hay que poner el nombre de la tabla, seguido de la palabra “Column”, usando el método getCellValue(n).



    Donde (n) es la posición de la celda en la fila o la posición de la celda en la columna.

SubTestCases

Los Subtestcases son casos de prueba que pueden ser pintados en un diagrama. La razón para implementar los subtestcases consiste en tener una opción visual en modelado de casos de prueba y verlos dibujados aparte de sólo tenerlos en gestión de datos. También para recibir un log o resultado de un caso aislado aparte del resultado total.

Cómo usarlo en un diagrama

Para usar un subtestcase en un diagrama se tiene que ir a la barra de herramientas, hacer cick en el icono ”+” y a continuación seleccionar subtestcase. También podemos usar “ALT + S” como acceso directo para dibujarlo. Para colocarlo en el canvas se tendrá que hacer click donde se quiera colocar.

Una vez dibujado, se puede cambiar el tamaño del subtestcase con el pequeño cuadrado verde claro situado en la parte inferior de la derecha del subtestcase. Los subtestcases se pueden mover (seleccionándolo y arrastrándolo) en cualquier dirección. La única limitación al movimiento vertical es que no sobrepasen la línea de los adaptadores.



Para abrir las propiedades, doble click en el subtestcase y aparecerá la siguiente pantalla. Aquí se puede cambiar el nombre del subtestcase (hasta 100 caracteres) y añadir/editar una guardia. También se puede poner un nombre con una variable de forma que quedaría: “name of the subtestcase” + #Variable
También funcionaría como: ‘name of the subtestcase‘ + #Variable

SubTestCases especificaciones

Hay algunas cosas a tener en cuenta usando subtestcases:

  1. Todos los mensajes dentro de un subtestcase funcionarán como siempre en el diagrama, pero generará un log aparte para estos. Por lo que al final tendremos un log general y uno específico del subtestcase. Si se desea ver los logs desde el cliente se verá de la siguiente manera.



    Dentro de la carpeta tendremos el log del subtest y se generarán tantas carpetas como subtestcases existan en el diagrama.

  2. No se pueden anidar los subtestcases, solo se registrarán los logs de uno en caso de que estén anidados, así que, no usarlos de esa manera.
  3. Dentro de un subtestcase se pueden poner pasos y fragmentos (combined fragments), estos fragmentos si pueden ser anidados.
  4. Dentro de un fragmento se pueden poner subtestcases.
  5. Los subtestcases pueden ser borrados, y también copiados y pegados.
  6. Se pueden poner varios subtestcases en el mismo diagrama.

SubTestCases en Gestión de Datos

En Gestión de Datos una vez se tenga un diagrama con un subtestcase (o varios) estos aparecerán marcados como un rectángulo rojo.

Gestión de Datos se usa como siempre pero con el añadido de ver los subtestcases.

SubTestCases en Resultados

En la página de resultados, una nueva funcionalidad ha sido añadida, con el simbolo: “+” puedes hacer click para desplegar una nueva tabla con todos los subtestcases que tiene una ejecución. Por ejemplo en las siguiente imagen.

Podemos ver los resultados como siempre. Pero con el nuevo añadido:

Podemos ver todos los resultados de subtestcases listados. Aquí se puede descargar los documentos de evidencias y los logs de los subtestcases.

En el documento de resultados:

En test case data description, se puede ver el nombre del subtestcase, en caso de que el test case data tenga una descripción se mostrará “testcasedatadescription_subtestcasename”.

SubTestCase en ALM

En ALM se mostrarán todas las evidencias de la ejecución, y todos los subtestcases aparecerán por separado (también si hay gates con subtestcases aparecerán aquí).



Eliminar un mensaje

Cuando se desea eliminar un mensaje de un diagrama, TAST nos ofrece varias alternativas:

La primera nos permite borrar el o los objetos del diagrama que se hayan seleccionado, haciendo click en el icono papelera de la barra de herramientas. Aparece la siguiente ventana que cuenta con 2 posibles opciones a la hora de borrar (Borrar elementos y variables, Borrar elementos) y una opción de Cancelar/volver atrás.





  • Cancelar: el mensaje no se elimina. La ventana de confirmación de eliminación está cerrada.
  • Borrar elementos y variables: se eliminan el mensaje y las referencias de las variables declaradas por ese mensaje. La ventana de confirmación de eliminación está cerrada.
  • Borrar elementos: sólo se elimina el mensaje, quedando las referencias de las variables declaradas por ese mensaje. La ventana de confirmación de eliminación está cerrada.

Una segunda sería haciendo click con el botón derecho del ratón sobre cualquier objeto del canvas, aparece un menú contextual dinámico, que presenta una serie de opciones dependiendo del tipo del objeto. Si se marca la opción “Delete”, aparece la misma pantalla anterior y se confirmara si se desea “Borrar elementos y variables”, “Borrar elementos” o “Cancelar/volver atrás”.


Y por último, podemos eliminar un elemento (esta opción sólo nos permite “Borrar elementos” o “Cancelar/volver atrás”), de una manera más rápida (atajo), utilizando el teclado. En este caso la tecla Supr.
Esta información sobre los atajos de teclado en el canvas, se mostrará al hacer click en el icono ”?” de la barra de herramientas.
Y a continuación nos aparecerá toda la ayuda necesaria:



Información sobre la gestión de Diagramas UML

A continuación, la pantalla para gestionar los diagramas UML:



Podemos acceder a la información del diagrama pulsando el icono 'Más información'.
Se pueden paginar los diagramas mediante los números de página de la parte inferior de la pantalla.

Esta pantalla permite:

- Crear un nuevo diagrama (//Nuevo diagrama// opción).
- Guardar la versión en pantalla del diagrama (icono del disquette).
- Borrar un diagrama, usando el icono papelera.
- Crear una nueva carpeta (//+ Carpeta// opción).
- Seleccionar diagramas usando los filtros de usuario y mapeos, mediante el icono
- Desactivar los filtros utilizados, usando el icono.
- Editar un diagrama para su actualización, haciendo doble click.

Pestaña Propiedades de mensajes

En la pestaña de asignación se establece la información en el nivel de mensaje:

  • Nombre: Nombre del mensaje.
  • Descripción: Descripción del mensaje.
  • Función predefinida: Función predefinida seleccionada (formar una lista combinada).
  • Parámetros de entrada: Dependiendo de tener o no parámetros de la PF seleccionada.



    Para los parámetros de entrada hay dos puntos importantes a tener en cuenta:

    • Sensible: En caso de que se compruebe, significa que el parámetro es sensible a los caracteres. Es decir, no puede ver los caracteres cuando está configurando el valor de los mismos (más adelante, en la pestaña Asignación). Por ejemplo, esto es muy útil para las contraseñas, para ocultar los valores introducidos.



    • Variable: En caso de que se compruebe, significa que el parámetro podría utilizarse más adelante en el diagrama como una variable. Una vez marcada la casilla de verificación aparece el símbolo # para indicar que este nombre será una variable desde ese momento.



Pestaña de Asignación de mensajes

La pestaña de asignación permite definir los parámetros de cada mensaje. Entonces, el “SearchBy” es la manera de encontrar un elemento en la sección de parámetros usando etiquetas, y el “Element”, es la ruta que se obtiene del SearchBy para indicar un elemento real e interactuar con él.

  • Elemento: Identificador del elemento HTML (relacionado con el atributo seleccionado en el campo SearchBy). Por ejemplo, XPath Identifier o CssSelector Identifier.
  • Buscar por: Atributo por el que se pregunta si se puede encontrar un elemento HTML. En el campo de SearchBy puedes elegir las siguientes opciones: ClassName, CssSelector, Id, LinkText, Name, PartialLinkText,TagName o Xpath y estas opciones son etiquetas que el usuario puede obtener de por ejemplo, el html de una pagina web en ciertos elementos. La mejor manera de obtener esta información es usando el F12 y buscando el elemento que queremos o usando la herramienta que hemos creado “Selective mapping”.

    Un Ejemplo visual de esto: Queremos pulsar el botón Amarillo.



    Para hacer eso con el F12, tienes que buscar el html del botón y guardar su SearchBy que es Id en este caso:



    Por otra parte usando el selective mapping puedes escoger entre las siguientes opciones…


    Y para finalizar, añades los datos a tu diagrama.
  • Valor (opcional): Valor de entrada para meter en el control.

Pestaña de Documentación de mensajes

En un diagrama de TAST, los mensajes (pasos) que no sean de respuesta se pueden documentar mediante la pestaña “Documentación del mensaje” existente en las propiedades del mismo.

En esta pestaña se va a poder documentar todo lo que debe almacenarse en las herramientas de repositorio de evidencias como ALM, Confluence, etc.


Esta nueva pestaña contiene los siguientes elementos:

  • Nombre del paso
  • Documentar evidencias: Este control indica si se deben obtener las evidencias (captura de pantalla, archivos, etc.) y si se debe registrar el paso en la herramienta de documentación (ALM, Confluence, etc.). Sólo se tomará una captura de pantalla al final de la ejecución de todos los parámetros del mensaje.
  • Descripción del paso: De manera predeterminada, la misma descripción que se ha hecho en las Propiedades del Mensaje, pero habrá la posibilidad de escribirlo y cambiarlo.
  • Resultado esperado del paso: De manera predeterminada está vacío o con OK, pero se podrá escribir lo que se quiera.
  • Resultado de ejecución del paso: Por el momento va a estar vacío.
  • Archivos adjuntos: Para pegar los archivos en la pestaña Documentación usando puede utilizar el acceso directo “Control + V” y arrastrando el ratón (ratón hacia abajo + ratón hacia arriba).
  • Capturas de pantalla: Para agregar una imagen en la zona de captura de pantalla desde el portapapeles, presione “Ctrl + V”; se abrirá una pantalla modal con la vista previa de la captura de pantalla y un campo para darle un nombre. No es necesario estar sobre ningún elemento, el evento de pegado funciona en cualquier lugar de la página de modelado, siempre y cuando haya una imagen en el portapapeles.

    IMPORTANTE:
    Esta función no es compatible con Internet Explorer debido a las limitaciones de IE, por lo que debe realizarse con Chrome.

Mover diagramas

Esta opción de la herramienta TAST le permite al usuario mover un diagrama a otra carpeta de cualquier dominio y proyecto al que tenga acceso. Para poder usarlo, lo primero es ir a “Modelado” y hacer click en Diagramas UML. Se muestra la tabla, donde debe hacer click en el icono de flecha ubicado en la columna Acciones (cuarto elemento). Aparece una ventana emergente en la que selecciona el dominio, el proyecto y la carpeta donde desea mover el diagrama. Haga click en “sí”. El diagrama se ha movido a esa carpeta.



Variables globales

En un diagrama, es posible utilizar un conjunto de variables globales en todas las partes donde se permite la ayuda de variables (mapeo de objetos, mapeo de mensajes,….).

El menú desplegable de variables (incluidas las globales) aparecerá al escribir el carácter '#':


En TAST, actualmente existen estas variables globales:

  • #caseResult: variable booleana que contiene el resultado de la ejecución del caso de prueba:
    • correcto: cuando el resultado de la ejecución de todos los pasos del caso de prueba ha sido correcto.
    • incorrecto: de lo contrario; es decir, al menos la ejecución de un paso del caso de prueba ha sido fallida.
  • #global_password: Contiene la password de acceso al cliente.
  • #global_user: Contiene el usuario de acceso al cliente.
  • #pathLog: contiene la ruta de la carpeta, que contiene las capturas de pantalla, el archivo de registro y otros archivos generados durante la ejecución.
  • #stepNumber: Contiene un número de cuatro caracteres (ej. '0001') y representa el número con el cual se registrará el siguiente paso marcado para documentar en ALM. Cuando un paso se registre en ALM, este número se incrementará para el siguiente.
  • #stepNumberTast: Contiene la vieja numeración para documentar pasos en ALM antes de que la variable 'stepNumber' estuviera disponible. Este formato es “Step X.Y…Z Loop I.J…K” siendo X…Z la posición del paso, donde Y…Z son posiciones dentro de Gates, e I…K son el número de iteración de bucle, donde J…K son el número de iteración de bucles anidados.
  • #stepResult: variable booleana que contiene el resultado de la ejecución del último paso en el caso de prueba:
    • correcto: cuando el resultado de la ejecución del último paso ha sido correcto.
    • incorrecto: de lo contrario; es decir, el resultado de la ejecución del último paso ha sido fallido.

También podemos acceder de una manera rápida al listado de variables globales a través de la barra de herramientas. Al hacer click en el icono ”?” nos aparecerá “Mostrar ayuda del Canvas”.



A continuación un modal con 3 pestañas y elegimos la Pestaña “Variables globales” que muestra las variables globales estándar disponibles en cualquier diagrama.



Funciones predefinidas - Generación de evidencias

A continuación, la lista de funciones predefinidas y la indicación de si generan evidencias o no:

Predefined Function AdaptorGenerates evidences
connectDatabase NO
connect_DBDatabase NO
dBExecuteStatementDatabase NO
dBGetQueryDataDatabase SI
disconnect_DBDatabase NO
getNumColumnsDatabase NO
getNumRowsDatabase NO
getTableValueDatabase NO
tableRecordCountDatabase NO
addSheetExcel File NO
deleteSheetExcel File NO
generateFileAsEvidenceExcel File SI
getCellValueExcel File NO
getColumnByRowSearchExcel File SI
getExcelSheetExcel File NO
getNumColumnsExcel File NO
getNumRowsExcel File NO
getNumValueSearchOnColumnExcel File NO
getRowByColumnSearchExcel File SI
getTableValueExcel File NO
getTableValueByColumnNameExcel File NO
getValuesByPositionExcel File NO
newFileExcel File NO
setCellValueOneParameterEcxel File NO
setColumnValuesExcel File NO
setHeaderExcel File NO
setRowValuesExcel File NO
setTableValueExcel File NO
setSheetExcel File NO
vTableLookUpExcel File SI
vTableLookupArrayExcel File SI
allOptionsAreSelectedGUI HTML SI
clearGUI HTML SI
clearAndTypeGUI HTML SI
clickGUI HTML SI
clickByJavaScriptGUI HTML SI
clickLinkGUI HTML SI
clickPrintGUI HTML NO
closeAllWindowsGUI HTML SI
closeOthersWindowsGUI HTML NO
closeWindowGUI HTML NO
countElementsGUI HTML NO
checkboxGUI HTML SI
checkRadioGUI HTML NO
doubleClickGUI HTML SI
deleteAllCookiesGUI HTML NO
deselectAllOptionsGUI HTML SI
fileDownloadGUI HTML SI
fileDownloadDialogGUI HTML SI
fileUploadGUI HTML NO
getAttributeGUI HTML SI
isCurrentUrlContainsGUI HTML SI
isCurrentUrlEqualsGUI HTML SI
isCurrentUrlMatchesGUI HTML SI
isDisplayedGUI HTML SI
isExistGUI HTML SI
isSelectedGUI HTML SI
isTitleEqualsGUI HTML SI
isTitleMatchesGUI HTML SI
hasOptionWithValueGUI HTML SI
javascriptAlertAcceptGUI HTML NO
javascriptAlertCancelGUI HTML NO
javascriptExecuteGUI HTML NO
loginGUI HTML SI
openUrlGUI HTML SI
optionWithValueIsEnabledGUI HTML SI
optionWithValueIsSelectedGUI HTML SI
pressEnterGUI HTML SI
selectGUI HTML SI
selectAllOptionsGUI HTML SI
selectOptionGUI HTML NO
submitGUI HTML SI
tableCellValueGUI HTML NO
tableCellXPathByPositionGUI HTML NO
tableColumnsNumGUI HTML NO
tableHLookUpXPathGUI HTML NO
tableHtmlGUI HTML SI
tableRowsNumGUI HTML NO
tableVLookUpValueGUI HTML NO
tableVLookUpXPathGUI HTML NO
takeScreenshotGUI HTML SI
typeGUI HTML SI
typeActionGUI HTML NO
typeKeysGUI HTML NO
uncheckboxGUI HTML SI
validateAttributeGUI HTML SI
waitForGUI HTML NO
waitForElementGUI HTML NO
waitForPageLoadGUI HTML NO
newConnect_ScriptScript Generic NO
execute_ScriptScript Generic SI
disconnect_ScriptScript Generic NO
connect_ScriptScript Generic NO
closeFileText Files NO
containsTextText Files NO
countFileLineText Files NO
countTextFile Text Files NO
deleteFtpFileText Files NO
deleteSftpFileText Files NO
generateFileAsEvidenceText Files SI
getFileTextText Files NO
getFtpFileText Files NO
getLineLengthText Files NO
getNumColumnsText Files NO
getOwnerText Files NO
getReadLineText Files NO
getSizeText Files NO
getSftpFileText Files NO
getTableValueText Files NO
getTextFileDataText Files SI
lineContainsTextText Files NO
loadCsvDataText Files SI
newFileText Files NO
openFileText Files NO
openNewFileText Files NO
putFtpFileText Files NO
putSftpFileText Files NO
replaceTextText Files NO
writeEnterText Files NO
writeToText Files NO
assertionUser Object NO
compareParametersUser Object NO
compareVariablesUser Object NO
copyFileUser Object NO
dateAdditionUser Object NO
dateDifferenceUser Object NO
dateWeekDayUser Object NO
executeCommandUser Object NO
executeJavaScriptUser Object NO
failTestUser Object NO
getCurrentDateUser Object NO
getCurrentDateAsDateUser Object NO
getCurrentDateAsStringUser Object NO
isExistVariableUser Object NO
manualTastUser Object SI
removeVariableUser Object NO
replaceAllUser Object NO
saveRepositoryAsEvidenceUser Object SI
sendKeysUser Object NO
sendKeysCombinationUser Object NO
sendKeysPasteUser Object NO
setArrayVariableUser Object NO
setVariableUser Object NO
systemCloseProgramUser Object NO
takeScreenshotUser Object SI
waitFor:User Object SI
deleteRestAPI/WebService SI
getALLXMLElementValueByTagNameAPI/WebService SI
getCookieValueAPI/WebService NO
getHeaderValueAPI/WebService NO
getHTMLElementValueByXPathAPI/WebService NO
getJSONElementValueByJsonPathAPI/WebService NO
getJSONElementValueByTagNameAPI/WebService NO
getRestAPI/WebService SI
getResponseStatusAPI/WebService NO
getResponseTimeAPI/WebService NO
getXMLElementValueByXPathAPI/WebService NO
getXMLElementValueByTagNameAPI/WebService NO
patchRestAPI/WebService SI
postRestAPI/WebService SI
putRestAPI/WebService SI
responseBodyContainsTextAPI/WebService NO
setNoneAuthenticationAPI/WebService NO
setBasicAuthenticationAPI/WebService NO
setBearerTokenAuthenticationAPI/WebService NO
setDigestAuthenticationAPI/WebService NO
clearAndWriteFieldHost 3270 SI
clearFieldHost 3270 SI
containsTextHost 3270 SI
getLenghFieldHost 3270 NO
nextScreenHost 3270 SI
previousScreenHost 3270 SI
readFieldHost 3270 SI
readRowHost 3270 SI
readScreenHost 3270 SI
readScreenByRowsHost 3270 SI
rowContainsTextHost 3270 SI
waitCRCHost 3270 NO
waitForHost 3270 NO
waitForChangeHost 3270 SI
waitForTextHost 3270 SI
writeAfterLabelHost 3270 SI
writeBeforeLabelHost 3270 SI
writeFieldHost 3270 SI
writeKeyHost 3270 SI
writeKeyUntilFindHost 3270 SI
writeTextHost 3270 SI
checkTextInSlidePDF NO
checkTextOnDocumentPDF NO
checkTextOnPagePDF NO
checkTextOnPageAreaPDF NO
generateFileAsEvidencePDF SI
getGetTextByPageAreaPDF SI
getNumPagesPDF NO
getNumWhitePagesPDF NO
getPageAsImagePDF SI
getPageTextPDF SI
getTextCountOnDocumentPDF NO
getTextCountOnPagePDF NO
isPageWhitePDF NO
generateFileAsEvidenceXML SI
getElementAttrTextByXPathXML NO
getElementsCountByTagNameXML NO
getElementsCountByXPathXML NO
getElementsTextByTagNameXML SI
getElementsTextByXPathXML SI
getElementTextByTagNameXML NO
getElementTextByXPathXML NO
replaceElementAttrTextByXPathXML NO
replaceElementTextByTagNameXML NO
replaceElementTextByXPathXML NO
saveAsXML NO
saveXmlXML NO
xmlToStringXML NO
executeAllServiceOperationsSOAP UI SI
executeAllTestSuiteSOAP UI SI
executeServiceOperationSOAP UI SI
executeTestCaseSOAP UI SI
executeTestStepSOAP UI SI
executeTestSuiteSOAP UI SI
executePostmanCollectionPostman Collection SI
getResponseBodyPostman Collection SI
getResponseStatusCodePostman Collection SI


Atajos

Para acelerar la fase de modelado, TAST ofrece un conjunto de atajos:

Atajo Descripción
Esc Cierra los menús y selecciona el puntero.
Supr Borra elementos si hay uno o más seleccionados.
Alt + 9 Desbloquear diagrama para edición.
Alt + P Selecciona la herramienta puntero.
Alt + O Selecciona la herramienta “Objeto”.
Alt + M Selecciona la herramienta “Mensaje”.
Alt + R Selecciona la herramienta “Mensaje de respuesta”.
Alt + G Selecciona la herramienta “Gate”.
Alt + A Selecciona la herramienta “Fragmento Combinado: ALT”.
Alt + D Selecciona la herramienta “Fragmento Combinado: DO WHILE”.
Alt + W Selecciona la herramienta “Fragmento Combinado: WHILE”.
Alt + F Selecciona la herramienta “Fragmento Combinado: FOR”.
Alt + E Selecciona la herramienta “Fragmento Combinado: FOR EACH”.
Alt + S Selecciona la herramienta “Subtestcase”.
Ctrl + C Copiar elementos seleccionados.
Ctrl + V Pegar elementos copiados.
Ctrl + Shift + V Pegar los elementos copiados en la posición que indique el cursor.
Ctrl + Z Deshace algunas acciones como (Borrar elementos, Redistribuir diagrama, etc…
Ctrl + Shift + F Comentar/descomentar los elementos seleccionados (mensajes/gates).
Double click Editar elemento: haga doble click sobre un elemento del diagrama para editar sus propiedades.
Right button Menú contextual: pulsando el botón derecho del ratón sobre un elemento, se accede al menú contextual dinámico. Las opciones de este menú varian y pueden aparecer activas/no activas, dependiendo de los elementos actualmente seleccionados.
Mouse Wheel Zoom in/Zoom out: mueva la rueda del ratón hacia adelante o hacia atrás, para alejar o acercar el canvas respectivamente.
Shift + click Selección múltiple: mantenga pulsada la tecla “shift” y haga click en distintos elementos para seleccionarlos.
Shift + drag Desplazamiento múltiple: mantenga pulsada la tecla “shift” mientras desplaza los elementos seleccionados.
Click + drag Desplazar diagrama: haga click en una zona vacía del diagrama mientras arrastra en cualquier dirección para mover el diagrama.



Selección múltiple de mensajes

Selección de objetos en el Canvas

Seleccionando un objeto, podremos a continuación realizar otras acciones con él (p.ej. borrarlo, copiarlo, moverlo, etc.)

Selección simple

Para seleccionar un objeto del Canvas basta hacer click encima del objeto (en cualquiera de sus partes, incluido el texto).
Para deseleccionarlo, basta con hacer click en una zona “vacía” del Canvas.

Selección múltiple

Para seleccionar varios objetos en el Canvas, pulsaremos shift-click sobre los distintos objetos que queremos ir seleccionando.
Esto nos permite realizar acciones sobre ese grupo de objetos seleccionados (p.ej. borrarlos, moverlos, copiarlos, etc.) Para deseleccionarlos, basta con hacer click en una zona “vacía” del canvas.
En la selección múltiple no hay limitación en cuanto al tipo de objetos seleccionados, es decir, se pueden seleccionar a la vez todo tipo de objetos (mensajes, gates, fragments…)


Mapeo Selectivo

TAST cuenta con una importante ayuda a la hora de hacer el mapeo de los objetos y los mensajes en un diagrama: el Mapeo Selectivo.

La configuración, cómo utilizar la funcionalidad, y algunas consideraciones se explican en el siguiente documento:

tast_mapeo_selectivo_2024.doc

Gestión de TastTableData

En un diagrama UML, TAST permite el uso de variables de un tipo específico de tabla, llamado TastTableData.

Estas variables pueden ser utilizadas con prácticamente todos los adaptadores disponibles en TAST (HTML GUI, Archivos Excel, Base de datos,…). Se pueden utilizar en la casilla “Valor” de una función predefinida o en Javascript.

Una vez creadas las variables TastTableData (como variables de salida), podrán ser utilizadas como variables de entrada en los mensajes posteriores. La forma de utilizarlos en una “caja de valores” es:
#TasTableDataVariableName.functionName(params…). Desde javascript, se utilizará la sintaxis functionName(params…)

Las funciones actualmente disponibles son:

Output Function Description
StringgetDateWithFormatFromCellValue(int row, int column, String format)A partir de una celda (identificada por fila y columna) cuyo contenido es de tipo DATE (dd/MM/yyyy HH:mm:ss) obtiene dicho valor o contenido en el formato indicado. Dicho formato tiene que ir entre comillas.
intgetNumColumns()Devuelve un número entero con el número de columnas.
int getNumRows() Devuelve un número entero con el número de filas.
String getStringValue() Devuelve una cadena que contiene el contenido de la tabla separando las celdas con | y las filas con ||.
TastRowTableData getTheRow(int index)Devuelve una línea.
N/AaddRowData(TastRowTableData rowData)Agrega una fila al final de la tabla.
TastRowTableData getTheColumn(int index)Devuelve una columna (como una línea).
TastDataGeneric getCellValue(int row,int column) Devuelve el valor de una celda específica.
TastDataGeneric getTableValueByColumnName(int rowNum, String columnName) Devuelve el valor de una celda identificada por el número de línea y el nombre de columna.
N/AsetTableValue(int row, int column, String value)Permite añadir un valor a una celda específica. El valor puede ser una cadena, un valor Float o Booleano, ya sea contenido o en una variable o en un código duro:

TastTableData es una lista multidimensional, o una lista de listas. Al colocar una lista dentro de otras, podemos guardar información en filas y columnas. Vamos a mostrar un ejemplo:

Con la función SetVariable vamos a definir una variable de tipo TastTableData.




Aparecen las distintas filas, que contiene cinco columnas, cada una de un tipo. Se pueden añadir más filas.



Para obtener toda la información que hay en la primera página del fichero Excel, podemos utilizar la función getExcelSheet y se guarda en esta variable TastOutputTable.





Después para poder trabajar con TastOutputTable podemos utilizar las funciones o métodos arriba expuestos.

Gestión de TastRowTableData

TAST permite el uso de variables de un tipo específico de fila, llamado TastRowValues.

Estas variables pueden ser utilizadas con prácticamente todos los adaptadores disponibles en TAST (HTML GUI, Archivos Excel, Base de datos,…). Se pueden utilizar en la casilla “Valor” de una función predefinida o en Javascript.

Una vez que las variables TastRowValues han sido creadas (como variables de salida), pueden ser utilizadas como variables de entrada en mensajes posteriores.

La forma de utilizarlos en una “caja de valores” es: #TastRowDataVariableName.functionName(params…) Desde javascript, se utilizará la sintaxis functionName(params…)

Para poder trabajar con estas variables, se han creado unos métodos o Funciones Predefinidas. Las funciones actualmente disponibles son:

Output Function Description
N/AaddCellValue(String value)Permite añadir una celda al final de TastRowValues.
String getCellValue(int index)Devuelve el contenido de una celda específica.
StringgetDateWithFormatFromCellValue(int row, int column, String format)A partir de una celda (identificada por columna) cuyo contenido es de tipo DATE (dd/MM/yyyy HH:mm:ss) obtiene dicho valor o contenido en el formato indicado. Dicho formato tiene que ir entre comillas.
int getLength()Devuelve el número de celdas de los datos de TastRowValues.
StringgetStringValue() Devuelve el contenido de la fila que separa las celdas con |

TastRowTableData es una colección de datos en forma de lista que pueden repetirse. El número de elementos no está fijado ni limitado por anticipado. Para acceder a los elementos se utiliza un índice que indica la posición del elemento en la colección. Este tipo de datos es necesario en varios Adaptadores.

Ponemos un ejemplo con dos Adaptadores: Adaptador de Usuario y Adaptador Excel. En el Adaptador de Usuario vamos a crear una variable de este tipo. Se utiliza el Método o la Función Predefinida SetVariable, para ello solo hay que elegir el tipo de dato: TastRowValue y rellenar.







En este otro ejemplo (mensaje) se recoge de un fichero Excel a través del Adaptador Excel, la columna cuya fila cumple una condición. El resultado se guarda en este tipo de dato, en la variable OUTPUT.



En este otro ejemplo (mensaje) vemos que vamos a utilizar la variable OUTPUT y vamos a obtener la celda de índice uno, con estos métodos o Funciones Predefinidas, la primera celda es el uno, no es el cero.



Para más información sobre la Gestión de Variables, ver el apartado Variable_Management.

TAST Canvas 2.0

TAST tiene una característica importante: el Canvas, que es un lugar donde el usuario puede pintar los diagramas UML.

En realidad, el flujo de trabajo del uso de TAST comienza desde su Canvas.

Actualmente Canvas/Modeling 2.0 no funciona en Internet Explorer, debido a que IE es un producto descontinuado. El resto de navegadores Chrome, Edge y Firefox si son compatibles.

Puedes lanzar el Canvas desde varios lugares:

  • Creación de un nuevo diagrama UML.
  • Edición de un diagrama existente.
  • Navegación desde varios lugares de TAST para consultar un diagrama.



Hemos creado una página donde se explica con detalle, su uso, las mejoras realizadas y todas las funcionalidades que tiene. TAST Canvas 2.0

Gestión de datos

Mediante esta opción se podrán gestionar los conjuntos de datos con los que se lanzarán las pruebas correspondientes a un diagrama específico.

La opción de Gestión de datos consta de tres pestañas:

  • Datos de los conjuntos de pruebas.
  • Datos del equipo de prueba.
  • Información de datos de los conjuntos de pruebas.

Ventana Datos de los Conjuntos de Prueba



Muestra la lista de los diagramas de un dominio y proyecto concreto, con información sobre sus conjuntos de datos de casos de prueba y conjuntos de casos de prueba. A nivel general, se podrá filtrar por:

  • Dominio.
  • Proyecto.
  • Diagrama.
  • Usuario.

También se permitirá modificar y eliminar una carpeta.

En la ventana principal de GESTIÓN DE DATOS se visualizará la lista de diagramas para los filtros empleados, con la siguiente información:

  • Fecha de creación.
  • Número de conjuntos de datos de casos de prueba.
  • Número de conjuntos de casos de prueba.
  • Acción: con los siguientes indicadores:
    • Subido a ALM.
    • Usuario propietario.
    • Más información: al hacer click en esta opción, se abre la ventana de Test Set Data Info.

Ventana Datos del Equipo de Pruebas



En esta ventana se crearán los datos de los casos de prueba de un diagrama. A ella se accede haciendo click sobre cualquier diagrama de la ventana Test Sets Data.

Existirá un conjunto de datos de validación y 1 a n conjuntos de datos de valores. Se podrá indicar :

  • La descripción del Test case data.
  • El tipo de prueba (positivo ó negativo).
  • Los valores para los parámetros de los objetos.
  • Los valores para los parámetros de los mensajes.

También se podrá visualizar el diagrama.

Existirá la opción de copiar los datos de los casos de pruebas, que posteriormente podrán ser modificados.

Ventana Información de Datos de los Conjuntos de Pruebas

Hay dos formas de acceder a esta Ventana de Información:

  • Seleccionando directamente dicha pestaña.



    o bien

  • Seleccionando el icono Más información de un diagrama.


Esta nueva Ventana de Información, nos proporcionará la información relativa a:

  • Usuario propietario.
  • Ruta donde se encuentra el diagrama.
  • Fecha de creación.
  • Nombre del diagrama.
  • Número de conjuntos de datos de casos de prueba.
  • Número de conjuntos de casos de prueba y su ruta.

Funcionalidad Borrar

En la Ventana de Test Set Data, tenemos otra funcionalidad para borrar Test Case Data (TCD) de forma masiva, creados para ese Test Set (TS).

Un nuevo icono con una papelera dentro ha sido colocado en la barra superior derecha.


Cuando este botón es presionado, aparece una ventana modal con una lista de todos los TCD.


Características de esta ventana modal:

  • Cada TCD tiene un checkbox.
  • Estos checkbox pueden ser seleccionados haciendo click en ellos. Permanecerán seleccionados a no ser que vuelvan a ser clickados.
  • También, puedes seleccionar multiples TCD si aprietas shift mientras eliges dos TCD separados. También se pueden elegir varios segmentos volviendo a hacer click en otro alejado de los demás segmentos.
  • Tenemos un checkbox de “select all” que, como el nombre dice, selecciona y deselecciona todos los TCD.
  • Para cerrar la ventana modal sin realizar cambios, puedes tanto cerrarla con la cruz de arriba a la derecha o pulsando el botón de “No”.
  • Finalmente, para borrar todos los TCD seleccionados, se pulsa el botón “Borrar”. La ventana modal se cerrará una vez los cambios estén realizados. Si quieres guardar los cambios definitivamente se tendrá que guardar el TS.

Importar TCD desde un fichero Excel

En esta página se puede importar datos de un archivo de Excel. Basta con hacer click en el icono Importar para mostrar la página “Importar archivo TC”.



Entonces,

  1. Debe proporcionar un archivo de Excel con el orden correcto de los datos.
  2. Para fijar en la página, la correspondencia entre la columna del fichero Excel (A, B, etc.) y el campo relacionado Descripción, Tipo de prueba, etc.

Después de seleccionar el archivo y establecer la correspondencia, haga click en el botón Importar para realizar el proceso de importación.


Cómo buscar un diagrama UML en Modelado

Esta opción de TAST permite al usuario realizar una búsqueda de un diagrama entre todos los dominios de la aplicación. TAST también permite filtrar el Conjunto de Pruebas en la Gestión de TS en todos los dominios.

Para utilizar la búsqueda de un diagrama UML, haga click en el botón de filtro de todos los dominios y proyectos.


Nos aparecerá la siguiente pantalla


Podemos elegir entre los dos tipos de búsqueda:

  • por ID de diagrama.
  • por nombre (parcial o total) del diagrama.

Búsqueda por ID de diagrama

En el campo búsqueda (search) escriba el ID del diagrama de la búsqueda que desea realizar y haga click en el botón de la lupa. La aplicación muestra el diagrama con el ID especificado en la búsqueda.


Si hace click en el icono del archivo, el diagrama se abrirá directamente:


Búsqueda por el nombre del diagrama

En el campo search escriba los caracteres de la búsqueda que desea realizar y haga click en el botón de la lupa. La aplicación muestra todos los diagramas de todos los dominios que contienen los caracteres introducidos en la búsqueda.



Si hace click en el icono de la lista, la aplicación cambiará al Diagrama, Dominio y Proyecto seleccionado:



Como buscar un diagrama UML en Gestión de Datos

Esta opción de TAST permite al usuario realizar una búsqueda de un diagrama (y sus Datos de Caso de Prueba) entre todos los dominios de la aplicación. TAST también permite filtrar el Conjunto de Pruebas en la Gestión de TS en todos los dominios.

Hay dos tipos de búsquedas:

  • por ID de diagrama.
  • por nombre (parcial o total) del diagrama.

Para utilizar la búsqueda de un diagrama UML, en la Gestión de Datos, siga estos pasos:

En Modelado, seleccione la Opción de Gestión de Datos.


Haga click en el botón de filtro de todos los dominios y proyectos.



Buscar por el ID del diagrama

En el campo search escriba el ID del diagrama de la búsqueda que desea realizar y haga click en el botón de la lupa. La aplicación muestra los Datos del Conjunto de Pruebas correspondientes al diagrama con el ID especificado en la búsqueda.



Si hace click en el icono del archivo, los Datos del Conjunto de Pruebas se abrirán directamente:



Buscar por el nombre del diagrama

En el campo search escriba los caracteres de la búsqueda que desea realizar y haga click en el botón de la lupa.


La aplicación muestra todos los diagramas de todos los dominios que contienen los caracteres introducidos en la búsqueda.



Si hace click en el icono de la lista, la aplicación cambiará a los Datos del Caso de Prueba, Dominio y Proyecto seleccionados:



Haciendo click en el diagrama, puede ver los Datos del Caso de Prueba del diagrama seleccionado.



Gestión de Repositorios

Este apartado, es donde se van a gestionar todos los repositorios usados en los diagramas. Los repositorios son archivos YML o TXT (deben tener formato YML/YAML) que creamos y subimos a esta página de repositorios y que contienen una serie de claves que podremos usar en los diagramas.

Glosario

Para evitar confusiones con la funcionalidad de la creación de repositorios debemos tener claro qué significa cada parte de los repositorios; para esto vamos a poner un ejemplo detallado.

Conceptos (a la hora de crear un repositorio):

  • Archivo: Es un fichero de texto o YML/YAML en el cual se introducen el código para usar el repositorio. Cabe mencionar que si no tenemos un entorno (como Notepad++ u otros) con transformación de tabulador en espacios, el archivo no funcionará si se usa el tabulador para hacer saltos de espacios en la línea, se tendrán que hacer pulsando múltiples veces el espacio porque la sangría con tabulador no funciona en YML.
  • Claves: Son cada una de las palabras que van antes de los “ : ”
  • Propiedad: Es la ruta completa formada con las claves hasta los “ : ” usando “ _ ” para separarlas.
  • Valor: Es lo que aparece después del “ : ”

Ejemplo:

También, se pueden hacer subclaves:

Por lo que al final la variable estará compuesta de las propiedades separadas por “_”, en el caso del ejemplo: #wiki_url1.

La primera clave siempre sera una de las siguientes:

Características

En la gestión de repositorios tenemos diferentes “características” con las que podemos contar:

  • Importar repositorios que sean TXT e YML. Los repositorios están definidos por claves. Estos repositorios deben tener una clave en el primer nivel la cual será una de las opciones del “searchBy” listadas en los mensajes de un diagrama. Luego tendrá una segunda clave que será un nombre identificativo y por último se colocará el valor, que es la ruta según el tipo de searchBy que estemos usando, (estas claves no son “case sensitive”, sin embargo, a la hora de ponerlo en el campo element del mensaje tiene que estar exactamente igual al repositorio).

    Un ejemplo de esto sería:

  • Exportar repositorios como archivos YML que tenemos guardados ya en este apartado.
  • Abrir, editar, borrar y guardar repositorios.
  • Crear, editar y borrar las carpetas donde se contendrán dichos repositorios. Una carpeta que contenga repositorios no podrá ser borrada si no se eliminan de ahí antes (y con la excepción de la carpeta por defecto).
  • Clonar un repositorio ya importado en otro nuevo.
  • Ver información sobre los repositorios tales como fecha de creación y diagramas que lo utilizan, similar a la pestaña de “más información” de modelado.
  • Ver donde se está usando un repositorio que está siendo usado.

Importar repositorios

En la página de gestión de repositorios, tenemos que pulsar el botón de importar arriba a la derecha.



Después se abrirá una ventana modal.


En esta ventana modal elegiremos el nombre del repositorio, en que dominio y proyecto lo queremos y en que carpeta guardarlo.


Completados todos los datos requeridos, le daremos a importar.

Si el archivo TXT /YML está correcto, se importará perfectamente, cómo vemos en la imagen siguiente.



Si no se ha podido importar, aparecerá el siguiente mensaje:



Esto puede pasar por diferentes motivos:

  • el formato del TXT no sea YML/YAML
  • hay algún error en el archivo o
  • la sintaxis del yml en el repositorio es incorrecta, como insertar espacios con tabulador en lugar de barra espaciadora o utilizar una clave como subclave de otra, cuando el valor ya está definido. Para evitar esto último se tendría que usar un editor como (Notepad++) con la opción de convertir la tabulación en espacios.

Cambios en Modelado

En el apartado de Modelado se pueden apreciar distintos cambios con respecto a los repositorios.

  • La pestaña de propiedades del diagrama ha sido actualizada para mostrar desde ahora, información en la parte derecha sobre repositorios.
  • Desde esta parte el usuario puede añadir repositorios, pulsando el botón de editar.



  • Después de pulsado el botón de editar, se desplegará una ventana modal, como se muestra en la siguiente imagen. A través de Dominio, Proyecto y carpeta, buscaremos los repositorios disponibles.



  • Podemos añadir o eliminar los repositorios que deseemos. Y una vez aceptado, se guarda y se actualiza el diagrama con los repositorios de la sección “Repositorios seleccionados”, lo cual elimina del diagrama los que estaban y se quitaron, y añade los que no estaban y se agregaron. Pese a que los repositorios estén inmediatamente disponibles tras seleccionarlos, la relación Repositorio-Diagrama no se confirma hasta que el Diagrama se guarde.



  • Para eliminar un repositorio desde las propiedades del diagrama, primero se selecciona el repositorio elegido y después se pulsa el botón del cubo de la basura. Este se eliminará junto con todas las conexiones a mensajes que tenga.



  • Para ir directamente a un repositorio, solo hay que pulsar en su nombre y se abrirá una pestaña nueva en Gestión de Repositorios con acceso directo al mismo.





  • En el apartado de mensajes también hay actualizaciones. Como se puede observar en la imagen se ha añadido un campo desplegable “Repositorio” desde el cual, se podrá elegir el repositorio que se desea usar en ese parámetro. Una vez elegido el repositorio, el siguiente paso es elegir en el campo SearchBy “Repository”. Y en el campo “Element” se pueden utilizar las claves del repositorio como variables tras escribir almohadilla “#”, y tener Repositorio y searchBy seleccionados.





  • Una vez pones la almohadilla es posible autocompletar con las claves del repositorio, como se muestra en la imagen siguiente. Para usar estas claves, las variables se generan concatenando los niveles de las claves con “_” (barra baja), hasta llegar al valor por lo que las claves deberán ser usadas como variables separadas por “_” como se muestra en el apartado de glosario.



  • Como nota importante, no usar en los nombres de las propiedades del repositorio nombres compuestos por “_” ya que a la hora de concatenar estos, podría ocasionar algún error.
es/modeling_2.0.txt · Last modified: 2024/03/20 08:46 by montse