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

このセクションでは、コネクタビルダーを使用してコネクタを作成し、オートメーション内で使用する方法について説明します。コネクタを手動で作成する例を挙げて説明するため、通常はスキップできる手順にも自動的に対処します。

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

注:

「 API 定義からコネクタを構築する」セクションもご覧ください。ここでは、Swagger 定義をインポートし、ほとんどの作業をコネクタビルダーで完了させる方法について説明します。

Polygon.io に登録する

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

polygon.io に移動し、アカウントを作成します。
ダッシュボードを開き、API キーを選択してキーを表示します。

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

Within Automation Suite, navigate to Integration Service and select Build your connector.

空のコネクタから始めましょう。手元に何らかの形式の API 定義 (Swagger、YAML など) がある場合は、[API 定義から開始] を選択して、ほとんどの構成作業をコネクタビルダーに任せることができます。

Web から polygon.svg アイコンをダウンロードして、ロゴをカタログに追加します。

注:
すべての画像の種類がサポートされていますが、正方形の SVG を使用することをお勧めします。
カスタムコネクタの名前と説明を追加し、[作成] を選択します。

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

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

API キーを以下のようにクエリ文字列で渡します。<your_token> は 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>
```
あるいは、以下の形式で API キーをトークンとして、認可ヘッダーを要求に追加することもできます。ここで、<your_token> は API キーです。
```
Authorization: Bearer <your_token>Authorization: Bearer <your_token>
```
コネクタビルダーで、[設定] に移動して [ベース API] タブを選択します。[ベース URL] を https://api.polygon.io に設定します。

手記：この例では、ベース URL に version "v2" セクションを追加しません。これにより、古いストックAPI呼び出しの一部を実行できます。
次に、[認証] タブに移動し、ドロップダウンリストから使用する認証の種類を選択します。この例では、[個人用アクセストークン (PAT)] を選択します。
注:
Polygon のドキュメントでは API キーを参照していますが、Authorization: Bearer <your_token> として送信する必要があることを考えると、実際には OAuth スタイルのトークンに近いものです。したがって、技術的には個人用アクセストークン (PAT) がより良い定義です。さまざまな認証の種類について詳しくは、こちらをご覧ください。
Polygon から API キーをコピーし、[値] を「Bearer <your_key>」に設定します。
[ユーザーに確認] フィールドを [いいえ] に設定し、このコネクタへのコネクションを作成するときにユーザーがキーの入力を求められないようにします。これは、テナントを超えてこのコネクタを共有しないためです。ただし、テナントを超えてコネクタを共有する場合は、独自のキーを追加しないでください。 [ユーザーに確認] を [はい] に設定して、他のユーザー自身による Polygon サービスへの登録を求められるようにします。
ほとんどの作業は、コネクタビルダーで事前に設定された認証の種類で行われます。たとえば、個人用アクセストークンは、認証ヘッダーとして Authorization: Bearer <your_token> を自動的に送信します。ユーザーが自分でこの構成を構築する必要はありません。
[ 未接続] > [コネクションを追加] ボタンを選択して、上記の構成でコネクションを設定します。新しく作成したコネクタは、Integration Service の他のコネクタと同様に動作します。 [ 接続 ] を選択して、API 呼び出しを実行するテスト接続を作成します。

API 呼び出しをテストする

サードパーティソフトウェアへのコネクションを確立したら、API 呼び出しを実際に実行します。

左側のパネルで [API] > [新しいリソースグループを作成] に移動します。この操作の目的は、特定の株式の始値に関する Slack 通知を毎日受け取ることです。ここで実装するエンドポイントは、Polygon の Daily open/close API です。
[新しいリソースグループを作成] ウィンドウに、Polygon ドキュメントの画面に表示される内容をコピーします。
[パス] を「/open-close/{stocksTicker}/{date}」に設定します。
[メソッドを選択] リストから [レコードを取得 (GETBYID)] を有効化します。オブジェクトの配列ではなく、単一のオブジェクトを選択するからです。
「Open - Close for stock」などの表示名を指定します。コネクタビルダーによって {x} 変数が自動的にパス変数に変換されます。
[作成] を選択して、このリソースを追加します。
設定が機能しているかどうかをテストするには、リソースの横にある [要求を送信] ボタンを選択します。これにより、2 つのパスパラメーターの値が作成されます。これらは、Polygon ドキュメントの使用法の例から取得できます。

コネクタをカタログに公開する

いくつかの追加手順を実行して、リソースとパラメーターの外観と動作を向上させることができます。たとえば、date パラメーターの型が DateTime であることを確認してマスクします。表示名を指定すると、Studio アクティビティ内でのコネクタの表示がよりよくなります。以下のスクリーンショットに例を示します。

最後の手順として、[パブリッシュ] を選択してコネクタをテナントにパブリッシュします。コネクタはテナント内で表示されているコネクタのリストに表示され、同じテナントを使用しているすべてのユーザーが Polygon コネクタを表示および使用できます。

詳細については、「コネクタをパブリッシュする」の詳細なセクションをご覧ください。

UiPath Studio でコネクタを使用する

コネクタを Integration Service に表示するのは、そのコネクタをワークフローで実際に使用できる場合にのみ有効です。

ワークフローでカスタムコネクタをテストするには、以下の手順を実行します。

UiPath Studio を開いて、新しいプロジェクトを作成します。たとえば、「毎日の株価を Slack で受け取る」プロジェクトです。毎日メッセージを受信するため、このワークフローで使用する最初のアクティビティは [タイムトリガー] です。
次に、Polygon アクティビティをキャンバスにドラッグすると、自分のアカウントで Polygon.io に接続するよう求められます。
コネクションが確立したら、Apple の株 (AAPL) に関する情報を取得するように Polygon アクティビティを設定します。関心のある銘柄をハードコードできますが、日付を実行時の日付に書式設定する必要があります。
次に、この情報をチャンネルに送信するための Slack アクティビティ [チャンネルにメッセージを送信] を追加します。自分宛てに情報を送信する場合は、[ユーザーにメッセージを送信] を使用します。