各製品の資料を入手。
詳細はこちら →
製品をチェック
RPA ツールBizRobo! でAdobe Analytics に連携したフローを作成する
RPA ツールBizRobo! で Adobe Analytics に連携したフローを作成する方法：CData JDBC Driver。
最終更新日：2022-03-24
この記事で実現できるAdobe Analytics 連携のシナリオ
こんにちは！リードエンジニアの杉本です。
BizRobo! はRPAテクノロジーズ株式会社が提供する低コストかつスモールスタートで利用できるRPA ツールです。
この記事では、BizRobo! に備わっているJDBC インターフェースと CData JDBC Driver for AdobeAnalytics を組み合わせることによりBizRobo! でAdobe Analytics
データを活用した自動化フローを作成する方法を紹介します。
BizRobo! 環境の構成
はじめるにあたりBizRobo! 側の環境を用意しておきます。
- 今回は検証にあたって、BizRobo! Basic を利用しました。JDBC Driver のアップロードに「BizRobo! Management Console」を利用するためです。
- 「BizRobo! Management Console」にアクセスするために、あらかじめBizRobo! Basic がインストールされたサーバー上で「Start Management Console」を実行しておきましょう。
CData JDBC Driver for AdobeAnalytics のインストール
続いてCData JDBC Driver for AdobeAnalytics をBizRobo! と同じマシンにインストールします。
-
以下のパスにJDBC Driver がインストールされます。
C:\Program Files\CData\CData JDBC Driver for AdobeAnalytics 20xxJ\lib\cdata.jdbc.adobeanalytics.jar
- 続いて、接続用の文字列を取得するために、CData JDBC Driverの接続ユーティリティを利用しましょう。対象の「cdata.jdbc.adobeanalytics.jar」を実行します。
- 以下のような接続テストツールが立ち上がるので必要なプロパティを指定し接続テストを実行します。入力した接続文字列はあとで利用するので控えておきましょう。
URL：
jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL; - また、事前に DbVisualizer のようなJDBC の接続ツールでどのようなデータが取得できるか確認しておくのがおすすめです。
-
Adobe Analytics への接続
Adobe Analytics に接続するには、GlobalCompanyId およびRSID を識別する必要があります。デフォルトで、ドライバーは会社とレポートスイートの識別を自動で試みますが、これらの値を明示的に指定することもできます。方法はヘルプドキュメントの「Adobe Analytics への接続」セクションを参照してください。
Adobe Analytics への認証
Adobe Analytics はOAuth 認証標準を利用しています。 OAuth またはサービスアカウントで認証できます。
ユーザーアカウント（OAuth）
すべてのユーザーアカウントフローでAuthScheme をOAuth に設定する必要があります。OAuth 経由のAdobe 認証では、2週間ごとにリフレッシュトークンを更新する必要があります。詳しい認証方法については、ヘルプドキュメントの「Adobe Analytics への認証」セクションを参照してください。
サービスアカウント
サービスアカウントにはサイレント認証があり、ブラウザでのユーザー認証は必要ありません。このフローでは、アプリケーションを作成する必要があります。アプリケーションの作成および認可については、ドキュメントの「カスタムOAuth アプリの作成」を参照してください。これでサービスアカウントにアクセス権があるAdobe Analytics データに接続できます。
サービスアカウントを使用したServer-to-Server OAuthで認証するには、AuthScheme をOAuthClient に設定します。接続するには次のプロパティを設定します。
- InitiateOAuth：GETANDREFRESH に設定。
- OAuthClientId：アプリケーション設定のクライアントId に設定。
- OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
接続すると、本製品 はサービスアカウントでのOAuth フローを完了します。
- クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
- トークンが期限切れになった際に、新しいアクセストークンを要求します。
BizRobo! にJDBC Driver をアップするために lic ファイルを調整
併せてCData JDBC ドライバのライセンスファイルをBizRobo! にアップロードするために少し追加の作業を実施します。
- 「lib」フォルダに存在する「cdata.jdbc.adobeanalytics.lic」ファイルをZIPに圧縮し
- 名前を「cdata.jdbc.adobeanalytics.lic.jar」に変更しておきます。これでBizRobo! にアップロードできるようになります。
BizRobo! Managmenet Console にJDBC Driver をアップロード
それでは「BizRobo! Managmenet Console」でCData JDBC ドライバを利用できるように設定を進めていきましょう。
- 「設定」→「データベース ドライバー」から「cdata.jdbc.adobeanalytics.jar」、「cdata.jdbc.adobeanalytics.lic.jar」2つのファイルをアップロードします。
- CData JDBC ドライバのアップロードが完了したら「データベースタイプ」で接続設定を追加しましょう。「設定」→「データベース タイプ」から「新しいタイプ」として以下の情報を入力し保存します。
名前： 例）CData JDBC Driver
JDBC ドライバー：cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver
接続URL テンプレート：
jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;SQLフレーバー：PostgreSQL - 続いて対象のクラスタにデータベース接続を追加します。「管理」→「RoboServer」から対象のクラスタの「クラスタ設定」を開きます。
- 「新しいデータベース」をクリックし各種情報を指定します。この際、明示的な指定が必要なものは「タイプ」だけです。ここで先ほど作成したデータベースタイプを入力します。それ以外の情報は内部的には利用しないので、任意の文字列を入力してもらって構いません。
- これで設定を反映させれば対象のクラスタでCData JDBC ドライバが利用できるようになります。
データベース設定をプロジェクトに追加
Design Studio を立ち上げて、ロボットを作成するためのプロジェクト側の準備を進めていきましょう。
- 「BizRobo! Managmenet Console」で追加したデータベース設定は Design Studio のデータベース一覧に表示されるのでここから右クリックで「プロジェクトに追加」から対象の環境に追加します。
- 任意のマッピング名で追加します。
- ちなみにデフォルトでは警告メッセージが表示されてしまうので、追加したデータベース マッピングの「設定」から
- 「警告を表示」のチェックを外しておくと良いです。
データを格納するためのタイプを追加
続いて、取得したデータを変数に適切に追加するために、「タイプ」を作成しましょう。
- メニューの「ファイル」→「新しいタイプ」をクリックし
- 任意のタイプ名で作成します。
- あとは下記のように各種項目を定義します。
新しいWeb オートメーションロボットを追加
実際にロボットの作成を開始します。
- 「メニュー」から「新しい Web オートメーションロボット」を選択し
- 任意の名称で作成します。
- これで以下のようにデフォルトのロボットが作成され、フローのデザイン画面が表示されます。
変数の準備
取得したデータを格納する変数を設定します。
- 以下の変数画面から「＋」ボタンをクリックし
- 先ほど作成したタイプを元に変数を追加します。
データベース照会アクションを追加
変数を追加したら、実際にCData JDBC ドライバ経由でデータを取得するアクションを追加します。
- デザイン画面から「アクション ステップ」を追加し
- アクションの一覧から「データベース照会」を選択します。「データベース」で先ほど登録したデータベースマッピングを選択し、SQL クエリの欄にデータを取得するためのクエリを入力します。最後に変数マップとして先ほど登録したタイプ変数にSQL クエリで取得できる各項目をマッピングします。
CSV 出力フローを追加
取得したデータはBizRobo! の機能を使って、自由に処理できます。
- 今回は試しにCSV データとして出力を行ってみました。詳細な手順は省略しますが、フローの作成方法はBizRobo! のマニュアルを参考に作成しています。
- 対象のCSV ファイルを読み込むアクションを追加し、LongText の変数に格納します。
- そのCSV ファイルデータを元に、レコードを1行づつ追加するファイル出力アクションを設定しました。
デバッグして実際に動かしてみる
これでロボットが完成です。それでは実際に動かしてみましょう。
- デバッグ画面に移動して、「実行」ボタンをクリックします。
- 正常にロボットが動作すると、以下のようにCSV ファイルが生成されます。
このようにCData JDBC Driver for AdobeAnalytics とBizRobo! を組み合わせることで、簡単にAdobe Analytics のデータを活用した自動化フローを作成することができました。ぜひ、30日の無償評価版をお試しください。
関連コンテンツ
