> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Una app de Jira para seguir errores, incidencias y trabajo ágil a través de tu cuenta conectada.

# Jira

Usa esta app cuando necesites crear, actualizar, buscar o mover elementos de trabajo de Jira. También te ayuda a gestionar comentarios, archivos adjuntos, registros de trabajo, proyectos, tableros y sprints.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta de Jira conectada que se usará para este paso. |
| Action | Yes | La acción de Jira que se va a realizar (por ejemplo Get Current User, Create Issue, Edit Issue, Get Issue). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Jira en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay una conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Arguments form

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Common actions

| Action | Description |
| - | - |
| **Get Current User** | Devuelve los detalles de la cuenta de usuario conectada de Jira. |
| **Create Issue** | Crea una nueva incidencia en un proyecto de Jira. |
| **Edit Issue** | Actualiza campos de una incidencia de Jira existente. |
| **Get Issue** | Recupera una incidencia de Jira por ID o clave. |
| **Search Issues** | Busca incidencias de Jira con filtros o JQL. |
| **Transition Issue** | Mueve una incidencia de Jira a otro estado del flujo de trabajo. |
| **List Comments** | Lista los comentarios de una incidencia de Jira. |
| **Add Attachment** | Sube un archivo y lo adjunta a una incidencia de Jira. |
| **Add Worklog** | Agrega una entrada de registro de trabajo a una incidencia de Jira. |
| **Link Issues** | Vincula dos incidencias de Jira. |
| **Get All Projects** | Lista todos los proyectos de Jira visibles. |
| **Get Project** | Recupera los detalles de un proyecto de Jira. |
| **List Boards** | Lista los tableros de Jira visibles para el usuario. |
| **Create Board** | Crea un nuevo tablero de Jira. |
| **List Sprints** | Lista los sprints de un tablero de Jira. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso guarda la respuesta de Jira como salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Abre **Integrations** y conecta Jira si aún no lo has hecho.
2. Añade un paso de **Jira** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get Current User** en **Action**.
5. Completa los campos requeridos. Usa **Insert Variable** para hacer referencia a la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Use cases

### Create a bug from a form reply

1. Create Issue
2. Add Comment
3. Add Attachment

### Route an issue through workflow

1. Search Issues
2. Get Issue
3. Transition Issue

### Plan sprint work

1. List Boards
2. List Sprints
3. Create Sprint

## Notes

* Este paso depende de una integración de Jira conectada en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto seleccionado de acciones. Los agentes con la herramienta de Jira pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar una marca de autorización de terceros.

## Using Jira as an Agent Tool

También puedes añadir Jira como una herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Jira**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de Jira cuando son relevantes para la conversación.

See also: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.