Adobe Workfront-Module
- die Verwendung des neuen Connectors beim Erstellen oder Aktualisieren eines Szenarios,
- die Aktualisierung vorhandener Module auf den neuen Connector.
Mit dem Adobe Workfront-Connector von Adobe Workfront Fusion können Sie Ihre Prozesse in Workfront automatisieren. Sie können Workfront auch mit anderen Anwendungen und Services verbinden.
Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Erstellen von Szenarios: Artikelindex. Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.
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 | Wenn Ihre Organisation über ein Workfront Select- oder Prime-Paket ohne Workfront Automation and Integration verfügt, muss Ihre Organisation Adobe Workfront Fusion erwerben. |
Weitere Details zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Verbinden von Workfront mit Workfront Fusion
Der Workfront-Connector nutzt OAuth 2.0, um eine Verbindung zu Workfront herzustellen.
Sie können direkt aus einem Workfront Fusion-Modul heraus eine Verbindung zu Ihrem Workfront-Konto herstellen.
Herstellen einer Verbindung mit Workfront per Client-ID und Client-Geheimnis
-
Klicken Sie in einem beliebigen Adobe Workfront-Modul neben dem Feld „Verbindung“ auf Hinzufügen.
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header Verbindungstyp Wählen Sie Adobe Workfront-Authentifizierungsverbindung aus. Verbindungsname Geben Sie einen Namen für die neue Verbindung ein. Client-ID Geben Sie Ihre Workfront-Client-ID ein. Diese finden Sie im Workfront-Bereich „Setup“ unter „OAuth2-Programme“. Öffnen Sie die Anwendung, zu der eine Verbindung hergestellt werden soll, um die Client-ID anzuzeigen. Client-Geheimnis Geben Sie Ihr Workfront-Client-Geheimnis ein. Diese finden Sie im Workfront-Bereich „Setup“ unter „OAuth2-Programme“. Wenn Sie in Workfront kein Client-Geheimnis für Ihre OAuth2-Anwendung besitzen, können Sie ein anderes generieren. Anweisungen hierzu finden Sie in der Workfront-Dokumentation. Authentifizierungs-URL Hier kann der Standardwert bleiben. Sie können aber auch die URL Ihrer Workfront-Instanz gefolgt von
/integrations/oauth2eingeben.Beispiel:
https://mydomain.my.workfront.com/integrations/oauth2Host-Präfix In den meisten Fällen sollte dieser Wert auf origingesetzt werden. -
Klicken Sie auf Weiter, um die Verbindung zu speichern und zum Modul zurückzukehren.
Wenn Sie nicht bei Workfront angemeldet sind, werden Sie zu einem Anmeldebildschirm weitergeleitet. Nach der Anmeldung können Sie die Verbindung zulassen.
- OAuth 2.0-Verbindungen zur Workfront-API sind nicht mehr auf API-Schlüssel angewiesen.
- Um eine Verbindung zu einer Workfront-Sandbox-Umgebung herzustellen, müssen Sie in dieser Umgebung eine OAuth2-Anwendung erstellen und dann die Client-ID und das Client-Geheimnis, die von dieser Anwendung generiert wurden, in Ihrer Verbindung verwenden.
Herstellen einer Verbindung mit Workfront per Server-zu-Server-Verbindung
-
Klicken Sie in einem beliebigen Adobe Workfront-Modul neben dem Feld „Verbindung“ auf Hinzufügen.
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header Verbindungstyp Wählen Sie Adobe Workfront-Server-zu-Server-Verbindung aus. Verbindungsname Geben Sie einen Namen für die neue Verbindung ein. Instanzname Geben Sie den Namen Ihrer Instanz ein (auch als Domain bezeichnet).
Wenn Ihre URL z. B.
https://example.my.workfront.comlautet, geben Sieexampleein.Instanzen-Lane Geben Sie den Umgebungstyp für die Verbindung ein.
Wenn Ihre URL z. B.
https://example.my.workfront.comlautet, geben Siemyein.Client-ID Geben Sie Ihre Workfront-Client-ID ein. Diese finden Sie im Workfront-Bereich „Setup“ unter „OAuth2-Programme“. Öffnen Sie die Anwendung, zu der eine Verbindung hergestellt werden soll, um die Client-ID anzuzeigen. Client-Geheimnis Geben Sie Ihr Workfront-Client-Geheimnis ein. Diese finden Sie im Workfront-Bereich „Setup“ unter „OAuth2-Programme“. Wenn Sie in Workfront kein Client-Geheimnis für Ihre OAuth2-Anwendung besitzen, können Sie ein anderes generieren. Anweisungen hierzu finden Sie in der Workfront-Dokumentation. Bereiche Geben Sie alle zutreffenden Bereiche für diese Verbindung ein. Host-Präfix In den meisten Fällen sollte dieser Wert auf origingesetzt werden. -
Klicken Sie auf Weiter, um die Verbindung zu speichern und zum Modul zurückzukehren.
Wenn Sie nicht bei Workfront angemeldet sind, werden Sie zu einem Anmeldebildschirm weitergeleitet. Nach der Anmeldung können Sie die Verbindung zulassen.
- OAuth 2.0-Verbindungen zur Workfront-API sind nicht mehr auf API-Schlüssel angewiesen.
- Um eine Verbindung zu einer Workfront-Sandbox-Umgebung herzustellen, müssen Sie in dieser Umgebung eine OAuth2-Anwendung erstellen und dann die Client-ID und das Client-Geheimnis, die von dieser Anwendung generiert wurden, in Ihrer Verbindung verwenden.
Workfront-Module und ihre Felder
Beim Konfigurieren von Workfront-Modulen werden in Workfront Fusion die unten aufgeführten Felder angezeigt. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der Anwendung oder im Service weitere Workfront-Felder angezeigt werden. Ein fett formatierter Titel in einem Modul kennzeichnet ein Pflichtfeld.
Wenn die Schaltfläche „Zuordnung“ über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen zwischen Modulen.
- Wenn in einem Workfront-Modul nicht die aktuellen Felder angezeigt werden, kann dies an Caching-Problemen liegen. Warten Sie in einem solchen Fall eine Stunde und versuchen Sie es dann erneut.
- Ein Status-Code „HTTP 429“ von Adobe Workfront sollte zu keinen Deaktivierungen führen, sondern vielmehr eine kurze Ausführungspause im Szenario auslösen.
Auslöser
Ereignisse überwachen
Dieses Auslösermodul führt ein Szenario in Echtzeit aus, wenn Objekte eines bestimmten Typs in Workfront hinzugefügt, aktualisiert oder gelöscht werden.
Das Modul zeigt alle Ereignisabonnements an, die mit dem Webhook verbunden sind. Dazu gehören Ereignisabonnements, die über Fusion erstellt wurden, sowie Ereignisabonnements, die direkt über die API erstellt wurden. Diese Ereignisabonnementansicht ist in der Legacy-Version des Moduls „Ereignisse überwachen“ nicht verfügbar.
Das Modul gibt alle Standardfelder zurück, die mit dem Eintrag verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
- Der bearbeitete Webhook wird von Workfront-Ereignisabonnements als neues Abonnement behandelt. Der Verlauf der Ereignisabonnements wird für die vorherige Webhook-Konfiguration nicht beibehalten, da dies als separates Ereignisabonnement betrachtet wird.
- Der Wechsel vom alten zum neuen Ereignisabonnement ist möglicherweise nicht perfekt synchronisiert. Es ist daher möglich, ein Ereignis zweimal zu erhalten (wenn das neue Abonnement vor dem alten abläuft) oder ein Ereignis zu verpassen (wenn das alte Abonnement vor dem Start des neuen abläuft).
-
Klicken Sie rechts neben dem Feld Webhook auf Hinzufügen.
-
Konfigurieren Sie den Webhook im angezeigten Feld Hook hinzufügen.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header Webhook-Name Geben Sie einen Namen für den Webhook ein. Verbindung Anweisungen zum Verbinden Ihrer Workfront-Anwendung mit Workfront Fusion finden Sie in diesem Artikel unter Verbinden von Workfront mit Workfront Fusion. Eintragstyp Wählen Sie den Typ des Workfront-Eintrags aus, der vom Modul überwacht werden soll. Status Wählen Sie aus, ob der alte oder der neue Status überwacht werden soll.
-
Neuer Status
Lösen Sie ein Szenario aus, wenn sich der Eintrag in einen bestimmten Wert ändert.
Wenn beispielsweise der Status auf „Neuer Status“ und der Filter auf „Status gleich In Arbeit“ gesetzt ist, löst der Webhook beim Wechsel des Status zu „In Arbeit“ ein Szenario aus. Dies gilt unabhängig vom vorherigen Status.
-
Alter Status
Lösen Sie ein Szenario aus, wenn sich der Eintrag von einem bestimmten Wert ändert.
Wenn beispielsweise der Status auf „Alter Status“ und der Filter auf „Status gleich In Arbeit“ gesetzt ist, löst der Webhook beim Wechsel eines Status vom Typ „In Arbeit“ zu einem anderen Status ein Szenario aus.
Ereignisfilter Sie können Filter festlegen, um nur auf Einträge zu achten, die die von Ihnen ausgewählten Kriterien erfüllen.
Geben Sie für jeden Filter Folgendes an: das Feld, das vom Filter ausgewertet werden soll, den Operator und den Wert, den der Filter zulassen soll. Sie können mehr als einen Filter verwenden, indem Sie UND-Regeln hinzufügen.
HINWEIS: Filter in vorhandenen Workfront-Webhooks können nicht bearbeitet werden. Um verschiedene Filter für Workfront-Ereignisabonnements einzurichten, entfernen Sie den aktuellen Webhook und erstellen Sie einen neuen.
Weitere Informationen zu Ereignisfiltern finden Sie in diesem Artikel unter Ereignisabonnementfilter in den Modulen unter „Workfront“ > „Ereignisse überwachen“.
Von dieser Verbindung stammende Ereignisse ausschließen Aktivieren Sie diese Option, um Ereignisse auszuschließen, die mit dem von diesem Auslösermodul verwendeten Connector erstellt oder aktualisiert wurden. Dadurch lassen sich Situationen verhindern, in denen ein Szenario von sich selbst ausgelöst und in einer Endlosschleife wiederholt wird.
HINWEIS: Der Eintragstyp „Zuweisung“ umfasst diese Option nicht.
Eintragsursprung Wählen Sie aus, ob das Szenario eine Überwachung anhand der Option „Nur neue Einträge“, „Nur aktualisierte Einträge“, „Neue und aktualisierte Einträge“ oder „Deleted Records Only“ durchführen soll.
HINWEIS: Wenn Sie die Option „Neue und aktualisierte Einträge“ auswählen, werden im Rahmen der Webhook-Erstellung zwei Ereignisabonnements (für dieselbe Webhook-Adresse) erstellt.
Sichere Hooks aktivieren Wählen Sie aus, ob die authToken-basierte Sicherheit für diesen Webhook aktiviert werden soll.
HINWEIS: Nach dem 23. August 2026 aktiviert Fusion standardmäßig die authToken-basierte Sicherheit für alle Workfront > Watch Event-Module, einschließlich der vorhandenen. Wenn ein bestimmter Webhooks unterbrochen wird oder Sie dies aus Kompatibilitätsgründen deaktivieren müssen, können Sie die Option Sichere Hooks aktivieren vor dem 23. August 2026 deaktivieren.
-
Nachdem der Webhook erstellt wurde, können Sie die Adresse des Endpunkts anzeigen, an den Ereignisse gesendet werden.
Weitere Informationen finden Sie in der Workfront-Dokumentation im Artikel „Ereignisabonnement-API“ unter Beispiele für Ereignis-Payloads.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Feld überwachen
Dieses Auslösermodul führt ein Szenario aus, wenn ein von Ihnen angegebenes Feld aktualisiert wird. Das Modul gibt sowohl den alten als auch den neuen Wert des angegebenen Felds zurück. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Eintrag überwachen
Dieses Auslösermodul führt ein Szenario aus, wenn Objekte eines bestimmten Typs hinzugefügt und/oder aktualisiert werden. Das Modul gibt alle Standardfelder zurück, die mit dem Eintrag bzw. den Einträgen verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
In der Ausgabe gibt das Modul an, ob es sich jeweils um einen neuen oder aktualisierten Eintrag handelt.
Einträge, die seit der letzten Szenario-Ausführung hinzugefügt und aktualisiert wurden, werden als neue Einträge zurückgegeben.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Aktionen
Objekt konvertieren
Dieses Aktionsmodul führt eine der folgenden Konvertierungen durch:
- Problem in Projekt konvertieren
- Problem in Aufgabe konvertieren
- Aufgabe in Projekt konvertieren
Eintrag erstellen
Dieses Aktionsmodul erstellt ein Objekt, z. B. ein Projekt, eine Aufgabe oder ein Problem in Workfront, und ermöglicht das Hinzufügen eines benutzerdefinierten Formulars zum neuen Objekt. Mit dem Modul können Sie auswählen, welche Objektfelder im Modul verfügbar sind.
Geben Sie die ID des Eintrags an.
Das Modul gibt daraufhin die ID des Eintrags und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Achten Sie darauf, die Mindestanzahl von Eingabefeldern anzugeben. Beim Erstellen eines Problems müssen Sie beispielsweise im Feld „Projekt-ID“ eine gültige übergeordnete Projekt-ID angeben, um die Problemstelle in Workfront anzugeben. Sie können das Zuordnungs-Panel verwenden, um diese Informationen aus einem anderen Modul in Ihrem Szenario zuzuordnen. Eine manuelle Eingabe ist ebenfalls möglich. Geben Sie hierzu den Namen ein und wählen Sie dann diesen aus der Liste aus.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
- Bei der Eingabe der ID eines Objekts können Sie mit der Eingabe des Namens des Objekts beginnen und es dann aus der Liste auswählen. Das Modul trägt daraufhin die entsprechende ID in das Feld ein.
- Bei der Eingabe von Text für ein benutzerdefiniertes Feld oder ein Objekt vom Typ Notiz (Kommentar oder Antwort) können Sie mithilfe von HTML-Tags im Feld Notizentext Rich-Text erstellen, z. B. fett oder kursiv formatierten Text.
-
Lösen von Problemen bei einzelnen Benutzenden
In der Benutzerliste können Sie Probleme bei einzelnen Benutzenden lösen.
- Wählen Sie die Benutzenden in der Benutzerliste aus.
- Klicken Sie auf das Dreipunkt-Menü in der Listenüberschrift.
- Wählen Sie Genehmigen aus.
- Aktualisieren Sie die Seite nach einigen Minuten.
-
Lösen von Problemen bei Benutzenden, die in großer Anzahl hinzugefügt wurden
Um Probleme bei Benutzenden zu lösen, die in großer Anzahl hinzugefügt wurden, können Sie den Batch von Benutzenden direkt in der Adobe Admin Console hinzufügen.
Anweisungen finden Sie unter Verwalten mehrerer Benutzender | CSV-Massen-Upload in der Adobe-Dokumentation.
Benutzerdefinierter API-Aufruf
Mit diesem Aktionsmodul können Sie einen benutzerdefinierten authentifizierten Aufruf an die Workfront-API durchführen. Auf diese Weise können Sie eine Datenflussautomatisierung erstellen, was über die anderen Workfront-Module nicht möglich ist.
Das Modul enthält folgende Informationen:
-
Status-Code (Zahl): Gibt den Erfolg oder Misserfolg Ihrer HTTP-Anfrage an. Hierbei handelt es sich um Standard-Codes, die Sie im Internet recherchieren können.
-
Header (Objekt): Ein ausführlicherer Kontext für die Antwort/den Status-Code, der sich nicht auf den Ausgabetext bezieht. Nicht alle Header, die in einem Antwort-Header angezeigt werden, sind Antwort-Header. Einige sind also möglicherweise nicht nützlich für Sie.
Die Antwort-Header hängen von der beim Konfigurieren des Moduls ausgewählten HTTP-Anfrage ab.
-
Text (Objekt): Je nach HTTP-Anfrage, die Sie beim Konfigurieren des Moduls ausgewählt haben, erhalten Sie möglicherweise bestimmte Daten zurück. Diese Daten, etwa die Daten aus einer GET-Anfrage, sind in diesem Objekt enthalten.
Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Eintrag löschen
Dieses Aktionsmodul löscht ein Objekt, z. B. ein Projekt, eine Aufgabe oder ein Problem in Workfront.
Geben Sie die ID des Eintrags an.
Das Modul gibt daraufhin die ID des Eintrags und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
- Löschen Sie den Eintrag synchron.
- Fügen Sie dem Modul „Eintrag löschen“ Anweisungen zur Fehlerbehandlung hinzu, um den Fehler zu ignorieren, der durch den Timeout nach 40 Sekunden verursacht wird.
Dokument herunterladen
Dieses Aktionsmodul lädt ein Dokument von Workfront herunter.
Geben Sie die ID des Eintrags an.
Das Modul gibt den Inhalt, den Dateinamen, die Dateierweiterung und die Dateigröße des Dokuments zurück. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Abrufen einer vordefinierten Datei-URL
Dieses Aktionsmodul ruft vorsignierte Datei-URLs ab, die später von anderen APIs verwendet werden können.
Sonstige Aktion
Mit diesem Aktionsmodul können Sie Aktionen für die API durchführen.
convertToProject das Feld copyCategories. Beim Festlegen von TRUE werden alle benutzerdefinierten Formulare in das Projekt eingeschlossen, in das das Problem konvertiert wird.Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Projekt
Eintrag lesen
Dieses Aktionsmodul ruft Daten aus einem einzelnen Eintrag ab.
Geben Sie die ID des Eintrags an. Sie können auch angeben, welche verwandten Einträge vom Modul gelesen werden sollen.
Wenn es sich bei dem Eintrag, den das Modul liest, beispielsweise um ein Projekt handelt, können Sie angeben, dass die Aufgaben des Projekts gelesen werden sollen.
Das Modul gibt ein Array von Daten aus den von Ihnen angegebenen Ausgabefeldern zurück.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Payload-Version der Ereignisse aktualisieren
Workfront hat kürzlich eine neue Version seines Ereignisabonnement-Services veröffentlicht. Die neue Version bewirkt keine Änderung der Workfront-API, sondern der Ereignisabonnementfunktion. Dieses Aktionsmodul aktualisiert die für dieses Szenario verwendete Ereignis-Payload-Version.
Weitere Informationen zur neuen Ereignisabonnementversion finden Sie in der Workfront-Dokumentation unter Ereignisabonnement-Versionierung.
Ressourcen zum Beibehalten Ihrer Workfront Fusion-Szenarios während des Ereignisabonnement-Upgrades, einschließlich einer Webinar-Aufzeichnung, finden Sie unter Beibehalten Ihrer Fusion-Szenarios beim Upgrade auf Ereignisabonnements V2.
Eintrag aktualisieren
Dieses Aktionsmodul aktualisiert ein Objekt, z. B. ein Projekt, eine Aufgabe oder ein Problem. Mit dem Modul können Sie auswählen, welche Objektfelder im Modul verfügbar sind.
Geben Sie die ID des Eintrags an.
Das Modul gibt daraufhin die ID des Objekts und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Dokument hochladen
Dieses Aktionsmodul lädt ein Dokument in ein Workfront-Objekt hoch, z. B. in ein Projekt, eine Aufgabe oder ein Problem. Mit diesem Modul wird das Dokument in Blöcken hochgeladen, was einen reibungsloseren Upload-Prozess in Workfront ermöglicht.
Dieses Modul kann größere Dateien als das Legacy-Modul verarbeiten und wird schrittweise an Organisationen mit Workfront-Ultimate-Paket ausgerollt.
Geben Sie den Speicherort für das Dokument, die hochzuladende Datei und einen optionalen neuen Namen für die Datei an.
Das Modul gibt daraufhin die ID des Dokuments und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.
Suchvorgänge
Verwandte Einträge lesen
Dieses Suchmodul liest Einträge, die mit Ihrer Suchanfrage in einem bestimmten übergeordneten Objekt übereinstimmen.
Legen Sie fest, welche Felder in der Ausgabe enthalten sein sollen. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Suche
Dieses Suchmodul sucht in einem Objekt in Workfront nach Einträgen, die mit Ihrer Suchanfrage übereinstimmen.
Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Suchen (Legacy)
Vorhandene Szenarios, die dieses Modul nutzen, funktionieren weiterhin erwartungsgemäß. Dieses Modul wurde im Mai 2025 aus der Modulauswahl entfernt.
Dieses Suchmodul sucht in einem Objekt in Workfront nach Einträgen, die mit Ihrer Suchanfrage übereinstimmen.
Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen
Für jedes Workfront-Trigger-Modul verfügbare Objekttypen
Für jedes Workfront-Aktionsmodul verfügbare Objekttypen
Für jedes Workfront-Suchmodul verfügbare Objekttypen
Sie sollten überprüfen, ob alles erwartungsgemäß funktioniert.
Ereignisabonnementfilter in den Workfront-Modulen Ereignisse überwachen
Mit Filtern in Ereignisabonnements können Sie sicherstellen, dass Ihre Szenarien nur ausgeführt werden, wenn bestimmte Parameter erfüllt sind.
Best Practices für Ereignisabonnementfilter
-
Es wird ausdrücklich empfohlen, Ereignisabonnementfilter in den Modulen Ereignisse überwachen zu verwenden.
-
Workfront hat kürzlich eine neue Version seines Ereignisabonnement-Services veröffentlicht. Die neue Version bewirkt keine Änderung der Workfront-API, sondern der Ereignisabonnementfunktion. Dieses Aktionsmodul aktualisiert die für dieses Szenario verwendete Ereignis-Payload-Version.
Weitere Informationen zur neuen Ereignisabonnementversion finden Sie in der Workfront-Dokumentation unter Ereignisabonnement-Versionierung.
Ressourcen zum Beibehalten Ihrer Workfront Fusion-Szenarios während des Ereignisabonnement-Upgrades, einschließlich einer Webinar-Aufzeichnung, finden Sie unter Beibehalten Ihrer Fusion-Szenarios beim Upgrade auf Ereignisabonnements V2.
Das Workfront-Modul Ereignisse überwachen löst Szenarios auf Basis eines Webhooks aus, der ein Ereignisabonnement in der Workfront-API erstellt. Das Ereignisabonnement ist ein Satz von Daten, der bestimmt, welche Ereignisse an den Webhook gesendet werden. Wenn Sie beispielsweise ein Modul Ereignisse überwachen einrichten, das auf Probleme achtet, sendet das Ereignisabonnement ausschließlich Ereignisse, die mit Problemen in Zusammenhang stehen.
Durch Verwendung von Ereignisabonnementfiltern können Fusion-Benutzende Ereignisabonnements erstellen, die für ihre Anwendungsfälle besser geeignet sind. Sie können z. B. ein Ereignisabonnement in der Workfront-API einrichten, um nur Probleme in einem bestimmten Projekt an den Webhook zu senden und so sicherzustellen, dass das Modul Ereignisse überwachen Szenarios nur für Probleme in diesem Projekt auslöst. Die Möglichkeit, genauer definierte Auslöser zu erstellen, verbessert das Szenario-Design, indem die Anzahl irrelevanter Auslöser reduziert wird.
Dies unterscheidet sich vom Einrichten eines Filters im Workfront Fusion-Szenario. Ohne einen Ereignisabonnementfilter erhält Ihr Webhook alle Ereignisse, die mit dem ausgewählten Objekttyp zusammenhängen. Die meisten dieser Ereignisse sind für das Szenario irrelevant und müssen herausgefiltert werden, bevor das Szenario fortgesetzt werden kann.
Die folgenden Operatoren sind im Filter unter „Workfront“ > „Ereignisse überwachen“ verfügbar:
-
Gleich
-
Ungleich
-
Größer als
-
Kleiner als
-
Größer oder gleich
-
Kleiner oder gleich
-
Enthält
-
Vorhanden
- Dieser Operator benötigt keinen Wert und das Wertfeld ist nicht vorhanden.
-
Existiert nicht
- Dieser Operator benötigt keinen Wert und das Wertfeld ist nicht vorhanden.
-
Geändert
- Dieser Operator benötigt keinen Wert und das Wertfeld ist nicht vorhanden.
- Dieser Operator ignoriert das Feld „Status“.
- Wählen Sie bei Verwendung von
Changedim Feld Eintragsursprung die Option Nur aktualisierte Ereignisse aus.
Filtern von Ereignissen mithilfe eines Ereignisabonnementfilters (empfohlen)
Filtern von Ereignissen innerhalb des Szenarios (nicht empfohlen)
Weitere Informationen zu Workfront-Ereignisabonnements finden Sie unter Häufig gestellte Fragen – Ereignisabonnements.
Weitere Informationen zu Webhooks finden Sie unter Instant-Auslöser (Webhooks) in Adobe Workfront Fusion.
Weitere Informationen zu Filtern in Szenarios finden Sie unter Hinzufügen eines Filters zu einem Szenario.
Erweiterte Filter verwenden
Das Modul Workfront > Ereignisse beobachten bietet zwei Filtertypen.
- Einfach: Dieser Filter bietet eine Schnittstelle, über die Sie Felder, Operatoren und Werte zusammen mit AND- und OR-Operatoren auswählen können, um einen Filter zu erstellen.
- Erweitert: Mit diesem Filter können Sie JSON hochladen, die Ihren Filter darstellt.
Einfache und erweiterte Filter im Vergleich
Der Hauptunterschied zwischen den beiden Typen ist der Status des Filters.
- Einfach: Beim Einrichten eines einfachen Filters können Sie auswählen, ob Sie nach dem alten oder dem neuen Status eines Felds filtern möchten. Das heißt, Sie entscheiden, ob Sie das Szenario aktivieren möchten, wenn sich das Feld von einem bestimmten Wert ändert, oder ob es aktiviert werden soll, wenn sich der Wert von ändert. Mit AND und OR können Sie mehrere Felder und Werte einbeziehen, sie müssen jedoch denselben Status aufweisen. Sie können für einige Felder nicht den alten und für andere den neuen Status verwenden.
- Erweitert: Sie können die JSON in einem erweiterten Filter konfigurieren, um Werte für den alten und den neuen Status im selben Filter anzugeben. Sie können beispielsweise angeben, dass Sie ein Szenario in den Trigger versetzen möchten, wenn ein Projekt von einem Planungsstatus in einen aktuellen Status wechselt. Dadurch würden Projekte ausgeschlossen, die von „Planung“ in „Eingestellt“ oder von „Gesperrt“ in „Aktuell“ wechseln.