ドキュメントWorkfrontWorkfront ガイド

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

Last update: Fri Feb 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー

一部のサービスでは、シナリオで簡単に使用できるアプリを Adobe Workfront Fusion のような統合ソリューションで作成することは許可されません。

この状況に対する回避策があります。Workfront Fusion の HTTP モジュールを使用して、目的のサービス（アプリ）を Workfront Fusion に接続できます。

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

アクセス要件

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

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件：Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件： Workfront Fusion for Work Automation and Integration

製品

現在の製品要件：Select または Prime Adobe Workfront プランをご利用の場合、この記事で説明されている機能を使用するには、Adobe Workfront に加えて Adobe Workfront Fusion も組織で購入する必要があります。Workfront Fusion は Workfront Ultimate プランに含まれています。

または

従来の製品要件：この記事で説明されている機能を使用するには、Adobe Workfront に加えて Adobe Workfront Fusion も組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

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

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

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

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

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

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

HTTP モジュールを設定

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

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

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

    note note
    NOTE
    これらのモジュール設定は、Pushover web サービスの API ドキュメントに対応します。他の web サービスでは設定が異なる場合があります。例えば、API トークンを本文フィールドではなくヘッダーに挿入するなどです。
    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 ドキュメントで確認できるエンドポイントが含まれます。
    Method

    POST

    使用されるメソッドは、対応するエンドポイントによって異なります。メッセージをプッシュするための Pushover エンドポイントでは、POST メソッドを使用します。
    Headers 一部の web サービスでは、ヘッダーを使用して API トークン認証や他のパラメーターを指定します。メッセージをプッシュする際、Pushover エンドポイントはすべてのリクエストタイプで本文を使用するので、この例ではそうではありません（以下を参照）。
    Query String 一部の web サービスでは、クエリ文字列を使用して他のパラメーターを指定します。この件は、Pushover web サービスは、すべてのリクエストタイプで Body（以下を参照）を使用するという例とは異なります。
    Body Type

    Raw

    この設定を使用すると、以下の Content Type フィールドで JSON コンテンツタイプを選択できます。
    Content Type

    JSON (application/json)

    JSON は、Pushover アプリで必要なコンテンツタイプです。これは、他の web サービスとは異なる場合があります。
    Request Content

    Body リクエストコンテンツを JSON 形式で入力します。JSON／Create JSON モジュールを使用できます。詳しくは、この記事のJSON／Create JSON モジュールを使用してマッピングされた JSON 本文を参照してください。または、JSON コンテンツを手動で入力することもできます。詳しくは、この記事の手動で入力した JSON 本文を参照してください。

    その web サービスに必要なパラメーターについて詳しくは、web サービスの API ドキュメントを参照してください。

手動で入力した JSON 本文

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

INFO
例：
code language-none 
{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}
user
USER_KEY。これは、Pushover ダッシュボードに表示されます。
token
生成した API トークン／API キーの Pushover アプリを作成します。
message
デバイスに送信されるプッシュ通知のテキストコンテンツ。
title
（オプション）メッセージのタイトル。値を入力しない場合は、アプリの名前が使用されます。

JSON／JSON を作成モジュールを使用してマッピングされた JSON 本文

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

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

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

  2. JSON／JSON を作成モジュールを HTTP／リクエストを実行モジュールに接続します。

  3. HTTP／リクエストを実行モジュール内で、JSON を作成モジュールから「コンテンツを要求」フィールドまで JSON 文字列をマッピングします。

    これで、シナリオを実行すると、プッシュ通知が、Pushover アカウントで登録されたデバイスに送信されます。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43