BIRT でDynamics 365 のデータのレポートを作成

Jerod Johnson
Senior Technology Evangelist

組み込み分析にリアルタイムDynamics 365 のデータを提供。

CData JDBC Driver for Dynamics 365 は、データドリブンな Java アプリケーションにDynamics 365 API への接続機能を統合します。CData JDBC Driver for Dynamics 365 を BIRT（Business Intelligence Reporting Tools）プラットフォームと組み合わせることで、データの変更をリアルタイムに反映する BIRT レポートを作成できます。

Dynamics 365 データ連携について

CData は、Microsoft Dynamics 365 のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています：

Sales、Customer Service、Finance & Operations、Marketing など、Dynamics 365 エコシステム全体のデータの読み取りと書き込みができます。
カスタマイズ可能なキャッシュと、インテリジェントなクエリ集約・分離により、Dynamics CRM のネイティブ機能を拡張できます。
Azure Active Directory、Azure マネージドサービス ID 認証情報、クライアントシークレットまたは証明書を使用した Azure サービスプリンシパルなど、さまざまな方法で Dynamics 365 に安全に認証できます。
SQL ストアドプロシージャを使用して、Dynamics 365 エンティティを管理できます。エンティティ間の関連付けの一覧表示、作成、削除などが可能です。

CData のお客様は、データをデータウェアハウスにレプリケートしたい場合（他のデータソースと併せて）や、Microsoft エコシステム内のお気に入りのデータツール（Power BI、Excel など）または外部ツール（Tableau、Looker など）からライブ Dynamics 365 データを分析したい場合など、さまざまな理由で当社の Dynamics 365 接続ソリューションを使用しています。

はじめに

まだインストールしていない場合は、BIRT Framework プラグインと Database Development プラグインを Eclipse にインストールします。
「File」->「New」->「Report」をクリックします。Report Design パースペクティブが開きます。
Data Explorer で「Data Sources」を右クリックし、「New Data Source」をクリックします。
「Create from a Data Source Type in the Following List」オプションを選択し、「JDBC Data Source」を選択します。
「Manage Drivers」をクリックし、インストールフォルダの lib サブフォルダにあるドライバー JAR を追加します。
「Database URL」ボックスに、接続文字列を含む JDBC URL を入力します。
Dynamics 365 接続プロパティの取得・設定方法

Microsoft Dynamics 365 への接続

Microsoft Dynamics 365 ドライバーは、以下のMicrosoft Dynamics 365 エディションへの接続をサポートしています。
- CustomerService
- FieldService
- FinOpsOnline （デフォルト）
- FinOpsOnPremise
- HumanResources
- Marketing
- ProjectOperations
- Sales
Notes：
- Supply Chain Management はFinance and Operations と同一です。これらのいずれかに接続するには、Edition をFinOpsOnline またはFinOpsOnPremise のいずれかに設定します。
- Microsoft Dynamics 365 Business Central については、個別のMicrosoft Dynamics 365 Business Central ドライバーを使用してください。
サポートされているMicrosoft Dynamics 365 エディションのいずれか接続するには、次のパラメータを設定します。
- OrganizationURL：お使いのMicrosoft Dynamics 365 組織のURL。例えば、https://orgcb42e1d0.crm.dynamics.com。
- Edition：上記のエディション一覧に示すとおり。
Microsoft Dynamics 365 への認証

Microsoft Dynamics 365 は、Microsoft Entra ID（Azure AD）、Azure サービスプリンシパル、Azure マネージドID（MSI）を経由する認証をサポートします。これらはすべてOAuth 規格に基づきます。認証方法の詳細は、ヘルプドキュメントを参照してください。

組み込みの接続文字列デザイナー

JDBC URL の構築には、Dynamics 365 JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
```
java -jar cdata.jdbc.dynamics365.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

JDBC URL を設定する際、Max Rows 接続プロパティも設定しておくと良いでしょう。返される行数が制限されるため、レポートやビジュアライゼーションの設計時のパフォーマンスが向上します。

一般的な JDBC URL は以下のとおりです：
```
jdbc:dynamics365:OrganizationUrl=https://myaccount.operations.dynamics.com/;Edition=Sales;
```
「Data Sets」フォルダを右クリックし、Dynamics 365用の JDBC データソースを選択します。
表示されるダイアログで、レポート用のデータを取得する SELECT クエリを作成します。この記事では以下のクエリを使用します：
```
SELECT GoalHeadingId, Name FROM GoalHeadings WHERE Name = 'MyAccount'
```
「Palette」からエディターにチャートをドラッグします。チャートウィザードが表示されます。
チャートタイプを選択した後、「Select Data」タブでカラムをチャートフィールドにドラッグします。
「Run」->「View Report」->「In Web Viewer」をクリックしてレポートを表示します。