共用方式為

專案生命週期

  • 發行項

在 Fabric UI 中建立項目的建議流程為

  1. 提示使用者輸入項目名稱。
  2. 建立一個「空白」項目。
  3. 編輯並儲存新項目。

Microsoft Fabric 中項目生命週期管理第一部分的圖解標記法。

此程序分為下列幾個階段：

  1. 建立空白項目
  2. 載入項目
  3. 編輯該項目

Microsoft Fabric 中項目生命週期管理第二部分的圖解標記法。

當使用者選取按鈕以建立任何類型的項目時，Fabric FE (入口網站) 程式碼必須載入對應的項目編輯器。 Fabric FE 會對 Fabric BE 進行 API 呼叫，以擷取必要的資訊，包括來源 URL、Microsoft Entra ID 應用程式詳細資料，以及工作負載 BE URL，全都對應至目前內容。 一旦提供這項資訊，就會建立項目。 該項目通常會從 CDN 載入其靜態資源，例如 HTML、JavaScript、CSS 和影像。 我們建議使用多重區域 CDN 部署和設定名稱解析，以便來源 URL 解析為實際最接近瀏覽器目前位置的 CDN 伺服器。

注意

通常項目編輯器需要呼叫工作負載 BE，可能在編輯階段。 這需要根據目前內容來解析工作負載 BE URL。 目前，程式碼可以使用硬式編碼的 BE URL。

建立空白項目

這是 Fabric 中常見的做法，除了項目名稱外，可建立無需使用者輸入的項目。 預計這類項目不會執行任何有意義的動作 (因此為「空白」)，但它們會出現在工作區中，而且可以參與基本流程和作業。 此外，在某些情況下，它們甚至可以根據工作負載設定的合理預設值運作。

此流程首先會提示使用者提供新項目的名稱。 擁有名稱後，iframe 會呼叫主機 JS API 以啟動項目建立流程，將選擇性的 JSON 對象傳遞為「建立承載」，然後主機會呼叫 Fabric BE。 驗證由主機處理。 Fabric BE 會根據內容解析工作負載 BE URL，並呼叫 CreateItem 工作負載 API，傳遞 iframe 所傳送的「建立承載」。 工作負載 BE 預期會儲存新的項目中繼資料，可能會配置一些資源 (雖然此步驟可以延遲到稍後的時間點)，並執行任何其他相關工作。 從工作負載 BE 的角度完成項目建立時，它需要在項目中繼資料變更時通知 Fabric BE。 項目中繼資料的任何更新都需要進行相同的程序，因此主題權杖需要為 Fabric BE 對象進行交換。

注意

目前無法使用通知項目中繼資料更新的 API。

載入項目

若要編輯項目，iframe 需要載入其中繼資料。 此程序與載入「空白」和「初始化」項目相同。 iframe 會呼叫主機 JS API，主機 JS API 會呼叫 Fabric BE，而 Fabric BE 又會呼叫 GetItemPayload 工作負載 API。 工作負載 BE 可以傳回 JSON 物件，然後 JSON 物件再傳回 iframe。 驗證由主機處理。

編輯該項目

載入項目中繼資料之後，就可以啟動編輯工作階段。 無論是在此工作階段的開頭還是期間，iframe 都可能需要呼叫工作負載 BE (例如擷取設定、填入 UI 控件、執行驗證等)。 為此，它需要向主機 JS API 請求權杖。

相關內容