各製品の資料を入手。
詳細はこちら →PHP でMySQL からDynamics 365 のデータにアクセス
PHP から標準MySQL ライブラリを介してDynamics 365 に接続。
最終更新日:2022-07-18
こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。
CData SQL Gateway とODBC Driver for Dynamics365 を使用することで、ETL を実行したりデータをキャッシュしたりすることなく、MySQL クライアントからDynamics 365 にアクセスできます。以下のステップに従って、PHP の標準MySQL インターフェースであるmysqli とPDO_MySQL を介してDynamics 365 のデータにリアルタイムで接続します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- Dynamics 365 をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにDynamics 365 のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてDynamics 365 の接続を設定、2.MySQL 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとDynamics 365 への接続設定
まずは、本記事右側のサイドバーからDynamics365 ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
必要な接続プロパティの値が未入力の場合には、データソース名(DSN)で入力します。組み込みのMicrosoft ODBC Data Source Administrator を使用し、DSN を構成できます。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定する方法は、ヘルプドキュメントの「はじめに」を参照してください。
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 ドライバーを使用してください。
- OrganizationUrl:お使いのMicrosoft Dynamics 365 組織のURL。例えば、https://orgcb42e1d0.crm.dynamics.com。
- Edition:上記のエディション一覧に示すとおり。
Microsoft Dynamics 365 への認証
Microsoft Dynamics 365 は、Azure AD、Azure サービスプリンシパル、Azure マネージドID(MSI)を経由する認証をサポートします。これらはすべてOAuth 規格に基づきます。 認証方法の詳細は、ヘルプドキュメントを参照してください。
SQL Gateway を構成する
Dynamics 365 のデータへの接続を、仮想MySQL データベースとして設定する方法については、「SQL Gateway Overview」を参照してください。クライアントからのMySQL リクエストをリッスンするMySQL リモートサービスを構成します。このサービスはSQL Gateway UI で設定できます。
PHP から接続する
以下の例は、オブジェクト指向インターフェースを使用してクエリを接続および実行する方法を示します。 以下のパラメータを使用して接続オブジェクトを初期化し、仮想MySQL データベースに接続します。
- Host:サービスが実行されているリモートホストの場所を指定します。この例では、サービスがローカルマシンで実行されているため、"localhost" をリモートホスト設定に使用します。
- Username:SQL Gateway の「ユーザー」タブで認証したユーザーのユーザー名を指定します。
- Password:認証されたユーザーアカウントのパスワードを指定します。
- Database Name:データベース名としてシステムDSN を指定します。
- Port:サービスが実行されているポートを指定します。この例では3306 を指定します。
mysqli
<?php $mysqli = new mysqli("localhost", "user", "password", "CData Dynamics365 Sys","3306"); ?>
PDO
<?php $pdo = new PDO('mysql:host=localhost;dbname=CData Dynamics365 Sys;port=3306', 'user', 'password'); ?>
PHP からクエリする
接続が確立されると、テーブルにアクセスできます。以下のステップでは、例を説明します。
- テーブル(GoalHeadings)をクエリします。結果は、連想配列として$result オブジェクトに保存されます。
- 各行とカラムを順番に処理して、値を出力してPHP ページに表示することができます。
- 接続を閉じます。
mysqli
$result = $mysqli->query("SELECT GoalHeadingId, Name FROM GoalHeadings WHERE Name = 'MyAccount'"); while($row = $result->fetch_assoc()) { foreach ($row as $k=>$v) { echo "$k : $v"; echo "<br />"; } } $mysqli->close();
PDO
$result = $pdo->query("SELECT GoalHeadingId, Name FROM GoalHeadings WHERE Name = 'MyAccount'"); while($row = $result->fetch(PDO::FETCH_ASSOC)) { foreach ($row as $k=>$v) { echo "$k : $v"; echo "<br />"; } } $result = null; $pdo = null;
おわりに
このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。