共用方式為

微軟 Fabric 擴充性工具包驗證器

Microsoft Fabric 擴充性工具包驗證器是一套針對 Microsoft Fabric 工作負載的完整驗證工具。 它幫助出版商在提交官方認證前，驗證其工作負載是否符合 Microsoft Fabric 的要求。

此工具是外部合作夥伴及開發 Fabric 工作負載的 客戶的公開驗證工具 。

概觀

驗證工具允許工作負載建立者自我驗證其 Microsoft Fabric 工作負載。 它旨在幫助在開發過程早期發現潛在問題，使官方驗證過程更有可能成功。

這很重要

成功的自我驗證並不保證能通過官方驗證，但能大幅提升成功機率，因為它能及早發現常見問題。

先決條件

  • Node.js （版本 14 或更高）
  • Microsoft Fabric 帳號 ，可存取 Fabric 工作負載中心
  • Chrome/Chromium 瀏覽器 （用於自動清單下載）
  • 使用 Microsoft Fabric 延展性工具包建置的工作負載套件
  • 已發佈工作負載 - 您的工作負載必須先發佈給租戶，才能開始驗證。

小提示

驗證時使用的租戶應與發佈時不同。 這讓你能體驗最終使用者會看到什麼，並提供更真實的驗證環境。

開始

1. 增加你的工作量

首先，使用官方入門套件建立你的工作量：

  1. 複製Fabric Extensibility Toolkit（入門套件）。
  2. 依照工具包文件來建置你的工作負載。

2. 安裝依賴項

前往驗證器目錄並安裝相依關係：

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

3. 基本驗證

為您的工作負載進行完整驗證：

基本驗證指令

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

真實工作量的例子

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

針對 GA 階段的工作負載

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

備註

在執行驗證前，務必在瀏覽器中登入 Microsoft Fabric，並確保你的工作負載已發佈並可存取於目標租戶中。

命令列選項

Option Description Example
--workload-name 完整工作負載名稱（Publisher.Product） "Contoso.DataProcessor"
--workload-stage 驗證階段 "Preview" 或 "GA"
--help 顯示說明資訊 （僅限旗幟）

驗證程序

驗證器會經歷幾個階段：

  1. 清單下載 ——自動從 Fabric 工作負載中心下載你的工作負載清單。
  2. 測試發現 - 根據您的工作負載類型，識別適用的測試案例。
  3. 測試執行 - 使用已設定的驗證器（自動化與手動）執行驗證測試。
  4. 報表產生 - 建立多種格式的完整報告。

輸出結構

驗證後，你會在目錄中找到結果 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

驗證者

這個工具會使用一組專門的驗證器來檢查你工作負載的不同面向。 部分驗證器自動化，另一些則需人工操作。

故障排除

瀏覽器問題

  • 確保 Chrome/Chromium 已安裝並可存取。
  • 請確保你在瀏覽器中已登入 Microsoft Fabric。
  • 檢查網路與 Fabric 服務的連線狀況。

清單檔案下載問題

  • 確認工作負載名稱完全一致（大小寫區分）。
  • 確保工作負載已部署並可存取於 Fabric Workload Hub。
  • 檢查驗證和權限。

測試執行問題

  • 請檢視結果目錄中的驗證日誌。
  • 請查看validator/validators/中的測試案例文件。
  • 確認所有必要的工作負載資產都能存取。

相關內容

  • Last updated on