Integrarea cu Jira

Integrarea cu Jira afișează activitățile din Jira în programarea proiectului din FlexiProject. Fiecare proiect poate prelua activități dintr-unul sau din mai multe proiecte Jira, iar lista activităților preluate se restrânge după tipuri de activități sau după un filtru JQL. Activitățile din Jira rămân sincronizate cu Jira în programare; câmpurile lor sunt numai pentru citire.

Un administrator activează integrarea și o configurează în Setări de sistem > JIRA (vezi Setări de sistem). Legarea utilizatorilor Jira de utilizatorii FlexiProject permite ca programarea și încărcarea resurselor să afișeze proprietarii activităților din Jira.

Conectarea la Jira

Cheia de conectare din Jira

1. În Jira, faceți clic pe avatar, în colțul din dreapta sus, și alegeți Gestionați contul.
2. Treceți la fila Securitate și, în secțiunea Token API, faceți clic pe Creați și gestionați tokenuri API.
3. Faceți clic pe Creați token API, introduceți un nume (de exemplu „FlexiProject”) și faceți clic pe Creați.
4. Copiați cheia generată. Jira o afișează o singură dată.

Activarea integrării în FlexiProject

1. Deschideți Setări de sistem (meniul principal) și treceți la pagina JIRA. Apare cardul Integrare cu JIRA.
2. Comutați integrarea pe Activat.
3. Introduceți Adresa serverului — adresa la care se deschide Jira organizației dvs., de exemplu https://name.atlassian.net.
4. Introduceți E-mail de utilizator — același cu care este autentificat utilizatorul care a generat cheia.
5. Lipiți cheia copiată în câmpul Cheie.
6. Faceți clic pe Salvare. Cu date corecte apare mesajul Conexiunea la serverul JIRA este corectă; cu date incorecte — Nu s-a reușit conectarea la serverul JIRA sau Adresa incorectă a serverului JIRA.

Butonul Verificați conexiunea verifică starea conexiunii oricând.

Notă: oprirea integrării cu Oprit elimină toate legăturile proiectelor cu Jira și toate activitățile din Jira din programări. Acțiunea nu poate fi anulată, iar pentru a porni integrarea din nou trebuie să legați din nou proiectele.

Legarea utilizatorilor Jira

Sub parametrii de conectare se află tabelul Utilizatori, cu coloanele Numele Jira, ID Jira și Utilizator (utilizatorul FlexiProject legat). Un filtru de deasupra tabelului restrânge lista. Cu o conexiune activă, FlexiProject încearcă în permanență să lege utilizatorii Jira de utilizatorii FlexiProject prin potrivirea adreselor de e-mail. Când Jira partajează o adresă de e-mail și aceeași adresă există în FlexiProject, avatarul și numele utilizatorului legat apar lângă numele Jira. Dacă Jira partajează sau nu adresele depinde de setările sale globale de securitate și de setările de confidențialitate ale utilizatorului Jira.

Legăturile create automat se actualizează singure. Cele adăugate manual nu: după o schimbare a numelui de familie sau a adresei de e-mail trebuie să le corectați manual.

Legarea manuală

1. Treceți cursorul peste un rând fără utilizator legat și faceți clic pe simbolul cu trei puncte.
2. Alegeți Conectează. Se deschide fereastra Asociază utilizatorul.
3. Alegeți utilizatorul FlexiProject și faceți clic pe Salvare.

Eliminarea unei legături

1. Treceți cursorul peste un rând cu utilizator legat și faceți clic pe simbolul cu trei puncte.
2. Alegeți Deconectare. Apare întrebarea Sunteți sigur că doriți să eliminați link-ul?.
3. Confirmați cu Salvare.

Importul listei de utilizatori Jira

1. Generați un fișier CSV cu utilizatori în panoul de administrare Atlassian (admin.atlassian.com), în fila utilizatorilor, cu comanda de export. Fișierul trebuie să conțină câmpurile User id, User name și email.
2. Faceți clic pe Importuri de utilizatori Jira, sub antetul tabelului. Se deschide fereastra de import.
3. Alegeți fișierul sau trageți-l în fereastră și faceți clic pe Salvare. Lista utilizatorilor Jira se actualizează, iar legăturile găsite se completează automat.

Rândurile cu valori incorecte sunt omise, iar aplicația le listează după import; un fișier incorect se încheie cu un mesaj despre formatul CSV greșit.

Activitățile Jira în programarea proiectului

Legarea unui proiect de Jira

1. Deschideți proiectul, fila Programare.
2. Faceți clic pe Setări și alegeți Conexiune la JIRA (elementul este vizibil după activarea integrării). Se deschide fereastra Integrare cu JIRA.
3. Introduceți Cheia proiectului Jira. Pentru a prelua activități din mai multe proiecte Jira, introduceți cheile separate prin virgulă.
4. Faceți clic pe Conectați. Se deschide fereastra Importuri din JIRA.
5. În partea Descărcarea datelor, alegeți modul de preluare a datelor: Tipul de Sarcini (numai cu un singur proiect Jira) sau Filtru JQL (vezi Filtrul JQL).
6. Pentru tipurile de activități: bifați tipurile de activități pe nivelurile ierarhiei (cel puțin un tip — altfel apare mesajul Cel puțin un nivel trebuie să fie marcat), apoi faceți clic pe Salvare. Când este posibil, dependențele dintre tipurile de activități sunt transformate în ierarhie de activități în programare.

După o descărcare reușită, activitățile din Jira apar în proiect, iar lângă numele proiectului apare o pictogramă Jira; un clic pe ea deschide proiectul Jira într-o filă nouă. Descărcarea poate eșua, de exemplu atunci când utilizatorul indicat în conexiune nu are permisiuni sau când JQL conține o eroare de sintaxă (Eroare în interogarea JQL). Aplicația afișează atunci un mesaj. O cheie inexistentă sau la care nu aveți acces se încheie cu Cheie de proiect incorectă, proiectul nu există sau nu aveți acces la el.

Schimbarea modului de preluare a activităților

Aceeași comandă Conexiune la JIRA deschide fereastra Importuri din JIRA pentru un proiect deja legat, unde schimbați tipurile de activități sau interogarea JQL.

Eliminarea activităților Jira dintr-un proiect

1. Deschideți fereastra Importuri din JIRA cu comanda Conexiune la JIRA.
2. Faceți clic pe Ștergeți și confirmați în fereastra Eliminarea linkului JIRA. Mesajul avertizează că ștergerea legăturii șterge toate legăturile din programare și că acțiunea este ireversibilă.

După ștergere, activitățile din Jira dispar din programare, iar proiectul nu mai este marcat ca fiind legat de Jira.

Filtrul JQL

JQL (Jira Query Language) permite preluarea în proiect exact a activităților Jira de care aveți nevoie, inclusiv din mai multe proiecte Jira simultan.

1. În Jira, pregătiți un filtru în instrumentul Filtre. Codul JQL este vizibil după ce comutați vizualizarea filtrului de la cea de bază la JQL.
2. Copiați codul JQL.
3. În FlexiProject, în fereastra Importuri din JIRA, alegeți Filtru JQL și lipiți codul în câmpul de text.
4. Faceți clic pe Salvare.

O interogare cu eroare de sintaxă este respinsă cu mesajul Eroare în interogarea JQL. Filtrul influențează doar activitățile care ajung în programare; la fiecare sincronizare, activitățile din afara rezultatului filtrului dispar din programare.

Activitățile Jira în programare

Activitățile din Jira ajung la sfârșitul programării, cu structura păstrată, și au în programare o pictogramă Jira. Se actualizează automat într-o sincronizare periodică; câmpurile care provin din Jira — Nume, Descriere, Progres, Proprietar și ierarhia activităților — sunt numai pentru citire. Nu puteți modifica progresul sau proprietarii unei astfel de activități (aplicația afișează Nu este posibilă modificarea statutului sarcinilor care provin din JIRA și Nu este posibil să se schimbe proprietarii sarcinilor care provin din JIRA.), iar astfel de activități nu se copiază la clonarea unui proiect. O activitate Jira nu poate fi părinte pentru activitățile FlexiProject. Puteți reordona activitățile aflate sub o activitate-părinte Jira, iar activitățile de sumar Jira, împreună cu subactivitățile lor, pot fi inserate în structura programării.

Pentru un proiect legat, programarea are trei coloane suplimentare: ID Jira (un clic deschide activitatea în Jira într-o filă nouă), Starea Jira și Tipul Jira. Progresul unei activități rezultă din categoria de stare din Jira: de făcut — 0%, în desfășurare — 50%, finalizat — 100%.

Proprietarul activității provine din legarea utilizatorilor (vezi Legarea utilizatorilor Jira). Când un utilizator Jira este legat de un utilizator FlexiProject, programarea afișează avatarul și numele acestuia, iar utilizatorul este adăugat în proiect. Fără legătură vedeți o pictogramă gri de avatar cu numele Jira. Programarea este descrisă în Programarea proiectului.