Infragistics Reveal で HCL Domino ののデータを分析・可視化
Reveal は Infragistics が提供するデータ可視化ソリューションで、CData API Server と組み合わせることで、リアルタイムのHCL Domino のデータから動的なダッシュボードを構築できます。CData API Server は HCL Domino 用の OData API を生成し、Reveal からネイティブに利用できます。この記事では、API Server で HCL Domino に接続し、Infragistics Reveal から API Server に接続してシンプルなダッシュボードを作成する方法を説明します。
API Server から HCL Domino に接続
CData API Server は、シンプルなポイント&クリック操作のインターフェースでデータソースに接続し、API を生成できます。
- API Server を開き、Settings -> Connection -> Add Connection をクリックします。
- 「HCL Domino」を選択します。
- 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 と同じです。
API Server で HCL Domino のリソース定義を追加
HCL Domino に接続したら、HCL Domino のデータ の API エンドポイントとなるリソースを作成します。
- Settings -> Resources -> Add Resource をクリックします。
- HCL Domino の接続を選択します。
- 取得したいテーブルを選択し、「次へ」をクリックします。
- (オプション) リソースを編集して、特定のフィールドを選択するなどの設定を行います。
- 設定を保存します。
API Server ユーザーの追加
API Server 経由で Reveal から HCL Domino に接続するためのユーザーを作成します。
- Settings -> Users をクリックします。
- Add をクリックします。
- HCL Domino の接続とリソースにアクセス可能なユーザーを設定します。
(オプション) クロスオリジンリソースシェアリング (CORS) の設定
Ajax などのアプリケーションから複数の異なるドメインにアクセス・接続する場合、クロスサイトスクリプティングの制限に抵触する可能性があります。その場合は、Settings -> Server で CORS 設定を行います。
- Enable cross-origin resource sharing (CORS): ON
- Allow all domains without '*': ON
- Access-Control-Allow-Methods: GET, PUT, POST, OPTIONS
- Access-Control-Allow-Headers: Authorization
設定の変更を保存します。
Reveal でダッシュボードを作成
API Server の設定が完了したら、Reveal でHCL Domino のデータを可視化していきましょう。
- Reveal にログインし、Dashboards -> New をクリックします。
- Data Source -> OData Feed をクリックします。
- API Server の API エンドポイント URL を指定します。例: https://serverurl/api.rsc
- Generic Credentials を選択し、API Server のユーザー名と認証トークンを指定します。
- 可視化したいエンティティを選択します。
- フィールドを選択し、チャートタイプを選びます。
詳細情報と無償トライアル
これで、リアルタイムのHCL Domino のデータからシンプルなダッシュボードを作成できました。HCL Domino (および 150 以上のデータソース) から OData フィードを作成する方法の詳細については、API Server ページをご覧ください。30日間の無償トライアルをダウンロードして、OData API を利用するツールでリアルタイムのHCL Domino のデータを活用してみてください。