API トークン認証を使用する web サービスに Adobe Workfront Fusion を接続

Last update: Thu Jan 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

一部のサービスでは、Adobe Workfront Fusion などの統合ソリューションを使用して、シナリオで簡単に使用できるアプリを作成できません。

この状況の回避策は、HTTP / リクエストを行うモジュールを使用して、目的のサービス（アプリ）をWorkfront Fusion に接続することです。

この記事では、API キー/API トークンを使用して、ほぼすべての web サービスをWorkfront Fusion に接続する方法について説明します。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ	任意
Adobe Workfront プラン	新規：標準または現在：ワーク以上
Adobe Workfront Fusion ライセンス**	現在：Workfront Fusion ライセンスは必要ありません。またはレガシー：任意
製品	新規： Prime Workfront プランを選択する：組織がAdobe Workfront Fusion を購入する必要があります。 Ultimate Workfront プラン：Workfront Fusion が含まれています。または現在：Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

API トークンを使用する web サービスへの接続

API トークンを介してサービスに接続する手順は、ほとんどの web サービスで同様です。

Web サービスの web サイト上にアプリケーションを作成します。詳しくは、この記事の新しいアプリケーションを作成して API トークンを取得を参照してください。
API キーまたは API トークンを取得します。
シナリオにWorkfront Fusion の HTTP / リクエストを行うモジュールを追加します。
この記事の HTTP モジュールの設定の節で説明されているように、web サービスの API ドキュメントに従ってモジュールを設定し、シナリオを実行します。

NOTE

次の使用例は、Pushhover 通知サービスに接続します。

新しいアプリケーションを作成して API トークンを取得

NOTE

Web サービスで API キーまたは API トークンを作成および配布するには、多くの異なる方法があります。目的の web サービスの API キーとトークンの取得手順については、サービスの web サイトにアクセスし、「API キー」または「API トークン」を検索してください。

Pushover API キーを取得する手順は、検索対象の例として記載しているだけです。

Pushhover アカウントにログインします。
ページの下部にある「Create an Application/API Token」をクリックします。
アプリケーション情報を入力し、「Create an Application」をクリックします。
提供された API トークンを安全な場所に保存します。目的の web サービスに接続するには、Workfront Fusion HTTP / リクエストを行うモジュール（この場合は Pushhover）が必要です。

HTTP モジュールの設定

Web サービスをWorkfront Fusion シナリオに接続するには、シナリオで HTTP/リクエストを行うモジュールを使用し、web サービスの API ドキュメントに従ってモジュールを設定する必要があります。

シナリオに HTTP / リクエストを行うモジュールを追加します。

Workfront Fusion を使用してメッセージをプッシュするには、HTTP モジュールを次のように設定します。

note note
NOTE
これらのモジュール設定は、Pushhover web サービス API ドキュメントに対応しています。他の web サービスでは設定が異なる場合があります。例えば、API トークンは Body フィールドではなく Header に挿入できます。

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.json` URL フィールドには、web サービスの API ドキュメントで確認できるエンドポイントが含まれます。
メソッド	`POST` 使用されるメソッドは、対応するエンドポイントによって異なります。メッセージをプッシュするための Pushover エンドポイントでは、POST メソッドを使用します。
ヘッダー	一部の web サービスでは、ヘッダーを使用して API トークン認証や他のパラメーターを指定します。メッセージをプッシュする際、Pushover エンドポイントはすべてのリクエストタイプで本文を使用するので、この例ではそうではありません（以下を参照）。
クエリ文字列	一部の web サービスでは、クエリ文字列を使用して他のパラメーターを指定します。Pushhover web サービスは、すべてのリクエストタイプに対して Body （以下を参照）を使用するので、この例では該当しません。
本文タイプ	`Raw` この設定を使用すると、下の「コンテンツタイプ」フィールドで JSON コンテンツタイプを選択できます。
コンテンツタイプ	`JSON (application/json)` JSON は、Pushover アプリで必要なコンテンツタイプです。これは、他の web サービスとは異なる場合があります。
コンテンツをリクエスト	Body リクエストのコンテンツを JSON 形式で入力します。この記事の JSON を使用した JSON 本文のマッピング/JSON モジュールの作成で説明しているように、JSON/JSON モジュールを作成を使用できます。または、この記事の JSON 本文の手動入力で説明しているように、JSON コンテンツを手動で入力できます。その web サービスに必要なパラメーターについて詳しくは、web サービスの API ドキュメントを参照してください。

JSON 本文を手動で入力

パラメーターと値を JSON 形式で指定します。

recommendation-more-help

例：

{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}

style

shade-box

この例には、次の情報が含まれます。

ユーザー

USER_KEY。これは、Pushhover ダッシュボードにあります。

トークン

生成された API トークン/API キーは、Pushover アプリを作成したものです。

メッセージ

デバイスに送信されるプッシュ通知のテキストコンテンツ。

タイトル

（オプション）メッセージのタイトル。値を入力しない場合は、アプリの名前が使用されます。

JSON/JSON を作成モジュールを使用して JSON 本文をマッピングします

この JSON を作成モジュールを使用すると、JSON の指定が容易になります。また、値を動的に定義することもできます。

JSON モジュールについて詳しくは、JSON モジュールを参照してください。

JSON を作成する元となる値を入力またはマッピングします。
JSON/JSON を作成モジュールを HTTP/ リクエストを行うモジュールに接続します。
JSON を作成モジュールの JSON 文字列を「HTTP / リクエストを行う」モジュールの「リクエストコンテンツ」フィールドにマッピングします。

シナリオを実行すると、プッシュ通知は Pushhover アカウントに登録されているデバイスに送信されます。

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3