Artikelns livscykel
Det rekommenderade flödet för att skapa objekt i infrastrukturgränssnittet är
- Fråga användaren om objektnamnet.
- Skapa ett "tomt" objekt.
- Redigera och spara det nya objektet.
Den här processen kan delas in i följande faser:
När användaren väljer en knapp för att skapa ett objekt av valfri typ måste fabric FE-koden (portalen) läsa in motsvarande objektredigerare. Fabric FE gör ett API-anrop till Fabric BE för att hämta nödvändig information, inklusive käll-URL:en, Microsoft Entra-ID-programinformationen och arbetsbelastningens BE-URL, som alla motsvarar den aktuella kontexten. När den här informationen är tillgänglig skapas ett objekt. Vanligtvis läser objektet in sina statiska resurser som HTML, JavaScript, CSS och bilder från CDN. Vi rekommenderar att du använder CDN-distribution i flera regioner och konfigurerar namnmatchning så att käll-URL:en matchas mot DEN CDN-server som är fysiskt närmast webbläsarens aktuella plats.
Kommentar
Vanligtvis behöver objektredigeraren göra anrop till arbetsbelastningen BE, eventuellt under redigeringsfasen. Detta kräver att du löser arbetsbelastningens BE-URL baserat på den aktuella kontexten. För närvarande kan koden använda en hårdkodad BE-URL.
Skapa ett tomt objekt
Det är vanligt i Fabric att skapa ett objekt utan användarindata, förutom objektnamnet. Det förväntas inte att sådana objekt gör något meningsfullt (därför "tomt"), men de visas på arbetsytan och kan delta i grundläggande flöden och åtgärder. Dessutom kan de i vissa fall till och med vara funktionella, baserat på rimliga standardvärden som anges av arbetsbelastningen.
Det här flödet börjar med att uppmana användaren att ange ett namn på det nya objektet. Med namnet gör iframe ett anrop till värd-JS-API:et för att initiera flödet för att skapa objekt, skicka valfritt JSON-objekt som "nyttolast för skapande", och värden gör sedan ett anrop till Fabric BE. Autentisering hanteras av värden. Fabric BE löser arbetsbelastningens BE-URL baserat på kontexten och anropar arbetsbelastnings-API:et CreateItem och skickar den "skapande nyttolast" som skickas av iframe. Arbetsbelastningen BE förväntas lagra de nya objektmetadata, eventuellt allokera vissa resurser (även om det här steget kan skjutas upp till en senare tidpunkt) och utföra annat relevant arbete. När objektskapandet har slutförts från arbetsbelastningens BE-perspektiv måste det meddela Fabric BE om ändring av objektmetadata. Samma process måste ske vid alla uppdateringar av objektmetadata och därför måste ämnestoken bytas ut mot Fabric BE-målgruppen.
Kommentar
API:et för att meddela objektmetadatauppdatering är inte tillgängligt för närvarande.
Läs in objektet
Om du vill redigera ett objekt måste iframe:en läsa in sina metadata. Den här processen är densamma för att läsa in "tomma" och "initierade" objekt. Iframe gör ett anrop till värd-JS-API:et, som anropar Fabric BE, som i sin tur anropar arbetsbelastnings-API:et GetItemPayload. Arbetsbelastningen BE kan returnera ett JSON-objekt som sedan skickas tillbaka till iframe. Autentisering hanteras av värden.
Redigera objektet
När objektmetadata har lästs in kan en redigeringssession starta. Antingen i början eller under den här sessionen kan iframe behöva göra anrop till arbetsbelastningen BE (till exempel för att hämta en konfiguration, fylla i användargränssnittskontroller, utföra valideringar med mera). För detta ändamål måste den begära en token från värd-JS-API:et.