Veröffentlichung und Zugriff auf Portale

Das Veröffentlichung-Panel sammelt Releases, Veröffentlichungsstatus und Berechtigungen des Portals. Die angezeigten Operationen hängen von der individuellen Berechtigung, der Rolle im Projekt und den vom Plattformadministrator vorgegebenen Funktionen ab.

Vorbereitung einer Release

Vor der Veröffentlichung:

1. alle Änderungen speichern;
2. Validieren ausführen und Fehler korrigieren;
3. die Vorschau mit Vorschau testen;
4. Veröffentlichen auswählen, um das Panel zu öffnen;
5. eine Neue Build-Release erstellen.

Eine Release ist eine unveränderliche Kopie der geprüften Revision. Spätere Änderungen der Vorschau ändern bereits erstellte Releases nicht.

Artefakte verstehen und verwalten

Jede erfolgreiche Build erzeugt ein Artefakt: das ausführbare HTML-Dokument des Portals, vollständig mit Layout, kompilierten Stilen und Widget-Runtime. Dem Dokument ist ein Manifest zugeordnet, das Quellrevision, Größe, Capability und verwendete Abhängigkeiten auflistet.

Der nach der Build angezeigte hexadezimale Wert ist der SHA-256-Hash des Inhalts. Es handelt sich nicht um ein Passwort oder einen Code, der an anderer Stelle eingegeben werden muss: Er identifiziert das Artefakt eindeutig und ermöglicht Sybot die Überprüfung seiner Integrität.

Im Panel Veröffentlichung → Build und Artefakte können Sie:

• Build-Vorschauen und Releases mit Status und Revision konsultieren;
• Details öffnen, um den vollständigen Hash, die Größe, das Manifest und die Diagnose zu lesen;
• Artefakt öffnen verwenden, um das generierte Dokument zu inspizieren;
• eine noch wartende oder laufende Build abbrechen.

Erfolgreiche Artefakte werden nicht manuell vom Editor gelöscht: Eine Release kann genau auf diesem unveränderlichen Inhalt basieren. Die normale Verwaltung erfolgt über Freigabe, Deployment, Widerruf und Rollback von Releases.

Ein Publisher oder Owner kann eine erfolgreiche Release freigeben. Die Freigabe ändert die Vorschau nicht und macht die Release für die Veröffentlichung auf bereits verfügbaren Zielen auswählbar. Der Status wird aktualisiert, ohne die Seite neu zu laden.

Wenn kein Ziel verfügbar ist, wenden Sie sich an den Projektbesitzer oder den Plattformadministrator. Versuchen Sie nicht, ein Ziel eines anderen Projekts wiederzuverwenden.

Auf dem ersten Ziel veröffentlichen

1. die erstellte Release freigeben;
2. als Owner von Portal und Projekt das Ziel mit der exakten Origin erstellen, zum Beispiel https://portals.example.com, ohne Pfad;
3. wenn die Release Power BI App owns data enthält, Profile und Berichte verwalten öffnen, einen Endpunkt für das Ziel oder den Fallback seiner Umgebung erstellen und Diagnose bis zum geprüften Status ausführen;
4. die freigegebene Release und das Ziel auswählen und anschließend Deploy starten;
5. den aktiven Status abwarten und den Portal mit Öffnen testen.

Produktion und Staging erfordern HTTPS. HTTP ist nur für ein Entwicklungsziel auf localhost verfügbar. Wenn eine Build erfolgreich ist, das Panel aber nicht aktualisiert wird, verwenden Sie Aktualisieren und prüfen Sie die Liste, bevor Sie eine weitere Release erstellen.

Verwendet die Release Qlik OAuth impersonation, müssen Profil und Endpunkt ebenfalls eine erfolgreiche Diagnose besitzen. Für ein Remote-Agent-Ziel muss der Administrator die Destination vorbereitet haben: Nach Deploy bleibt der Status Wartet auf Agent, bis die Release geprüft und aktiviert ist. Die vorherige Version bleibt verfügbar. Siehe Verwaltete Integrationen.

Erwartetes Verhalten eines Remote-Agent-Ziels

Wenn Sie Öffnen verwenden, kann die Remote-Runtime Sie zur Anmeldeseite der Sybot-Installation weiterleiten, der das Portal gehört. Nach der Anmeldung kehrt der Browser automatisch zum Portal zurück; im Editor ist keine zweite Konfiguration erforderlich.

Layout, Stile und statische Inhalte stammen aus der auf dem Ziel aktivierten Release. Widgets, die Daten, Benutzeransichten, Workflows, BPMN, Power BI oder Qlik verwenden, wenden weiterhin in Echtzeit die Berechtigungen und Konfiguration der besitzenden Sybot-Installation an. Sie können daher vorübergehend nicht verfügbar sein, wenn die Plattform nicht erreichbar ist, auch wenn der statische Teil des Portals bereits sichtbar ist.

Veröffentlichung überprüfen

Während der Aktivierung zeigt das Panel den aktuellen Status an. Wenn die Operation abgeschlossen ist, erscheint Öffnen, mit dem Sie den Portal mit den gleichen Zugriffskontrollen wie für Endbenutzer testen können.

Bei einem Remote-Ziel bestätigt Letzter Agent-Kontakt, dass der Agent mit Sybot kommuniziert hat. Dies ersetzt nicht den Test dynamischer Widgets.

Vergleichen Sie bei der Abnahme Position, Breite und Höhe der Widgets mit der Vorschau derselben Revision. Die Geometrie ist Bestandteil des unveränderlichen Artefakts: Erstellen Sie nach einem Update, das die Portal-Darstellung ändert, einen neuen Build und eine neue Release. Ein erneutes Deployment derselben Release kompiliert sie nicht neu.

Eine fehlgeschlagene Veröffentlichung ersetzt nicht die bereits aktive Version. Lesen Sie die angezeigte Meldung, korrigieren Sie den angegebenen Grund und wiederholen Sie die Operation mit einer gültigen Release.

Wenn eine vorherige Version verfügbar ist, kann der Publisher Rollback verwenden, um sie ohne Änderung oder Neuaufbau der aktuellen Vorschau wiederherzustellen.

Mitarbeitern und Zielgruppen verwalten

Der Owner findet im Panel Zugriff zwei Bereiche:

• Mitarbeiter, um Berechtigungen von Projektmitgliedern zu erteilen oder zu widerrufen;
• Runtime-Zielgruppe, um Anwendungsrollen zu autorisieren, die den veröffentlichten Portal öffnen können.

Die Zielgruppe ersetzt nicht die Zugehörigkeit zum Projekt. Das Entfernen eines Mitglieds, der Widerruf der Berechtigung oder das Entfernen der Rolle aus der Zielgruppe verhindert zukünftige nicht mehr autorisierte Öffnungen.

Fehlerbehebung

• Die Build startet nicht oder bleibt warten: Aktualisieren Sie das Panel und melden Sie die Meldung an den Administrator, wenn sich der Status nicht ändert.
• Die Release kann nicht freigegeben werden: Überprüfen Sie, ob Sie die Berechtigung Publisher oder Owner haben und ob die Build erfolgreich war.
• Der veröffentlichte Portal öffnet sich nicht: Überprüfen Sie die Zugehörigkeit zum Projekt, die Berechtigung oder Zielgruppe und den aktiven Status.
• Das Remote-Ziel kehrt wiederholt zur Anmeldeseite zurück: Schließen Sie veraltete Tabs, öffnen Sie das Portal erneut über Öffnen und melden Sie die Schleife dem Administrator, falls sie bestehen bleibt. Teilen Sie keine Authentifizierungslinks.
• Das Remote-Ziel öffnet sich, aber dynamische Widgets reagieren nicht: Prüfen Sie, ob die Sybot-Plattform erreichbar ist. Sichtbare statische Inhalte bestätigen allein nicht die Verfügbarkeit von Daten und Integrationen.
• Veröffentlichte Widgets sind komprimiert oder falsch angeordnet: Erstellen Sie mit der aktuellen Version einen neuen Build und eine neue Release und deployen Sie diese. Ein erneutes Deployment der vorherigen Release behält das alte Artefakt bei.
• Daten oder Workflows sind verweigert: Überprüfen Sie, ob das verknüpfte Objekt weiterhin zugänglich ist und die Release eine aktuelle Konfiguration verwendet.
• Das Deployment mit Power BI ist blockiert: Überprüfen Sie, ob jede App-owns-data-Bindung und -Variante einen aktiven, diagnostizierten Endpunkt für das Ziel oder seine Umgebung besitzt.
• Ein diagnostischer Identifikator erscheint: Kopieren Sie ihn ohne hinzugefügte vertrauliche Daten und übergeben Sie ihn dem Support.