Integrazione con Jira

L’integrazione con Jira mostra le attività Jira nel cronoprogramma di progetto di FlexiProject. Ogni progetto può prelevare attività da uno o più progetti Jira, e l’elenco delle attività prelevate viene ristretto per tipo di attività o con un filtro JQL. Le attività Jira restano sincronizzate con Jira nel cronoprogramma; i loro campi sono di sola lettura.

Un amministratore attiva l’integrazione e la configura in Impostazioni del sistema > JIRA (vedi Impostazioni del sistema). Il collegamento degli utenti Jira con gli utenti di FlexiProject consente al cronoprogramma e al carico delle risorse di mostrare i proprietari delle attività Jira.

Connettersi a Jira

La chiave di connessione in Jira

1. In Jira, clicca sull’avatar nell’angolo in alto a destra e scegli Gestisci account.
2. Passa alla scheda Sicurezza e, nella sezione Token API, clicca su Crea e gestisci token API.
3. Clicca su Crea token API, inserisci un nome (per esempio «FlexiProject») e clicca su Crea.
4. Copia la chiave generata. Jira la mostra una sola volta.

Attivare l’integrazione in FlexiProject

1. Apri Impostazioni del sistema (menu principale) e passa alla pagina JIRA. Compare la scheda Integrazione con JIRA.
2. Porta l’integrazione su Abilitato.
3. Inserisci l’Indirizzo del server — l’indirizzo a cui si apre il Jira della tua organizzazione, per esempio https://name.atlassian.net.
4. Inserisci l’Email dell’utente — la stessa con cui ha effettuato l’accesso l’utente che ha generato la chiave.
5. Incolla la chiave copiata nel campo Chiave.
6. Clicca su Salva. Con dati corretti compare il messaggio La connessione al server JIRA è corretta; con dati errati, Connessione fallita al server JIRA oppure Indirizzo del server JIRA non corretto.

Il pulsante Controllare il collegamento verifica lo stato della connessione in qualsiasi momento.

Nota: portare l’integrazione su Spento rimuove tutti i collegamenti dei progetti con Jira e tutte le attività Jira dai cronoprogrammi. L’operazione non può essere annullata, e per riattivarla bisogna collegare di nuovo i progetti.

Collegare gli utenti Jira

Sotto i parametri di connessione c’è la tabella Utenti con le colonne Nome di Jira, ID Jira e Utente (l’utente FlexiProject collegato). Un filtro sopra la tabella restringe l’elenco. Con una connessione attiva, FlexiProject cerca di continuo di collegare gli utenti Jira agli utenti FlexiProject confrontando gli indirizzi e-mail. Quando Jira condivide un indirizzo e-mail e lo stesso indirizzo esiste in FlexiProject, accanto al nome Jira compaiono l’avatar e il nome dell’utente collegato. Il fatto che Jira condivida o no gli indirizzi dipende dalle sue impostazioni di sicurezza globali e da quelle di privacy dell’utente Jira.

I collegamenti creati automaticamente si aggiornano da soli. Quelli aggiunti manualmente no: dopo un cambio di cognome o di indirizzo e-mail devi correggerli a mano.

Collegare manualmente

1. Passa il mouse su una riga senza utente collegato e clicca sul simbolo dei tre puntini.
2. Scegli Connetti. Si apre la finestra Collega utente.
3. Seleziona l’utente FlexiProject e clicca su Salva.

Rimuovere un collegamento

1. Passa il mouse su una riga con un utente collegato e clicca sul simbolo dei tre puntini.
2. Scegli Disconnetti. Compare la domanda Sei sicuro di voler rimuovere il link?
3. Conferma con Salva.

Importare l’elenco degli utenti Jira

1. Genera un file CSV degli utenti nel pannello di amministrazione di Atlassian (admin.atlassian.com), nella scheda degli utenti, con il comando di esportazione. Il file deve contenere i campi User id, User name ed email.
2. Clicca su Importazioni di utenti Jira sotto l’intestazione della tabella. Si apre la finestra di importazione.
3. Seleziona il file o trascinalo nella finestra e clicca su Salva. L’elenco degli utenti Jira si aggiorna e i collegamenti trovati vengono compilati automaticamente.

Le righe con valori errati vengono saltate e l’applicazione le elenca dopo l’importazione; un file errato termina con un messaggio sul formato CSV non corretto.

Attività Jira nel cronoprogramma del progetto

Collegare un progetto a Jira

1. Apri il progetto, scheda Cronoprogramma.
2. Clicca su Impostazioni e scegli Connessione a JIRA (la voce è visibile quando l’integrazione è attiva). Si apre la finestra Integrazione con JIRA.
3. Inserisci la Chiave del progetto Jira. Per prelevare attività da più progetti Jira, inserisci le chiavi separate da virgole.
4. Clicca su Collega. Si apre la finestra Importazioni da JIRA.
5. Scegli come prelevare i dati nella parte Download dei dati: Tipo di attività (solo con un progetto Jira) oppure Filtro JQL (vedi Filtro JQL).
6. Per i tipi di attività: seleziona i tipi di attività sui livelli della gerarchia (almeno un tipo — altrimenti compare il messaggio Almeno un livello deve essere contrassegnato), poi clicca su Salva. Le dipendenze tra i tipi di attività vengono trasformate, quando possibile, in una gerarchia di attività nel cronoprogramma.

Quando il download riesce, le attività Jira compaiono nel progetto e accanto al nome del progetto compare un’icona Jira; cliccando su di essa si apre il progetto Jira in una nuova scheda. Il download può fallire, per esempio quando all’utente indicato nella connessione mancano i permessi o il JQL contiene un errore di sintassi (Errore nella query JQL). L’applicazione mostra allora un messaggio. Una chiave che non esiste o a cui non hai accesso termina con Chiave di progetto errata, il progetto non esiste o non vi si ha accesso.

Cambiare il modo di prelevare le attività

Lo stesso comando Connessione a JIRA apre la finestra Importazioni da JIRA per un progetto già collegato, dove cambi i tipi di attività o la query JQL.

Rimuovere le attività Jira da un progetto

1. Apri la finestra Importazioni da JIRA con il comando Connessione a JIRA.
2. Clicca su Cancellare e conferma nella finestra Rimozione del collegamento a JIRA. Il messaggio avverte che eliminare il collegamento elimina tutti i collegamenti nel cronoprogramma e che l’operazione è irreversibile.

Dopo l’eliminazione, le attività Jira scompaiono dal cronoprogramma e il progetto non è più contrassegnato come collegato a Jira.

Filtro JQL

Il JQL (Jira Query Language) permette di prelevare in un progetto esattamente le attività Jira che servono, anche da più progetti Jira contemporaneamente.

1. In Jira, prepara un filtro nello strumento Filtri. Il codice JQL è visibile dopo aver cambiato la vista del filtro da base a JQL.
2. Copia il codice JQL.
3. In FlexiProject, nella finestra Importazioni da JIRA, scegli Filtro JQL e incolla il codice nel campo di testo.
4. Clicca su Salva.

Una query con un errore di sintassi viene rifiutata con il messaggio Errore nella query JQL. Il filtro determina solo quali attività arrivano nel cronoprogramma; a ogni sincronizzazione le attività fuori dal risultato del filtro scompaiono dal cronoprogramma.

Attività Jira nel cronoprogramma

Le attività Jira arrivano in fondo al cronoprogramma con la loro struttura conservata e hanno un’icona Jira nel cronoprogramma. Si aggiornano automaticamente con una sincronizzazione periodica; i campi che provengono da Jira — Nome, Descrizione, Progresso, Proprietario e la gerarchia delle attività — sono di sola lettura. Non puoi modificare l’avanzamento né i proprietari di una tale attività (l’applicazione mostra Non è possibile modificare lo stato dei compiti provenienti da JIRA. e Non è possibile modificare i proprietari dei compiti provenienti da JIRA.), e queste attività non vengono copiate quando si clona un progetto. Un’attività Jira non può essere genitore di attività FlexiProject. Puoi riordinare le attività sotto un’attività genitore Jira, e le attività di riepilogo Jira con le loro sottoattività possono essere inserite nella struttura del cronoprogramma.

Per un progetto collegato, il cronoprogramma ha tre colonne in più: ID di Jira (un clic apre l’attività in Jira in una nuova scheda), Stato di Jira e Tipo Jira. L’avanzamento di un’attività deriva dalla categoria di stato in Jira: da fare — 0%, in corso — 50%, completata — 100%.

Il proprietario dell’attività deriva dal collegamento degli utenti (vedi Collegare gli utenti Jira). Quando un utente Jira è collegato a un utente FlexiProject, il cronoprogramma mostra il suo avatar e il suo nome, e l’utente viene aggiunto al progetto. Senza collegamento vedi un’icona avatar grigia con il nome Jira. Il cronoprogramma è descritto in Cronoprogramma di progetto.