Veröffentlichen der benutzerdefinierten Erweiterung
Ihre Erweiterung wird in Fusion erst ausgeführt, nachdem sie erstellt bereitgestellt in Adobe und wurde. Die Verfahren auf dieser Seite zeigen, wie Sie Ihre Erweiterung veröffentlichen und das Ergebnis überprüfen können.
Diese Informationen werden aus der offiziellen Adobe-Dokumentation übernommen und gelten speziell für Workfront Fusion. Allgemeine Informationen zu Adobe finden Sie unter UI-Erweiterungs-Entwicklungsablauf und UI-Erweiterungsverwaltung in der Dokumentation zu Adobe.
Arbeitsbereiche
Jedes App Builder-Projekt verfügt über Staging und einen Produktions Arbeitsbereich. Betrachten Sie sie als Umgebungen:
- Staging dient der Entwicklung und dem Testen. Sie stellen hier bereit, während Sie iterieren. Es ist keine Genehmigung erforderlich und das Ergebnis ist nur über den unten beschriebenen Staging-Test-Schalter (oder die lokale Vorschau) sichtbar.
- Produktion dient der Freigabe für alle. Nach der Bereitstellung in der Produktionsumgebung übermitteln Sie eine Genehmigungsanfrage und nach der Genehmigung wird die Erweiterung in der Adobe-App-Registrierung registriert und für Ihr gesamtes Unternehmen angezeigt.
Weitere Informationen finden Sie unter:
- Einrichten von Tools und Konto für die Benutzeroberflächenerweiterung
- So erhalten Sie Zugriff in der Dokumentation zu Adobe.
Standardmäßig zeigt Fusion nur veröffentlichte Erweiterungen an. Hierbei handelt es sich um Erweiterungen, die Sie im Arbeitsbereich Produktion bereitgestellt und dann zur () haben. Dies ist die sichere Standardeinstellung, sodass eine laufende Bereitstellung Ihrer gesamten Organisation nie versehentlich angezeigt wird.
Eine Bereitstellung im Staging-Arbeitsbereich wird nicht veröffentlicht und daher nicht eigenständig in Fusion angezeigt. Es gibt zwei Möglichkeiten, eine Erweiterung zu testen, bevor Sie sie veröffentlichen:
- Lokale Vorschau mit
aio app run(siehe Lokale Vorschau von Benutzeroberflächenerweiterungen in der Dokumentation zu Adobe). Es wird nichts bereitgestellt, und nur Sie sehen es. - Laden Sie sie von Stage in Fusion indem Sie einen Benutzer-Testschalter in Ihrem Fusion-Profil einschalten. Dies wird in Artikel unter „Testen eines Staging-Builds in " beschrieben.
Testen eines Staging-Builds in Fusion
Verwenden Sie diesen Fluss, um eine Staging-Bereitstellung in Fusion anzuzeigen, bevor Sie sie veröffentlichen.
Schritt 1: Staging-Arbeitsbereich auswählen
aio console where # shows current org / project / workspace
aio console workspace select # choose Stage
Schritt 2: Erstellen
aio app build
Dadurch wird Ihr Frontend kompiliert und der Metadaten-Hook ausgeführt (der app-metadata.json generiert). Beheben Sie alle gemeldeten Fehler, bevor Sie fortfahren.
Schritt 3: Bereitstellen
aio app deploy
deploy hat zwei Möglichkeiten:
- Hostet Ihre im Content Delivery Network von Adobe unter einer URL wie
https://<project>-stage.adobeio-static.net. Die CLI druckt diese Erweiterungs-Endpunkt-URL nach Abschluss. Dies ist die URL, die Fusion in seinen iframe lädt. - Registriert die Endpunkte Ihrer für den Erweiterungspunkt (
fusion/nav-organization/1) im Staging-Arbeitsbereich.
Weitere Informationen finden Sie unter Erweiterungspunkt ist nicht vorhanden im Artikel zur Fehlerbehebung.
Schritt 4: Aktivieren Sie das Staging-Testing in Ihrem Fusion-Profil
Fusion lädt Staging-Erweiterungen nur beim Opt-in pro Benutzer:
-
Melden Sie sich bei Fusion mit einem Konto an, das derselben Organisation, für die Sie bereitgestellt haben.
-
Öffnen Sie das Benutzeravatar-Menü in der oberen Ecke und gehen Sie zu Produkteinstellungen > Fusionsprofil > Voreinstellungen.
-
Schalten Sie den Staging-Erweiterungen ein.
Fusion fordert Sie zum Neuladen auf.
-
Bestätigen Sie das Neuladen.
Nach dem Neuladen lädt Fusion Erweiterungen aus dem Staging-Arbeitsbereich anstelle des veröffentlichten Sets und kennzeichnet jedes (Staging) in der Navigation, damit Sie es auseinanderhalten können.
Dieser Schalter ist eine persönliche Testeinstellung, die in Ihrem Browser gespeichert ist, keine Unternehmenseinstellung. Deaktivieren (und neu laden), um zu den veröffentlichten Erweiterungen zurückzukehren. Da es lokal gespeichert ist, folgt es Ihnen nicht zu einem anderen Browser oder Computer.
Schritt 5: Überprüfen in Fusion
-
Öffnen Sie den Abschnitt, der Ihrem Erweiterungspunkt entspricht:
fusion/nav-organization/1→ den Bereich Organisation im linken Navigationsbereich.fusion/nav-team/1→ den Bereich Team (wählen Sie zuerst ein Team aus).
Eine Schaltfläche mit dem Titel, den Sie in
getWidget()festgelegt haben, wird angezeigt, markiert (Phase). -
Klicken Sie auf die angezeigte Schaltfläche.
Ihre Benutzeroberfläche lädt und empfängt den Fusion-Kontext.
Wenn die Schaltfläche nicht angezeigt wird oder im Bedienfeld ein Fehler angezeigt wird, finden Sie weitere Informationen unter Fehlerbehebung.
Produktionsfreigabe
Wenn Ihre Erweiterung in der Staging-Umgebung funktioniert und Sie für alle Benutzer bereit sind:
Schritt 1: Wechseln Sie zum Arbeitsbereich Produktion .
aio console workspace select # choose Production
Wenn Sie von der CLI zur .env der Datei aufgefordert werden, wählen Sie Zusammenführen aus, damit Ihre Umgebungsvariablen beibehalten werden.
Schritt 2: Erstellen und für die Produktion bereitstellen
aio app build
aio app deploy
Schritt 3: Validierungsanfrage einreichen
Die Veröffentlichung ist eine Genehmigungsanfrage, die vom Produktionsarbeitsbereich gesendet wird:
- Öffnen Sie die Adobe Developer Console, wählen Sie Ihre Organisation aus, öffnen Sie Ihr Projekt und wechseln Sie zum Arbeitsbereich Produktion.
- Senden Sie Ihre App zur Genehmigung/Veröffentlichung (hierfür ist die Rolle Systemadministrator erforderlich).
- Nach der Genehmigung wird Ihre Erweiterung der Adobe App Registry hinzugefügt und steht für Ihr Unternehmen in Adobe Experience Cloud einschließlich Fusion zur Verfügung.
Detaillierte Anweisungen finden Sie unter Verwaltung von Benutzeroberflächenerweiterungen in der Dokumentation zu Adobe Developer.
Status und Updates
Einige Verhaltensweisen sind es wert, geklärt zu werden, sodass man „noch daran arbeitet“ von „irgendetwas stimmt nicht“ unterscheiden kann:
-
In der Produktion bereitgestellt ist nicht dasselbe wie sichtbar.
aio app deployzur Produktion lädt Ihre App hoch, aber die Erweiterung wird dadurch nicht angezeigt. Sie wird erst angezeigt, nachdem die Genehmigungsanforderung übermittelt und genehmigt wurde. Wenn Sie in der Produktion bereitgestellt haben und es immer noch nicht in Fusion sehen, liegt der übliche Grund darin, dass es noch nicht genehmigt ist. -
Nur-Code-Aktualisierungen erfordern keine neue Genehmigung. Wenn Ihre Erweiterung bereits veröffentlicht ist und Sie nur ihren Code ändern (die Benutzeroberfläche oder die Laufzeitaktionen), stellen Sie sie erneut für dieselbe URL bereit mit:
code language-sh aio app deploy --force-deployBenutzer erhalten die neue Version, wenn sie die Erweiterung das nächste Mal öffnen. Es gibt nichts für sie zu installieren. Sie müssen nur dann einen neuen Genehmigungsantrag einreichen, wenn Sie die Registrierung ändern, z. B. wenn Sie einen neuen Erweiterungspunkt hinzufügen oder ändern, was
getWidget()annimmt. -
Eine widerrufene oder zurückgenommene Erweiterung verschwindet. Wenn eine Erweiterung von Ihnen widerrufen oder zurückgenommen wird, wird sie in Fusion nicht mehr ohne Fehlermeldung angezeigt. Wenn eine zuvor funktionierende Erweiterung für alle verschwindet, überprüfen Sie, ob sie widerrufen wurde, bevor Sie nach einem Code-Problem suchen.
Entfernen (Widerrufen) einer Erweiterung
Eine veröffentlichte Erweiterung wird in Adobe Exchange durch Widerrufen entfernt:
- Bei Adobe Exchange anmelden.
- Navigieren Sie Verwalten > App Builder Apps.
- Klicken neben Erweiterung, die Sie entfernen möchten, auf „Widerrufen“ und bestätigen Sie den Vorgang.
Nach dem Widerrufen zeigt die Erweiterung den widerrufen in Extension Manager an und wird nicht mehr in Fusion angezeigt. Um es vollständig zu entfernen, löschen Sie das Projekt in der Developer Console. Ein Projekt kann erst gelöscht werden, nachdem seine Erweiterung widerrufen wurde.
Bei einer reinen Staging-Testbereitstellung können Sie die Bereitstellung mit folgenden Optionen entfernen:
aio app undeploy
Weitere Ressourcen
Die folgenden Ressourcen stehen in der Dokumentation zu Adobe zur Verfügung: