Elementlivscyklus
Det anbefalede flow til oprettelse af elementer i Fabric UI er
- Spørg brugeren om elementnavnet.
- Opret et "tomt" element.
- Rediger og gem det nye element.
Denne proces kan opdeles i følgende faser:
Når brugeren vælger en knap for at oprette et element af en hvilken som helst type, skal Fabric FE-koden (Portal) indlæse den tilsvarende elementeditor. Fabric FE foretager et API-kald til Fabric BE for at hente de påkrævede oplysninger, herunder kilde-URL-adressen, oplysninger om Microsoft Entra ID-programmet og URL-adressen til arbejdsbelastningen, der alle svarer til den aktuelle kontekst. Når disse oplysninger er tilgængelige, oprettes der et element. Elementet indlæser typisk sine statiske ressourcer, f.eks. HTML, JavaScript, CSS og billeder fra CDN. Vi anbefaler, at du bruger CDN-installationen med flere områder og konfigurerer navneopløsningen, så kilde-URL-adressen oversættes til den CDN-server, der fysisk er tættest på browserens aktuelle placering.
Bemærk
Elementeditoren skal typisk foretage kald til arbejdsbelastningen BE, muligvis under redigeringsfasen. Dette kræver, at arbejdsbelastningens BE-URL-adresse løses på baggrund af den aktuelle kontekst. Koden kan i øjeblikket bruge en hard-coded BE URL-adresse.
Opret et tomt element
Det er almindelig praksis i Fabric at tillade oprettelse af et element uden brugerinput, undtagen elementnavnet. Det forventes ikke, at sådanne elementer gør noget meningsfuldt (derfor "tomt"), men de vises i arbejdsområdet og kan deltage i grundlæggende flow og handlinger. Desuden kan de i nogle tilfælde endda være funktionelle baseret på rimelige standarder, der er angivet af arbejdsbelastningen.
Dette flow starter med at bede brugeren om at angive et navn til det nye element. Under navnet foretager iframe et kald til JS-værts-API'en for at starte elementoprettelsesflowet og overfører valgfrit JSON-objekt som "oprettelsesnyttedata", og værten foretager derefter et kald til Fabric BE. Godkendelse håndteres af værten. Fabric BE løser arbejdsbelastningens BE URL-adresse baseret på konteksten CreateItem og kalder arbejdsbelastnings-API'en og overfører nyttedata for oprettelse sendt af iframe. Arbejdsbelastningen BE forventes at gemme de nye elementmetadata, muligvis allokere nogle ressourcer (selvom dette trin kan udskydes til et senere tidspunkt) og udføre andet relevant arbejde. Når oprettelsen af elementer er fuldført fra BE-arbejdsbelastningsperspektivet, skal den give Fabric BE besked om ændring af elementmetadata. Den samme proces skal ske ved enhver opdatering af elementets metadata, og derfor skal emnetokenet udveksles til Fabric BE-målgruppen.
Bemærk
API'en til meddelelse om opdatering af elementmetadata er ikke tilgængelig i øjeblikket.
Indlæs elementet
Hvis du vil redigere et element, skal iframe'en indlæse metadataene. Denne proces er den samme for indlæsning af "tomme" og "initialiserede" elementer. Iframe foretager et kald til JS-værts-API'en, som kalder Fabric BE, som igen kalder GetItemPayload-arbejdsbelastnings-API'en. ARBEJDSbelastningen BE kan returnere et JSON-objekt, som derefter overføres tilbage til iframe. Godkendelse håndteres af værten.
Rediger elementet
Når elementets metadata er indlæst, kan en redigeringssession starte. Enten i starten eller under denne session skal iframe muligvis foretage kald til BE-arbejdsbelastningen (f.eks. for at hente en konfiguration, udfylde kontrolelementerne i brugergrænsefladen, udføre valideringer med mere). Til dette formål skal den anmode om et token fra JS-værts-API'en.