Del via

Microsoft Fabric Udvidelsesværktøjsværktøjsvalidator

Microsoft Fabric Extensibility Toolkit Validator er et omfattende valideringsværktøj til Microsoft Fabric-arbejdsbelastninger. Det hjælper udgivere med at validere deres arbejdsbelastninger i forhold til Microsoft Fabric-krav, før de indsender til officiel certificering.

Dette værktøj er det offentlige valideringsværktøj for eksterne partnere og kunder, der udvikler Fabric-arbejdsbelastninger.

Oversigt

Valideringsværktøjet gør det muligt for arbejdsbelastningsskabere at selvvalidere deres Microsoft Fabric-arbejdsbelastninger. Den er designet til at hjælpe med at identificere potentielle problemer tidligt i udviklingsprocessen, hvilket gør den officielle valideringsproces mere sandsynlig at lykkes.

Vigtigt

Succesfuld selvvalidering er ingen garanti for at bestå officiel validering, men den øger sandsynligheden for succes betydeligt ved at opdage almindelige problemer tidligt.

Forudsætninger

  • Node.js (version 14 eller nyere)
  • Microsoft Fabric-konto med adgang til Fabric Workload Hub
  • Chrome/Chromium Browser (til automatisk manifest-download)
  • Arbejdsbelastningspakke bygget med Microsoft Fabric Extensibility Toolkit
  • Publiceret arbejdsbelastning - Din arbejdsbyrde skal være publiceret til en lejer, før validering kan begynde.

Tips

Brug en anden tenant til validering end den, der bruges til publicering. Dette giver dig mulighed for at opleve, hvad slutbrugerne vil se, og giver et mere realistisk valideringsmiljø.

Start her

1. Byg din arbejdsbyrde op

Først skal du oprette din arbejdsbyrde ved hjælp af det officielle startsæt:

  1. Klon Fabric Extensibility Toolkit (starter-kit).
  2. Følg toolkit-dokumentationen for at opbygge din arbejdsbyrde.

2. Installationsafhængigheder

Navigér til validator-mappen og installer afhængighederne:

cd fabric-extensibility-toolkit-validator/validator
npm install

3. Grundlæggende validering

Kør en komplet validering af din arbejdsbyrde:

Grundlæggende valideringskommando

node index.js --workload-name "YourPublisher.YourWorkload" --workload-stage "Preview"

Eksempel med reel arbejdsbyrde

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "Preview"

For GA-fase arbejdsbelastninger

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "GA"

Notat

Sørg for, at du er logget ind i Microsoft Fabric i din browser, før du kører valideringen, og sørg for, at din arbejdsbyrde er offentliggjort og tilgængelig i mållejeren.

Kommandolinjeindstillinger

Indstilling Beskrivelse Eksempel
--workload-name Fuld arbejdsbelastningsnavn (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Valideringsfase "Preview" eller "GA"
--help Vis hjælpeinformation (kun flag)

Valideringsproces

Validatoren gennemgår flere faser:

  1. Manifest Download - Downloader automatisk din arbejdsbelastningsmanifest fra Fabric Workload Hub.
  2. Testopdagelse - Identificerer relevante testcases baseret på din arbejdsbelastningstype.
  3. Testudførelse - Kører valideringstests ved hjælp af de konfigurerede validatorer (både automatiserede og manuelle).
  4. Rapportgenerering - Skaber omfattende rapporter i flere formater.

Outputstruktur

Efter validering finder du resultater i kataloget Results :

Results/
├── YourPublisher.YourWorkload/
│   └── Preview/
│       └── [ValidationID]/
│           ├── YourPublisher.YourWorkload_Metadata.json
│           ├── YourPublisher.YourWorkload_Manifest.json
│           ├── YourPublisher.YourWorkload_Workload_Tests.json
│           ├── YourPublisher.YourWorkload.Item_Item_Tests.json
│           └── Reports/
│               ├── ValidationReport.md
│               ├── ValidationReport.html
│               └── ValidationReport.pdf

Validatorer

Værktøjet bruger et sæt specialiserede validatorer til at tjekke forskellige aspekter af din arbejdsbyrde. Nogle validatorer er automatiserede, mens andre kræver manuel interaktion.

Fejlfinding

Browserproblemer

  • Sørg for, at Chrome/Chromium er installeret og tilgængeligt.
  • Sørg for, at du er logget ind i Microsoft Fabric i din browser.
  • Tjek netværksforbindelsen til Fabric-tjenester.

Problemer med manifest-download

  • Verificér arbejdsbelastningens navn præcist (kasusfølsomt).
  • Sørg for, at arbejdsbelastningen er implementeret og tilgængelig i Fabric Workload Hub.
  • Tjek autentificering og tilladelser.

Testudførelsesproblemer

  • Gennemgå valideringsloggene i Results-mappen.
  • Tjek dokumentationen for individuelle testtilfælde i validator/validators/.
  • Kontroller at alle nødvendige arbejdsmængderessourcer er tilgængelige.

Relateret indhold

  • Last updated on