Ir al contenido
↑↓ moverse↵ abriresc cerrar

Empieza aquí

La barra lateral

Lee el árbol de la barra lateral, busca en él, abre un workflow o uno de sus pasos, y administra contratos y ambientes desde sus secciones.

5 min de lectura

La barra lateral es el mapa de la colección abierta: sus archivos Arazzo, workflows, pasos, requests, contratos y ambientes. Úsala para abrir cosas, para ver cómo salió la última ejecución y para encontrar lo que sea por su nombre.

Dentro de una colección, de arriba hacia abajo:

Fila Qué es Un clic hace
El archivo Arazzo El archivo que contiene workflows. Con varios archivos, muestra el título del archivo y, debajo, el nombre del archivo. Abre la vista del archivo y despliega el archivo.
Un workflow Un workflow del archivo, con un punto de color. Abre el workflow.
Un paso Una llamada del workflow, con su método (GET, POST…). Abre una pestaña con ese paso.
Requests Los requests guardados de la colección y sus carpetas. Abre el request. Consulta Requests.
Contratos Los archivos OpenAPI y AsyncAPI. Abre el contrato. Consulta Contratos.
Ambientes Los ambientes de la colección. Lo deja activo y lo abre. Consulta Ambientes.

La flecha antes del nombre de un workflow tiene el tooltip Mostrar u ocultar los pasos. Haz clic en ella para plegar o desplegar los pasos sin abrir el workflow.

El punto muestra cómo salió la última ejecución de ese workflow. Apúntalo para leer el estado.

Punto Tooltip Significado
Anillo vacío Sin ejecutar Todavía no se ejecutó ningún caso.
Azul, parpadeando Ejecutando Un caso se está ejecutando.
Verde Pasaron Los casos que se ejecutaron pasaron.
Amarillo Advertencias o No concluyentes Al menos un caso terminó con una advertencia, o no se pudo juzgar.
Rojo No pasaron Al menos un caso falló.
Rojo, antes de ejecutar 1 error(es) El workflow tiene un error que corregir antes de poder ejecutarse. El número dice cuántos.

Un paso en rojo tiene un error. Un ! junto al nombre de un archivo significa que el archivo tiene errores. Abre la pestaña Resumen del workflow para verlos.

Esta búsqueda filtra el árbol. Para buscar en todo a la vez y saltar a un resultado, usa mejor ⌘K.

  1. Arriba de la barra lateral, junto a Colecciones, haz clic en la lupa (Buscar en las colecciones).
  2. Escribe en el cuadro Workflow, paso o colección…. El árbol se filtra mientras escribes.
  3. Haz clic en un resultado para abrirlo.
  4. Pulsa Esc, o haz clic de nuevo en la lupa, para cerrar la búsqueda y ver todo.

Qué compara la búsqueda:

Mira Y muestra
El nombre, el id y la descripción de un workflow El workflow, con todos sus pasos.
El nombre de un paso o la ruta de su operación El workflow, solo con los pasos que coinciden.
El nombre y la URL de un request, y el nombre de una carpeta El request, dentro de su carpeta.
El nombre de una colección La colección. La abierta siempre se queda.

Mientras buscas, todo lo que coincide aparece desplegado. Las secciones Contratos y Ambientes no se filtran.

Ejemplo. En la colección Pokédex, escribe species. El árbol deja Pokemon card, con el paso getSpecies, y Type explorer, con getFirstSpecies. Los dos coinciden por el nombre, y también por la ruta /pokemon-species/{idOrName}.

Haz clic en un paso de la barra lateral y se abre una pestaña junto a las pestañas del workflow, con el nombre del paso. Muestra, de arriba hacia abajo:

  • El método y la URL completa, armada con la URL base del ambiente activo.
  • La descripción del paso, si la tiene.
  • Parámetros, con Nombre, En y Valor; el body; Criterios de éxito; onSuccess y onFailure; y Outputs.
  • Probar sola, que llama a esa operación fuera del workflow. Consulta Probar una operación.
  • Editar en YAML, que abre la pestaña YAML del workflow.

Cuando el paso no tiene successCriteria, la pestaña dice: Sin successCriteria: se considera exitosa cualquier respuesta 2xx. Esta pestaña es para leer. Para cambiar el paso, usa la pestaña Diseño.

Cada fila de contrato empieza con una marca:

Marca Significado
✓ El contrato está cargado.
✕ No cargó. Apúntalo para leer el motivo. La fila ofrece Adjuntar, para elegir el archivo, y Descargar cuando el contrato tiene una URL.
○ El archivo está en la colección, pero ningún Arazzo lo usa todavía. Su tooltip dice Ningún Arazzo de la colección usa este archivo todavía.

El número junto a Contratos es cuántos están cargados, o 1/2 cuando falta uno. Un + en un contrato OpenAPI ejecuta Generar requests. Consulta Generar requests desde un contrato.

El + del encabezado de Contratos (Agregar contrato) ofrece Nuevo contrato OpenAPI, Nuevo contrato AsyncAPI e Importar contrato…. El ⋯ de una fila ofrece Eliminar contrato… (o Quitar contrato… cuando no hay archivo). Luvin pregunta antes. Consulta Contratos.

  • El punto lleno marca el ambiente activo. Un punto de color muestra su color.
  • Haz clic en una fila para usar ese ambiente y abrirlo. Su tooltip dice Usar y abrir este ambiente.
  • En el activo, Configurar lo abre de nuevo.
  • El + del encabezado (Nuevo ambiente) crea uno.
  • El ⋯ de una fila ofrece Eliminar ambiente….

Cuando abriste archivos sin un workspace, el árbol muestra una colección con un encabezado: Agregar archivos y Cerrar la colección. Cerrar pregunta antes: ¿Cerrar la colección? Se descartan la sesión y los resultados. Consulta Usar Luvin sin workspace.