Jira UAT: skicka testärenden till Jira med ett klick

På en minut

Titta först

Konfigurera Jira-kopplingen och skicka ett första ärende, med statusen som kommer tillbaka (59 sekunder, undertexter i bilden).

Innan du börjar

Vad du behöver

Jira Cloud: en adress som slutar på .atlassian.net.
Ett Jira-konto som får skapa issues i projektet som buggarna ska till.
Administratörsbehörighet i din arbetsyta i UAT Studio.

Tips: använd ett tjänstekontoTickets skapas i namnet på det konto vars token du använder. Många team skapar en separat Jira-användare som UAT Studio för detta, så att tickets inte är beroende av en persons konto och är lätta att känna igen.

Konfigurera · en gång per arbetsyta

Koppla ditt Jira-projekt

Skapa en API-token i Atlassian

Logga in på Atlassian med det Jira-konto du ska använda och gå till id.atlassian.com › Security › API tokens.
Klicka på Create API token.
Ge den ett namn som du känner igen senare, till exempel UAT Studio, och välj ett utgångsdatum.
Klicka på Copy. Håll fönstret öppet tills du har klistrat in token i steg 5: Atlassian visar den bara en gång.

Atlassian-konto, fliken Security, API Tokens: knappen Create API token och en token med namnet UAT Studio som går ut efter ett år — Använd **Create API token**, inte *Create API token with scopes*. Tokens upphör att gälla efter högst ett år.

Lägg in utgångsdatumet i din kalenderNär token upphör att gälla slutar sändningen. Skapa en ny token och klistra in den i UAT Studio; inget annat ändras.

Hitta din Jira-adress och projektnyckel

Jira address: öppna Jira och titta i adressfältet. Allt till och med .atlassian.net är din adress, till exempel https://acme.atlassian.net.

Project key: den korta koden framför varje ticketnummer. I PORTAL-123 är nyckeln PORTAL. Öppna valfri ticket i projektet så ser du den i sökvägen högst upp. Inga tickets än? Öppna projektet och titta i adressfältet: nyckeln står efter /projects/.

Projekt eller spaces?Nyare Jira kallar projekt för spaces. Det är samma sak: använd nyckeln för det space som buggarna ska till.

Öppna Connections i UAT Studio

Logga in på app.uat.studio och öppna din arbetsyta. Klicka på Connections. Du hittar det också under Setup i alla projekt, som Manage connections.

Arbetsytans sida med knapparna Plan & billing, People & access, Connections och Audit log

Lägg till Jira och fyll i inställningarna

Under Add a connection väljer du Jira och klickar på Add.

Add a connection, med Jira valt och knappen Add

Ett kort för den nya kopplingen visas. Fyll i:

Fält	Vad du fyller i
Name	Vad som står på knappen: Send to Jira. Ändra det om du kopplar mer än ett projekt, till exempel Portal Jira.
Jira address	Din adress från steg 2, till exempel `https://acme.atlassian.net`.
Email of the Jira account	E-postadressen till kontot som skapade token.
Project key	Nyckeln från steg 2, med versaler, till exempel `PORTAL`.
Issue type	`Bug`. Om ditt projekt inte har typen Bug använder du den typ som ditt team använder för fel, till exempel `Task`.

Klicka på Save settings.

Kortet för Jira-kopplingen med adress, e-post, projektnyckel och issue-typ ifyllda

Spara token

Klistra in token från steg 1 i fältet API token och klicka på Store token. Fältet visar sedan bara de 4 sista tecknen, så att du kan se vilken token som är sparad.

Fältet API token med en inklistrad token, dold som punkter, och knappen Store token

Din token förblir dinToken skickas en gång över en krypterad anslutning och lagras krypterad. Ingen kan läsa den igen: inte dina kollegor, inte UAT Studios support.

Testa kopplingen

Klicka på Test connection. UAT Studio loggar in i Jira med din token och kontrollerar projektet. När allt är i ordning ser du Connected as <name> to project <project>, och OK bredvid det senaste testet.

Kopplingskortet efter ett lyckat test: senaste test OK, ansluten som Emma de Vries till projektet Customer Portal

Klart. Alla projekt i den här arbetsytan kan nu skicka ärenden till det här Jira-projektet.

Varje testdag

Skicka ärenden till Jira

Ett ärende

Öppna ärendet. Under Ticket in the development team's system klickar du på Send to Jira.

Några sekunder senare finns ticketen i Jira. Ticketnumret och en länk visas på ärendet, och ärendets historik visar när det skickades och av vem. Ett ärende som redan är kopplat kan inte skickas två gånger av misstag.

Ärendepanelen efter sändning: kopplad till Jira-ticket PORTAL-1, med länken Open Jira PORTAL-1

Alla ärenden efter triagemötet

I Issues › Triage ger du varje nytt ärende ett beslut. När du är klar räknar UAT Studio de ärenden som ska åtgärdas och som ännu inte har någon ticket. Klicka på Send 3 to Jira (eller hur många det nu är) för att skapa alla tickets på en gång.

Triage klar: Send to the development team, med knappen Send 3 to Jira och CSV-nedladdningarna

Vad Jira-ticketen innehåller

Titel: ärendets nummer och titel, till exempel ISS-012: Quote PDF shows the wrong VAT rate.
Beskrivning: vad testaren skrev, testfallet med steget som misslyckades och det förväntade resultatet, miljön och vem som hittade det.
Prioritet utifrån allvarlighetsgraden, och etiketterna UAT och ärendenumret, så att du kan filtrera på dem.
En länk tillbaka till ärendet i UAT Studio, där skärmbilderna finns.

En Bug i Jira skapad av UAT Studio: titeln ISS-001 med det misslyckade teststeget, och en beskrivning med steget, det förväntade och det faktiska resultatet — En ticket som UAT Studio skapar den. Under beskrivningen: testfallet, vem som hittade det och länken *Open in UAT Studio*.

Skärmbilderna följer med

Ärendets skärmbilder och filer bifogas till Jira-ticketen: upp till 10 filer på högst 10 MB vardera. En fil som inte får plats stannar i UAT Studio, och ärendets historik visar vilken.

Slå ihop dubbletter

När du slår ihop två ärenden i UAT Studio som båda har en ticket följer dubblettens ticket med: den får en kommentar, länken duplicates till den andra ticketen och flyttas till Done. Om ditt arbetsflöde inte tillåter det meddelar UAT Studio dig, och du stänger den själv i Jira. När bara dubbletten hade en ticket tar ärendet som blir kvar över den.

Status tillbaka

När rättningen är klar i Jira

När utvecklaren flyttar ticketen till en status i kategorin Done blir ärendet i UAT Studio Ready for retest och testaren får ett mejl om att testa om. När ticketen flyttas till In Progress gör ärendet det också. Statusen i Jira visas bredvid ticketlänken.

Ett misslyckat omtest ångras aldrig: när testaren öppnar ärendet igen medan ticketen fortfarande är Done låter UAT Studio det vara öppet. Ett stängt ärende förblir stängt.

Av sig självt, eller direkt

Utan att du gör något hämtar UAT Studio ticketstatusen varje gång en administratör öppnar ärendena, och med knappen Update ticket status.

Direkt: låt Jira meddela UAT Studio när en ticket flyttas. Du måste ha behörighet att skapa en automationsregel i Jira-projektet.

I UAT Studio, under Connections, i Jira-kopplingen, klickar du på Create webhook address och kopierar adressen. Den visas bara en gång.
Öppna projektet i Jira och gå till Project settings › Automation › Create rule.
Trigger: Work item transitioned (i äldre Jira: Issue transitioned). Lämna From och To tomma.
Action: Send web request. Web request URL: adressen du kopierade. Method POST. Web request body: Issue data (Jira format).
Döp regeln till UAT Studio status och aktivera den.

Håll adressen inom teametAdressen fungerar som en nyckel, enbart för att rapportera ticketstatusar. Har du tappat bort den eller delat den av misstag? Klicka på New address: den gamla slutar fungera direkt.

Roller

Vem kan göra vad

AdminsLägger till, ändrar, testar och tar bort kopplingar; skickar ärenden.

Testare, intressenter, utvecklareSer ticketnumret och länken på ett ärende. De kan inte skicka ärenden eller se kopplingens inställningar.

GranskningsloggVarje ändring av en koppling registreras, så att du alltid ser vem som ändrade vad och när.

Felsökning

Om något går fel

Du ser	Vad du gör
Token eller e-postadressen godtas inte	E-postadressen måste vara den för Atlassian-kontot som skapade token. Kontrollera stavfel, eller skapa en ny token och spara den igen.
Projektet … hittades inte	Kontrollera projektnyckeln och att Jira-kontot kan se projektet.
Sändningen misslyckas på issue-typen	Projektet har ingen typ med det namnet. Slå upp typerna i ditt Jira-projekt och fyll i rätt typ under Issue type.
Det fungerade förut, nu gör det inte det	Token har förmodligen gått ut eller återkallats. Skapa en ny och spara den; resten förblir som det är.
Statusen kommer inte tillbaka	Öppna ärendena som administratör, eller klicka på Update ticket status. Med en webhook-adress: kontrollera att automationsregeln är aktiverad och titta i dess granskningslogg i Jira; under Connections ser du när det senaste meddelandet kom.
Ingen knapp Send to Jira	Bara administratörer ser den, och bara när kopplingen är On och har en sparad token.
Kopplingar ingår inte i ditt paket	Kopplingar ingår i Team, Business, Partner och Enterprise, och som tillägg för Project. Din administratör kan uppgradera under Plan & billing.

Kommer du fortfarande inte vidare? Mejla [email protected] med meddelandet du ser. Skicka aldrig själva token till oss.

Använder du Azure DevOps? Se Koppla UAT Studio till Azure DevOps. Alla guider: UAT Studio hjälp.

Säkerhet

Hur vi hanterar din token

Token går från din webbläsare till vår server en gång, över en krypterad anslutning.
Den lagras krypterad (AES-256). Nyckeln för att dekryptera den förvaras separat från databasen, så en kopia av databasen ensam är oanvändbar.
Ingen kan läsa token igen: inte i appen, inte via supporten.
UAT Studio använder token bara för att testa kopplingen, skapa de tickets du skickar (med deras filer), läsa statusen för dessa tickets och stänga en dubblett-ticket efter en sammanslagning. Den läser inget annat i din Jira.
Ta bort kopplingen eller återkalla token i Atlassian, så upphör åtkomsten direkt.

Koppla UAT Studio till Jira