API トークン認証を使用する web サービスに Adobe Workfront Fusion を接続
一部のサービスでは、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 Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| Adobe Workfront Fusion ライセンス |
オペレーションベース:Workfront Fusion ライセンス要件なし コネクターベース(レガシー): Workfront以外のアプリケーションに接続するには、作業の自動化と統合用のWorkfront Fusionが必要です |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
API トークンを使用する web サービスへの接続
API トークンを介してサービスに接続する手順は、ほとんどの web サービスで同様です。
- Web サービスの web サイト上にアプリケーションを作成します。詳しくは、この記事の新しいアプリケーションを作成して API トークンを取得を参照してください。
- API キーまたは API トークンを取得します。
- Workfront FusionのHTTP/リクエストモジュールをシナリオに追加します。
- この記事の「HTTP モジュールの設定」の節で説明しているように、web サービスのAPI ドキュメントに従ってモジュールを設定し、シナリオを実行します。
新しいアプリケーションを作成して API トークンを取得
- プッシュオーバーアカウントにログインします。
- ページの下部にある「Create an Application/API Token」をクリックします。
- アプリケーション情報を入力し、「Create an Application」をクリックします。
- 提供された API トークンを安全な場所に保存します。 Workfront Fusion HTTP/リクエストモジュールを作成して、目的のweb サービス(この場合はプッシュオーバー)に接続する必要があります。
HTTP モジュールの設定
web サービスをWorkfront Fusion シナリオに接続するには、シナリオでHTTP/リクエストモジュールを使用し、web サービスのAPI ドキュメントに従ってモジュールを設定する必要があります。
-
HTTP/リクエストモジュールをシナリオに追加します。
-
Workfront Fusionを使用してメッセージをプッシュするには、HTTP モジュールを次のように設定します。
note NOTE これらのモジュール設定は、Pushover 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.jsonURL フィールドには、web サービスの API ドキュメントで確認できるエンドポイントが含まれます。
メソッド POST使用されるメソッドは、対応するエンドポイントによって異なります。 メッセージをプッシュするための Pushover エンドポイントでは、POST メソッドを使用します。
ヘッダー 一部の web サービスでは、ヘッダーを使用して API トークン認証や他のパラメーターを指定します。 メッセージをプッシュする際、Pushover エンドポイントはすべてのリクエストタイプで本文を使用するので、この例ではそうではありません(以下を参照)。 クエリ文字列 一部の web サービスでは、クエリ文字列を使用して他のパラメーターを指定します。 この例では、Pushover web サービスがすべてのリクエストタイプにBody (以下を参照)を使用するため、この例では当てはまりません。 Body Type Rawこの設定を使用すると、以下の「コンテンツタイプ」フィールドでJSON コンテンツタイプを選択できます。
コンテンツタイプ JSON (application/json)JSONは、プッシュオーバーアプリで必要なコンテンツタイプです。 これは、他の web サービスとは異なる場合があります。
コンテンツを依頼 JSON形式でBody リクエストコンテンツを入力します。 JSON/JSONを作成モジュールを使用できます。詳しくは、JSON/JSONを作成モジュールを使用してJSON本文をマッピングするを参照してください。 または、この記事の「JSON本文を手動で入力する」で説明しているように、JSON コンテンツを手動で入力することもできます。
その web サービスに必要なパラメーターについて詳しくは、web サービスの API ドキュメントを参照してください。
JSON本文を手動で入力する
パラメーターと値を JSON 形式で指定します。
例:
{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}
この例には、次の情報が含まれています。
JSON/JSONを作成モジュールを使用してJSON本文をマッピングします
JSONを作成モジュールを使用すると、JSONの指定が簡単になります。 また、値を動的に定義することもできます。
JSON モジュールについて詳しくは、JSON モジュールを参照してください。
-
JSON を作成する元となる値を入力またはマッピングします。
-
JSON/JSON モジュールをHTTP/リクエストモジュールに接続します。
-
JSONを作成モジュールのJSON文字列を、HTTP/リクエストモジュールを作成のリクエストコンテンツフィールドにマッピングします。
シナリオを実行すると、プッシュ通知はプッシュオーバーアカウントに登録されているデバイスに送信されます。