クラウドRPA BizteX Connect でConfluence データにアクセス
CData Connect Server を使ってConfluence データのOData API エンドポイントを作成し、BizteX Connect からConfluence データにアクセスする方法。
杉本和也
リードエンジニア
最終更新日:2021-12-23
こんにちは!リードエンジニアの杉本です。
BizteX Connect は BizteX 社が提供する国産iPaaS です。ノーコードでkintone やChatwork などさまざまなクラウドサービスと連携したフローを作成し、業務の自動化・効率化を実現することができます。この記事では、CData Connect Server を経由して BizteX Connect からConfluence データを取得し活用する方法を説明します。
CData Connect Server は、Confluence データのクラウド to クラウドの仮想OData インターフェースを提供し、BizteX Connect からリアルタイムにConfluence データへ連携することができます。
Confluence の仮想OData API エンドポイントを作成
まずCData Connect Server でデータソースへの接続およびOData API エンドポイント作成を行います。
- CData Connect Server にログインして、Databases をクリックします。
- 利用できるデータソースアイコンから"Confluence" を選択します。
-
Confluence に接続するために必要なプロパティを入力します。
API Token を取得する方法
API token は、アカウントへの認証に必須です。トークンの生成には、Atlassian アカウントでサービスにログインし、API tokens > Create API token
に進みます。生成されたトークンが表示されます。
Confluence Cloud Account への接続
Cloud アカウントへの接続には、以下のプロパティを設定します(Password は、Server Instance への接続時のみ必要で、Cloud Account
への接続には不要になりました。):
- User: Confluence サーバーに認証するユーザー名。
- APIToken: 認証するユーザーに紐付けられたAPI Token。
- Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net
Confluence Server Instance への接続
Server instance への接続には以下を設定します:
- User: Confluence Instance に接続するユーザー名。
- Password: Confluence Instance に接続するユーザーのパスワード。
- Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net
-
Test Database をクリックします。
-
Permission -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
-
API タブをクリックして OData API エンドポイントが生成されていることを確認します。
プロジェクト・シナリオの作成
CData Connect Server 側の準備が完了したら、早速BizteX Connect 側でプロジェクト・シナリオの作成を開始します。
- まずはプロジェクトとシナリオ(フロー)を作成します。シナリオ(フロー)はプロジェクト単位でまとめて管理できるようです。
- 「新規プロジェクト作成」をクリック
- 任意の名称でプロジェクトを作成します。
- その後「+新規シナリオ作成」をクリックして、Confluence データ連携シナリオの作成を進めていきます。
起動イベントの設定
シナリオの作成で一番最初に設定することが、起動イベントの構成です。BizteX Connect ではさまざまな起動イベントが存在しますが、今回は検証用途として「手動」実行にしてみました。
- 「アプリ選択」の一覧から「一般」を選択し
- 「ボタンを押して実行」を選択します。
- それぞれのイベントでは出力データが変数として格納されます。内容を確認して「完了して次へ」をクリックしましょう。
HTTP コネクタの構成
今回のシナリオでは、Confluence のデータを取得して BizteX Connect で扱えるようにします。
- CData Connect Server へのアクセスには「HTTPコネクタ」が利用できるので、アプリの一覧から選択します。
- アクションは「HTTPリクエスト」を指定します。
- 続いて、データを取得するためのAPI リクエストを指定します。今回はデータを取得するのでGET リクエストです。対象のURL はCData Connect Server のAPI ドキュメントから取得してきて指定しましょう。
- 基本設定が完了したら、オプションを指定します。ここで最低限必要になるオプションはCData Connect Server への認証情報の指定です。以下のようなJSON 形式でx-cdata-authtoken のプロパティにCData Connect Server で構成したユーザーのトークンを指定すれば接続が行えます。
- すべての設定が完了したら出力結果を確認してみましょう。以下のようにBody の中の「value」オブジェクトの中に配列形式でデータが格納されていることが確認できます。正常にBizteX Connect からConfluence のデータが取得できていますね。
- あとはBizteX Connect の各種機能を活用して、さまざまなサービスとの連携を実現できます。
このように、CData Connect Server を経由することで、API 側の複雑な仕様を意識せずにConfluence と連携をしたシナリオをBizteX Connect で作成できます。他にも多くのデータソースに対応するCData Connect Server の詳細をこちらからご覧ください。