Lebenszyklus der Elemente
Der empfohlene Flow für die Elementerstellung in der Fabric Benutzeroberfläche ist
- Fordern Sie den Benutzer zur Eingabe des Elementnamens auf.
- Erstellen Sie ein „Leer“-Element.
- Bearbeiten und speichern Sie das neue Element.
Dieser Prozess kann folgendermaßen unterteilt werden:
Wenn der Benutzer eine Schaltfläche zum Erstellen eines Elements eines beliebigen Typs auswählt, muss Fabric FE (Portal)-Code den entsprechenden Element-Editor laden. Fabric FE führt einen API-Aufruf von Fabric BE durch, um die dem aktuellen Kontext entsprechend erforderlichen Informationen abzurufen, einschließlich Quell-URL, Microsoft Entra ID-Anwendungsdetails und Workload-BE-URL. Sobald diese Informationen verfügbar sind, wird ein Element erstellt. In der Regel lädt das Element seine statischen Ressourcen wie HTML, JavaScript, CSS und Bilder aus CDN. Es wird empfohlen, die CDN-Bereitstellung mit mehreren Regionen zu verwenden und die Namensauflösung so zu konfigurieren, dass die Quell-URL auf den CDN-Server aufgelöst wird, der physisch am aktuellen Speicherort des Browsers liegt.
Hinweis
In der Regel muss der Element-Editor Aufrufe an die Arbeitsauslastung BE tätigen, möglicherweise während der Bearbeitungsphase. Dies erfordert das Auflösen der BE-URL der Workload basierend auf dem aktuellen Kontext. Derzeit kann der Code eine hartcodierte BE-URL verwenden.
Erstellen Sie ein leeres Element.
Es ist üblich, in Fabric das Erstellen eines Elements ohne Benutzereingabe zuzulassen, mit Ausnahme des Elementnamens. Es wird nicht erwartet, dass solche Elemente etwas sinnvolles tun (daher "leer"), aber sie werden im Arbeitsbereich angezeigt und können an grundlegenden Flüssen und Vorgängen teilnehmen. Darüber hinaus können sie in einigen Fällen sogar funktionsfähig sein, basierend auf angemessenen Standardeinstellungen, die von der Workload festgelegt werden.
Dieser Fluss beginnt mit der Aufforderung des Benutzers, einen Namen für das neue Element anzugeben. Mit dem Namen führt der iframe einen Aufruf der Host-JS-API durch, um den Elementerstellungsfluss zu initiieren, optionales JSON-Objekt als "Erstellungs-Payload" zu übergeben, und der Host führt dann einen Aufruf von Fabric BE durch. Die Authentifizierung erfolgt durch den Host. Fabric BE löst die Workload BE URL basierend auf dem Kontext auf und ruft die Workload-API CreateItem auf, wobei die vom Iframe gesendete „Erstellungsnutzlast“ übergeben wird. Die Arbeitslast BE soll die neuen Metadaten der Artikel speichern, möglicherweise einige Ressourcen zuweisen (obwohl dieser Schritt auf einen späteren Zeitpunkt verschoben werden kann) und alle anderen relevanten Arbeiten ausführen. Wenn die Erstellung von Elementen aus der Perspektive der Arbeitsauslastung BE abgeschlossen ist, muss Fabric BE über Elementmetadatenänderungen benachrichtigt werden. Derselbe Vorgang muss bei jeder Aktualisierung der Elementmetadaten erfolgen, und daher muss das Betrefftoken für die Fabric BE-Zielgruppe ausgetauscht werden.
Hinweis
Die API zum Benachrichtigen der Elementmetadatenaktualisierung ist derzeit nicht verfügbar.
Laden Sie das Element
Zum Bearbeiten eines Elements muss der iframe seine Metadaten laden. Dieser Vorgang ist für das Laden von "leeren" und "initialisierten" Elementen identisch. Der iframe ruft die Host-JS-API auf, die Fabric BE aufruft, die wiederum getItemPayload-Workload-API aufruft. Die Workload BE kann ein JSON-Objekt zurückgeben, das dann an den iframe übergeben wird. Die Authentifizierung erfolgt durch den Host.
Bearbeiten Sie das Element
Sobald die Elementmetadaten geladen wurden, kann eine Bearbeitungssitzung gestartet werden. Entweder am Anfang oder während dieser Sitzung muss der iframe möglicherweise Aufrufe an die Workload BE durchführen (z. B. zum Abrufen einer Konfiguration, Auffüllen von UI-Steuerelementen, Durchführen von Überprüfungen und mehr). Zu diesem Zweck muss ein Token aus der Host-JS-API angefordert werden.