MotionBoard からHCL Domino のデータに連携してダッシュボードを作成

桑島義行
桑島義行
テクニカルディレクター
国産BI のMotionBoard からCData Connect AI を使ってHCL Domino のデータにリアルタイム連携するレポートを作成。

MotionBoard は、ウイングアーク1st 社が提供する人気のBI ダッシュボードツールです。この記事ではMotionBoard で、HCL Domino のデータをCData Connect を通じてシームレスに統合利用する方法を説明します。

CData Connect AI は、SaaS 型のデータ仮想化プラットフォームです。Salesforce、Dynamics、Zoho CRM、NetSuite、Marketo、kintone など150以上の多様なSaaS にBI ツール、アナリティクス、iPaaS、ノーコード開発プラットフォームからアクセスするための仮想エンドポイントを提供します。連携方法が異なるSaaS をSQL Server 、SQL Server、OData の3種類のインターフェースに仮想化することで、データ連携をシンプルに実現します。

この記事では、HCL Domino のデータを仮想SQL Server エンドポイントして利用してMotionBoard からデータを取得、可視化します。

Connect AI からHCL Domino に接続する

CData Connect AI では、直感的なクリック操作ベースのインターフェースを使ってデータソースに接続できます。
  1. Connect AI にログインし、 Add Connection をクリックします。
    2. コネクションの作成
  2. Add Connection パネルから「HCL Domino」を選択します。
    3. データソースの選択
  3. 必要な認証プロパティを入力し、HCL Domino に接続します。

    Domino への接続

    それでは、Domino のデータに接続していきましょう。接続するには、以下のプロパティを設定してください。

    • URL：Domino データベースをホスティングしているサーバーのホスト名またはIP アドレス。Domino データベースをホスティングしているサーバーのポートを含めます。例：http://sampleserver:1234/
    • DatabaseScope：Domino Web UI でのスコープ名。CData 製品は、指定されたスコープに適合するスキーマのフォームとビューを公開します。Domino Admin UI で、サイドバーのScopes メニューを選択してください。このプロパティを既存のスコープ名に設定します

    Domino での認証

    続いて、認証方法を設定しましょう。Domino では、ログインクレデンシャル（OAuthPassword）またはMicrosoft Entra ID（AzureAD）のいずれかによる認証をサポートしています。

    ログインクレデンシャル

    ログインクレデンシャルで認証するには、以下のプロパティを設定してください：

    • AuthScheme：OAuthPassword
    • User：認証するDomino ユーザーのユーザー名
    • Password：認証するDomino ユーザーに関連付けられたパスワード

    ドライバーがログインクレデンシャルを使用して、自動的にOAuth トークン交換を実行します。

    Microsoft Entra ID（Azure AD）

    この認証方法は、Azure Active Directory をIdP として使用してJWT トークンを取得します。Azure Active Directory にカスタムのアプリケーションを作成し、それをIdP として設定する必要があります。詳しい手順については、ヘルプドキュメントの指示に従ってください。その後、以下のプロパティを設定します。

    • AuthScheme：AzureAD
    • InitiateOAuth：これをGETANDREFRESH に設定します。InitiateOAuth を使用すると、OAuth 交換の繰り返しやOAuthAccessToken の手動設定を避けることができます
    • OAuthClientId：カスタムAzure AD アプリケーションの作成時に取得したクライアントID
    • OAuthClientSecret：カスタムAzure AD アプリケーションの作成時に取得したクライアントシークレット
    • CallbackURL：カスタムAzure AD アプリケーションの登録時に指定されたリダイレクトURI。例えば、https://localhost:33333
    • AzureTenant：データにアクセスするために使用されるMicrosoft Online テナント。companyname.microsoft.com 形式の値またはテナントID のいずれかを指定してください

    テナントID は、Azure ポータルのAzure Active Directory > プロパティページに表示されているディレクトリID と同じです。

    コネクションの設定
  4. Create & Test をクリックします。

パーソナルアクセストークンの追加

MotionBoard への接続には、パスワードの代わりとしてパーソナルアクセストークンを利用します。セキュアなアクセス管理を実現するには、サービスごとに個別のPAT を作成するのがベストプラクティスです。

  1. Connect AI アプリの右上にある歯車アイコンをクリックします。
  2. Settings ページで「Access Tokens」タブに移動し、 Create PAT をクリックします。
  3. PAT の名前を入力して Create をクリックします。
    4. 新しいPAT を作成
  4. パーソナルアクセストークンは作成時にしか表示されないため、コピーして安全に保存してください。

MotionBoard からHCL Domino のデータに接続してダッシュボードを作成

MotionBoardの「システム設定 → 接続/認証 → 外部接続」から新しい外部接続を作成します。接続先タイプはSQL Server を選択します。

  • 外部接続名：任意（例：CDataConnect）
  • 接続先タイプ：SQL Server
  • 中継サービス：使用しない

外部接続の基本情報タブにて以下内容をセットします。

  • 外部接続名：任意（例：CDataConnect）
  • 接続先タイプ：SQL Server
  • 接続先タイプ：SQL Server 4.0(JDBC)
  • 中継サービス：使用しない
  • サーバー名：tds.cdata.com
  • ポート : 14333
  • データベース名 : 先ほどConnect AI で作成した接続先データソース名(例：HCL Domino1)
  • ユーザー名 : Connect AI のユーザー名（メールアドレス）
  • パスワード : パーソナルアクセストークン
基本情報エリアの最下部に「接続確認」ボタンをクリックして外部接続の確認が取れることを確認します。

「データソース」タブを開き、HCL Domino 内のテーブルが一覧に表示されることを確認できます。ここまで確認できたら「保存」ボタンで外部接続定義を保存して閉じます。

「ボード新規作成」から新しいボードを作成します。

アイテムウィザードのDS1の接続先に上記の外部接続定義で作成した接続（本例では Cdata Connect）を選択します。次に、左側のデータベースにHCL Domino のテーブルリストが表示されますので、使用するテーブルを選択します。右側にDealsテーブル内のデータがプレビューされます。

ウィザードを次に進み、作成するアイテムにチャートを選択して、「次へ」をクリックします。データソース エディタが起動します。左側の項目一覧から可視化したい項目を行項目・列項目・集計項目にセットします。もうRDB やCSV などのデータソースを扱う場合と同じ操作でビジュアライズを作成できます。あとは、おすすめチャートから適切なチャート種類を選択します。

まとめ

このように、CData Connect AI を経由することで、API 側の複雑な仕様を意識せずにMotionBoard でデータを可視化できます。他にも多くのデータソースに対応するCData Connect AI の詳細をこちらからご確認ください。

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル お問い合わせ

この記事の内容

関連記事