Adobe Workfront Planning-Module
Mit den Adobe Workfront Planning-Modulen können Sie einen Trigger erstellen, wenn in Workfront Planning Ereignisse eintreten. Sie können auch Datensätze erstellen, lesen, aktualisieren und löschen oder einen benutzerdefinierten API-Aufruf an Ihr Adobe Workfront Planning-Konto durchführen.
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.
Voraussetzungen
Für den Zugriff auf Workfront Planning sind folgende Voraussetzungen erforderlich:
- Ein neues Workfront-Paket und eine neue Lizenz. Workfront Planning ist nicht für ältere Workfront-Pakete oder -Lizenzen verfügbar.
- Ein Workfront-Planungspaket.
- Die Workfront-Instanz Ihres Unternehmens muss in das einheitliche Adobe-Erlebnis integriert werden.
Informationen zur Adobe Workfront Planning-API
Der Adobe Workfront Planning-Connector verwendet Folgendes:
Workfront Planning mit Workfront Fusion verbinden
Der Workfront Planning-Connector verwendet OAuth 2.0, um eine Verbindung zu Workfront Planning herzustellen.
Sie können direkt aus einem Workfront Planning Fusion-Modul heraus eine Verbindung zu Ihrem Workfront Planning-Konto erstellen.
Verbindung mit Workfront Planning über Client-ID und Client-Geheimnis herstellen
-
Klicken Sie in einem beliebigen Adobe Workfront Planungsmodul neben dem Feld Verbindung 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 Adobe Workfront-Auth-Verbindung auswählen. 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 Planning 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 Planning über eine Server-zu-Server-Verbindung
-
Klicken Sie in einem beliebigen Adobe Workfront Planungsmodul neben dem Feld Verbindung 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 Planning 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.
Adobe Workfront Planning Version 2-Module und ihre Felder
Beim Konfigurieren von Workfront-Planungsmodulen zeigt Workfront Fusion die unten aufgeführten Felder an. 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.
Arbeitsbereiche (v2)
Erstellen eines Arbeitsbereichs (v2)
Dieses Aktionsmodul erstellt einen neuen Arbeitsbereich in Planning.
Löschen eines Arbeitsbereichs (v2)
Dieses Aktionsmodul löscht einen einzelnen Arbeitsbereich, angegeben durch eine ID.
Alle Arbeitsbereiche abrufen (v2)
Dieses Modul ruft eine Liste aller Arbeitsbereiche ab.
Abrufen eines Arbeitsbereichs (v2)
Dieses Modul ruft einen Arbeitsbereich anhand seiner ID ab.
Aktualisieren eines Arbeitsbereichs (v2)
Dieses Aktionsmodul aktualisiert einen neuen Arbeitsbereich in Planning.
Datensatztypen (v2)
Erstellen eines Datensatztyps (v2)
Dieses Aktionsmodul erstellt einen neuen Datensatztyp im ausgewählten Arbeitsbereich.
Löschen eines Datensatztyps (V2)
Dieses Aktionsmodul löscht einen einzelnen Datensatztyp, angegeben durch die ID.
Abrufen globaler Datensatztypen (v2)
Dieses Modul ruft eine Liste von Datensatztypen in einem Adobe Workfront Planning-Konto ab.
Datensatztyp abrufen (V2)
Dieses Modul ruft einen Datensatztyp anhand seiner ID ab.
Datensatztypen abrufen (v2)
Dieses Modul ruft eine Liste der in einem bestimmten Arbeitsbereich verfügbaren Datensatztypen ab.
Aktualisieren eines Datensatztyps (V2)
Dieses Modul aktualisiert einen Datensatztyp.
Datensätze (v2)
Erstellen eines Datensatzes (v2)
Diese Aktion erstellt in Workfront Planning einen einzigen Datensatz.
Löschen eines Datensatzes (v2)
Dieses Aktionsmodul löscht einen einzelnen Datensatz, angegeben durch eine ID.
Datensatz abrufen (v2)
Dieses Aktionsmodul ruft einen Datensatz ab, der durch seine ID angegeben wird.
Datensätze nach Datensatztyp abrufen (V2)
Dieses Modul ruft eine Liste aller Datensätze des angegebenen Datensatztyps ab.
Datensätze verschieben (v2)
Dieses Modul ordnet einen oder mehrere Datensätze innerhalb eines Datensatztyps neu an, indem angegeben wird, wo sie platziert werden sollen.
Datensätze suchen (v2)
Gibt Datensätze anhand von angegebenen Kriterien zurück.
Aktualisieren eines Datensatzes (v2)
Dieses Modul aktualisiert den angegebenen Datensatz.
Felder (v2)
Erstellen eines Felds (v2)
Dieses Aktionsmodul erstellt ein neues Feld für den angegebenen Datensatztyp.
Löschen eines Felds (v2)
Dieses Aktionsmodul löscht ein einzelnes Feld, angegeben durch eine ID.
Abrufen eines Felds (V2)
Dieses Modul ruft ein Feld anhand seiner ID ab.
Abrufen von Feldern nach Datensatztyp (V2)
Dieses Modul ruft eine Liste von Feldern für einen bestimmten Datensatztyp ab.
Aktualisieren eines Felds (V2)
Dieses Modul aktualisiert ein Feld teilweise anhand seiner ID.
Ansichten (v2)
Erstellen einer Ansicht (v2)
Dieses Aktionsmodul erstellt eine neue Ansicht für den ausgewählten Datensatztyp.
Löschen einer Ansicht (v2)
Dieses Aktionsmodul löscht eine einzelne Ansicht, angegeben durch eine ID.
Ansicht abrufen (v2)
Dieses Modul ruft anhand seiner ID eine Ansicht ab.
Ansichten nach Datensatztyp abrufen (V2)
Dieses Modul ruft eine Liste von Ansichten für den jeweiligen Datensatztyp ab.
Aktualisieren einer Ansicht (V2)
Dieses Aktionsmodul aktualisiert die angegebene Ansicht.
Berechtigungen (v2)
Schließen von Zugriffsanfragen (v2)
Dieses Aktionsmodul schließt eine oder mehrere Zugriffsanfragen ab, angegeben durch eine ID.
Abrufen aller Mitglieder und ihrer Rollen für eine Ressource (V2)
Dieses Modul listet alle Benutzer, Gruppen und Teams auf, die eine explizite Freigabebeziehung zur Ressource haben. Die in der Verbindung für dieses Modul verwendeten Anmeldeinformationen müssen über Verwaltungsberechtigungen für die Ressource verfügen.
Abrufen der effektiven Berechtigungen des aktuellen Benutzers für eine Ressource (V2)
Dieses Modul gibt die Anzeigen-, Bearbeitungs-, Lösch- und Hinzufügen-Berechtigungen der aktuellen Benutzerin bzw. des aktuellen Benutzers für eine bestimmte Ressource zurück.
Auflisten ausstehender Zugriffsanfragen für eine Ressource (V2)
Dieses Modul gibt alle ausstehenden Zugriffsanfragen für die angegebene Ressource zurück.
Anfordern des Zugriffs auf eine Ressource (V2)
Dieses Modul erstellt oder aktualisiert eine Zugriffsanfrage für den aktuellen Benutzer bzw. die aktuelle Benutzerin auf der angegebenen Ressource.
Sonstige (v2)
Authentifizierungs-ID von Workfront ID abrufen (V2)
Dieses Modul verwendet eine Workfront-Benutzer-ID und gibt die entsprechende Autorisierungs-ID zurück, die von Planning verwendet wird.
Erstellen eines benutzerdefinierten API-Aufrufs (V2)<table
Dieses Modul führt einen benutzerdefinierten Aufruf an die Workfront Planning-API durch.
https://<WORKFRONT_DOMAIN>/maestro/api/. ein.Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu. Dadurch wird der Content-Typ der Anfrage bestimmt.
Beispiel: {"Content-type":"application/json"}
Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"name":"something-urgent"}
Tipp: Es wird empfohlen, Informationen mittels JSON-Text und nicht als Abfrageparameter zu senden.
Fügen Sie den Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Hinweis:
Wenn Sie bedingte Anweisungen wie if in Ihrem JSON-Objekt verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.
Ereignisse ansehen (v2)
Dieses Trigger-Modul startet ein Szenario, wenn ein Datensatz, ein Datensatztyp oder ein Arbeitsbereich in Workfront Planning erstellt, aktualisiert oder gelöscht wird.
- 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).
Ein Beispiel für die Verwendung der erweiterten Logik in diesem Modul finden Sie Beispiel für die erweiterte Logik im Modul Ereignisse beobachten.
Adobe Workfront Planning Version 1-Module und ihre Felder
Beim Konfigurieren von Workfront-Planungsmodulen zeigt Workfront Fusion die unten aufgeführten Felder an. 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.
Auslöser
Ereignisse überwachen
Dieses Trigger-Modul startet ein Szenario, wenn ein Datensatz, ein Datensatztyp oder ein Arbeitsbereich in Workfront Planning erstellt, aktualisiert oder gelöscht wird.
- 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).
Ein Beispiel für die Verwendung der erweiterten Logik in diesem Modul finden Sie Beispiel für die erweiterte Logik im Modul Ereignisse beobachten.
Aktionen
Datensatztyp löschen
Dieses Aktionsmodul löscht einen einzelnen Datensatztyp in Workfront Planning anhand seiner ID.
Benutzerdefinierten API-Aufruf erstellen
Dieses Modul führt einen benutzerdefinierten API-Aufruf an die Adobe Workfront Planning-API durch.
https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"Content-type":"application/json"}
Workfront Fusion fügt automatisch Autorisierungs-Header hinzu.
Fügen Sie den Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Hinweis:
Wenn Sie bedingte Anweisungen wie if in Ihrem JSON-Objekt verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.
Suchvorgänge
Datensätze suchen
Dieses Aktionsmodul ruft eine Liste von Datensätzen basierend auf von Ihnen angegebenen Kriterien ab.
Nicht kategorisiert
Eintrag erstellen
Diese Aktion erstellt in Workfront Planning einen einzigen Datensatz.
Eintrag löschen
Dieses Aktionsmodul löscht den angegebenen Datensatz in Workfront Planning.
Datensatz abrufen
Dieses Aktionsmodul ruft einen einzelnen Datensatz aus Adobe Workfront Planning ab, angegeben durch die Kennung.
Datensätze nach Datensatztyp abrufen
Dieses Aktionsmodul ruft alle Datensätze des angegebenen Typs ab.
Datensatztypen abrufen
Dieses Aktionsmodul ruft eine Liste von Datensatztypen in einem Adobe Workfront Planning ab.
Eintrag aktualisieren
Diese Aktion aktualisiert einen einzelnen Datensatz in Workfront Planning.
Verwenden von JSONata für eine lesbare Aufschlüsselung der record-types
Der folgende JSONata-Ausdruck erstellt eine für Menschen lesbare Ausgabe der Planning-Abfrage, die Ihnen die Aufschlüsselung der Datensatztypen liefert. Dadurch können der Name des Datensatztyps, die Feldnamen und gegebenenfalls die Feldoptionennamen anhand eines Namens für Menschen lesbar gemacht werden, während der Rest der Struktur intakt bleibt.
(
$s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
$s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
$s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
$s2.data{displayName:$}
)
Informationen zur Verwendung von JSONata-Modulen finden Sie unter JSONata-Module.
Beispiel für die erweiterte Logik im Modul Ereignisse beobachten
Dies ist ein Beispiel für das Format, das die erweiterte Logik bei Verwendung des Moduls Workfront-Planung > Ereignisse beobachten annimmt.
[
{
"fieldName": "recordTypeId",
"fieldValue": "Rt68c886502d4b5554ee80896b",
"comparison": "eq",
"state": "newState"
},
{
"fieldName": "data",
"fieldValue": {
"F68c886502d4b5554ee808975": "planning"
},
"comparison": "eq",
"state": "newState"
},
{
"fieldName": "data",
"fieldValue": {
"F68c886502d4b5554ee808975": "active"
},
"comparison": "eq",
"state": "newState"
}
]
Beachten Sie Folgendes bei der Verwendung der erweiterten Logik im Modul Ereignisse beobachten:
- Der erste
"fieldvalue":ist die Kennung des Planungs-Datensatztyps, die von der URL abgerufen wird. In diesem Beispiel ist die Kennung des Planungs-DatensatztypsRt68c886502d4b5554ee80896b. - Planungsdaten werden in einem Array namens
datazurückgegeben, das in diesem Beispiel als"fieldName": "data"angezeigt wird. - Planning-Feldnamen werden als IDs zurückgegeben, die mit
Fbeginnen. - Da dieses Beispiel mit einem
ORFilter-Connector ausgewertet wird, hat es zwei Einträge für dasselbe Feld (F68c886502d4b5554eec808975). Die beiden Dropdown-Optionen, nach denen das Modul filtert, sind"planning"und"active".