Verwenden benutzerdefinierter Funktionspakete
Mithilfe von Paketen können Sie Ihre eigene benutzerdefinierte Logik in Adobe Workfront Fusion erstellen und ausführen, ohne die Fusion-Benutzeroberfläche zu verlassen. Wenn die Standardmodule nicht genau das tun, was Sie benötigen, können Sie eine Funktion verwenden, um Daten umzuwandeln, eine Berechnung durchzuführen, einen externen Service aufzurufen oder eine Routine einzuschließen, die Sie wiederverwenden möchten. Anschließend können Sie sie testen, live schalten und in Ihren Szenarien verwenden.
Komplexe Funktionen erfordern möglicherweise Ressourcen wie Variablen und Abhängigkeiten wie Bibliotheken. Für diese Funktionen können Sie ein Paket erstellen, das die Funktion und ihre Ressourcen enthält.
Ein Paket kann Folgendes enthalten:
- Funktionen: Die Logik, die während der Ausführung eines Szenarios ausgeführt wird.
- Variablen: Wiederverwendbare Werte, wie eine Basis-URL oder ein API-Schlüssel, die von der Funktion im Paket verwendet werden.
- Abhängigkeiten: Außerhalb von Bibliotheken können Ihre Funktionen auf Folgendes angewiesen sein.
- History: Frühere Versionen jeder Funktion, die automatisch gespeichert wurde und auf die Sie verweisen können.
Zugriffsanforderungen
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront-Paket |
Ein beliebiges Adobe Workfront Workflow- und Adobe Workfront Automation and Integration-Paket Workfront Ultimate Workfront Prime- und Select-Pakete bei zusätzlichem Kauf von Workfront Fusion. |
| Adobe Workfront-Lizenzen |
Standard Work oder höher |
| Produkt |
|
Weitere Details zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Einrichten der Verbindung zur Laufzeitumgebung
Wenn Ihr Team diese Funktion zum ersten Mal verwendet, müssen Sie die Umgebung einrichten, in der die Funktionen ausgeführt werden. Dies ist nur einmal pro Team möglich.
-
Klicken Sie auf Registerkarte Pakete
Wenn die Umgebung nicht eingerichtet wurde, wird der Bildschirm Laufzeitumgebung nicht konfiguriert angezeigt.
-
Klicken Sie Laufzeit initialisieren.
-
Um einen anderen Namen als den Standardnamen einzugeben, geben Sie den Namen in das Feld Verbindungsname ein.
-
Wählen Sie das Adobe App Builder-Projekt aus, zu dem dieses Paket gehören soll:
- Um ein vorhandenes Projekt auszuwählen, geben Sie zunächst den Projektnamen ein und wählen Sie ihn aus, wenn er angezeigt wird.
- Um ein neues Projekt zu erstellen, geben Sie einen Namen ein, der noch nicht vorhanden ist, und klicken Sie auf Neu erstellen.
- Wenn Sie dieses Feld leer lassen, verwendet Fusion ein Standardprojekt.
-
Wählen Sie Weiter.
Fusion beendet die Einrichtung und Sie können Pakete erstellen.
Ihre Umgebung wird als Registerkarte Verbindung oben auf der Seite angezeigt.
-
(Bedingt) Um eine zusätzliche Umgebung hinzuzufügen, klicken Sie auf das Pluszeichen und befolgen Sie die Anweisungen in diesem Abschnitt.
-
(Bedingt) Um eine vorhandene Umgebung zu entfernen, bewegen Sie den Mauszeiger über die Registerkarte Umgebungsverbindung und klicken Sie auf X wenn sie angezeigt wird.
note warning WARNING Durch das Entfernen einer Verbindung wird Fusion von dieser Umgebung getrennt. Die darin enthaltenen Pakete sind in Fusion über diese Verbindung nicht mehr verfügbar.
Erstellen und Öffnen eines Pakets
-
Klicken Sie auf Registerkarte Pakete
-
Wählen Sie die Registerkarte für die Verbindung aus, in der Sie arbeiten möchten.
-
Klicken Sie Paket erstellen.
-
Geben Sie einen Namen ein und wählen Sie Erstellen.
Das Paket wird automatisch geöffnet.
-
Um ein Paket später erneut zu öffnen, wählen Sie es aus der Liste Pakete aus und klicken Sie auf Anzeigen.
-
Um ein Paket zu löschen, wählen Sie es aus der Liste Pakete aus und klicken Sie auf Löschen.
note warning WARNING Wenn Sie ein Paket löschen, werden es und alles, was darin ist, dauerhaft entfernt.
Verwalten eines Pakets
Ein offenes Paket ist in vier Bereiche unterteilt:
- Funktionen: Erstellen, testen und veröffentlichen Sie die Funktion.
- Variablen: Konfigurieren von Variablen für die Funktion.
- Abhängigkeiten: Installieren Sie Abhängigkeiten wie externe Bibliotheken für diese Funktion.
- History: Frühere Versionen jeder Funktion anzeigen.
Zusätzlich zu diesen vier Bereichen zeigt ein Speichermeter oben an, wie viel von Ihrem Platz belegt ist. Jedes Paket hat eine Gesamtgrößenbeschränkung von 21 MB. Dazu gehören Funktionen, Variablen und Abhängigkeiten, einschließlich gespeicherter Versionen.
Wenn Sie keinen Speicherplatz mehr haben, empfehlen wir, nicht verwendete Abhängigkeiten, Variablen oder ältere Versionen zu entfernen, um einige freizugeben.
Um zur Paketliste zurückzukehren, klicken Sie auf den Rückwärtspfeil neben dem Paketnamen.
Funktionen
Der Bereich Funktionen zeigt eine Liste der Funktionen im Paket an, einschließlich des Namens der Funktion, ihres Status, ihrer Größe und der erwarteten Anzahl von Eingaben.
Anzeigen und Verwalten der Funktionsliste
So filtern Sie die Liste Funktionen :
- Filtern Sie nach Status, indem Sie auf Alle, Entwürfe oder Veröffentlicht klicken.
- Verwenden Sie die Suchleiste, um nach bestimmten Funktionen zu suchen.
Eine Funktion kann den Status „Entwurf“ oder „Veröffentlicht“ haben.
- Entwurf: Funktionen im Entwurfsstatus sind in Bearbeitung. Sie können frei bearbeiten und testen, ohne die Live-Daten zu beeinflussen.
- Veröffentlicht: Veröffentlichte Versionen sind live. Ihre Szenarien führen veröffentlichte Versionen von Funktionen aus.
Mit Entwürfen können Sie sicher Änderungen vornehmen. Sie können einen Entwurf verfeinern, testen und ihn dann veröffentlichen, wenn Sie damit zufrieden sind.
Erstellen oder Bearbeiten einer Funktion im Bereich Pakete
-
Klicken Sie auf Registerkarte Pakete
-
Wählen Sie im Bereich Funktionen die Option Funktion erstellen.
ODER
Klicken Sie auf das Kontrollkästchen neben einer vorhandenen Funktion und wählen Sie Bearbeiten in der Aktionsleiste unten auf der Seite aus.
-
(Bedingt) Wenn Sie eine neue Funktion erstellen, geben Sie im Feld Neue Funktion einen Namen für die Funktion ein.
-
(Optional und bedingt) Um eine vorhandene Funktion umzubenennen, klicken Sie auf das Bearbeitungssymbol neben dem Namen der Funktion und geben Sie den neuen Namen ein.
-
Geben auf der Registerkarte Code“ die Funktionslogik ein.
Beachten Sie beim Erstellen Ihrer Funktion Folgendes:
- Funktionen müssen in JavaScript geschrieben werden.
- Sie können die von Ihnen definierten Eingaben lesen, Ihre Variablen wiederverwenden und Ihre anderen Funktionen aufrufen.
- Während der Eingabe werden Vorschläge angezeigt.
-
Um die Funktionsformatierung zu bereinigen, klicken Sie auf Beautify.
-
(Optional) Definieren Sie auf der Registerkarte Parameter die Eingaben, die Ihre Funktion erwartet.
Informationen zu Eingaben finden Sie unter Definieren von Eingaben in diesem Artikel.
-
Testen Sie auf Registerkarte Ihre Funktion.
Anweisungen finden Sie unter Testen einer Funktion in diesem Artikel.
-
Um diese Funktion als Entwurf zu speichern, klicken Sie auf Als Entwurf speichern.
ODER
Um die Funktion zu veröffentlichen, klicken Sie auf "".
note NOTE Das Veröffentlichen einer Funktion löscht ihren Versionsverlauf. Die veröffentlichte Version wird zum aktuellen Ausgangspunkt, und frühere Entwurfsversionen werden nicht mehr beibehalten.
Eingaben definieren
Auf der Registerkarte Parameter können Sie die Informationen beschreiben, die Ihre Funktion bei jeder Ausführung benötigt.
-
Klicken Sie auf Registerkarte Pakete
-
Wählen Sie im Bereich Funktionen die Option Funktion erstellen.
ODER
Klicken Sie auf das Kontrollkästchen neben einer vorhandenen Funktion und wählen Sie Bearbeiten in der Aktionsleiste unten auf der Seite aus.
-
Klicken Sie auf Registerkarte Parameter“.
-
Klicken Sie für jeden Parameter, den Sie hinzufügen möchten auf „Parameter hinzufügen und konfigurieren Sie Folgendes:
- Name: Der Name der Eingabe
- Label: Ein benutzerfreundlicher Name, der beim Testen der Funktion angezeigt wird
- Type: Der Datentyp, z. B. Text, Zahl, true/false oder ein strukturiertes Objekt.
- Erforderlich: Ob ein Wert angegeben werden muss.
Diese Eingaben werden zu den Feldern, die Sie beim Testen ausfüllen, und zu den Werten, die Ihr Szenario beim Ausführen der Funktion übergibt.
Testen einer Funktion
Es wird empfohlen, eine Funktion vor ihrer Veröffentlichung zu testen.
-
Klicken Sie auf Registerkarte Pakete
-
Wählen Sie im Bereich Funktionen die Option Funktion erstellen.
ODER
Klicken Sie auf das Kontrollkästchen neben einer vorhandenen Funktion und wählen Sie Bearbeiten in der Aktionsleiste unten auf der Seite aus.
-
Klicken Sie auf Registerkarte Test“.
-
Geben Sie für jede Eingabe einen Wert ein.
-
Funktion ausführen:
- Wählen Entwurf testen, um Ihre laufende Version zu testen.
- Wählen Veröffentlicht ausführen, um die Live-Version auszuführen.
-
Überprüfen Sie das Ergebnis, einschließlich der Frage, ob es erfolgreich war, wie lange es dauerte und welche Ausgabe zurückgegeben wurde.
Änderungen an einer Live-Funktion vornehmen
Nachdem eine Funktion veröffentlicht wurde, wird die Schaltfläche Veröffentlichen zu einem Menü:
- Erneut veröffentlichen — Pushen Sie Ihre neuesten Entwurfsänderungen auf die Live-Version.
- Veröffentlichung aufheben - Die Funktion wird nicht mehr bereitgestellt. Ihre Arbeit wird als Entwurf gespeichert, damit Sie darauf zurückkommen können.
Funktion löschen
- Klicken Sie auf Registerkarte Pakete
- Klicken Sie auf das Kontrollkästchen neben einer vorhandenen Funktion und wählen Sie Löschen in der Aktionsleiste am unteren Rand der Seite aus.
Variablen
Variablen sind wiederverwendbare Werte, die Ihre Funktionen verwenden können, z. B. eine Basis-URL, eine Konto-ID oder ein API-Schlüssel. Wenn Sie diese Variablen als Variablen speichern, legen Sie einen Wert einmal fest und aktualisieren ihn an einer Stelle, anstatt ihn über viele Funktionen hinweg zu aktualisieren.
Erstellen oder Bearbeiten einer Variablen
-
Klicken Sie auf Registerkarte Pakete
-
Wählen Sie auf der Variablen die Option Neue Variable aus.
ODER
Klicken Sie auf Bearbeiten-Symbol neben der Variablen, die Sie bearbeiten möchten.
-
Füllen Sie die Details aus:
- Schlüssel: Geben Sie den Namen ein, mit dem Ihre Funktionen auf den Wert verweisen.
Um diese Variable umzubenennen, ändern Sie den Schlüsselwert.
- Wert: Geben Sie den zu speichernden Wert ein.
- Type: Wählen Sie aus, ob der Werttyp Text, eine Zahl, ein boolescher Wert (true/false) oder ein strukturiertes Objekt ist.
- Beschreibung: Geben Sie einen optionalen Hinweis ein, um Sie daran zu erinnern, wozu er verwendet werden soll.
- Öffentlich: Aktivieren Sie diese Option, wenn Sie die Variable im Szenario-Designer verwenden möchten. Wenn diese Option deaktiviert ist, ist die Variable nur innerhalb der -Funktionen des Pakets verfügbar.
- Geheimnis: Aktivieren Sie diese Option, um vertrauliche Werte wie Schlüssel auszublenden. Der Wert wird in der Variablenliste ausgeblendet und ebenfalls bereinigt, sodass er nicht im Szenario-Designer verfügbar gemacht wird. Ihre Funktionen erhalten bei ihrer Ausführung weiterhin den tatsächlichen Wert.
-
Wählen Variable erstellen oder Änderungen speichern.
Löschen einer Variablen
- Klicken Sie auf Registerkarte Pakete
- Klicken Sie auf Registerkarte auf das Symbol Löschen neben der Variablen, die Sie löschen möchten.
Abhängigkeiten
Einige Funktionen erfordern zusätzliche Bibliotheken, um ihre Aufgabe zu erfüllen. Auf Registerkarte Abhängigkeiten“ können Sie diese Bibliotheken hinzufügen und verwalten.
Bibliotheken hinzufügen
-
Klicken Sie auf Registerkarte Pakete
-
Geben Sie auf Registerkarte einen oder mehrere Bibliotheksnamen ein, getrennt durch Kommas. Sie können eine bestimmte Version anfordern, indem Sie sie nach dem Namen hinzufügen (z. B.
axios, lodash@4.17.21). -
Klicken Sie auf Installieren.
Bibliothek entfernen
- Klicken Sie auf Registerkarte Pakete
- Klicken Sie auf Registerkarte auf das Symbol Löschen neben der Bibliothek, die Sie entfernen möchten.
Verlauf
Jedes Mal, wenn Sie einen Entwurf einer Funktion speichern, speichert Fusion eine Kopie. Auf Registerkarte Verlauf“ können Sie frühere Versionen anzeigen und wiederherstellen.
-
Klicken Sie auf Registerkarte Pakete
-
Wählen Sie auf Registerkarte Verlauf“ auf der linken Seite eine Funktion aus, um deren zuletzt gespeicherte Versionen anzuzeigen.
-
Wählen Sie eine Version aus, um genau anzuzeigen, was sie zu diesem Zeitpunkt enthielt.
-
Um eine Version wiederherzustellen, klicken Sie auf Als Entwurf wiederherstellen.
Die Version wird als neuer Entwurf wiederhergestellt, sodass Sie sie vor der Veröffentlichung überprüfen und testen können. Ihre Live-Version bleibt bis zur Veröffentlichung bestehen.
-
Um eine Version zu löschen, wählen Sie die Version aus, klicken Sie auf Version löschen und bestätigen Sie dann.
- Das Veröffentlichen einer Funktion löscht ihren Verlauf. Der Verlauf verfolgt die Änderungen, die Sie während der Arbeit an einem Entwurf vornehmen, bis zur Veröffentlichung.
- Das Löschen einer Version kann nicht rückgängig gemacht werden.
Verwenden eines Pakets in einem Szenario
Der Zweck des Erstellens von Funktionen und Variablen besteht darin, sie in Ihren Szenarien zum Einsatz zu bringen. Um Funktionen und Variablen zu verwenden, verwenden Sie den Adobe App Builder-Connector.
- Funktion aus Paket verwenden: Dieses Modul führt eine Ihrer Funktionen als Schritt in einem Szenario aus. Wählen Sie das Paket und die Funktion aus, füllen Sie die von Ihnen definierten Eingaben aus, und das Ergebnis der Funktion wird an die folgenden Module weitergegeben.
- Variable aus Paket verwenden: Dieses Modul bringt eine Ihrer Paketvariablen in ein Szenario, sodass Sie seinen Wert anderen Modulen zuordnen können.
Informationen und Anweisungen finden Sie unter Adobe App Builder-Module.