Životní cyklus položky
Doporučený tok pro vytvoření položky v uživatelském rozhraní Fabric je
- Vyzvat uživatele k zadání názvu položky.
- Vytvořte "prázdnou" položku.
- Upravte a uložte novou položku.
Tento proces lze rozdělit do následujících fází:
Když uživatel vybere tlačítko pro vytvoření položky libovolného typu, musí kód Fabric FE (portál) načíst odpovídající editor položek. Fabric FE volá rozhraní FABRIC BE, aby načítá požadované informace, včetně zdrojové adresy URL, podrobností aplikace Microsoft Entra ID a adresy URL BE úlohy odpovídající aktuálnímu kontextu. Jakmile jsou tyto informace k dispozici, vytvoří se položka. Obvykle položka načte statické prostředky, jako je HTML, JavaScript, CSS a obrázky z CDN. Doporučujeme použít nasazení CDN s více oblastmi a nakonfigurovat překlad adres IP tak, aby se zdrojová adresa URL přeložil na server CDN, který je fyzicky nejblíže aktuálnímu umístění prohlížeče.
Poznámka:
Editor položek obvykle potřebuje volat úlohu BE, případně během fáze úprav. To vyžaduje překlad adresy URL BE úlohy na základě aktuálního kontextu. V současné době může kód používat pevně zakódovanou adresu URL BE.
Vytvoření prázdné položky
V prostředcích infrastruktury se běžně používá možnost vytvářet položku bez uživatelského vstupu s výjimkou názvu položky. Neočekává se, že takové položky dělají něco smysluplného (proto prázdného), ale zobrazují se v pracovním prostoru a mohou se účastnit základních toků a operací. V některých případech mohou být dokonce funkční na základě přiměřených výchozích hodnot nastavených úlohou.
Tento tok začíná výzvou uživatele k zadání názvu nové položky. Iframe s názvem volá rozhraní JS API hostitele, aby inicioval tok vytvoření položky, předal volitelný objekt JSON jako datovou část vytvoření a hostitel pak zavolá fabric BE. Ověřování zpracovává hostitel. Prostředky infrastruktury BE přeloží adresu URL be úlohy na základě kontextu a zavolá CreateItem rozhraní API pro úlohy a předá datovou část vytvoření poslanou elementem iframe. Očekává se, že úloha BE uloží metadata nových položek, pravděpodobně přidělí některé prostředky (i když tento krok může být odložen na pozdější bod) a provede jakoukoli jinou relevantní práci. Po dokončení vytváření položek z hlediska úlohy BE je potřeba upozornit Fabric BE na změnu metadat položek. Stejný proces musí proběhnout u jakékoli aktualizace metadat položky, takže token předmětu je potřeba vyměnit pro cílovou skupinu Fabric BE.
Poznámka:
Rozhraní API pro upozorňování na aktualizaci metadat položek není v současné době k dispozici.
Načtení položky
Pokud chcete upravit položku, musí prvek iframe načíst jeho metadata. Tento proces je stejný pro načtení "prázdných" a "inicializovaných" položek. Prvek iframe volá hostitelské rozhraní JS API, které volá Prostředky infrastruktury BE, které pak volají rozhraní API úlohy GetItemPayload. Úloha BE může vrátit objekt JSON, který se pak předá zpět do prvku iframe. Ověřování zpracovává hostitel.
Úprava položky
Po načtení metadat položky se může spustit relace úprav. Buď na začátku, nebo během této relace může být potřeba provést volání úlohy BE (například k načtení konfigurace, naplnění ovládacích prvků uživatelského rozhraní, provádění ověření a další). Pro tento účel musí požádat o token z hostitelského rozhraní JS API.