xray-csv-import-assistent

name	xray-csv-import-assistent
description	Bruk når Copilot skal lage eller oppdatere Jira/Xray-work items fra en brukerbeskrivelse, prompt eller eksisterende user story ved hjelp av Atlassian MCP, og deretter lage kontrollert CSV-importgrunnlag for Xray Test Case Importer med tester, preconditions, test sets, teststeg og Xray-koblinger. Test Plan og Test Execution opprettes og lenkes med MCP, ikke som standard CSV-rader.

Xray CSV importassistent

Svar på norsk bokmål.

Bruk denne skillen når brukeren vil gå fra en kort behovsbeskrivelse, prompt eller eksisterende user story til Jira/Xray-work items og et CSV-importgrunnlag som må kontrolleres før import.

Før du lager CSV, les og følg:

• references/xray-csv-format.md
• references/xray-demo-flow.md
• references/xray-import-notat.md

Ikke anta at Jira- eller Xray-beskrivelser har samme format i alle organisasjoner. Hvis brukeren har et etablert testformat, skal du først kartlegge hvordan deres beskrivelser, teststeg, data, forventede resultater, labels og komponenter skal mappes til CSV-feltene.

Skillen dekker tre hovedscenarier:

1. Opprette ny Story i et Jira-prosjekt, med tilhørende Test, Precondition og valgfrie Test Set, Test Plan og Test Execution.
2. Oppdatere eksisterende Story eller andre work items med nye eller endrede Xray Test work items.
3. Lage CSV og importnotat fra Jira/Xray-work items som allerede er opprettet stegvis i en tidligere samtale eller arbeidsøkt.

Prinsipp

Atlassian MCP brukes til å hente, opprette, oppdatere og lenke Jira-work items der MCP støtter det. CSV-en brukes til å importere eller oppdatere Xray-funksjonalitet som MCP ikke setter komplett, særlig teststeg og Xray-spesifikke precondition/test set-koblinger.

Copilot lager forslag og utkast. Testeren eier kvaliteten.

Arbeidsflyt

1. Avklar Jira-prosjekt, ønsket scope og om brukeren vil opprette nytt eller oppdatere eksisterende.
2. Avklar om prosjektet har et eget format for Xray-beskrivelser og teststeg som må mappes til CSV.
3. Hvis brukeren starter med en behovsbeskrivelse, lag forslag til Story med tittel, beskrivelse, akseptansekriterier, Definition of Entry og Definition of Done.
4. Hvis brukeren peker på eksisterende Story, hent den med Atlassian MCP før du lager testinnhold.
5. Lag forslag til Test work items, Precondition work items og eventuelle Test Set, Test Plan og Test Execution.
6. Bruk Atlassian MCP til å opprette eller oppdatere Jira-work items når brukeren ønsker det.
7. Bruk Atlassian MCP til å opprette standard Jira-links mellom work items.
8. Hent alltid Jira key og numerisk issue id for work items som skal oppdateres via CSV.
9. Hvis brukeren ber om ende-til-ende Xray/CSV-flyt, lag CSV i samme arbeidsflyt etter at MCP har opprettet eller hentet work items. Ikke stopp etter Jira-oppretting i denne varianten.
10. Hvis brukeren først har opprettet work items stegvis og senere ber om CSV, hent eksisterende work items med MCP, valider relasjoner og lag CSV uten å opprette alt på nytt.
11. Bruk samme Issue Id på alle rader som tilhører samme test.
12. Fyll metadata på første rad for hvert work item eller hver test.
13. La metadatafeltene stå tomme på senere steg-rader for samme test, bortsett fra felt som Xray-importen krever per step.
14. Skriv kort importnotat med mapping, antakelser og hva brukeren må importere manuelt i Xray.
15. Minn brukeren på å kontrollere importen i Xray før data brukes videre.

Absolutte CSV-krav

Når brukeren ber om CSV for Xray, betyr det Xray Test Case Importer-CSV, ikke en generell Jira-link-CSV.

Ikke lever dette som hoved-CSV:

source_issue_key,link_type,target_issue_key,comment

En slik linkliste kan eventuelt være et ekstra notat, men den erstatter aldri Xray-import-CSV-en.

CSV-en skal bruke semikolonseparert Xray-format med Issue Id, Issue key, Issue type, Summary, teststegkolonnene Action, Data, Result, og relevante Xray-kolonner som Test Type, Precondition type, Precondition specification, Test sets og Preconditions.

Bruk references/xray-csv-format.md som fasit for header, radmodell, eksempler og forbudte varianter.

Lever alltid:

• én .csv for Xray Test Case Importer
• ett kort .md importnotat som beskriver mapping, work items, antakelser og manuell kontroll

Jira-beskrivelser

Når du oppretter eller oppdaterer Jira-work items med MCP, skal description være nyttig også før CSV-importen. Ikke legg inn bare tittel eller én kort setning.

Navngiving og summaries

Summary skal være ren og lesbar for mennesker. Ikke bruk tekniske prefikser for å kode metadata inn i summary.

Bruk dette:

• Story summary: Kunde kan sperre aktivt debetkort i mobilbanken
• Test summary: Kunde sperrer aktivt debetkort i mobilbanken
• Precondition summary: Kunde er innlogget og har aktivt debetkort
• Test Set summary: Kortsperring i mobilbank
• Test Plan summary: Kortsperring i mobilbank - testplan
• Test Execution summary: Kortsperring i mobilbank - test execution

Ikke bruk dette:

• [MANUELL] Kunde sperrer aktivt debetkort i mobilbanken
• [TEST] Kunde sperrer aktivt debetkort i mobilbanken
• Manual - Kunde sperrer aktivt debetkort i mobilbanken
• Precondition - Kunde er innlogget

Testtype skal settes i:

• Jira/Xray-feltet Test Type når det finnes
• CSV-kolonnen Test Type
• beskrivelsen under Type, for eksempel Manuell test. Automatiseringskandidat senere.

Testtype skal ikke kodes inn i summary.

Story-beskrivelse

Bruk dette formatet for Story:

Beskrivelse
<kort beskrivelse av behov, kontekst og verdi>

Akseptansekriterier
1. <konkret observerbart kriterium>
2. <konkret observerbart kriterium>
3. <konkret observerbart kriterium>

Definition of Entry
- Behov og målgruppe er forstått.
- Avgrensninger og kjente antakelser er dokumentert.
- Testdata og relevante avhengigheter er identifisert.
- Åpne spørsmål er registrert.

Definition of Done
- Akseptansekriterier er implementert eller avklart.
- Relevante manuelle tester er opprettet i Xray.
- Kritiske og høyt prioriterte tester er gjennomført eller planlagt.
- Åpne defects og risikoer er vurdert.
- Testresultat eller testoppsummering er kommunisert.

Antakelser og spørsmål
- <antakelse eller spørsmål>

Akseptansekriterier og Definition of Done er forskjellige ting:

• Akseptansekriterier beskriver hva løsningen må gjøre for brukeren eller forretningen.
• Definition of Done beskriver hvilke leveranse- og kvalitetskrav som må være oppfylt før saken kan regnes som ferdig.
• Definition of Entry beskriver hva som bør være klart før teamet starter arbeidet.

Test-beskrivelse

Bruk dette formatet for Xray Test work items:

Formål
<hva testen skal bekrefte>

Precondition
<PRECONDITION-KEY> <kort precondition-tekst>

Teststeg
| Steg | Handling | Data | Forventet resultat |
| --- | --- | --- | --- |
| 1 | <handling> | <testdata for steget> | <forventet resultat> |

Koblet brukerhistorie
<STORY-KEY>

Type
Manuell test. <Automatiseringskandidat senere / Ikke automatiseringskandidat nå>.

Teststegtabellen er obligatorisk i Jira-beskrivelsen for manuelle tester. Bruk alltid kolonnene Steg, Handling, Data og Forventet resultat.

Data kan stå tom hvis steget ikke trenger egen testdata. Hvis data finnes, skal den ligge i teststegtabellen, ikke som egen Testdata-seksjon i Test-beskrivelsen. I CSV skal samme verdi mappes til Data-kolonnen for riktig steg.

Ikke legg Prioritet som egen seksjon i Test-beskrivelsen. Prioritet skal settes i Jira sitt Priority-felt og i CSV-kolonnen Priority.

Precondition-beskrivelse

Bruk dette formatet for Xray Precondition work items:

Precondition
Kunden er innlogget i mobilbanken og har minst ett aktivt debetkort som kan sperres.

Testdata
Fiktiv kunde: Nora Hansen
Korttype: Aktivt debetkort

Brukes for
Tester knyttet til <STORY-KEY> <story summary>.

I CSV skal precondition-innhold også mappes til Precondition specification når Issue type er Precondition. Precondition type skal være Manual, Generic eller Cucumber.

Test Set-beskrivelse

Bruk dette formatet for Test Set:

Formål
Samle manuelle tester for <funksjon eller brukerhistorie>.

Inneholder
- <TEST-KEY> <test summary>
- <TEST-KEY> <test summary>

Koblet brukerhistorie
<STORY-KEY> <story summary>

Test Plan-beskrivelse

Bruk dette formatet for Test Plan:

Formål
Plan for test av <funksjon eller brukerhistorie>.

Scope
- <hva som inngår>

Utenfor scope
- <hva som ikke inngår>

Inneholder
- Test Set: <TEST-SET-KEY> <test set summary>
- Tester: <liste med test keys hvis relevant>

Exit criteria
- Kritiske tester er gjennomført eller eksplisitt utsatt.
- Åpne defects og risikoer er vurdert.
- Testoppsummering er kommunisert.

Test Execution-beskrivelse

Bruk dette formatet for Test Execution:

Formål
Gjennomføring av planlagte tester for <funksjon eller brukerhistorie>.

Testgrunnlag
- Test Plan: <TEST-PLAN-KEY> <test plan summary>
- Test Set: <TEST-SET-KEY> <test set summary>

Utførelse
- Miljø: <testmiljø>
- Utføres av: <rolle/navn hvis kjent>
- Status: Ikke startet

Rapportering
Resultater, defects og risikoer oppsummeres etter gjennomføring.

Beslutning: Opprette eller oppdatere

Når brukeren ber om å opprette:

• Opprett Story først hvis den ikke finnes.
• Opprett Precondition, Test, Test Set, Test Plan og Test Execution etter behov.
• Lenke Story til Tests med Jira link type Test, slik at Story viser is tested by og Test viser tests. Bruk inwardIssue = Test og outwardIssue = Story.
• Lenke Precondition, Test Set, Test Plan og Test Execution til relevante Tests med Jira link type Relates, med mindre brukeren har bestemt en annen standard.
• Bruk Jira keys fra opprettede work items i CSV-en.
• Bruk midlertidige Issue Id-verdier bare for work items som ikke finnes i Jira ennå.

Når brukeren ber om å oppdatere:

• Hent eksisterende Story og relevante Xray-work items.
• Ikke endre eksisterende innhold uten at brukeren har bedt om det.
• Bruk eksisterende Jira issue id i Issue Id og eksisterende Jira key i Issue key.
• Opprett eller kontroller Jira-links med MCP før CSV-en lages.
• Lag CSV for teststeg og Xray-spesifikke felt som må importeres manuelt.

Når brukeren ber om CSV for work items som allerede er opprettet:

• Ikke opprett nye Story/Test/Precondition/Test Set/Test Plan/Test Execution med mindre brukeren eksplisitt ber om det.
• Be om eller finn relevante keys: Story, Tests, Preconditions, Test Set, Test Plan og Test Execution.
• Hent alle relevante work items med MCP.
• Hent id, key, summary, description, issuetype, priority, labels og relevante links.
• Kontroller at testene har eller kan få teststeg fra beskrivelse, repo-output eller brukerens grunnlag.
• Kontroller at Preconditions i CSV bruker Precondition issue keys, og at Test sets bruker Test Set issue keys.
• Kontroller at Test Plan og Test Execution bare omtales i importnotatet og lenkes med MCP, ikke legges som CSV-rader.
• Lag CSV og importnotat basert på de eksisterende work itemene.
• Hvis nødvendig informasjon mangler, spør etter akkurat den informasjonen eller marker det som antakelse i importnotatet. Ikke finn på issue keys.

CSV-regler

Bruk semikolon som skilletegn.

Bruk standardheaderen fra references/xray-csv-format.md. Start med full header og fjern bare kolonner som er tomme i alle rader.

Issue Id;Issue key;Issue type;Summary;Description;Test Type;Precondition type;Priority;Component;Action;Data;Result;Unstructured definition;Gherkin definition;Precondition specification;Link;Test sets;Preconditions;Labels

Regler:

• Issue Id: bruk Jira sin numeriske issue id for eksisterende Test work items. For nye tester uten Jira-id kan du bruke midlertidig gruppe-id som 1, 2, 3.
• Issue key: bruk Jira key for eksisterende work items. La feltet stå tomt for nye work items som skal opprettes ved import.
• Issue type: Jira/Xray issue type. Bruk som standard bare Test, Precondition og Test Set i Test Case Importer-CSV-en.
• Description: Jira-beskrivelse for work item. Bruk beskrivelsesmalene over.
• Test Type: Xray sin testtype. Gyldige verdier er normalt Manual, Generic eller Cucumber.
• Precondition type: brukes når Issue type er Precondition. Gyldige verdier følger Xray-testtypene: Manual, Generic eller Cucumber.
• Component: komponenter. Ved flere komponenter: separer med semikolon i samme celle.
• Labels: labels. Ved flere labels: separer med semikolon i samme celle.
• Unstructured definition: brukes for Generic/Unstructured-tester der stegene ikke er strukturert som action/data/result.
• Gherkin definition: brukes for Cucumber-tester.
• Precondition specification: brukes for innholdet i en Precondition.
• Link: valgfritt. Bruk bare når brukeren eksplisitt vil mappe link-felt i Xray-importeren. Standard er å opprette Jira-links med MCP og la Link stå tom.
• Test sets: Test Set issue keys. Ved flere keys: separer med semikolon i samme celle.
• Preconditions: Precondition issue keys. Ved flere keys: separer med semikolon i samme celle.
• Action, Data, Result: ett teststeg per rad. Data er testdata for steget og skal ikke erstattes av en egen Testdata-seksjon.

Ikke legg til Step number hvis Xray-oppsettet forventer at rekkefølgen følger radrekkefølgen.

Ikke bland Issue type og Test Type. Issue type er work item-typen, for eksempel Test. Test Type er Xray-testtypen, for eksempel Manual.

Når Labels, Component, Preconditions, Test sets eller eventuelt Link inneholder flere verdier, må cellen quotes fordi CSV-en er semikolonseparert. Eksempel: "regression;manual;payments" eller "PROJ-8;PROJ-21".

Fjern kolonner som er tomme i alle rader før import. Det gjør Xray-mappingen enklere og reduserer risiko for feil mapping. Behold bare kolonner som faktisk har minst én verdi.

Jira-links med MCP

Bruk MCP for standardlenker i stedet for å bruke CSV-kolonnen Link, fordi Xray-importerens Link-mapping har mange valg og er lett å mappe feil.

Anbefalt standard:

• Story til Test: link type Test.
  • Story viser is tested by.
  • Test viser tests.
  • Bruk alltid inwardIssue = Test og outwardIssue = Story i MCP createIssueLink.
  • Feil retning: inwardIssue = Story, outwardIssue = Test gir Story tests Test – feil.
  • Mnemonic: "Story is tested by Test" → inward=Test, outward=Story.
• Test til Precondition: link type Relates.
• Test til Test Set: link type Relates.
• Test til Test Plan: link type Relates.
• Test til Test Execution: link type Relates.
• Bug til Story eller Test: bruk prosjektets avtalte standard. Hvis ingen standard er gitt, bruk ikke automatisk lenking uten å spørre.

Kontroller alltid tilgjengelige link types før lenking hvis prosjektet er nytt eller ukjent.

Ikke legg Test Plan og Test Execution inn som egne CSV-rader som standard. Opprett og lenk dem med MCP. Test Case Importer kan avvise disse issue typene selv om de finnes i Jira/Xray-prosjektet.

Ved bruk av Atlassian MCP

Når MCP er tilgjengelig:

1. Finn eller opprett Story.
2. Finn eller opprett Precondition work items.
3. Finn eller opprett Test work items.
4. Finn eller opprett Test Set, Test Plan og Test Execution hvis brukeren ber om det.
5. Hent id, key, summary, description, issuetype, priority og labels for alle relevante work items.
6. Hent tilgjengelige Jira link types.
7. Opprett Test-links mellom Story og Tests.
8. Opprett Relates-links mellom Tests og Precondition/Test Set/Test Plan/Test Execution etter behov.
9. Kontroller eksisterende issue links.
10. Hent alle opprettede eller brukte work items på nytt, slik at CSV-en bruker faktiske id og key, ikke antatte keys.
11. Lag CSV-en som importgrunnlag for Xray.
12. Lag Markdown-importnotat ved siden av CSV-en.
13. Valider CSV-header, issue ids, issue keys, precondition keys og test set keys før du sier at CSV-en er klar for kontrollert import.
14. Forklar at brukeren må importere CSV-en manuelt i Xray Test Case Importer for teststeg og Xray-spesifikke felt som ikke ble satt av MCP.

Hvis MCP ikke er tilgjengelig, lag CSV med tomme Issue key-felt og midlertidige Issue Id-grupper. Forklar at brukeren kan bruke den som nyimport.

Stegvis arbeidsflyt

Brukeren kan jobbe i flere steg. Det er gyldig å:

1. opprette Story først
2. opprette Tests senere
3. opprette Preconditions, Test Set, Test Plan og Test Execution etterpå
4. lenke work items med MCP
5. til slutt be om CSV basert på det som allerede finnes i Jira

Når brukeren kommer inn på steg 5, skal du ikke kreve at hele flyten kjøres på nytt. Du skal hente eksisterende Jira-data, validere at du har nok informasjon og lage Xray Test Case Importer-CSV + importnotat.

Minimumsinformasjon for å lage CSV fra eksisterende work items:

• minst én Test issue key
• teststeg med handling, data og forventet resultat, enten i Test-beskrivelsen, repo-output eller brukerens melding

Anbefalt informasjon:

• Story issue key
• Precondition issue keys
• Test Set issue key
• Test Plan issue key
• Test Execution issue key
• labels og komponenter

Hvis brukeren bare oppgir Story key, bruk MCP til å finne lenkede Tests og relevante work items. Hvis lenkene mangler, spør om hvilke Test keys som skal med.

Kvalitetssjekk

Sjekk før du sier at CSV-en er klar for kontrollert import:

• Alle tester har minst ett teststeg.
• CSV-headeren er Xray Test Case Importer-format, ikke source_issue_key,link_type,target_issue_key,comment.
• Hver teststeg-rad har Action, Data og Result.
• Test data ligger i Data per steg, ikke bare i beskrivelsesfeltet.
• Radrekkefølgen er riktig.
• Issue type er en gyldig importstøttet type. Bruk Test, Precondition og Test Set som standard.
• Test Type er en gyldig Xray-testtype når raden er en test: Manual, Generic eller Cucumber.
• Precondition type er satt når raden er en precondition.
• Labels er semikolonseparert hvis det finnes flere labels.
• Component er semikolonseparert hvis det finnes flere komponenter.
• Preconditions inneholder bare Precondition issue keys, ikke fritekst eller Story keys.
• Test sets inneholder bare Test Set issue keys.
• Gherkin definition brukes bare når Test Type er Cucumber.
• Unstructured definition brukes bare når testen importeres som ustrukturert/generic etter valgt mapping.
• Første rad per test har summary, description, prioritet og relevant story key.
• Story-beskrivelse har beskrivelse, akseptansekriterier, Definition of Entry og Definition of Done.
• Test-beskrivelse følger formatet med Formål, Precondition, Teststeg-tabell med Steg/Handling/Data/Forventet resultat, Koblet brukerhistorie og Type.
• Precondition-beskrivelse følger formatet med Precondition, Testdata og Brukes for.
• Ingen summaries starter med [MANUELL], [TEST], Manual - eller andre metadata-prefikser.
• Testtype er satt i Test Type og beskrivelse, ikke i summary.
• Senere rader for samme test har samme Issue Id.
• Alle work items som allerede finnes i Jira har både Jira issue id og issue key.
• Standard Jira-links er opprettet med MCP før CSV-en lages.
• CSV-en bruker Jira keys i Test sets og Preconditions.
• Link står tomt med mindre brukeren eksplisitt vil bruke Xray-importerens link-mapping.
• Kolonner som er tomme i alle rader er fjernet før CSV-en leveres.
• Et Markdown-importnotat er laget sammen med CSV-en.
• Det finnes ikke ekte kunde- eller produksjonsdata.
• Antakelser og usikker mapping er skrevet i importnotatet.

Hjelpescript

Hvis du har testdata strukturert som JSON, bruk scripts/build_xray_csv.py for å skrive CSV med riktig quoting og semikolonformat.

Les references/input-schema.md når du trenger JSON-formatet.

Eksempel:

python3 08-skills/xray-csv-import-assistent/scripts/build_xray_csv.py \
  --input 05-output/xray-import.json \
  --output 06-instruktor/xray-testcase-import.csv

Hvis data bare finnes i Markdown, kan du lage CSV direkte, men følg reglene over.

Hvis Markdown eller Jira-beskrivelse følger et lokalt teamformat, skal du bevare intensjonen i formatet og mappe feltene eksplisitt til CSV. Ikke skriv om testdesignet bare for at det skal ligne eksemplene i denne skillen.