Azure DevOps - SpiraDocs (2023)

Denne delen skisserer hvordan du bruker SpiraTest, SpiraPlan eller SpiraTeam (heretter referert til som SpiraTeam) i forbindelse med sporingsfunksjonaliteten for arbeidselementer til Microsoft Azure DevOps, også kjent som Microsoft Team Foundation Server (TFS) heretter kalt TFS for korthets skyld.

Den innebygde integrasjonstjenesten lar kvalitetssikringsteamet administrere sine krav og testtilfeller i SpiraTeam, utføre testkjøringer i SpiraTest, og deretter la de nye hendelsene som genereres under kjøringen automatisk lastes inn i TFS. Når hendelsene er lastet inn i TFS som arbeidselementer, kan utviklingsteamet administrere livssyklusen til disse arbeidselementene i TFS, og få statusendringene i TFS til å reflekteres tilbake i SpiraTeam.

På samme måte, ettersom kravene er dekomponert til diskrete prosjektoppgaver i SpiraTeam, vil integrasjonstjenesten automatisk laste disse nye oppgavene inn i TFS som oppgavearbeidselementer der utviklingsteamet kan administrere livssyklusen deres, med tidsplan og fremdriftsendringer i TFS som reflekteres tilbake i SpiraTeam .

Konfigurering av plug-in¶

Neste trinn er å konfigurere plugin-modulen i SpiraTeam slik at systemet vet hvordan det skal få tilgang til TFS-serveren. Inne i SpiraPlan, gå til Administrasjon-siden og naviger til Integration > Data Synchronization. Sjekk om du ser en plug-in kaltMsTfsDataSync, som vist under:

Når plugin-modulen er på plass, klikker du på "rediger"-knappen for å åpne siden med detaljerte innstillinger.

Du må fylle ut følgende felt for at TFS Plug-in skal fungere korrekt:

• Navn: dette må settes tilMsTfsDataSync.
• Bildetekst: dette er visningsnavnet til plugin-en. Normalt kan du bruke noe generisk som "Microsoft TFS", men hvis du har flere TFS-forekomster, vil du kanskje kalle det noe spesifikt som "TFS External". Hvis du ikke angir en verdi, vil visningsnavnet være "MsTfsDataSync"
• Beskrivelse: dette bør settes til en beskrivelse av plugin-modulen. Dette er et valgfritt felt som brukes til dokumentasjonsformål og som faktisk ikke brukes av systemet.
• ADO URL: Grunnadressen du bruker for å koble til Azure DevOps. For Microsoft Azure DevOps Online er det av formatethttps://dev.azure.com/mycompany. Referere tilKB437 angående Microsoft Azure DevOps Onlinefor mer informasjon. For Microsoft Azure DevOps Server, også kjent som Team Foundation Server (TFS), er den av formatethttp://servernavn:8080/tfs/samlingsnavnder 'samlingsnavn' er navnet på prosjektsamlingen du integrerer med.
• ADO-pålogging: Dette skal være en gyldig bruker som har tillatelser til å få tilgang til ADO-forekomsten. Påloggingen må ha tillatelser for å opprette og se arbeidselementer og iterasjoner i ADO. Merk: Ikke ta med Windows Active Directory-domene i dette feltet hvis du bruker en Windows-domenebruker.
• Passord eller PAT: For ADO Server eller TFS Server bør dette settes til passordet til brukeren spesifisert ovenfor. Hvis du bruker Microsoft Azure DevOps Online i stedet for en lokal ADO/TFS-forekomst, må du bruke et Personal Access Token (PAT) for å koble til forekomsten av Azure DevOps fra Spira. Azure DevOps (ADO)
• Tidsforskyvning: normalt skal dette settes til null, men hvis du finner ut at arbeidselementer som endres i TFS ikke oppdateres i SpiraTeam, prøv å øke verdien da dette vil fortelle datasynkroniserings-plugin-modulen å legge til på tidsforskyvningen (i timer) når du sammenligner dato- og klokkeslettstempler. Også hvis TFS-installasjonen din kjører på en server satt til en annen tidssone, bør du legge til antall timers forskjell mellom servernes tidssoner her.

• Auto-kart brukere: Dette endrer måten plugin-en kartlegger brukere i SpiraTeam til de i TFS:

  • Auto-Map = Sant: Med denne innstillingen må alle brukere i SpiraTeam ha samme brukernavn som de i TFS. Hvis dette er tilfelle, trenger du ikke å utføre brukerkartleggingsoppgaven som er skissert i avsnitt 5.2.2. Dette er en stor tidsbesparelse hvis du kan garantere at alle brukernavn er like i begge systemene.
  • Autokart = Falsk: Med denne innstillingen kan brukere i SpiraTeam og TFS ha forskjellige brukernavn fordi du spesifiserer det tilsvarende TFS-navnet for hver bruker som beskrevet i 5.2.2.

• Windows-domene: Dette brukes til å spesifisere Windows Active Directory-domene som Windows-brukeren spesifisert ovenfor er medlem av. For Azure DevOps i skyen bør du la dette feltet stå tomt.

• Oppgavetyper: Dette feltet skal inneholde en kommadelt liste over arbeidselementtyper som du ønsker å synkronisere som Spira-oppgaver i motsetning til hendelser. Normalt ønsker du å liste opp minst ADO 'Task' arbeidselementtypen i dette feltet.
• Spira Artifact ID-felt: Hvis du vil at systemet skal vise Spira-artefakt-IDen (f.eks. IN5 for hendelser eller TK36 for oppgaver) i et tilpasset felt i ADO, bør du bare skrive inn navnet på det aktuelle ADO-feltet fra prosessmalen din (f.eks. Spira.IncidentId ), og når hendelsen eller oppgaven legges til ADO, vil den tilsvarende Spira-IDen bli lagt til det feltet i arbeidselementet.
• Spira detektorfelt: Avhengig av ADO-prosessmalen din, kan det hende at datasynkroniseringspluginen ikke har lov til å stille inn detektoren for hendelsen i ADO. Hvis du vil at systemet skal vise detektoren for hendelsen (som registrert i Spira) i et tilpasset felt i ADO, bør du bare skrive inn navnet på det aktuelle ADO-feltet fra prosessmalen din (f.eks. Spira.Detector) og deretter når hendelsen legges til ADO, vil den tilsvarende detektorens navn bli lagt til det feltet i arbeidselementet.
• Kravtyper: Dette feltet skal inneholde en kommadelt liste over arbeidselementtyper som du ønsker å synkronisere som Spira-krav i motsetning til hendelser. Normalt ønsker du å liste opp minst ADO 'User Story'-arbeidselementtypen i dette feltet.

Konfigurering av datatilordning¶

Deretter må du konfigurere datatilordningen mellom SpiraTeam og TFS. Dette gjør at de ulike prosjektene, brukerne, utgivelsene, hendelsestypene, statusene, prioriteringene og egendefinerte egenskapsverdiene som brukes i de to applikasjonene, kan relateres til hverandre. Dette er viktig, siden uten en korrekt kartlegging er det ingen måte for integrasjonstjenesten å vite at en "Ikke reproduserbar" hendelse i SpiraTeam er det samme som en "Lukket+ Kan ikke gjenskape" feilarbeidselement i TFS (for eksempel).

Følgende kartinformasjon må konfigureres i SpiraTeam:

• Kartleggingen av prosjektidentifikatorene for prosjektene som må synkroniseres
• Kartleggingen avbrukerei systemet
• Kartleggingen avutgivelser(tilsvarer TFS iterasjoner) i systemet
• Kartleggingen av de ulike standardenehendelsefelt i systemet
• Kartleggingen av de ulike skikkenehendelseegenskaper i systemet
• Kartleggingen av de ulike standardenekravfelt i systemet (hvis synkroniseringskrav)
• Kartleggingen av de ulike skikkenekravegenskaper i systemet (hvis synkroniseringskrav)
• Kartleggingen av de ulike standardeneoppgavefelt i systemet (hvis synkroniseringsoppgaver)
• Kartleggingen av de ulike skikkeneoppgaveegenskaper i systemet (hvis synkroniseringsoppgaver)

Merk: Hvis du bruker SpiraTest, trenger du ikke å sette opp de to siste settene med tilordninger, da oppgaver ikke er tilgjengelige i SpiraTest.

Konfigurering av prosjektkartleggingen¶

Fra administrasjonssiden for datasynkronisering må du klikke på hyperkoblingen "View Project Mappings" ved siden av TFS-plugin-navnet. Dette tar deg til startsiden for datakartlegging for det valgte prosjektet:

Hvis prosjektnavnet ikke samsvarer med navnet på prosjektet du vil konfigurere datatilordningen for, klikk på hyperkoblingen "(Endre prosjekt)" for å endre det gjeldende prosjektet.

For å aktivere dette prosjektet for datasynkronisering med TFS, må du angi:

Ekstern nøkkel-- Dette bør settes til navnet på prosjektet i TFS som synlig fra Visual Studio Team Explorer eller nettgrensesnitt:

ELLER

Aktivt flagg-- Sett dette til 'Ja' slik at SpiraTeam vet at du vil synkronisere data for dette prosjektet. Når prosjektet er fullført, setter du verdien til "Nei", stopper datasynkroniseringen, noe som reduserer nettverksutnyttelsen.

Klikk på [Oppdater] for å bekrefte disse innstillingene. Når du har aktivert prosjektet for datasynkronisering, kan du nå angi de andre datakartleggingsverdiene som er skissert nedenfor.

Merk: Når du har konfigurert prosjektet, når du oppretter et nytt prosjekt, bør du velge alternativet "Opprett prosjekt fra eksisterende prosjekt" i stedet for "Bruk standardmal" slik at alle prosjekttilordningene blir kopiert til det nye prosjektet.

Konfigurering av brukerkartlegging¶

For å konfigurere tilordningen av brukere i de to systemene, må du gå til Administrasjon > Brukere > Vis Rediger brukere, som vil få opp listen over brukere i systemet. Klikk deretter på "Rediger"-knappen for en bestemt bruker som skal redigere arbeidselementer i TFS:

Det vil du merke i spesialenDatakartleggingfanen, er det en liste over alle de konfigurerte plugin-modulene for datasynkronisering. I tekstboksen ved siden av TFS Data-Sync-plugin-modulen må du skrive inn hele navnet til denne Windows-brukeren (ikke påloggingen). Dette er navnet på brukeren slik de vises i arbeidselementer i TFS:

Dette vil tillate datasynkroniseringsplugin-modulen å vite hvilken bruker i SpiraTeam som samsvarer med hvilken tilsvarende bruker i TFS. Klikk på [Oppdater] når du har angitt riktig påloggingsnavn. Du bør nå gjenta for de andre brukerne som vil være aktive i begge systemene.

Hvis du har angitt alternativet "Auto-Map Users" i TFS 2012-plugin, kan du hoppe over denne delen helt.

Konfigurering av utgivelseskartlegging¶

Når datasynkroniseringstjenesten kjører, når den kommer over en utgivelse/iterasjon i SpiraTeam som den ikke har sett før, vil den lage en tilsvarende «Iterasjon» i TFS. Tilsvarende hvis den kommer over en ny iterasjon i TFS som den ikke har sett før, vil den opprette en ny utgivelse/Iterasjon i SpiraTeam. Når du bruker begge systemene sammen, anbefales det derfor at du bare legger inn nye utgivelser/gjentakelser i ett system og lar datasynkroniseringstjenesten legge dem til det andre systemet.

Du kan imidlertid starte med situasjonen der du allerede har eksisterende utgivelser/gjentakelser i begge systemene som du må knytte til i datatilordningen. Hvis du ikke gjør dette, kan du oppleve at duplikater blir opprettet når du først aktiverer datasynkroniseringstjenesten. Derfor for alle utgivelser/gjentakelser som allerede eksisterer i BEGGE systemer, gå til Planlegging > Utgivelser og klikk på den aktuelle utgivelsen/gjentakelsen. Sørg for at du har «Oversikt»-fanen synlig, og utvid «Egenskaper»-delen av utgivelsen/iterasjonen:

I tillegg til standardfeltene og egendefinerte egenskaper som er konfigurert for utgivelser, vil du se en ekstra tekstegenskap kalt "MsTfsDataSync ID" som brukes til å lagre den tilordnede eksterne identifikatoren for den tilsvarende versjonen i TFS. Du må finne IDen til den tilsvarende iterasjonen i TFS, skriv den inn i denne tekstboksen og klikk på [Lagre]. Du bør nå gjenta for alle andre allerede eksisterende utgivelser.

TFS Iteration ID er ikke synlig i TFS-brukergrensesnittet, men kan i stedet lokaliseres ved å åpne opp SQL Serveren som den er installert på, åpne 'TfsWorkItemTracking'-databasen (i TFS 2010 vil den i stedet få navn etter prosjektsamlingen din) og finne 'TreNodes'-tabellen:

Når du har funnet den matchende iterasjonen (etter navn), er den numeriske verdien som er lagret i ID-kolonnen (den til venstre) verdien som må legges til som MsTfsDataSync ID inne i SpiraTeam.

Konfigurering av standard hendelsesfeltkartlegging¶

Nå som prosjektene, brukeren og utgivelsene er kartlagt riktig, må vi konfigurere standard hendelsesfelt. For å gjøre dette, gå til Administrasjon > System > Datasynkronisering og klikk på "View Project Mappings" for MsTfsDataSync-plugin-oppføringen:

Fra denne skjermen må du klikke på Prioritet, Alvorlighet, Status og Type etter tur for å konfigurere verdiene deres:

a) Hendelsestype¶

Klikk på "Type"-hyperlenken under Hendelsesstandardfelt for å få opp skjermbildet for kartlegging av hendelsestype:

Tabellen viser hver av hendelsestypene som er tilgjengelige i SpiraTeam og gir deg muligheten til å angi det samsvarende TFS-arbeidselementtypenavnet for hver enkelt. For å gjøre dette enklere, anbefaler vi at du i skjermbildet Administrasjon > Rediger hendelsesstatuser først gjør alle hendelsestyper inaktive unntattRisiko, problemogBugsiden bare disse typene er fornuftige å synkronisere med TFS.

b) Hendelsesstatus¶

Klikk på "Status"-hyperlenken under Standard Felt for hendelser for å få opp skjermbildet for kartlegging av hendelsesstatus:

Tabellen viser hver av hendelsesstatusene som er tilgjengelige i SpiraTeam og gir deg muligheten til å legge inn det matchende TFS-arbeidselementetTilstand + grunnellerStatfor hver eneste.

TFS bruker separat tilstandskode (aktiv, løst, lukket) og årsak (fast, duplisert, ikke løst, etc.) i motsetning til SpiraTeam som bruker en enkelt statuskode. For maksimal fleksibilitet kan integrasjonen fungere med enten en kartlagtStateller en kartlagtTilstand+grunn.

Hvis du vil at SpiraTeam-statuser skal peke til en spesifikk TFS-arbeidselementtilstand og en spesifikk årsak knyttet til den tilstanden, må du sette sammen TFS-tilstanden og -grunnen sammen med et plusstegn (+) slik at systemet vet at hendelsesstatus i SpiraTeam tilsvarer den spesifikke kombinasjonen.

Hvis du vil ha SpiraTeam-statuser ganske enkelt peke til en spesifikk TFS-arbeidselementstatus og la TFS tildele standardårsaken for den tilstanden, tilordner du ganske enkelt SpiraTeam-statusene til staten:

Du kan tilordne flere SpiraTeam-felt til de samme TFS-feltene (f.eks. Ny og Åpen i SpiraTeam tilsvarer begge 'Aktiv+Ny' i TFS), i så fall kan bare én av de to verdiene vises som Primær = Ja, da det er verdi som brukes på omvendt synkronisering (fra TFS > SpiraTeam).

Vi anbefaler at du alltid peker på Ny og Åpen-statusene inne i SpiraTeam for å peke på "Aktiv+Ny" TFS-status+årsak, og gjør Åpne i SpiraTeam til Primærstatus for de to. Dette anbefales slik at etter hvert som nye hendelser i SpiraTeam blir synkronisert til TFS, vil de byttes til "Aktiv+Ny"-status i TFS som deretter vil bli synkronisert tilbake til "Åpen" i SpiraTeam. På den måten vil du på et øyeblikk kunne se hvilke hendelser som har blitt synkronisert med TFS og de som ikke har det.

c) Hendelsesprioritet¶

Klikk på hyperkoblingen "Priority" under Incident Standard Fields for å få opp skjermbildet for kartlegging av hendelsesprioritet:

Tabellen viser hver av hendelsesprioriteringene som er tilgjengelige i SpiraTeam og gir deg muligheten til å angi den samsvarende TFS-prioritetsverdien for hver enkelt. For å gjøre dette enklere, anbefaler vi at du i skjermbildet Administrasjon > Rediger hendelsesprioriteter først gjør eventuelle statuser som ikke brukes i TFS inaktive i SpiraTeam.

d) Alvorlighetsgrad av hendelsen¶

Klikk på hyperkoblingen "Alvorlighetsgrad" under Standardfelt for hendelser for å få opp skjermbildet for kartlegging av alvorlighetsgrad for hendelser:

Tabellen viser hver av hendelsens alvorlighetsgrad som er tilgjengelig i SpiraTeam og gir deg muligheten til å angi den samsvarende TFS-alvorlighetsverdien for hver enkelt. For å gjøre dette enklere, anbefaler vi at du i skjermbildet Administrasjon > Rediger alvorlighetsgrad for hendelser først gjør eventuelle statuser som ikke brukes i TFS inaktive i SpiraTeam.

Konfigurere den tilpassede egenskapskartleggingen for hendelsen¶

Nå som de ulike SpiraTeam standard hendelsesfeltene er kartlagt riktig, må vi konfigurere de tilpassede egenskapskartleggingene. Dette brukes for både egendefinerte egenskaper i SpiraTeam som kartlegger til egendefinerte felt i TFS og også for egendefinerte egenskaper i SpiraTeam som brukes til å kartlegge til standardfelt i TFS (f.eks. Area) som ikke finnes i SpiraTeam.

Fra skjermbildet Vis/rediger prosjektdatakartlegging må du klikke på navnet på den egendefinerte hendelseseiendommen du vil legge til datakartleggingsinformasjon for:

a) TFS sitt Arealfelt¶

Først må du gå til Administrasjon > Rediger tilpassede lister og lage en ny tilpasset liste som inneholder alle de forskjellige områdene som brukes i TFS.

Deretter må du gå til Administrasjon > Rediger egendefinerte egenskaper og legge til en nylisteegendefinert egenskap til hendelsesartefakttypen kalt 'Area' og koble den til den tilpassede området Area-listen du opprettet i forrige trinn. Denne vil nå være tilgjengelig for kartlegging.

Nå, tilbake på datakartleggingssiden, klikker du på hyperkoblingen 'Område' under Egendefinerte egenskaper for hendelse for å få opp skjermbildet for tilpasset egenskapskartlegging:

Først må du skrive inn ordet "Area" som den eksterne nøkkelen til den tilpassede egenskapen. Dette forteller datasynkroniserings-plugin-modulen at den tilpassede egenskapen i SpiraTeam skal tilordnes til innebygd område-felt i TFS.

Neste for hver av egenskapsverdiene i tabellen (på nedre halvdel av siden) må du angi entenOmråde IDellerOmrådestiav de ulike områdene som er konfigurert i TFS. TFS-område-ID-en er ikke synlig i TFS-brukergrensesnittet, men kan i stedet lokaliseres ved å åpne opp SQL-serveren som den er installert på, åpne 'TfsWorkItemTracking'-databasen (i TFS 2010 og senere vil den i stedet få navn etter prosjektsamlingen din) og finne 'TreeNodes'-tabellen:

Når du har funnet det samsvarende området (ved navn), er den numeriske verdien lagret i ID-kolonnen (den til venstre) verdien som må legges til som den eksterne nøkkelen i SpiraTeam.

For Azure DevOps i skyen er det vanligvis enklere å bare kartlegge områdene til de riktige banene i stedet (siden ID-ene ikke er lett å finne):

b) Egendefinerte TFS-felt¶

Hvis det tilpassede feltet i TFS er et listefelt, må du først gå til Administrasjon > Rediger tilpassede lister i SpiraTeam og opprette en ny tilpasset liste som inneholder alle de forskjellige verdiene som brukes i TFS.

Så for både listefelt og verdifelt må du gå til Administrasjon > Rediger egendefinerte egenskaper og legge til en ny egendefinert egenskap på hendelsesartefakttypen med navnet på det aktuelle TFS-feltet (f.eks. Triage, Rangering, etc.) og hvis et listefelt, koble det til den egendefinerte listen du opprettet i forrige trinn. Den egendefinerte egenskapen vil nå være tilgjengelig for datakartlegging.

Nå, tilbake på siden for datasynkronisering av datatilordning, klikker du på hyperkoblingen under Egendefinerte egenskaper for hendelse som tilsvarer den egendefinerte egenskapen for å få opp skjermbildet for tilpasset egenskapskartlegging:

Først må du skrive inn helereferansenavnav TFS-feltet som den eksterne nøkkelen til den tilpassede egenskapen. Dette forteller datasynkroniserings-plugin-modulen at den tilpassede egenskapen i SpiraTeam skal tilordnes dette spesifikke feltet i TFS. For å se en liste over felt og deres referansenavn, kan du kjøre følgende SQL-spørring mot TFS-databasen din:

VELG Navn, Referansenavn FRA felt ORDER BY Name

Vi har inkludert en liste over felt i Agile prosessmalen iTFS-feltreferansesom en nyttig referanse.

Neste for hver av egenskapsverdiene i tabellen (i nedre halvdel av siden) må du angi navnet på feltverdiene slik de vises i TFS som den eksterne nøkkelen.

Konfigurering av standard oppgavefelttilordning¶

Nå som prosjektene, brukeren, utgivelsene og hendelsesfeltene er riktig kartlagt, må vi konfigurere standard oppgavefeltene. For å gjøre dette, gå til Administrasjon > System > Datasynkronisering og klikk på "View Project Mappings" for MsTfsDataSync-plugin-oppføringen:

Fra denne skjermen må du klikke på Prioritet og Status etter tur for å konfigurere verdiene deres:

a) Oppgavestatus¶

Klikk på "Status"-hyperlenken under Task Standard Fields for å få opp skjermbildet for Oppgavestatuskartlegging:

Tabellen viser hver av oppgavestatusene som er tilgjengelige i SpiraTeam, og gir deg muligheten til å angi samsvarende TFS-arbeidselementstatus for hver enkelt. I motsetning til kartleggingen for hendelser (se ovenfor) sporer ikke SpiraTeam årsakskodene knyttet til oppgavene i MS TFS, så du trenger kun å kartlegge tilstandsnavnene fra TFS med oppgavestatusnavnene.

Du kan tilordne flere SpiraTeam-felt til de samme TFS-feltene (f.eks. Blocked, Completed og Deferred i SpiraTeam tilsvarer alle State= Closed i TFS), i så fall kan bare én av verdiene vises som Primær = Ja, da det er verdien som brukes på omvendt synkronisering (fra TFS > SpiraTeam).

b) Oppgaveprioritet¶

Klikk på hyperkoblingen "Priority" under Task Standard Fields for å få opp skjermbildet Task Priority Mapping-konfigurasjon:

c) Oppgavetype¶

Klikk på "Type"-hyperlenken under Task Standard Fields for å få opp skjermbildet Task Type mapping:

Tabellen viser hver av oppgavetypeverdiene som er tilgjengelige i SpiraTeam, og gir deg muligheten til å angi den matchende TFS-arbeidselementtypeverdien for hver enkelt.

Tabellen viser hver av oppgaveprioriteringene som er tilgjengelige i SpiraTeam og gir deg muligheten til å angi den matchende TFS-prioritetsverdien for hver enkelt.

Konfigurering av egendefinert oppgavetilordning¶

Nå som de forskjellige SpiraTeam-standardoppgavefeltene er tilordnet riktig, må vi konfigurere de tilpassede egenskapstilordningene. Dette brukes for både egendefinerte egenskaper i SpiraTeam som kartlegger til egendefinerte felt i TFS og også for egendefinerte egenskaper i SpiraTeam som brukes til å kartlegge til standardfelt i TFS (f.eks. Area) som ikke finnes i SpiraTeam.

Fra skjermbildet Vis/rediger prosjektdatakartlegging må du klikke på navnet på den egendefinerte oppgaveegenskapen som du vil legge til datakartleggingsinformasjon for:

a) TFS sitt Arealfelt¶

Først må du gå til Administrasjon > Rediger tilpassede lister og lage en ny tilpasset liste som inneholder alle de forskjellige områdene som brukes i TFS.

Deretter må du gå til Administrasjon > Rediger egendefinerte egenskaper og legge til en nylisteegendefinert egenskap til oppgaveartefakttypen kalt 'Area' og koble den til den tilpassede områdelisten du opprettet i forrige trinn. Denne vil nå være tilgjengelig for kartlegging.

Nå, tilbake på datakartleggingssiden, klikker du på hyperkoblingen 'Område' under Egendefinerte oppgaveegenskaper for å få opp skjermbildet for tilpasset egenskapskartlegging:

Først må du skrive inn ordet "Area" som den eksterne nøkkelen til den tilpassede egenskapen. Dette forteller datasynkroniserings-plugin-modulen at den tilpassede egenskapen i SpiraTeam skal tilordnes til innebygd område-felt i TFS.

Neste for hver av egenskapsverdiene i tabellen (i nedre halvdel av siden) må du angi IDen eller banen til de forskjellige områdene som er konfigurert i TFS. TFS-område-ID-en er ikke synlig i TFS-brukergrensesnittet, men kan i stedet lokaliseres ved å åpne opp SQL-serveren som den er installert på, åpne 'TfsWorkItemTracking'-databasen (i TFS 2010 og senere vil den i stedet få navn etter prosjektsamlingen din) og finne 'TreeNodes'-tabellen:

Når du har funnet det samsvarende området (ved navn), er den numeriske verdien lagret i ID-kolonnen (den til venstre) verdien som må legges til som den eksterne nøkkelen i SpiraTeam.

For Azure DevOps i skyen er det vanligvis enklere å bare kartlegge områdene til de riktige banene i stedet (siden ID-ene ikke er lett å finne):

b) Egendefinerte TFS-felt¶

Hvis det tilpassede feltet i TFS er et listefelt, må du først gå til Administrasjon > Rediger tilpassede lister i SpiraTeam og opprette en ny tilpasset liste som inneholder alle de forskjellige verdiene som brukes i TFS.

Så for både listefelt og verdifelt må du gå til Administrasjon > Rediger egendefinerte egenskaper og legge til en ny egendefinert egenskap på oppgaveartefakttypen med navnet på det aktuelle TFS-feltet (f.eks. Disiplin, Stack Rank, etc.) og hvis et listefelt, koble det til den egendefinerte listen du opprettet i forrige trinn. Den egendefinerte egenskapen vil nå være tilgjengelig for datakartlegging.

Nå, tilbake på siden for datasynkronisering av datatilordning, klikker du på hyperkoblingen under Egendefinerte oppgaveegenskaper som tilsvarer den egendefinerte egenskapen for å få opp skjermbildet for tilpasset egenskapskartlegging:

Først må du skrive inn helereferansenavnav TFS-feltet som den eksterne nøkkelen til den tilpassede egenskapen. Dette forteller datasynkroniserings-plugin-modulen at den tilpassede egenskapen i SpiraTeam skal tilordnes dette spesifikke feltet i TFS. For å se en liste over felt og deres referansenavn, kan du kjøre følgende SQL-spørring mot TFS-databasen din:

VELG Navn, Referansenavn FRA felt ORDER BY Name

Vi har inkludert en liste over felt i Agile prosessmalen iTFS-feltreferansesom en nyttig referanse.

Neste for hver av egenskapsverdiene i tabellen (i nedre halvdel av siden) må du angi navnet på feltverdiene slik de vises i TFS som den eksterne nøkkelen.

Konfigurering av standard kravfelttilordning (kun 2012 plugin)¶

Nå som prosjektene, brukeren, utgivelsene, hendelsen og oppgavefeltene er riktig kartlagt, må vi konfigurere standard kravfelt. For å gjøre dette, gå til Administrasjon > System > Datasynkronisering og klikk på "View Project Mappings" for MsTfsDataSync-plugin-oppføringen:

Fra denne skjermen må du klikke på Viktighet og Status etter tur for å konfigurere verdiene deres:

a) Kravstatus¶

Klikk på "Status"-hyperlenken under Kravstandardfelt for å få opp skjermbildet Kravstatuskartlegging:

Tabellen viser hver av kravstatusene som er tilgjengelige i SpiraTeam, og gir deg muligheten til å angi samsvarende TFS-arbeidselementstatus for hver enkelt. I motsetning til kartleggingen for hendelser (se ovenfor) sporer ikke SpiraTeam årsakskodene knyttet til kravene i MS TFS, så du trenger kun å kartlegge tilstandsnavnene fra TFS med kravstatusnavnene.

Du kan tilordne flere SpiraTeam-felt til de samme TFS-feltene, i så fall kan bare én av verdiene vises som Primær = Ja, da det er verdien som brukes på omvendt synkronisering (fra TFS > SpiraTeam).

b) Krav betydning¶

Klikk på hyperkoblingen "Viktighet" under Kravstandardfelt for å få opp skjermbildet for kartlegging av kravviktighet:

Tabellen viser hver av kravenes viktighetsverdier som er tilgjengelige i SpiraTeam og gir deg muligheten til å angi den samsvarende TFS-arbeidselementprioritetsverdien for hver enkelt.

c) Kravtype¶

Klikk på hyperkoblingen "Type" under Kravstandardfelt for å få opp skjermbildet for tilordning av kravtypetilordning:

Tabellen viser hver av kravtypeverdiene som er tilgjengelige i SpiraTeam, og gir deg muligheten til å angi den matchende TFS arbeidselementtypeverdien for hver enkelt.

Konfigurering av kravet tilpasset egenskapskartlegging¶

Nå som de ulike SpiraTeam-standardkravsfeltene er tilordnet riktig, må vi konfigurere de tilpassede egenskapstilordningene. Dette brukes for både egendefinerte egenskaper i SpiraTeam som kartlegger til egendefinerte felt i TFS og også for egendefinerte egenskaper i SpiraTeam som brukes til å kartlegge til standardfelt i TFS (f.eks. Area) som ikke finnes i SpiraTeam.

Fra skjermbildet Vis/rediger prosjektdatakartlegging må du klikke på navnet på den egendefinerte kravegenskapen som du vil legge til datakartleggingsinformasjon for:

a) TFS sitt Arealfelt¶

Først må du gå til Administrasjon > Rediger tilpassede lister og lage en ny tilpasset liste som inneholder alle de forskjellige områdene som brukes i TFS.

Deretter må du gå til Administrasjon > Rediger egendefinerte egenskaper og legge til en nylisteegendefinert egenskap til kravartefakttypen kalt 'Area' og koble den til den tilpassede områdelisten du opprettet i forrige trinn. Denne vil nå være tilgjengelig for kartlegging.

Nå, tilbake på datakartleggingssiden, klikker du på hyperkoblingen 'Område' under Egendefinerte egenskaper for krav for å få opp skjermbildet for tilpasset egenskapskartlegging:

Først må du skrive inn ordet "Area" som den eksterne nøkkelen til den tilpassede egenskapen. Dette forteller datasynkroniserings-plugin-modulen at den tilpassede egenskapen i SpiraTeam skal tilordnes til innebygd område-felt i TFS.

Neste for hver av egenskapsverdiene i tabellen (i nedre halvdel av siden) må du angi IDen eller banen til de forskjellige områdene som er konfigurert i TFS. TFS-område-ID-en er ikke synlig i TFS-brukergrensesnittet, men kan i stedet lokaliseres ved å åpne opp SQL-serveren som den er installert på, åpne 'TfsWorkItemTracking'-databasen (i TFS 2010 og senere vil den i stedet få navn etter prosjektsamlingen din) og finne 'TreeNodes'-tabellen:

Når du har funnet det samsvarende området (ved navn), er den numeriske verdien lagret i ID-kolonnen (den til venstre) verdien som må legges til som den eksterne nøkkelen i SpiraTeam.

For Azure DevOps i skyen er det vanligvis enklere å bare kartlegge områdene til de riktige banene i stedet (siden ID-ene ikke er lett å finne):

b) Egendefinerte TFS-felt¶

Hvis det tilpassede feltet i TFS er et listefelt, må du først gå til Administrasjon > Rediger tilpassede lister i SpiraTeam og opprette en ny tilpasset liste som inneholder alle de forskjellige verdiene som brukes i TFS.

Så for både listefelt og verdifelt må du gå til Administrasjon > Rediger tilpassede egenskaper og legge til en ny egendefinert egenskap på Krav-artefakttypen med navnet på det aktuelle TFS-feltet (f.eks. Risk, Stack Rank, etc.) og hvis et listefelt, koble det til den egendefinerte listen du opprettet i forrige trinn. Den egendefinerte egenskapen vil nå være tilgjengelig for datakartlegging.

Tilbake på siden for datasynkronisering av datatilordning, klikk på hyperkoblingen under Egendefinerte egenskaper for krav som tilsvarer den egendefinerte egenskapen for å få opp skjermbildet for tilpasset egenskapskartlegging:

Først må du skrive inn helereferansenavnav TFS-feltet som den eksterne nøkkelen til den tilpassede egenskapen. Dette forteller datasynkroniserings-plugin-modulen at den tilpassede egenskapen i SpiraTeam skal tilordnes dette spesifikke feltet i TFS. For å se en liste over felt og deres referansenavn, kan du kjøre følgende SQL-spørring mot TFS-databasen din:

VELG Navn, Referansenavn FRA felt ORDER BY Name

Vi har inkludert en liste over felt i Agile prosessmalen iTFS-feltreferansesom en nyttig referanse.

Neste for hver av egenskapsverdiene i tabellen (i nedre halvdel av siden) må du angi navnet på feltverdiene slik de vises i TFS som den eksterne nøkkelen.

Når du har oppdatert de ulike kartseksjonene, er du nå klar til å starte tjenesten.

Bruker SpiraTeam med TFS¶

Nå som integrasjonstjenesten er konfigurert og tjenesten startet, vil i utgangspunktet alle hendelser som allerede er opprettet i SpiraTeam for de spesifiserte prosjektene bli importert til TFS og eventuelle krav, oppgaver eller feil som allerede er opprettet i TFS vil bli importert til SpiraTeam. På dette tidspunktet anbefaler vi å åpne Windows Event Viewer og velge applikasjonsloggen. I denne loggen vil eventuelle feilmeldinger fra SpiraTeam Data Sync Service vises. Hvis du ser noen feilmeldinger på dette tidspunktet, anbefaler vi å stoppe SpiraTeam-tjenesten umiddelbart og sjekke de ulike kartoppføringene. Hvis du ikke kan se noen arbeidselementer med kartleggingsinformasjonen, anbefaler vi å sende en kopi av hendelsesloggmeldingen(e) til Inflectra kundeservice (support@inflectra.com) som vil hjelpe deg med å feilsøke problemet.

For å bruke SpiraTeam med TFS på løpende basis, anbefaler vi at følgende generelle prosesser følges:

Når du kjører tester i SpiraTest eller SpiraTeam, bør oppdagede defekter logges gjennom testkjøringsveiviseren som normalt.

Når en hendelse har blitt opprettet under kjøringen av testen, vil den nå fylles ut i TFS som et arbeidselement av typen som tilsvarer typene oppsettet i hendelsestypetilordningene.

På dette tidspunktet kan hendelsen jobbes med i begge systemene, med endringer som synkroniseres med det andre systemet. Generelt anbefaler vi imidlertid at QA/Testing-teamet bruker SpiraTeam og utviklingsteamet bruker TFS. f.eks. Utviklerne vil merke feilene som løst i MSTS når de har fullført å fikse dem, og QA-teamet vil enten gjenåpne eller lukke deretter i SpiraTeam når de har fått en endring for å bekrefte løsningen.

Du kan nå utføre testdekning og hendelsesrapportering inne i SpiraTest/SpiraTeam ved å bruke testsakene administrert av SpiraTest/SpiraTeam og hendelsene som administreres i samarbeid mellom SpiraTest/SpiraTeam og TFS.

Du kan opprette prosjektkrav og tilknyttede oppgaver i enten SpiraTeam eller TFS, men synkroniseringstjenesten er kun ensrettet for krav og oppgaver, så når du oppretter eller oppdaterer et krav eller oppgave i TFS, vil endringen reflekteres i SpiraTeam, men ikke motsatt.

Beskrivelse Håndtering¶

Mens Spira har en enkelt artefaktBeskrivelsefeltet, har ADO/TFS tre mulige "Beskrivelse"-felt avhengig av malene som er satt opp av en administrator:

• Microsoft.VSTS.TCM.ReproSteps(rik tekst)
• Microsoft.VSTS.Common.DescriptionHtml(rik tekst)
• Systembeskrivelse(ren tekst)

Programtillegget sjekker for hver av dem i rekkefølgen ovenfor. Den vil synkronisere beskrivelsen i Spira med den av disse den finner først. Så hvis du har både ReproSteps og Description (for eksempel), vil den bruke ReproSteps.

Hvis du trenger begge feltene i Spira, anbefaler vi å lage to separate egendefinerte rik tekstegenskaper og tilordne hver av disse til de i ADO/TFS.

Feilsøking¶

I de fleste tilfeller når du har startet tjenesten, vil du ikke se noen feil- eller advarselsmeldinger fra Data-Sync-tjenesten når den er i gang. Men hvis du har nye brukere opprettet i SpiraTeam som ikke er tilordnet brukere i TFS, når du tilordner hendelser, krav eller oppgaver til disse elementene, kan du se advarsler i Event Viewer som forteller deg hvilke brukere som må tilordnes .

TFS-feltreferanse¶

Følgende felt er tilgjengelige i TFS for datakartlegging ved bruk av TFS smidig prosessmal:

For en fullstendig liste over de tilgjengelige TFS-feltene i de forskjellige prosessmalene, se:http://msdn.microsoft.com/en-us/library/vstudio/dd997792.aspx