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 サービスで同様です。

  1. Web サービスの web サイト上にアプリケーションを作成します。詳しくは、この記事の新しいアプリケーションを作成して API トークンを取得を参照してください。
  2. API キーまたは API トークンを取得します。
  3. Workfront FusionのHTTP/リクエストモジュールをシナリオに追加します。
  4. この記事の「HTTP モジュールの設定」の節で説明しているように、web サービスのAPI ドキュメントに従ってモジュールを設定し、シナリオを実行します。
NOTE
次の使用例は、プッシュオーバー通知サービスに接続します。

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

NOTE
Web サービスで API キーまたは API トークンを作成および配布するには、多くの異なる方法があります。 目的の web サービスの API キーとトークンの取得手順については、サービスの web サイトにアクセスし、「API キー」または「API トークン」を検索してください。
Pushover API キーを取得する手順は、検索対象の例として記載しているだけです。
  1. プッシュオーバーアカウントにログインします。
  2. ページの下部にある「Create an Application/API Token」をクリックします。
  3. アプリケーション情報を入力し、「Create an Application」をクリックします。
  4. 提供された API トークンを安全な場所に保存します。 Workfront Fusion HTTP/リクエストモジュールを作成して、目的のweb サービス(この場合はプッシュオーバー)に接続する必要があります。

HTTP モジュールの設定

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

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

  2. 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.json

    URL フィールドには、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"}

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

ユーザー
USER_KEY。 これは、プッシュオーバーダッシュボードにあります。
トークン
プッシュオーバーアプリを作成した際に生成されたAPI トークン/API キー。
message
デバイスに送信されるプッシュ通知のテキストコンテンツ。
タイトル
(オプション)メッセージのタイトル。 値を入力しない場合は、アプリの名前が使用されます。

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

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

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

  1. JSON を作成する元となる値を入力またはマッピングします。

    JSON値

  2. JSON/JSON モジュールをHTTP/リクエストモジュールに接続します。

  3. JSONを作成モジュールのJSON文字列を、HTTP/リクエストモジュールを作成のリクエストコンテンツフィールドにマッピングします。

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

recommendation-more-help
workfront-fusion-help-workfront-fusion