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

Erweitern, um die Zugriffsanforderungen für die in diesem Artikel beschriebene Funktionalität anzuzeigen.
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 s#

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:

Basis-URL
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
API-Tag
v1.13.7

Erstellen einer Verbindung zu den Adobe Workfront Planning create-a-connection-to-adobe-workfront-planning

Sie können direkt aus einem Workfront Fusion-Modul heraus eine Verbindung zu Ihrem Workfront Planning-Konto herstellen.

  1. Klicken Sie in einem beliebigen Adobe Workfront Planning-Modul neben dem Feld „Verbindung“ auf Hinzufügen.

  2. 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 layout-auto html-authored no-header
    Verbindungsname Geben Sie einen Namen für die Verbindung ein.
    Umgebung Wählen Sie aus, ob Sie eine Verbindung zu einer Produktions- oder Nicht-Produktionsumgebung herstellen.
    Typ Wählen Sie aus, ob Sie eine Verbindung zu einem Service-Konto oder einem persönlichen Konto herstellen möchten.

    Client-ID

    (Optional)

    Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen der Adobe Developer Console.

    Client-Geheimnis

    (Optional)

    Geben Sie Ihr Adobe-Client-Geheimnis ein. Dieses finden Sie im Abschnitt mit den Anmeldeinformationen der Adobe Developer Console.
    Authentifizierungs-URL

    Geben Sie die URL ein, die Ihre Workfront-Instanz zur Authentifizierung dieser Verbindung verwenden soll.

    Der Standardwert lautet https://oauth.my.workfront.com/integrations/oauth2.

    Host-Präfix

    Geben Sie Ihr Host-Präfix ein.

    Der Standardwert lautet origin-.

  3. Klicken Sie auf Weiter, um die Verbindung zu speichern und zum Modul zurückzukehren.

Adobe Workfront Planning-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.

Umschalter „Zuordnung“

Auslöser

Ereignisse ansehen

Dieses Trigger-Modul startet ein Szenario, wenn ein Datensatz, ein Datensatztyp oder ein Arbeitsbereich in Workfront Planning erstellt, aktualisiert oder gelöscht wird.

Webhook
Wählen Sie den Webhook aus, den Sie verwenden möchten, oder klicken Sie auf Hinzufügen , um einen neuen zu erstellen.
Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Objekttyp
Wählen Sie aus, ob Datensätze, Datensatztypen oder Arbeitsbereiche überwacht werden sollen.
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.

  • Alter Status

    Lösen Sie ein Szenario aus, wenn sich der Eintrag von einem bestimmten Wert ändert.

Workspace
Wenn Sie Datensätze beobachten, wählen Sie die Workspace aus, die Sie auf Datensätze überwachen möchten.
Eintragstyp
Wählen Sie beim Überwachen von Datensätzen den Typ des Datensatzes aus, auf den Sie achten möchten.
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 unter Ereignisabonnementfilter in den Workfront- > Ereignisse beobachten-Modulen im Artikel zu Workfront-Modulen.

zu überwachende Objekte
Wählen Sie aus, ob Sie auf neue Nachrichten achten möchten. Aktualisierte, neue und aktualisierte oder gelöschte Datensätze.
Von dieser Verbindung vorgenommene Aktualisierungen ausschließen
Aktivieren Sie diese Option, um zu verhindern, dass das Szenario ausgelöst wird, wenn eine Änderung durch die von diesem Modul verwendete Verbindung vorgenommen wird. Dadurch wird verhindert, dass eine weitere Instanz des Szenarios ausgelöst wird, wenn dieses Szenario eine auslösende Aktion ausführt.

Aktionen

Datensatztyp löschen

Dieses Aktionsmodul löscht einen einzelnen Datensatztyp in Workfront Planning anhand seiner ID.

WARNING
Durch das Löschen eines Datensatztyps in Workfront Planning werden auch alle Datensätze in der Datensatztyptabelle gelöscht.
Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Datensatztyp-ID
Geben Sie die ID des Datensatztyps ein, den Sie löschen möchten, oder ordnen Sie sie zu.

Benutzerdefinierten API-Aufruf erstellen

Dieses Modul führt einen benutzerdefinierten API-Aufruf an die Adobe Workfront Planning-API durch.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
URL
Pfad eingeben für https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Header

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.

Abfragezeichenfolge
Klicken Sie für jedes Schlüssel/Wert-Paar, das Sie der Abfragezeichenfolge hinzufügen möchten, auf Element hinzufügen und geben Sie den Schlüssel und den Wert ein.
Text

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.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Workspace
Geben Sie die Workspace ein, die die zu durchsuchenden Datensätze enthält, oder ordnen Sie sie zu.
Eintragstyp
Wählen Sie den Datensatztyp aus, den Sie suchen möchten.
Datensatzfelder
Suchen Sie für jedes Feld, das Sie bei der Suche verwenden möchten, dieses Feld, wählen Sie den Operator aus und geben Sie den Wert ein, nach dem Sie suchen möchten, oder mappen Sie ihn. Felder sind je nach ausgewähltem Datensatztyp verfügbar.
-Bedingung für Filter

Bedingung für die Filter auswählen:

  • UND

    Das Modul gibt Datensätze zurück, (alle der von Ihnen ausgewählten Feldwerte erfüllen.

  • ODER

    Das Modul gibt Datensätze zurück, (beliebige der ausgewählten Feldwerte erfüllen.

Beschränkung
Geben Sie die maximale Anzahl von Einträgen ein, die das Modul während jedes Szenario-Ausführungszyklus zurückgeben soll, oder ordnen Sie diese zu.

Nicht kategorisiert

Eintrag erstellen

Diese Aktion erstellt in Workfront Planning einen einzigen Datensatz.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Datensatztyp-ID
Geben Sie den Typ des Datensatzes ein, den Sie erstellen möchten, oder ordnen Sie ihn zu. Die verfügbaren Datensatztypen basieren auf Ihrem Workfront Planning-Konto.
Andere Felder
Geben Sie die Werte ein, die der neue Datensatz haben soll. Diese Felder basieren auf dem von Ihnen ausgewählten Datensatztyp.

Löschen eines Datensatzes

Dieses Aktionsmodul löscht den angegebenen Datensatz in Workfront Planning.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Datensatz-ID
Geben Sie die ID des Datensatzes ein, den Sie löschen möchten, oder mappen Sie sie.

Datensatz abrufen

Dieses Aktionsmodul ruft einen einzelnen Datensatz aus Adobe Workfront Planning ab, angegeben durch die Kennung.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Datensatz-ID
Geben Sie die ID des Datensatzes ein, den Sie abrufen möchten, oder ordnen Sie sie zu.

Datensätze nach Datensatztyp abrufen

Dieses Aktionsmodul ruft alle Datensätze des angegebenen Typs ab.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Workspace
Wählen Sie den Arbeitsbereich aus, der die abzurufenden Datensätze enthält, oder ordnen Sie ihn zu.
Eintragstyp
Wählen Sie den Typ des Datensatzes aus, den Sie abrufen möchten.

Datensatztypen abrufen

Dieses Aktionsmodul ruft eine Liste von Datensatztypen in einem Adobe Workfront Planning ab.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Workspace
Wählen Sie den Arbeitsbereich aus, der die Datensatztypen enthält, die Sie abrufen möchten, oder ordnen Sie ihn zu.

Eintrag aktualisieren

Diese Aktion aktualisiert einen einzelnen Datensatz in Workfront Planning.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu den Adobe Workfront Planning finden Sie in diesem Artikel unter Erstellen einer Verbindung zu den Adobe Workfront Planning.
Datensatz-ID
Geben Sie den Typ des Datensatzes ein, den Sie aktualisieren möchten, oder ordnen Sie ihn zu. Die verfügbaren Datensatztypen basieren auf Ihrem Workfront Planning-Konto.
Andere Felder
Geben Sie die neuen Werte ein, die der Datensatz haben soll. Diese Felder basieren auf dem von Ihnen ausgewählten Datensatztyp.

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.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3