Verbinden von Adobe Workfront Fusion mit einem Webservice, der die API-Token-Autorisierung verwendet
Einige Services lassen keine Integrationslösungen wie Adobe Workfront Fusion zu, um eine App zu erstellen, die Sie in Ihrem Szenario einfach verwenden können.
Um diese Situation zu umgehen, verbinden Sie den gewünschten Service (die App) mit Workfront Fusion über das HTTP-Modul > Anfrage stellen .
In diesem Artikel wird erläutert, wie Sie mithilfe eines API-Schlüssels/API-Tokens nahezu jeden Webservice mit Workfront Fusion verbinden.
Zugriffsanforderungen
Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront-Paket | Beliebig |
| Adobe Workfront-Lizenz |
Neu: Standard Oder Aktuell: Arbeit oder höher |
| Lizenz für Adobe Workfront Fusion** |
Aktuell: Keine Workfront Fusion-Lizenzanforderung Oder Legacy: Beliebig |
| Produkt |
Neu:
Oder Aktuell: Ihr Unternehmen muss Adobe Workfront Fusion erwerben. |
Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.
Herstellen einer Verbindung zu einem Webdienst, der ein API-Token verwendet
Die Vorgehensweise beim Verbinden des Service über ein API-Token ist bei den meisten Web-Services ähnlich.
- Erstellen Sie eine Anwendung auf der Website des Webservices, wie im Abschnitt Erstellen einer neuen Anwendung und Abrufen des API-Tokens in diesem Artikel erläutert.
- Abrufen des API-Schlüssels oder API-Tokens.
- Fügen Sie das HTTP-Modul > Anfrage erstellen von Workfront Fusion zu Ihrem Szenario hinzu.
- Richten Sie das Modul gemäß der API-Dokumentation des Web-Services ein und führen Sie das Szenario aus, wie in Abschnitt Einrichten des HTTP-Moduls in diesem Artikel beschrieben.
Erstellen eines neuen Programms und Abrufen des API-Tokens
- Melden Sie sich bei Ihrem Pushover-Konto an.
- Klicken unten auf der Seite auf "/API-Token erstellen“.
- Füllen Sie die Informationen aus und klicken Sie auf Anwendung erstellen.
- Bewahren Sie das bereitgestellte API-Token an einem sicheren Ort auf. Sie benötigen es für das Workfront Fusion-HTTP > Erstellen eines Anfragemoduls , um eine Verbindung zum gewünschten Webservice herzustellen (in diesem Fall Pushover).
Einrichten des HTTP-Moduls
Um einen Webservice mit Ihrem Workfront Fusion-Szenario zu verbinden, müssen Sie das HTTP-Modul > Anfrage stellen im Szenario verwenden und das Modul gemäß der API-Dokumentation des Webservices einrichten.
-
Fügen Sie das Modul HTTP > Anfrage stellen zu Ihrem Szenario hinzu.
-
Um eine Nachricht mithilfe von Workfront Fusion zu pushen, richten Sie das HTTP-Modul wie folgt ein.
note note NOTE Diese Moduleinstellungen entsprechen der Pushover-Webservice-API-Dokumentation. Die Einstellungen für andere Webdienste können sich unterscheiden. Beispielsweise kann das API-Token in die Kopfzeile und nicht in das Feld Hauptteil eingefügt werden. 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 URL https://api.pushover.net/1/messages.jsonDas URL-Feld enthält den Endpunkt, den Sie in der API-Dokumentation des Webservices finden.
Methode POSTDie verwendete Methode hängt vom entsprechenden Endpunkt ab. Der Pushover-Endpunkt für das Pushen von Nachrichten verwendet die POST-Methode.
Kopfzeilen Einige Webdienste verwenden möglicherweise Kopfzeilen, um das API-Token oder andere Parameter für die Authentifizierung anzugeben. Dies ist in unserem Beispiel nicht der Fall, da der Endpunkt des Pushover für das Pushen von Nachrichten den Hauptteil (siehe unten) für alle Anfragetypen verwendet. Abfragezeichenfolge Einige Webdienste verwenden möglicherweise eine Abfragezeichenfolge, um andere Parameter anzugeben. Dies ist in unserem Beispiel nicht der Fall, da der Pushover-Webservice Body (siehe unten) für alle Anfragetypen verwendet. Textkörper RawMit dieser Einstellung können Sie den JSON-Inhaltstyp im Feld Inhaltstyp unten auswählen.
Inhaltstyp JSON (application/json)JSON ist der erforderliche Inhaltstyp der Pushover-App. Dies kann sich von anderen Web-Services unterscheiden.
Inhalt anfordern Geben Sie den Inhalt der Hauptteilanfrage im JSON-Format ein. Sie können das Modul JSON > JSON erstellen verwenden, wie in Zuordnen des JSON-Bodys mithilfe des Moduls JSON > JSON erstellen in diesem Artikel erläutert. Sie können den JSON-Inhalt auch manuell eingeben, wie in JSON-Text manuell eingeben in diesem Artikel beschrieben.
Die erforderlichen Parameter für diesen Webdienst finden Sie in der API-Dokumentation des Webdienstes.
JSON-Text manuell eingeben
Geben Sie Parameter und Werte im JSON-Format an.
Beispiel:
{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}
Dieses Beispiel enthält die folgenden Informationen.
Ordnen Sie den JSON-Text mithilfe des JSON- > JSON erstellen -Moduls zu
Das Modul JSON erstellen erleichtert die Angabe von JSON. Außerdem haben Sie die Möglichkeit, Werte dynamisch zu definieren.
Weitere Informationen zu den JSON-Modulen finden Sie unter JSON-.
-
Geben Sie die Werte ein, aus denen Sie JSON erstellen möchten, oder ordnen Sie sie zu.
-
Verbinden Sie das Modul JSON > JSON erstellen mit dem Modul HTTP > Anfrage stellen .
-
Ordnen Sie die JSON-Zeichenfolge aus dem Modul JSON erstellen dem Inhaltsfeld Anfrage im Feld HTTP > Modul Anfrage erstellen zu.
Wenn Sie das Szenario ausführen, wird die Push-Benachrichtigung an das Gerät gesendet, das in Ihrem PushOver-Konto registriert wurde.