Integration Service
最新
バナーの背景画像
Integration Service ユーザー ガイド
最終更新日 2024年2月27日

はじめてのコネクタを構築する

このページでは、コネクタ ビルダーを使用して手動でコネクタを作成し、オートメーション内で使用する方法について説明します。 手動での作成手順を記載しているため、通常はスキップできる手順も記載しています。たとえば、Swagger 定義をインポートする手順を含みますが、ほとんどの作業はコネクタ ビルダーがユーザーの代わりに行います。

構築するワークフローは、関心のある株価に関する Slack メッセージを毎日受信することを目的としています。Polygon.io は、株式情報を取得する無料の API セットを提供しており、この目的にも使用できます。Polygon.io で簡単な登録プロセスを経ると、必要な API 呼び出しを行うための API キーが提供されます。

Polygon.io に登録する

ほとんどのベンダー アプリケーションでは、ユーザー名とパスワード、OAuth アプリ、API キーなどの形式で認証の詳細が必要です。Polygon.io も例外ではなく、無料登録をすると一部の API を試すことができます。[Signup] ボタンをクリックして API キーを取得します。
docs image

コネクタ ビルダーでコネクタを作成する

Automation Cloud 内で [Integration Service] に移動し、カタログ内の最初のカードである [新しいコネクタを構築] をクリックして、「空のコネクタ」から始めます。 Web から polygon.svg アイコンをダウンロードして、ロゴをカタログに追加します。
注: すべての画像の種類がサポートされていますが、正方形の SVG を使用することをお勧めします。
何らかの形式の API 定義 (Swagger、yaml など) を持っている場合は、最初のカードから始めて、ほとんどの構築作業をコネクタ ビルダーに任せることができます。
docs image

認証をセットアップし接続する

Polygon のドキュメントでは、プラットフォームへの API 呼び出しでは、API キーをヘッダーまたはクエリ パラメーターで送信する必要があると説明されています。 これを行うには、次の例のように、ヘッダーに追加する必要があります。

API キーを以下のようにクエリ文字列に渡します。
https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2023-01-09/2023-01-09?apiKey=<your_token>https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2023-01-09/2023-01-09?apiKey=<your_token>
<your_token> が API キーです。
あるいは、以下のように、API キーをトークンとして認可ヘッダーを要求に追加することもできます。
Authorization: Bearer <your_token>Authorization: Bearer <your_token>
<your_token> が API キーです。
コネクタ ビルダーで [設定] > [ベース API] に移動します。ここで [ベース URL] を入力して https://api.polygon.io に設定する必要があります。
注: この例では、ベース URL に version "v2" セクションを追加しません。追加すると、古いストック API 呼び出しの一部の実行が可能となるからです。

docs image
[設定] > [認証] で、[認証の種類] ドロップダウンを [個人用アクセス トークン (PAT)] に設定します。Polygon のドキュメントでは APIキーを参照していますが、 Authorization: Bearer <your_token> として送信する必要があることを考えると、実際には OAuth スタイルのトークンに近いため、技術的には PAT がより良い定義です。 ドキュメント内の認証の種類に関する項目をご覧下さい。
スクリーンショットでは、キーを [値] として配置して設定しました。これによりユーザーはキーの入力を求められません。これは、テナントを超えてこのコネクタを共有しないためです。ただし、テナントを超えてコネクタを共有する場合は、独自のキーを追加せず、[ユーザーに確認] > [はい] の設定を保持し、ユーザー自身による Polygon サービスへの登録を求められるようにします。
ほとんどの作業はコネクタ ビルダーで事前に設定された認証の種類で行われます。 たとえば、さきほど構築したパーソナル アクセス トークンは、認証ヘッダーとして「認証: ベアラー <ユーザーのトークン>」を自動的に送信し、ユーザーが自分でこの構成を構築する必要はありません。
docs image

画面右上隅の [未接続] > [コネクションを追加] をクリックして、上記の構成でコネクションを設定します。 新しく作成したコネクタは、Integration Service の他のコネクタと同様に動作します。[接続] をクリックして、API 呼び出しを実行するテスト接続を作成します。

API 呼び出しをテストする

サードパーティ ソフトウェアへのコネクションを確立したら、API 呼び出しを実際に実行します。左側のパネルで [API] > [新しいリソース グループを作成] に移動します。 この操作の目的は、特定の株式の始値に関する Slack 通知を毎日受け取ることです。 ここで実装するエンドポイントは、Polygon の Daily open/close APIです。


docs image

[新しいリソース グループを作成] のモーダルに、Polygon ドキュメントの画面に表示される内容をコピーします。

パスを /open-close/{stocksTicker}/{date} に設定し、オブジェクトの配列ではなく単一のオブジェクトをを選択するため、[メソッド] で [Get record (GETBYID)] を選択します。「Open - Close for stock」などの表示名を指定します。コネクタ ビルダーによって {x} 変数が自動的にパス変数に変換されます。
docs image
実行した設定が機能しているかどうかをテストするには、上部にある [要求を送信] をクリックします。 これにより、2 つのパス パラメーターの値が作成されます。 これらは、Polygon ドキュメントの使用法の例から取得できます。
docs image

コネクタをカタログにパブリッシュする

いくつかの追加手順を実行して、リソースとパラメーターの外観と動作を向上させることができます。 [日付] パラメーターの型が DateTime であることを確認し、例としてマスクを指定します。表示名を指定すると、Studio アクティビティ内でのコネクタの表示がよりよくなります。以下のスクリーンショットに例を示します。
docs image
最後の手順として、[パブリッシュ] をクリックしてコネクタをテナントにパブリッシュします。 コネクタはテナント内で表示されているコネクタのリストに表示され、同じテナントを使用しているすべてのユーザーが Polygon コネクタを表示および使用できます。
docs image

Studio でコネクタを使用する

Integration Service にコネクタが表示されるのは、実際に使用できる場合のみです。 任意の Studio デザイナーに移動し、新しいプロジェクトを作成します。 この例では、Studio Web を使用し、プロジェクト「Slack daily stock prices」という名前を付け、毎日繰り返されるイベントとして設定します。毎日メッセージを受信するため、このワークフローで使用する最初のアクティビティは [タイム トリガー] です。


docs image

Polygon アクティビティをキャンバスにドラッグすると、自分のアカウントで Polygon.io に接続するよう求められます。

コネクションが確立したら、Apple の株 (AAPL) に関する情報を取得するように Polygon アクティビティを設定します。 関心のある銘柄をハードコーディングできますが、日付を実行時の日付に書式設定する必要があります。 次に、この情報をチャンネルまたは自分自身に送信するための Slack アクティビティを追加します。

Polygon の API は一度に 1 つの株しか取り込みませんが、コネクタを介して複数の呼び出しを行い、UiPath の 1 日の株式始値 (PATH) も通知するよう Studio を設定できます。

フローは次の画像のようになります。
docs image

Was this page helpful?

サポートを受ける
RPA について学ぶ - オートメーション コース
UiPath コミュニティ フォーラム
UiPath ロゴ (白)
信頼とセキュリティ
© 2005-2024 UiPath. All rights reserved.