Fragmentos Cómo facilitar el proceso de trabajar con documentación


Hola Habr! Me llamo Pavel Lesyuk. Soy un probador de aplicaciones móviles nativas. En mi artículo anterior , di una lista de herramientas que los probadores y algunos otros expertos pueden usar para aumentar la productividad de su trabajo.

En una nueva serie de artículos, me gustaría echar un vistazo más de cerca a algunas herramientas e ilustrar su uso con ejemplos. El primer artículo estará dedicado a la solución más efectiva y simple: fragmentos.

Fragmentos : son fragmentos del texto (código), que se almacena para su posterior reutilización. Los fragmentos vienen en tres formas: estática (texto plano), dinámica (usando variables) y scripting (usando código).

En este artículo, veremos ejemplos de creación de fragmentos estáticos y dinámicos al trabajar con aplicaciones móviles y de escritorio. Recuerde que los fragmentos son una herramienta universal que puede ser utilizada por cualquier especialista que trabaje con información textual.

Herramientas de escritorio


Consideraremos todo el proceso utilizando el programa TextExpander para macOS como ejemplo . Hay versiones para Windows, Chrome, iOS. Esta es la herramienta más funcional. Costo: $ 4.16 por mes o $ 3.33 por mes para una suscripción anual. Como alternativa, recomendaría probar PhraseExpress . Hay versiones para macOS, Windows, iOS, Android.

MacOS tiene auto-reemplazo incorporado. Puede encontrarlo en la ruta: “Configuración” → “Teclado” → “Texto”.


Solo admite texto sin formato, por lo que solo se puede usar para plantillas simples.

Completar informes de defectos


Digamos que queremos automatizar el proceso de creación de informes de defectos. Primero, cree la plantilla más completa para completar la descripción en el sistema de seguimiento de errores de Jira. Tendremos en cuenta el hecho de que en el futuro querremos crear todas las combinaciones de los campos más utilizados para completar la descripción de los informes. Empecemos.

Crear un grupo de fragmentos


Primero, cree un grupo de fragmentos y asígnele un nombre.

Asignación de un nombre y abreviatura


Ahora necesita crear un nuevo fragmento, asígnele un nombre y abreviatura. Nombre: identificador con el que puede determinar rápidamente qué contiene el fragmento y encontrarlo si es necesario. Abreviatura: una secuencia de caracteres, al ingresar en la que se insertará el contenido del fragmento.

Aquí hay algunas propiedades de buenos acrónimos:

  1. . , ( ). «report», . , , . , . , «,report» . — .
  2. . . , . , «,bg», «,bg2», «2» .
  3. . , . , «Bug report» «,report» «,bg».
  4. . .

En la mayoría de los casos, prefiero usar nombres y abreviaturas en inglés. Llamaremos al primer fragmento "Entorno, condiciones previas, pasos, resultados reales y esperados" (recuerde, queremos crear algunas combinaciones más de estos parámetros, por lo que creo que este nombre es el más adecuado). La abreviatura es ", epsae", que corresponde a las primeras letras de las palabras en el nombre. También puede configurar mayúsculas y minúsculas.

Relleno de fragmento


Rellene el fragmento con contenido para describir el informe.

Hemos creado un fragmento estático. Los caracteres "*" y "#" son la sintaxis de formato en Jira (lista en negrita y numerada, respectivamente). Veamos cómo funciona el inserto.


Mucho mejor que ingresar todo esto manualmente o buscar la plantilla deseada en las notas, ¿no? En la configuración, puede configurar las opciones de inserción de fragmentos. La inserción puede ocurrir inmediatamente después de la entrada o después de presionar la tecla de límite.

Del mismo modo, podemos crear plantillas para todas las combinaciones de campos utilizadas en la descripción del informe de defectos. Puede crear exactamente el conjunto de plantillas que usaremos con mayor frecuencia.

Por ejemplo, tengo este conjunto de la siguiente manera:

  • Condiciones previas, pasos, resultado real y esperado
  • Condiciones previas, resultado real y esperado
  • Pasos, resultado real y esperado
  • Resultado real y esperado

Usando elementos dinámicos


Veamos algunos ejemplos más.

Por ejemplo, necesito insertar rápidamente un enlace en el texto al preparar un informe. Al usar la herramienta incorporada en Jira, se ve así:


Parece que no está mal, podemos comenzar a escribir de inmediato. Pero, ¿qué sucede si, en lugar de example.com, quiero pegar el enlace ya copiado del portapapeles? Para hacer esto, necesitamos la capacidad de crear contenido dinámico dentro del fragmento.

Usando elementos dinámicos, pegamos el contenido copiado en el portapapeles y colocamos el cursor en la posición que necesitamos. Veamos cómo funciona el inserto.


Ahora mejoraremos nuestra primera plantilla. Supongamos que es un probador móvil, tiene una flota de dispositivos móviles, parte de los cuales se le asignan. Realiza pruebas en estos dispositivos con mayor frecuencia y le gustaría tener una lista de ellos a la mano al preparar un informe de defectos.

Primero, cree una lista de dispositivos. Hacemos esto usando los elementos opcionales para seleccionar.

A continuación, cree una lista de hosts en los que estamos probando. Agregue un nuevo fragmento a nuestro grupo y nuevamente use los elementos opcionales.

¡Multa! Ahora pasemos a nuestro fragmento principal y enriquezcámoslo con contenido. Agregamos la inserción de elementos opcionales de otros fragmentos y establecemos la posición del cursor para que pueda comenzar a ingresar texto de inmediato. Veamos cómo funciona nuestro fragmento avanzado.




Al insertar elementos dinámicos que esperan algunas acciones del usuario (relleno, selección, etc.), se abrirá una ventana separada en la que se deberán realizar las acciones correspondientes en estos elementos.

Crear plantillas de notas


Otro ejemplo: crear plantillas para la estructura de notas de trabajo. Mantengo notas con soporte de rebajas para compilaciones de aplicaciones móviles con una estructura específica y uso fragmentos para generarlas rápidamente. A continuación se muestra un ejemplo de inserción de una plantilla terminada en las notas.




Rellenar formularios de prueba


Al trabajar con aplicaciones web / de escritorio, puede usar fragmentos para completar formularios con datos.

Al simular presionando el botón Tabulador, la transición entre campos se produce automáticamente.


Informes


Considere crear un informe de prueba. Supongamos que una vez a la semana escribimos un informe sobre nuevos proyectos en aplicaciones móviles.

Utilizamos elementos dinámicos, texto formateado e imágenes.

Como resultado, obtenemos una estructura de informe preparada, que se puede completar rápidamente con los valores necesarios y enviar una carta.


Herramientas para SO móviles


Androide


En Android, puede usar Texpand o Gboard . Desafortunadamente, en ambas aplicaciones no hay posibilidad de sincronización entre dispositivos.

Gboard solo admite texto sin formato. De hecho, este es un portapapeles extendido en el que puede anclar algunos de los fragmentos.


En Texpand oportunidad más amplia. La versión gratuita tiene soporte para 10 fragmentos, fechas y horas dinámicas, pegar desde el portapapeles y establecer la posición del cursor. También puede hacer copias de seguridad e importar fragmentos a otros dispositivos.


iOS


IOS tiene un reemplazo automático incorporado, solo admite texto sin formato.

También hay versiones de TextExpander y PhraseExpress para iOS.

En TextExpander, todos los fragmentos se sincronizan entre las versiones de escritorio y móviles. Hay una serie de limitaciones en la versión móvil en comparación con la versión de escritorio:

  1. Los fragmentos se abren cuando se imprime solo cuando el teclado TextExpander está activo (el teclado viene con la aplicación, que se puede habilitar en la configuración de iOS).
  2. La interacción con elementos dinámicos (relleno, selección, etc.) funciona solo en la aplicación misma, en el segmento "Notas". A partir de ahí, el fragmento completo se puede copiar o enviar a través del menú para compartir.
  3. Los fragmentos de script no funcionan (no se consideraron en este artículo).


Puede agregar fragmentos a sus favoritos para acceder rápidamente desde el teclado.

A continuación se muestra un ejemplo de trabajo con un fragmento dinámico.


Conclusión


Examinamos el trabajo de fragmentos estáticos y dinámicos utilizando el ejemplo de creación de documentación de prueba. También se pueden usar para crear varios tipos de cartas (listas de correo repetidas, ofertas de trabajo, etc.), la estructura de documentos y notas, generación de código y mucho más .

Gracias por leer el artículo hasta el final. Espero que la información contenida en ella le sea útil, y puede ahorrar tiempo usándola en la práctica. Si tiene alguna pregunta sobre el artículo, con gusto le responderé. En el próximo artículo, planeo escribir sobre el uso de fragmentos de script. Mientras tanto, propongo suscribirme a mi canal de Telegram , donde publico toda otra información sobre el tema de las pruebas.

Source: https://habr.com/ru/post/undefined/


All Articles