# Pasos compartidos > Reutiliza una misma secuencia de pasos en muchos casos de prueba, edítala una sola vez y mantén las ejecuciones congeladas. Un **paso compartido** es un conjunto de pasos con título y orden —acción, datos, resultado esperado e imágenes, o palabra clave, texto y argumento en un conjunto Gherkin— que los casos de prueba usan en lugar de copiar los mismos pasos una y otra vez. Iniciar sesión, preparar un carrito, limpiar datos de prueba: lo escribes una vez, lo insertas en cada caso que lo necesite y lo editas en un solo lugar. Cada caso que lo usa muestra el cambio la próxima vez que se abre; las ejecuciones que ya empezaron conservan los pasos que tenían. | Pregunta | Respuesta | | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | | ¿Dónde viven los pasos compartidos? | En un proyecto (los usan los casos de ese proyecto) o en toda la organización (los usa cualquier proyecto). | | ¿Quién crea pasos compartidos de proyecto? | Miembros y roles superiores, en todos los planes. | | ¿Quién crea los de toda la organización? | Propietarios y administradores, en los planes Pro y Enterprise (y durante la prueba gratuita). | | ¿Qué muestra una ejecución? | Los pasos del paso compartido como pasos normales numerados. | | ¿Qué pasa si elimino uno? | Tú eliges: mantener sus pasos en cada caso como pasos normales, o quitarlos. | | ¿Qué casos pueden usarlo? | Solo los casos del mismo formato de pasos: Clásico o Gherkin. El formato se fija al crearlo. | ## Abrir la biblioteca Abre un proyecto y haz clic en **Pasos compartidos** en la barra lateral del proyecto, justo después de **Repositorio**. La biblioteca lista todos los pasos compartidos que el proyecto puede usar: los suyos y los de toda la organización. Cada elemento de la lista muestra el título y el ID del paso compartido, cuántos pasos contiene, cuántos casos de prueba lo usan (**Sin usar** si ninguno), cuándo cambió por última vez y un icono con su alcance: de proyecto o de toda la organización. Haz clic en un paso compartido para abrirlo. En una pantalla ancha se abre junto a la lista, así puedes pasar de uno a otro sin salir de la biblioteca; las flechas arriba y abajo del teclado hacen lo mismo. En una pantalla más pequeña se abre en su propia página. Usa el cuadro de búsqueda para filtrar por título. El menú de carpetas que está encima acota la lista: **Todos los pasos compartidos**, **Este proyecto**, **Organización** o cualquier carpeta dentro de ellas. La lista conserva tu carpeta y tu búsqueda mientras abres pasos compartidos. Cada paso compartido tiene además un identificador legible, `SS-1`, `SS-2`, … — una sola secuencia para toda la organización — que aparece en la dirección de su página. Un ID nunca se reutiliza: si eliminas `SS-7`, el siguiente paso compartido será `SS-8`, y hacer que un paso compartido de proyecto pase a toda la organización conserva su ID. ## Crear un paso compartido 1. Haz clic en **Nuevo**, junto al título de la biblioteca. 2. Escribe un **Título** (hasta 255 caracteres), por ejemplo `Iniciar sesión como administrador`. 3. Si eres propietario o administrador en un plan que incluye pasos compartidos de toda la organización, elige dónde queda **Disponible en**: **Este proyecto** u **Organización**. El resto de las personas crea pasos compartidos de proyecto. 4. Si quieres, elige una **Carpeta** de ese alcance y haz clic en **Crear paso compartido**. El diálogo también pide el **Formato de pasos**, **Clásico** o **Gherkin**. No cambia después de crear el paso compartido, y solo pueden usar el conjunto los casos de ese formato. Abre el nuevo paso compartido y agrega sus pasos en la pestaña **Pasos** con **Editar pasos**: cada paso tiene los campos de su formato, igual que un paso de un caso de prueba (una acción con datos y resultado esperado opcionales, o una palabra clave con texto y un argumento opcional), y puede llevar imágenes. Un paso compartido admite hasta 500 pasos y no puede contener otro paso compartido. ## Organizar con carpetas Las carpetas agrupan pasos compartidos relacionados y se pueden anidar. El proyecto y la organización tienen cada uno su propio árbol de carpetas: una carpeta solo contiene pasos compartidos y subcarpetas de su mismo alcance. - Abre el menú de carpetas para gestionarlas: **+** junto a **Este proyecto** u **Organización** crea una carpeta, y el menú **⋯** de cada carpeta tiene **Nuevo paso compartido** (se crea en esa carpeta), **Nueva subcarpeta**, **Renombrar** y **Eliminar**. Dos carpetas al mismo nivel no pueden llamarse igual. - Los pasos compartidos que no están en ninguna carpeta aparecen en **Pasos compartidos sin carpeta**, la primera entrada de su sección. La entrada solo se muestra mientras la sección tenga alguno, y su menú **⋯** crea un nuevo paso compartido fuera de cualquier carpeta. - **Eliminar** quita solo la carpeta: sus pasos compartidos y subcarpetas suben a la carpeta que la contenía y no se borra nada más. Si una subcarpeta quedara junto a otra con el mismo nombre, la eliminación se rechaza; renombra una de las dos primero. - Para cambiar el nombre de un paso compartido o moverlo a otra carpeta, abre el menú **⋯** en la parte superior de su página y elige **Editar paso compartido**. ## Usar un paso compartido en un caso de prueba En el editor del caso —la página completa del editor, o la sección **Pasos** del panel del caso después de **Editar**— haz clic en **Insertar paso compartido**: 1. La lista de pasos compartidos aparece junto a la vista previa. Escribe en la búsqueda para acotarla por título, y acótala a **Este proyecto** u **Organización** y a una de sus carpetas. Los pasos compartidos de toda la organización llevan el icono del edificio; pasa el puntero sobre él para leer el alcance. 2. Elige un paso compartido de la lista, con el ratón o con las flechas y Enter desde la búsqueda: la vista previa de al lado muestra sus pasos. 3. En **Insertar en**, deja **Al final**, elige **Al inicio** o el paso detrás del que debe ir, y haz clic en **Insertar**. 4. Guarda el caso. Los pasos del paso compartido aparecen entonces entre los pasos del caso, numerados como ellos: un paso compartido de 3 pasos insertado después del paso 01 ocupa los pasos 02, 03 y 04, y el siguiente paso del caso es el 05. En el caso son de solo lectura (en el editor, su texto aparece en cuadros atenuados en los que no se puede escribir). Solo el editor del caso los marca: cada uno muestra a la derecha la etiqueta **Paso compartido**, y al pasar el puntero sobre ella se ve el título del paso compartido. La vista del caso y las ejecuciones los muestran como pasos normales numerados. En el editor, abre el menú **⋯** de la fila de un paso compartido, donde los pasos normales tienen sus botones de imagen y de borrar: ofrece **Abrir paso compartido**, **Convertir en paso normal** y **Quitar**. Un caso puede combinar pasos normales y pasos compartidos, usar varios pasos compartidos y repetir el mismo más de una vez. Un caso sigue teniendo como máximo 500 filas, y un paso compartido cuenta como una sola fila para ese límite, tenga los pasos que tenga. Un caso puede usar un paso compartido de su propio proyecto o uno de toda la organización, nunca el de otro proyecto. El selector solo muestra los pasos compartidos del formato del caso, y la API rechaza con `422` uno del otro formato. En un plan sin pasos compartidos de toda la organización, el selector los sigue mostrando, pero no se pueden insertar; **Ver planes** muestra los planes que los incluyen. Hay tres acciones que cambian cómo un caso usa los pasos compartidos. **Convertir en paso normal** y **Quitar** están en el menú **⋯** de cada paso de un paso compartido: - **Quitar**: quita solo ese paso; al guardar, el caso deja de tenerlo y los demás pasos del paso compartido siguen compartidos y se siguen actualizando. El paso compartido en sí no cambia. - **Convertir en paso normal**: convierte todo el paso compartido, desde cualquiera de sus pasos; después de confirmar, todos sus pasos pasan a ser copias normales y editables de su texto e imágenes actuales, en el mismo lugar y solo en este caso. Las ediciones posteriores del paso compartido ya no llegan a este caso. - **Crear paso compartido con la selección**: marca las casillas de pasos normales seguidos, haz clic en **Crear paso compartido con la selección** y dale al nuevo paso compartido de proyecto un **Título** y, si quieres, una **Carpeta**. Los pasos pasan a ser los pasos del nuevo paso compartido en el mismo lugar, con su texto y las imágenes de ese texto. No se pueden convertir pasos con un hueco entre ellos. El nuevo conjunto toma el formato de pasos del caso. **Convertir en paso normal** y **Crear paso compartido con la selección** cambian el caso guardado en el momento, así que solo funcionan en un caso que ya existe y no tiene cambios sin guardar: guarda o descarta tus cambios antes. Un caso que se está creando no ofrece ninguna de las dos. Un marcador dentro de un paso compartido, como `${nombre}`, se lee desde el caso que usa el paso. Así, un mismo paso compartido puede servir a todas las combinaciones de un caso parametrizado. Consulta [Casos de prueba parametrizados](https://docs.probara.net/es/guides/parameterized-test-cases/). ## Editar un paso compartido y qué ven las ejecuciones Editar un paso compartido lo cambia **en todos los lugares donde se usa**. No hay una copia por caso que actualizar: cada caso lee los pasos actuales del paso compartido. Cada edición, incluida la eliminación de una imagen, guarda una nueva versión de cada caso cuyos pasos cambia, y a quien esté editando uno de esos casos en ese momento se le pide recargar antes de guardar. El título, los pasos y las imágenes de un paso compartido que usan más de 5.000 casos no se pueden cambiar; conviértelo en pasos normales o quítalo en algunos de ellos primero. Las ejecuciones funcionan distinto. Cuando un caso se agrega a una ejecución, sus pasos quedan [congelados en un snapshot](https://docs.probara.net/es/guides/test-runs/), y un paso compartido se congela con los pasos que tiene en ese momento. En el panel de ejecución aparecen como pasos normales, cada uno con su número y sin etiqueta; cada uno se marca como cualquier otro paso. Editar o eliminar el paso compartido después nunca cambia una ejecución que ya lo contiene. ## Pasos compartidos de toda la organización Un paso compartido de toda la organización lo pueden usar los casos de cualquier proyecto. Como una sola edición llega a todos ellos, solo **propietarios y administradores** pueden crearlos, editarlos, moverlos o eliminarlos, y lo mismo con sus carpetas. Los miembros sí pueden insertarlos en sus casos. Los pasos compartidos de toda la organización forman parte de los planes **Pro** y **Enterprise**, y de la prueba gratuita. En el plan Free, la sección **Organización** muestra la opción de mejorar el plan en lugar de sus acciones de creación. Para compartir un paso compartido de proyecto con toda la organización, un propietario o administrador lo abre y elige **Hacer de toda la organización** en el menú **⋯** de la parte superior de su página. Pasa a la carpeta raíz de la organización y conserva su ID, sus pasos y todos los casos que lo usan. **No se puede deshacer.** ### Si tu organización pasa al plan Free No se borra nada y nada deja de funcionar en los casos que ya los usan: - Los casos siguen mostrando sus pasos compartidos de toda la organización, y las nuevas ejecuciones los siguen congelando. - Guardar un caso que ya usa uno lo conserva, y **Convertir en paso normal** sigue funcionando. - Propietarios y administradores pueden seguir **eliminando** pasos compartidos de toda la organización y sus carpetas, para que puedas ordenar. Lo que se detiene hasta que vuelvas a un plan de pago: crear, editar o hacer de toda la organización un paso compartido; crear, renombrar o mover carpetas de la organización, y agregar un paso compartido de toda la organización a un caso que todavía no lo usa. ## Eliminar un paso compartido Abre el paso compartido, luego el menú **⋯** de la parte superior de su página, y elige **Eliminar**. El diálogo indica cuántos casos lo usan y te pregunta **qué pasa con los casos que lo usan**: - **Mantener los pasos en los casos** (la opción predeterminada): cada caso recibe su propia copia normal de los pasos, en el mismo lugar, con las imágenes de su texto. Las ediciones posteriores ya no les llegan. - **Quitar los pasos de los casos**: los pasos desaparecen de todos los casos que lo usan, y los pasos restantes cierran el hueco. Todos los casos cambian a la vez, o ninguno. La eliminación se rechaza, sin cambiar nada, cuando: - mantener los pasos haría que un caso superara los 500 pasos; el diálogo lista esos casos; - el paso compartido lo usan más de 5.000 casos (con cualquiera de las dos opciones); conviértelo en pasos normales o quítalo en algunos de ellos primero; Eliminar nunca cambia una ejecución. ## Uso e historial La página de un paso compartido tiene tres pestañas: - **Pasos**: sus pasos, editables por quien tenga permiso para editarlo. - **Usado en**: cada caso de prueba que lo usa, con su proyecto y su suite. Solo ves casos de proyectos que puedes abrir. - **Historial**: quién lo creó, editó, movió, eliminó o lo hizo de toda la organización, y los cambios paso a paso de cada edición. Cada caso que cambia porque se elimina un paso compartido, se convierte en pasos normales o se crea uno con la selección también registra el cambio en su propia actividad. ## Duplicar, exportar e importar - **Duplicar** un caso o una suite conserva sus pasos compartidos cuando la copia queda donde se pueden usar: en el mismo proyecto, o en cualquier proyecto si son de toda la organización. Un paso compartido de proyecto duplicado en otro proyecto se convierte en pasos normales, con sus imágenes; consulta [Duplicar casos y suites](https://docs.probara.net/es/guides/duplicating-cases-and-suites/). - **Exportar** escribe los pasos compartidos como pasos normales, en todos los formatos. - **Importar** nunca crea pasos compartidos. Un paso compartido que el archivo de origen trae con su contenido llega como pasos normales en su lugar; uno que el archivo solo referencia por su ID se omite y se informa como advertencia en ese caso; consulta [Importar casos de prueba](https://docs.probara.net/es/guides/import-test-cases/). Los parámetros compartidos son una biblioteca aparte, con su propio alcance. Los parámetros compartidos de toda la organización necesitan el mismo permiso y el mismo derecho del plan que los pasos compartidos de toda la organización. Consulta [Casos de prueba parametrizados](https://docs.probara.net/es/guides/parameterized-test-cases/). ## Permisos | Acción | Quién | | ------------------------------------------------------------------------------ | -------------------------------------------------- | | Ver pasos compartidos | Cualquiera que pueda abrir el proyecto | | Crear, editar, mover y eliminar pasos compartidos y carpetas de proyecto | Miembros y roles superiores | | Insertar, quitar, convertir en paso normal y crear con la selección en un caso | Miembros y roles superiores | | Crear, editar y mover pasos compartidos y carpetas de toda la organización | Propietarios y administradores, en un plan de pago | | Hacer de toda la organización un paso compartido | Propietarios y administradores, en un plan de pago | | Eliminar pasos compartidos y carpetas de toda la organización | Propietarios y administradores, en cualquier plan | ## API y MCP Todo lo que describe esta página está disponible para integraciones. La [referencia de la API](https://docs.probara.net/es/developers/api-reference/v1/) documenta las operaciones de **Shared steps**, y los agentes de IA usan las herramientas de pasos compartidos que lista la [referencia de herramientas MCP](https://docs.probara.net/es/developers/mcp-tools/#list_shared_steps).