Retningslinjer for testpakke

  • Artikel

Vigtigt!

Testbasen for Microsoft 365 overgår til EOL (end-of-life) den 31. maj 2024. Vi er forpligtet til at arbejde tæt sammen med hver enkelt kunde om at yde support og vejledning for at gøre overgangen så problemfri som muligt. Hvis du har spørgsmål, bekymringer eller har brug for hjælp, kan du indsende en supportanmodning.

1. Script-referencing

Når du uploader en .zip fil til portalen, udpakkes alt indholdet af filen til en rodmappe. Du behøver ikke at skrive kode for at udføre denne indledende udpakningshandling. Du kan også referere til en hvilken som helst fil i .zip ved hjælp af stien i forhold til den overførte zip-fil.

I eksemplet nedenfor viser vi, hvordan du kan referere til dine binære/scripts fra inputfeltet under fanen Opgaver. Teksten med blå skal indtastes i feltet Scriptstiuden anførselstegnene.

Det er vigtigt, at du er opmærksom på indholdet i zip-filen, før du uploader den. Når du kopierer en mappe, opretter din lokale computer ofte en hovedmappe under zip-filen. I dette tilfælde vil referencen være som vist med fed 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/folder1/script.ps1"

Andre gange kan zip-filen have dine filer eller indhold lige under den (f.eks. ingen mappe på 2. niveau):

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1
  • ScriptX.ps1 - "ScriptX.ps1"
  • Script.ps1 - "folder1/script.ps1"

2. Kørsel af script

Out-of-Box-test: Programpakken skal indeholde mindst tre PowerShell-scripts. Disse scripts udfører automatisk installation, start og lukning af programmet og dets afhængigheder. Hvert script skal håndtere kontrol af sine egne forudsætninger, validering af sin egen succes og oprydning efter sig selv (hvis det er nødvendigt).

Funktionelle test: Programpakken skal indeholde mindst ét PowerShell-script. Hvis der er angivet mere end ét script, køres scripts i overførselssekvensen, og en fejl i et bestemt script forhindrer efterfølgende scripts i at blive udført.

Scriptkrav

  • PowerShell Version 5.1+
  • Automatisk udførelse
  • Fejl returneret kode
  • Valider udført
  • Logføring i scriptspecifik logmappe

Hvert script skal køre automatisk (ingen brugerprompter) for at kunne udføres i testpipelinen.

Bemærk!

Scripts skal returnere "0" efter fuldførelsen og en fejlkode, der ikke er nul, hvis der opstår en fejl under udførelsen.

Hvert script skal validere, at det blev kørt korrekt. Installationsscriptet skal f.eks. kontrollere, om der findes visse binære og/eller registreringsdatabasenøgler på systemet, når installationsprogrammets binære fil er fuldført. Denne kontrol hjælper med at sikre, at installationen lykkedes med en rimelig grad af sikkerhed.

Validering er nødvendig for korrekt at diagnosticere, hvor der opstår fejl under en testkørsel. Hvis scriptet f.eks. ikke kan installere programmet korrekt i forhold til ikke at kunne starte det.

Vigtigt!

Undgå følgende:

  • Scripts bør ikke genstarte computeren. Hvis det er nødvendigt at genstarte, skal du angive dette under upload af dine scripts.
  • Rediger ikke søgelisten for DNS-suffiks i Windows IP-konfiguration.

Vigtigt!

Den maksimale tilgængelige diskplads er 127 GB. Pakker, der forbruger mere end denne mængde plads, udføres ikke.

Vigtigt!

Pakker, der interagerer med Windows-brugergrænsefladen, skal have autologon-legitimationsoplysningerne aktiveret for at kunne køre korrekt.

Vigtigt!

Scripts i pakker har alle en grænse for udførelsestid på 60 minutter. Udførelsen af scripts efter 60 minutter får timeout.

3. Logsamling

Hvert script skal skrive alle logfiler, det genererer, i en mappe med navnet logs. Alle mapper i mappen med navnet logs kopieres og præsenteres til download på Test Results siden.

Installationsscriptet (som kan være placeret i mappen App/scripts/Install ) kan f.eks. sende sine logge til: logfiler/install.log, så den endelige log er på: Apps/scripts/install/logs/install.log

Systemet henter install.log filen sammen med andre filer i andre logs mapper og samler den til download.

4. Binære programfiler

Alle binære filer og afhængigheder skal inkluderes i den enkelte zip-fil.

Disse binære filer skal indeholde alt det, der er nødvendigt for installationen af programmet (f.eks. installationsprogrammet til programmet). Hvis programmet er afhængig af nogen strukturer, f.eks. .NET Core/Standard eller .NET Framework, skal disse strukturer medtages i filen og refereres korrekt til dem i de angivne scripts.

Bemærk!

Den overførte zip-fil må ikke indeholde mellemrum eller specialtegn i navnet

5. Program-/testregler

Hvis dine programmer/test skal køre korrekt under testbaseinfrastrukturen, skal de overholde de regler, der er beskrevet i Regler for program/test .

Næste trin

Gå videre til næste artikel for at få vist nogle ofte stillede spørgsmål

Næste trin