Adobe Workfront-Module

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.

Standard

Work oder höher

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
• Herstellen einer Verbindung mit Workfront per Server-zu-Server-Verbindung

Herstellen einer Verbindung mit Workfront per Client-ID und Client-Geheimnis

1. Klicken Sie in einem beliebigen Adobe Workfront-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 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/oauth2 eingeben. Beispiel: https://mydomain.my.workfront.com/integrations/oauth2
   Host-Präfix	In den meisten Fällen sollte dieser Wert auf origin gesetzt werden.

3. 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.

Herstellen einer Verbindung mit Workfront per Server-zu-Server-Verbindung

1. Klicken Sie in einem beliebigen Adobe Workfront-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 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.com lautet, geben Sie example ein.
   Instanzen-Lane	Geben Sie den Umgebungstyp für die Verbindung ein. Wenn Ihre URL z. B. https://example.my.workfront.com lautet, geben Sie my 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.
   Bereiche	Geben Sie alle zutreffenden Bereiche für diese Verbindung ein.
   Host-Präfix	In den meisten Fällen sollte dieser Wert auf origin gesetzt werden.

3. 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.

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.

• Trigger
• Aktionen
• Suchvorgänge

Auslöser

Wählen Sie den Typ des Workfront-Eintrags aus, der vom Modul überwacht werden soll.

Wählen Sie beispielsweise „Aufgabe“ aus, wenn die Ausführung des Szenarios bei jeder Aktualisierung eines Eintragsfelds in einer Aufgabe gestartet werden soll.

Wählen Sie den Typ des Workfront-Eintrags aus, der vom Modul überwacht werden soll.

Wenn das Szenario beispielsweise bei jeder Erstellung eines neuen Projekts starten soll, wählen Sie „Projekt“ aus.

Geben Sie die ID des Objekts ein.

Hinweis: 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.

Wenn Sie in ein Projekt konvertieren, wählen Sie die Vorlagen-ID aus, die für das Projekt verwendet werden soll.

Hinweis: 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.

Wählen Sie den Typ des Workfront-Eintrags aus, der vom Modul erstellt werden soll.

Wenn Sie beispielsweise ein Projekt erstellen möchten, wählen Sie in der Dropdown-Liste die Option „Projekt“ aus.

Wählen Sie die Felder aus, die zur Dateneingabe verfügbar sein sollen. Auf diese Weise können Sie diese Felder verwenden, ohne durch nicht benötigte Felder scrollen zu müssen. Anschließend können Sie Daten in diese Felder eingeben oder darin zuordnen.

Verwenden Sie für Felder in benutzerdefinierten Formularen das Feld Benutzerdefiniertes Formular anfügen.

• 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

  code language-none
  In der Benutzerliste können Sie Probleme bei einzelnen Benutzenden lösen.

• 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.

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"}

Hinweis: Wenn Fehler auftreten und es schwierig ist, deren Ursprung zu ermitteln, sollten Sie die Header anhand der Workfront-Dokumentation ändern. Wenn Ihr benutzerdefinierter API-Aufruf einen 422-HTTP-Anfragefehler zurückgibt, versuchen Sie es dem Header "Content-Type":"text/plain".

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.

Geben Sie die eindeutige Workfront-ID des zu löschenden Eintrags ein.

Um die ID abzurufen, öffnen Sie das Workfront-Objekt in Ihrem Browser und kopieren Sie den Text am Ende der URL nach „ID=“. Beispiel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

1. Löschen Sie den Eintrag synchron.
2. 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.

Ordnen Sie die eindeutige Workfront-ID des Dokuments zu, das vom Modul heruntergeladen werden soll, oder geben Sie diese manuell ein.

Um die ID abzurufen, öffnen Sie das Workfront-Objekt in Ihrem Browser und kopieren Sie den Text am Ende der URL nach „ID=“. Beispiel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Wählen Sie die Aktion aus, die vom Modul ausgeführt werden soll.

Abhängig von Ihrer Auswahl unter „-Eintragstyp“ und „Aktion“ müssen Sie möglicherweise zusätzliche Felder ausfüllen. Bei bestimmten Kombinationen dieser beiden Einstellungen muss unter Umständen nur eine Eintrags-ID angegeben werden, während für andere (z. B. die Option „Projekt“ unter Eintragstyp und die Option „Vorlage anfügen“ unter Aktion) zusätzliche Informationen (wie eine Objekt-ID und eine Vorlagen-ID) erforderlich sind.

Die für einige Aktionen verfügbaren Optionen finden Sie in diesem Artikel unter Sonstige Aktionsoptionen.

Weitere Informationen zu den einzelnen Feldern finden Sie in der Workfront-Entwicklerdokumentation.

Hinweis: Die Site mit der Entwicklerdokumentation enthält nur Informationen bis zur API-Version 14, sie liefert aber dennoch wertvolle Informationen für API-Aufrufe.

1. Wählen Sie im linken Navigationsbereich der Workfront-Entwicklerdokumentation den Eintragstyp aus. Für folgende Typen sind eigene Seiten vorhanden:

   • Projekte

   • Aufgaben

   • Probleme

   • Benutzende

   • Dokumente

   Wählen Sie für alle anderen Eintragstypen das unterste Thema zu anderen Objekten und Endpunkten aus und suchen Sie den Eintragstyp auf den alphabetisch sortierten Seiten.

2. Suchen Sie (über den Tastaturbefehl Strg+F bzw. Befehlstaste+F) auf der Seite des entsprechenden Eintragstyps nach der Aktion.

3. Lassen Sie sich Beschreibungen für die verfügbaren Felder unter der ausgewählten Aktion anzeigen.

Hinweis:

Beim Erstellen eines Korrekturabzugs über das Workfront-Modul „Sonstige Aktion“ empfiehlt es sich, einen Korrekturabzug ohne erweiterte Optionen zu erstellen und dann den Korrekturabzug mithilfe der Workfront Proof-SOAP-API zu aktualisieren.

Weitere Informationen zum Erstellen eines Korrekturabzugs mit der Workfront-API (die dieses Modul verwendet) finden Sie unter Hinzufügen erweiterter Proofing-Optionen beim Erstellen eines Korrekturabzugs über die Adobe Workfront-API.

Geben Sie die eindeutige Workfront-ID des Eintrags ein, mit dem das Modul interagieren soll, oder ordnen Sie diese zu.

Um die ID abzurufen, öffnen Sie das Workfront-Objekt in Ihrem Browser und kopieren Sie den Text am Ende der URL nach „ID=“. Beispiel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

• clearApprovers

• clearAssignments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Finanzielle Informationen löschen

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Erinnerungsnachrichten löschen

• clearApprovers

• clearAssignments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  Finanzielle Informationen löschen

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Erinnerungsnachrichten löschen

• clearApprovers
• clearAssignments
• clearCustomData
• clearDocuments
• clearPermissions
• clearProgress

• preserveIssue

  Ursprüngliches Problem beibehalten und Lösung hiermit verknüpfen: Aufgabe

• preservePrimaryContact

  Zugriff auf diese Aufgabe durch den primären Kontakt für das Problem zulassen

• preserveCompletionDate

  Das geplante Abschlussdatum des Problems beibehalten

• preserveIssue

  Ursprüngliches Problem beibehalten und Lösung hiermit verknüpfen: Aufgabe

• preservePrimaryContact

  Zugriff auf diese Aufgabe durch den primären Kontakt für das Problem zulassen

• clearApprovers

• clearAssignments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Finanzielle Informationen löschen

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Erinnerungsnachrichten löschen

• clearApprovers

• clearAssignments

• clearBillingRates

• clearConstraints

• clearDeliverables

  Ziele löschen

• clearDocuments

• clearExpenses

• clearFinancials

  Finanzielle Informationen löschen

• clearHourTypes

• clearIssueSetup

  Warteschlangeneigenschaften und Problem-Setup löschen

• clearPredecessors

• clearRisks

• clearSharingOptions

• clearTimedNotifications

  Erinnerungsnachrichten löschen

Geben Sie die eindeutige Workfront-ID des Eintrags ein, der vom Modul gelesen werden soll.

Um die ID abzurufen, öffnen Sie das Workfront-Objekt in Ihrem Browser und kopieren Sie den Text am Ende der URL nach „ID=“. Beispiel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Geben Sie die eindeutige Workfront-ID des Eintrags ein, der vom Modul aktualisiert werden soll.

Um die ID abzurufen, öffnen Sie das Workfront-Objekt in Ihrem Browser und kopieren Sie den Text am Ende der URL nach „ID=“. Beispiel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Wählen Sie die benutzerdefinierten Formulare aus, für die Sie Feldwerte zum neuen Eintrag angeben möchten. Nachdem Sie das Formular ausgewählt haben, geben Sie die Daten für die Felder in diesem Formular ein.

Um Feldwerte für ein Formular anzugeben, das Sie in diesem Modul anfügen, schließen Sie die benutzerdefinierte Formular-ID in den Abschnitt mit den zuzuordnenden Feldern ein.

Wählen Sie den Typ des übergeordneten Eintrags (Workfront-Objekts) aus, dessen verknüpfte Einträge Sie lesen möchten.

Eine Liste der Workfront-Objekttypen, für die Sie dieses Modul verwenden können, finden Sie in diesem Artikel unter Für die einzelnen Workfront-Module verfügbare Workfront-Objekttypen.

Geben Sie die ID des übergeordneten Eintrags ein, dessen verknüpfte Einträge Sie lesen möchten, oder ordnen Sie diese zu.

Um die ID abzurufen, öffnen Sie das Workfront-Objekt in Ihrem Browser und kopieren Sie den Text am Ende der URL nach „ID=“. Beispiel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Geben Sie das Feld ein, nach dem gesucht werden soll, den gewünschten Operator für die Abfrage und den Wert, nach dem im Feld gesucht werden soll.

Hinweis: Verwenden Sie nicht username in Ihren Suchkriterien. Ist username in einer API-Abfrage an Workfront enthalten, wird die bzw. der Benutzende bei Workfront angemeldet und die Suche ist nicht erfolgreich.

Hinweis: In und NotInarbeiten mit Arrays. Die Eingaben sollten im Array-Format erfolgen.

Geben Sie das Feld ein, nach dem gesucht werden soll, den gewünschten Operator für die Abfrage und den Wert, nach dem im Feld gesucht werden soll.

Hinweis: Verwenden Sie nicht username in Ihren Suchkriterien. Ist username in einer API-Abfrage an Workfront enthalten, wird die bzw. der Benutzende bei Workfront angemeldet und die Suche ist nicht erfolgreich.

Hinweis: In und NotInarbeiten mit Arrays. Die Eingaben sollten im Array-Format erfolgen.