xray-playwright-result-assistent

name	xray-playwright-result-assistent
description	Bruk når Copilot skal koble Playwright-testresultater til eksisterende Xray Test og Test Execution issue keys, lage Xray execution result JSON for manuell import, eller forklare Test Execution vs Test Run uten CI/CD.

Xray Playwright resultassistent

Svar på norsk bokmål.

Bruk denne skillen når brukeren har automatiserte Playwright-tester og vil lage en kontrollert Xray-resultatfil for manuell import til en eksisterende Test Execution.

Før du lager resultatfil, les:

• references/xray-result-format.md

Prinsipp

Playwright kjører testen. Xray forvalter testresultatet.

Denne flyten har tre separate lag:

1. Atlassian MCP håndterer Jira work items og vanlige Jira-lenker.
2. Xray CSV-import håndterer Xray-spesifikt testinnhold som teststeg, data, forventet resultat, preconditions og test sets.
3. Xray execution result JSON håndterer resultatet av en testkjøring: PASS, FAIL eller TODO for en Test i en Test Execution.

Skill tydelig mellom:

• Xray Test: selve testcasen, for eksempel BBI-42
• Xray Test Execution: gjennomføringen eller containeren for resultatene, for eksempel BBI-50
• Test Run: resultatinstansen for én Test inne i en Test Execution

Når du importerer resultater til en Test Execution, oppretter eller oppdaterer Xray Test Run-resultater under denne Test Executionen.

Arbeidsflyt

1. Avklar om brukeren vil lime inn keys manuelt eller om Atlassian MCP skal forsøke å hente dem fra Jira.
2. Avklar Test Execution key.
3. Avklar mapping fra Playwright-testnavn til Xray Test keys.
4. Ikke finn på issue keys. Bruk bare keys som brukeren oppgir eller som er hentet fra Jira/Xray.
5. Kjør Playwright eller bruk en eksisterende Playwright JSON-resultatfil.
6. Lag Xray execution result JSON med testExecutionKey og tests.
7. Marker status som PASS, FAIL eller TODO.
8. Skriv kort importnotat: hva filen inneholder, hvilke keys som brukes, og hva som må kontrolleres i Xray etter import.
9. Minn brukeren på at dette er execution results, ikke Xray Test Case Importer-CSV.

Finne keys

Hvis brukeren limer inn keys

Bruk dette som tryggeste og mest kontrollerte workshopflyt.

Be brukeren lime inn:

Test Execution: BBI-50
Tests:
- BBI-42 = kunde kan sperre aktivt debetkort i mobilbanken
- BBI-43 = kunde får feilmelding hvis sperring feiler

Lag eller oppdater mappingfilen slik at Playwright-testnavn matcher riktig Xray Test key.

Hvis Atlassian MCP er tilgjengelig

Atlassian MCP kan brukes til å hente Jira work items og vanlige Jira-lenker.

Forsøk å:

1. Hente Test Execution issue.
2. Hente lenkede work items.
3. Identifisere hvilke lenkede issues som er Xray Tests.
4. Sammenligne testenes summaries med Playwright-testnavn.
5. Foreslå mapping og be brukeren bekrefte før kjøring.

Hvis relasjonene ikke er entydige, stopp og be brukeren lime inn Test Execution key og Test keys manuelt.

Ikke anta at MCP ser Xray sin interne Test Run- eller Test Coverage-modell. MCP brukes her til Jira work items og Jira-lenker, ikke til å konfigurere Xray-resultater direkte.

For bonusappen i repoet

Hvis brukeren jobber i 10-bonus-playwright-best-bank/, kan denne kommandoen brukes:

npm run test:xray -- --execution BBI-50 --map xray-test-map.example.json

For standard bonusdemo med én Playwright-test kan du bruke enklere kommando uten mappingfil:

npm run test:xray -- --execution BBI-50 --test BBI-42

For ekte bruk må BBI-50 byttes med faktisk Test Execution key, og mappingfilen må peke på faktiske Xray Test keys.

Mappingfil:

{
  "tests": [
    {
      "playwrightTitle": "kunde kan sperre aktivt debetkort i mobilbanken",
      "testKey": "BBI-42"
    }
  ]
}

Resultatfilen skrives til xray-results/xray-execution-result.json.

Eksempel på naturlig språk brukeren kan gi Copilot:

Bruk xray-playwright-result-assistent.
Test Execution er BBI-50.
Testen "kunde kan sperre aktivt debetkort i mobilbanken" skal rapporteres til BBI-42.
Kjør Playwright og lag Xray-resultatfil for manuell import.

For bonusappen skal Copilot da normalt gjøre dette selv:

cd 10-bonus-playwright-best-bank
npm run test:xray -- --execution BBI-50 --test BBI-42

Ikke be brukeren lage mappingfil manuelt når det bare gjelder standardtesten i bonusappen.

Ikke gjør dette

• Ikke bruk Test Execution key som testKey.
• Ikke bruk Test key som testExecutionKey.
• Ikke bland dette med CSV-import for teststeg/preconditions/test sets.
• Ikke påstå at dette er full CI/CD-integrasjon.
• Ikke last opp resultatfil til Eika produksjons-Jira uten eksplisitt godkjenning.
• Ikke anta at alle Xray-installasjoner har samme importmeny eller tillatte statusnavn.

Kjernebudskap

Automatisering erstatter ikke testdesign. Automatisering gjenbruker godt testdesign og rapporterer resultatet tilbake til teststyringen.