クラウドRPA Coopel でJira Assets のデータにアクセス

こんにちは！リードエンジニアの杉本です。

Coopel は DeNA社が提供するクラウドベースのRPAサービスです。WebブラウザやExcel、SaaSなどのクラウドサービスの操作の自動化が実現できます。この記事では、CData Connect Server を経由して Coopel からJira Assets のデータを取得し活用する方法を説明します。

CData Connect Server は、Jira Assets のデータのクラウド to クラウドの仮想OData インターフェースを提供し、Coopel からリアルタイムにJira Assets のデータへ連携することができます。

Jira Assets の仮想OData API エンドポイントを作成

まずCData Connect Server でデータソースへの接続およびOData API エンドポイント作成を行います。

1. CData Connect Server にログインして、Databases をクリックします。
2. 利用できるデータソースアイコンから"Jira Assets" を選択します。
3. Jira Assets に接続するために必要なプロパティを入力します。

   Jira Assets は、APIToken 経由での接続と認証をサポートしています。

   API トークンを生成するには：

   1. Atlassian アカウントにログインします。
   2. セキュリティ設定 > API トークン > API トークンを作成するをクリックします。

   Atlassian がAPI トークンを生成して表示します。

   API トークンを生成したら、以下のパラメータをセットします。

   • AuthScheme：APIToken。
   • User：認証するユーザーのログイン名。
   • APIToken：生成したAPI トークン。

   これでJira Assets に接続して認証する準備が整いました。

4. Test Database をクリックします。
5. Permission -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
6. API タブをクリックして OData API エンドポイントが生成されていることを確認します。

Coopel でシナリオを作成する

CData Connect Server 側の準備が完了したら、早速Coopel側でシナリオの作成を開始します。

1. まず、Coopelにログインし、必要に応じて新しいワークスペースを作成します。
2. ワークスペースを作成後、CData Connect Server にアクセスするための認証情報をCoopel 上に保存しましょう。「シナリオアカウント設定」→「新規追加」→「その他のサービス」を選択します。
3. ここで、CData Connect Server にアクセスするためのUserIDとPasswordを入力し、保存じます。Webサービス名には任意の名称を入力してください。
4. 次にメインとなるシナリオを作成します。「シナリオ作成」をクリックし
5. 任意の名称を入力します。

Jira Assets のデータを取得する処理を作成

シナリオを作成したらJira Assets のデータを取得する処理の作成を進めましょう。

1. CoopelからJira Assets のデータを取得するためには、CData Connect Server を経由します。Coopelでは、ブラウザアクセスと同じような方法でCData Connect Server にアクセスするので、「URLにアクセス」のアクションを使って、データ取得を行います。Coopelのアクション一覧から「URLにアクセス」を配置し、先程検証した以下の「URL」および、「Basic認証アカウント」に指定します。
2. 続いて、表示されたデータをCoopel上で扱いやすい形にするためにテーブルデータとして取得を行います。Coopelアクションの一覧から「テーブルデータを取得」を配置し、先程作成した「URLにアクセス」をブラウザへ指定。テーブルの要素として「table」を指定します。
3. これで、Coopel上でCData Connect Server 経由で取得したデータを操作する準備が整いました。あとはCoopelの様々なアクションを駆使して、フローを作成していきます。

ファイル出力処理を作成

データを取得する処理が作成できたら、そのデータをExcel ファイルに出力してみましょう。

1. 最初に「ファイルの新規作成」アクションを使って、Excel ファイルを作成します。任意の名称でファイル名とシート名を指定してください。
2. 次に「シートをシート名で指定」のアクションを配置して、先程作成したExcelファイルのシートを参照します。
3. シートを開いたら、取得したデータを「セルにペースト」アクションで貼り付けます。事前に作成した「対象シート」と、CData Connect Server から取得した「テーブルデータ」を指定します。書き込み対象セルは一番左上のセルから入力するので「A1」を指定しました。
4. 最後に作成したExcelファイルを「ファイルを保存する」アクションで保存します。以上ですべてのシナリオが完成しました。

実行

それでは完成したシナリオを実行してみましょう。

1. Coopelでは画面右上の「実行」ボタンでシナリオを試すことができます。正常に実行されると、以下のように「ファイルを保存する」アクションのダイアログに生成されたExcelファイルが表示されます。
2. これをダウンロードして、Excelで開いてみると、以下のようにCData Connect Server 経由で取得したデータが入力されていることが確認できます。

このように、CData Connect Server を経由することで、API 側の複雑な仕様を意識せずにJira Assets と連携をしたRPA シナリオをCoopel で作成できます。他にも多くのデータソースに対応するCData Connect Server の詳細をこちらからご覧ください。