Retningslinjer for testpakke

  • Artikkel

Viktig

Testbasen for Microsoft 365 går over til slutten av levetiden (EOL) 31. mai 2024. Vi er forpliktet til å samarbeide tett med hver kunde for å gi støtte og veiledning for å gjøre overgangen så jevn som mulig. Hvis du har spørsmål, bekymringer eller trenger hjelp, kan du sende inn en støtteforespørsel.

1. Skriptreferanse

Når du laster opp en .zip-fil til portalen, vil vi pakke ut alt innholdet i filen i en rotmappe. Du trenger ikke å skrive noen kode for å utføre denne første pakkeoperasjonen. Du kan også referere til en fil i .zip ved å bruke banen i forhold til den opplastede ZIP-filen.

I eksemplet nedenfor viser vi hvordan du kan referere til binærfiler/skript fra inndatafeltet på Oppgaver-fanen. Teksten i blått skal skrives inn i skriptbanefeltetuten anførselstegn.

Det er viktig at du er klar over innholdet i ZIP-filen før du laster den opp. Ofte når du pakker inn en mappe, oppretter den lokale maskinen en hovedmappe under ZIP-filen. I dette tilfellet vil referansen være som vist i fet skrift nedenfor:

Contoso_App_Folder.zip:

├── Contoso_App_Folder

│   ├── file1.exe

│   ├── ScriptX.ps1

│   ├── folder1

│      ├── file3.exe

│      ├── script.ps1
  • ScriptX.ps1 – «Contoso_App_Folder/ScriptX.ps1»
  • Script.ps1 – Contoso_App_Folder/mappe1/script.ps1

Andre ganger kan zip-filen ha filer eller innhold rett under den (for eksempel ingen mappe på andre nivå):

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1
  • ScriptX.ps1 - "ScriptX.ps1"
  • Script.ps1 – «mappe1/script.ps1»

2. Kjøring av skript

Out-of-Box tester: Programpakken må inneholde minst tre PowerShell-skript. Disse skriptene kjører uovervåket installasjon, oppstart og lukking av programmet og dets avhengigheter. Hvert skript bør håndtere kontroll av sine egne forutsetninger, validere sin egen suksess og rydde opp etter seg selv (om nødvendig).

Funksjonelle tester: Programpakken må inneholde minst ett PowerShell-skript. Når mer enn ett skript er angitt, kjøres skriptene i opplastingssekvens, og en feil i et bestemt skript vil hindre påfølgende skript fra å kjøre.

Skriptkrav

  • PowerShell versjon 5.1+
  • Uovervåket kjøring
  • Feilreturkode
  • Valider vellykket
  • Logger til skriptspesifikk loggmappe

Hvert skript må kjøre uovervåket (ingen brukermeldinger) for å kunne kjøre i testforløpet.

Obs!

Skript skal returnere "0" ved vellykket fullføring og en feilkode som ikke er null, hvis det oppstår en feil under kjøring.

Hvert skript skal validere at det kjørte. Installasjonsskriptet bør for eksempel kontrollere om visse binærfiler og/eller registernøkler finnes på systemet etter at installasjonsfilen er ferdig. Denne kontrollen bidrar til å sikre med en rimelig grad av tillit til at installasjonen var vellykket.

Validering er nødvendig for å diagnostisere hvor feil oppstår under en testkjøring. Hvis skriptet for eksempel ikke kan installere programmet, i motsetning til at det ikke kan startes.

Viktig

Unngå følgende:

  • Skript bør ikke starte maskinen på nytt. Hvis en omstart er nødvendig, angir du dette under opplastingen av skriptene.
  • Ikke endre søkelisten for DNS-suffiks i Windows IP Configuration.

Viktig

Den maksimale diskplassen som er tilgjengelig, er 127 GB. Pakker som bruker mer enn denne mengden plass, vil ikke bli utført.

Viktig

Pakker som samhandler med brukergrensesnittet i Windows, må ha autopåloggingslegitimasjonen aktivert for å kjøre riktig.

Viktig

Skript i pakker har alle en tidsbegrensning på 60 minutter. Skriptkjøring etter 60 minutter ble tidsavbrutt.

3. Loggsamling

Hvert skript skal sende eventuelle logger som genereres til en mappe kalt logs. Alle mappene i katalogen som heter logs , kopieres og presenteres for nedlasting på Test Results siden.

Installasjonsskriptet (som kan være plassert i app-/skript/installasjonskatalogen ) kan for eksempel sende loggene til: logger/install.log, slik at den endelige loggen vil være på: Apper/skript/installasjon/logger/install.log

Systemet henter install.log filen sammen med andre filer i andre logs mapper og sorterer den for nedlasting.

4. Programbinærer

Eventuelle binære filer og avhengigheter bør inkluderes i den enkle ZIP-filen.

Disse binærfilene bør inneholde alt som er nødvendig for installasjon av programmet (for eksempel installasjonsprogrammet for programmet). Hvis programmet er avhengig av noen rammeverk, for eksempel .NET Core/Standard eller .NET Framework, bør disse rammeverkene inkluderes i filen og refereres riktig i de angitte skriptene.

Obs!

Den opplastede ZIP-filen kan ikke ha mellomrom eller spesialtegn i navnet

5. Program-/testregler

For at programmene/testene skal kjøre riktig under testbaseinfrastrukturen, må de overholde reglene som er beskrevet i program-/testreglene .

Neste trinn

Gå videre til neste artikkel for å vise noen vanlige spørsmål

Neste trinn: