Vai al contenuto principale

Integrazione Jira - Guida alla configurazione

Collega il tuo account Jira a Goodweek per gestire ticket, progetti, sprint e flussi di lavoro direttamente dal tuo spazio di lavoro IA.

A
Scritto da Antoine Stempien

Collega il tuo account Jira a Goodweek per gestire ticket, progetti, sprint e flussi di lavoro direttamente dal tuo spazio di lavoro IA.

ℹ️ Nota sulla governance

Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Jira, garantendo l'allineamento con le policy di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare in base alle autorizzazioni specifiche e all'accesso autenticato di ciascun utente.

📋 Prerequisiti

Prima che qualsiasi utente possa vedere e collegare l'integrazione Jira, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Configurazione amministratore

L'integrazione Jira (nome app: Composio- Jira Connector) utilizza OAuth 2.0 tramite Atlassian. Per la maggior parte delle organizzazioni non è richiesta alcuna approvazione da parte dell'amministratore. Tuttavia, alcune organizzazioni Atlassian hanno disabilitato l'"Accesso alle app di terze parti tramite OAuth" a livello di organizzazione.

⚠️ Interruttore di sicurezza Atlassian

Se gli utenti visualizzano un errore "Accesso app OAuth limitato" durante la connessione, un amministratore dell'organizzazione Atlassian deve abilitare l'accesso alle app di terze parti da admin.atlassian.com → Sicurezza → Accesso alle app di terze parti.

⚠️ Solo Jira Cloud

Questa integrazione supporta solo Jira Cloud. Le installazioni di Jira Data Center e Jira Server non sono compatibili.

Connessione dell'utente

  1. In Goodweek, vai su Integrazioni.

  2. Trova Jira e fai clic su Connetti.

  3. Verrai reindirizzato ad Atlassian, dove ti verrà chiesto di accedere e autorizzare l'accesso.

  4. Seleziona il sito Jira che vuoi collegare e fai clic su Accetta per tornare a Goodweek.

Note importanti

  • Ogni utente deve collegare il proprio account individualmente.

  • Goodweek può accedere solo ai progetti e ai ticket che il tuo account Jira individuale ha il permesso di vedere.

  • Questa integrazione supporta solo Jira Cloud. Data Center e Server non sono supportati.

  • Puoi revocare l'accesso di Goodweek in qualsiasi momento da id.atlassian.com → Sicurezza → App collegate → Composio.


Strumenti disponibili

Strumento

Descrizione

Tipo

Search Issues Using JQL

Cerca i ticket Jira utilizzando JQL con paginazione e selezione dei campi.

Lettura

Search Issues (Advanced)

Ricerca avanzata dei ticket che supporta filtri strutturati e JQL grezzo.

Lettura

Get Issue

Recupera un ticket Jira tramite ID o chiave con campi ed espansioni personalizzabili.

Lettura

Bulk Fetch Issues

Recupera fino a 100 ticket Jira tramite i loro ID o chiavi in un'unica richiesta.

Lettura

Create Issue

Crea un nuovo ticket Jira (bug, attività, storia, ecc.) in un progetto specificato.

Scrittura

Bulk Create Issues

Crea fino a 50 ticket Jira in un'unica chiamata con pieno supporto delle funzionalità.

Scrittura

Edit Issue

Aggiorna un ticket Jira esistente con nuovi valori dei campi e operazioni.

Lettura

Transition Issue

Sposta un ticket Jira in un diverso stato del flusso di lavoro (ad es. Da fare → In corso → Fatto).

Lettura

Assign Issue

Assegna un ticket Jira a un utente, all'assegnatario predefinito, oppure lo rende non assegnato.

Lettura

Get Transitions

Recupera le transizioni del flusso di lavoro disponibili per un ticket Jira.

Lettura

List Issue Comments

Recupera i commenti paginati di un ticket Jira.

Lettura

Get Comment

Recupera un commento specifico tramite ID da un ticket Jira.

Lettura

Add Comment

Aggiunge un commento in testo formattato a un ticket Jira esistente.

Scrittura

Update Comment

Aggiorna il testo o la visibilità di un commento Jira esistente.

Scrittura

Add Attachment

Carica e allega un file a un ticket Jira.

Scrittura

Get Attachment

Recupera il contenuto binario di un allegato Jira tramite ID.

Lettura

Link Issues

Collega due ticket Jira utilizzando un tipo di collegamento specificato con un commento facoltativo.

Scrittura

Get Issue Link Types

Recupera tutti i tipi di collegamento tra ticket configurati in Jira.

Lettura

Add Worklog

Aggiunge un worklog (voce di rilevazione del tempo) a un ticket Jira.

Scrittura

Get Worklogs

Recupera i worklog di un ticket Jira specificato.

Lettura

Get all Projects

Recupera tutti i progetti visibili tramite l'API paginata di Jira.

Lettura

Get Project

Recupera i dettagli di un progetto Jira tramite il suo ID o chiave.

Lettura

Create Project

Crea un nuovo progetto Jira con lead, modello e tipo di configurazione richiesti.

Scrittura

Get Project Versions

Recupera tutte le versioni di un progetto Jira.

Lettura

Create Version

Crea una nuova versione per release o milestone in un progetto Jira.

Scrittura

List Boards

Recupera le board di Jira paginate con opzioni di filtro e ordinamento.

Lettura

Create Board

Crea una nuova board Jira (kanban, scrum o agility).

Scrittura

List Sprints

Recupera gli sprint paginati di una board Jira con filtro facoltativo per stato.

Lettura

Get Sprint

Recupera informazioni dettagliate su uno sprint specifico tramite il suo ID.

Lettura

Create Sprint

Crea un nuovo sprint su una board Jira con date di inizio/fine e obiettivo facoltativi.

Scrittura

Move Issues to Sprint

Sposta uno o più ticket Jira in uno sprint attivo specificato.

Lettura

Get Current User

Recupera informazioni sull'utente Jira attualmente autenticato.

Lettura

Get Issue Types

Recupera tutti i tipi di ticket Jira disponibili per l'utente.

Lettura

Get Issue Statuses

Recupera tutti gli stati dei ticket associati ai flussi di lavoro in Jira.

Lettura

Get Fields

Recupera i metadati dei campi dei ticket Jira, inclusi gli ID dei campi personalizzati.

Lettura

Delete Issue

Elimina in modo permanente e irreversibile un ticket Jira tramite il suo ID o chiave.

⚠️ Distruttivo

Delete Comment

Elimina in modo permanente un commento specifico da un ticket Jira.

⚠️ Distruttivo

Delete Attachment

Elimina in modo permanente un allegato da Jira tramite il suo ID.

⚠️ Distruttivo

Delete Worklog

Elimina una voce di worklog da un ticket Jira.

⚠️ Distruttivo

Delete Version

Elimina una versione Jira e, facoltativamente, riassegna i relativi ticket.

⚠️ Distruttivo

Casi d'uso

  • Crea e aggiorna ticket dalle conversazioni. Registra nuovi ticket Jira — bug, attività o storie — con il progetto, il tipo e i campi corretti direttamente da una conversazione Goodweek, senza navigare nell'interfaccia di Jira.

  • Cerca e valuta i ticket utilizzando JQL. Esegui query JQL da Goodweek per individuare ticket scaduti, attività non assegnate o elementi del backlog dello sprint e agisci su di essi senza aprire Jira.

  • Fai avanzare i ticket nei flussi di lavoro. Sposta i ticket tra gli stati (ad es. In corso → Fatto) direttamente da Goodweek per mantenere aggiornate le board degli sprint e i flussi di lavoro.

  • Registra il tempo e aggiungi commenti. Registra i worklog e aggiungi commenti ai ticket da Goodweek dopo aver completato il lavoro, mantenendo accurata la cronologia dei ticket senza cambiare strumento.


Risoluzione dei problemi

"Accesso app OAuth limitato" durante la connessione

La tua organizzazione Atlassian ha limitato l'accesso alle app di terze parti. Un amministratore dell'organizzazione Atlassian deve abilitarlo da admin.atlassian.com → Sicurezza → Accesso alle app di terze parti.

Integrazione non visibile in Goodweek

Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Jira dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Riferimenti

Hai ricevuto la risposta alla tua domanda?