Microsoft Fabric Extensibility Toolkit Verifierare

Microsoft Fabric Extensibility Toolkit Validator är ett omfattande valideringsverktyg för Microsoft Fabric-arbetsbelastningar. Det hjälper utgivare att verifiera sina arbetsbelastningar mot Microsoft Fabric-krav innan de skickar in för officiell certifiering.

Det här verktyget är det offentliga valideringsverktyget för externa partners och kunder som utvecklar Fabric-arbetsbelastningar.

Översikt

Valideringsverktyget gör det möjligt för arbetsbelastningsskapare att själv validera sina Microsoft Fabric-arbetsbelastningar. Den är utformad för att hjälpa till att identifiera potentiella problem tidigt i utvecklingsprocessen, vilket gör den officiella valideringsprocessen mer sannolikt att lyckas.

Viktigt!

Lyckad självvalidering är ingen garanti för att klara officiell validering, men det ökar avsevärt sannolikheten för framgång genom att upptäcka vanliga problem tidigt.

Förutsättningar

  • Node.js (version 14 eller senare)
  • Microsoft Fabric-konto med åtkomst till Fabric Workload Hub
  • Chrome/Chromium Browser (för automatisk nedladdning av manifest)
  • Arbetsbelastningspaket som skapats med hjälp av Microsoft Fabric Extensibility Toolkit
  • Publicerad belastning – Din belastning måste publiceras till en hyresgäst innan verifieringen kan börja.

Tips/Råd

Använd en annan klient för validering än den som används för publicering. På så sätt kan du uppleva vad slutanvändarna ser och ger en mer realistisk valideringsmiljö.

Get started

1. Skapa din arbetsbelastning

Skapa först din arbetsbelastning med hjälp av det officiella startpaketet:

  1. Klona Fabric Extensibility Toolkit (startpaket).
  2. Följ verktygssatsens dokumentation för att bygga ditt arbetsflöde.

2. Installera beroenden

Gå till validatorkatalogen och installera beroendena:

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

3. Grundläggande validering

Kör en fullständig validering för din arbetsbelastning:

Grundläggande valideringskommando

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

Exempel med verklig arbetsbelastning

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

För arbetsbelastningar i GA-fasen

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

Anmärkning

Kontrollera att du är inloggad i Microsoft Fabric i webbläsaren innan du kör verifieringen och se till att din arbetsbelastning är publicerad och tillgänglig i målklientorganisationen.

Kommandoradsalternativ

Option Description Example
--workload-name Fullständigt arbetsbelastningsnamn (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Valideringssteg "Preview" eller "GA"
--help Visa hjälpinformation (flagga endast)

Valideringsprocessen

Validatorn går igenom flera steg:

  1. Manifestnedladdning – laddar automatiskt ned arbetsbelastningsmanifestet från Fabric Workload Hub.
  2. TestIdentifiering – Identifierar tillämpliga testfall baserat på din arbetsbelastningstyp.
  3. Testkörning – Kör valideringstester med hjälp av de konfigurerade validatorerna (både automatiserade och manuella).
  4. Rapportgenerering – Skapar omfattande rapporter i flera format.

Utdatastruktur

Efter valideringen hittar du resultat i Results katalogen:

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

Validerare

Verktyget använder en uppsättning specialiserade validatorer för att kontrollera olika aspekter av din arbetsbelastning. Vissa validatorer är automatiserade, medan andra kräver manuell interaktion.

Felsökning

Problem med webbläsare

  • Kontrollera att Chrome/Chromium är installerat och tillgängligt.
  • Kontrollera att du är inloggad i Microsoft Fabric i webbläsaren.
  • Kontrollera nätverksanslutningen till Fabric-tjänster.

Problem med manifestnedladdning

  • Kontrollera att arbetsbelastningsnamnet matchar exakt (skiftlägeskänsligt).
  • Se till att arbetsbelastningen är distribuerad och tillgänglig i Fabric Workload Hub.
  • Kontrollera autentisering och behörigheter.

Problem med testkörning

  • Granska valideringsloggarna i katalogen Resultat.
  • Kontrollera dokumentationen för enskilda testfall i validator/validators/.
  • Kontrollera att alla nödvändiga arbetsbelastningstillgångar är tillgängliga.

Relaterat innehåll

  • Last updated on