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

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

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

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

Polygon.io に登録する

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

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

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

Automation Cloud^TM 内で [Integration Service] に移動し、[コネクタを構築] を選択します。

空のコネクタから始めましょう。手元に何らかの形式の 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)] を選択します。
注:
ポリゴンのドキュメントでは APIキーについて言及していますが、 承認:ベアラー<your_token>として送信する必要があることを考えると、実際にはOAuthスタイルのトークンに近いです。したがって、個人用アクセストークン (PAT) は、技術的にはより良い定義です。さまざまな認証の種類について詳しくは、こちらをご覧ください。
ポリゴンから API キーをコピーし、[ 値 ] を「 Bearer <your_key>」に設定します。
このコネクタへの接続を作成するときにユーザーがキーの入力を求められないように、[ ユーザーに確認 ] フィールドを [ いいえ] に設定します。これは、このコネクタをテナントを超えて共有しないためです。ただし、テナントを超えてコネクタを共有する場合は、独自のキーを追加せずに、[ ユーザーに確認 ] を [ はい] に設定すると、他のユーザーが自分で Polygon サービスにサブスクライブするように求められるようにします。
コネクタビルダーで事前設定された認証の種類が、ほとんどの作業を処理します。たとえば、 個人用アクセストークンは 認証ヘッダーとして Authorization: Bearer <your_token> を自動的に送信し、ユーザーがこの構成を自分で構築する必要はありません。
[未接続] > [コネクションを追加] ボタンを選択して、上記の構成でコネクションを設定します。新しく作成したコネクタは、Integration Service の他のコネクタと同様に動作します。[接続] をクリックして、API 呼び出しを実行するテスト接続を作成します。

API 呼び出しをテストする

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

左側のパネルで [API] > [新しいリソースグループを作成] に移動します。この操作の目的は、特定の株式の始値に関する Slack 通知を毎日受け取ることです。ここで実装するエンドポイントは、Polygon の Daily open/close API です。
[Create new resource group] ウィンドウで、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 の [ チャンネルにメッセージを送信 ] アクティビティを追加します。自分宛てに情報を送信する場合は、[ ユーザーにメッセージを送信] を使用します。