各製品の資料を入手。
詳細はこちら →ColdFusion にリアルタイムe-Sales Manager のデータをインポートしてアプリケーションを構築
CData JDBC ドライバを使ってColdFusion にe-Sales Manager のデータをインポートして使用します。
最終更新日:2023-02-02
この記事で実現できるe-Sales Manager 連携のシナリオ
こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。
Adobe ColdFusion は、Web アプリケーションおよびモバイルアプリケーション開発プラットフォームです。独自のスクリプト言語であるColdFusion Markup Language(CFML)を使用し、データドリブンなWeb サイトを作成したり、REST などのリモートサービスを生成したりすることができます。
ColdFusion とCData JDBC Driver for ESalesManager を組み合わせると、ColdFusion のWeb アプリケーションやモバイルアプリケーションを、運用中のe-Sales Manager のデータにリンクできます。 これにより、アプリケーションの堅牢性と完成度を高めることができます。この記事では、JDBC ドライバーを使ってColdFusion マークアップファイルからe-Sales Manager のデータを入力したテーブルを作成する方法について詳しく説明します。
最適化されたデータ処理が組み込まれたCData JDBC ドライバは、リアルタイムe-Sales Manager のデータを扱う上で高いパフォーマンスを提供します。 e-Sales Manager にSQL クエリを発行すると、CData ドライバーはフィルタや集計などのe-Sales Manager 側でサポートしているSQL 操作をe-Sales Manager に直接渡し、サポートされていない操作(主にSQL 関数とJOIN 操作)は組み込みSQL エンジンを利用してクライアント側で処理します。 組み込みの動的メタデータクエリを使用すると、ネイティブのデータ型を使ってe-Sales Manager のデータを操作および分析できます。
e-Sales Manager への接続を設定する
Coldfusion とe-Sales Manager の接続を確立するには、JDBC 接続文字列が必要です。
e セールスマネージャー Remix に接続するには、User、Passowrd、URL、TenantId パラメータが必要です。
- User:API を実行するためのログインユーザーのユーザーID。
- Password:API を実行するためのログインユーザーのユーザーパスワード 。
- URL:e-Sales Manager Remix エンドポイントへのURL。例:https://XXX.softbrain.co.jp
- TenantId:e-Sales Manager Remix テナント名のTenantd。例:cdata
組み込みの接続文字列デザイナー
JDBC URL の作成の補助として、e-Sales Manager JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。
java -jar cdata.jdbc.esalesmanager.jar

データソースを追加してテーブルを作成する
接続を設定したのち、次の手順に従ってはじめにCData JDBC ドライバをColdFusion のlib ディレクトリに追加し、続けて新しいデータソースを追加、接続をテスト、ColdFusion マークアップファイルを作成し、最後にe-Sales Manager のデータとリアルタイム接続してColdFusion Markup Language(CFML)で記述されるテーブルに表示します。
-
JDBC Driver for ESalesManager およびlic ファイルを"C:\Program Files\CData\CData JDBC Driver for ESalesManager\lib" から"C:\ColdFusion2021\cfusion\wwwroot\WEB-INF\lib"にコピーします。
cdata.jdbc.esalesmanager.jar cdata.jdbc.esalesmanager.lic
Note:.lic ファイルをjar ファイルとともにコピーしないと、有効なライセンスがインストールされていないことを示すライセンスエラーが表示されます。 これは評価版、製品版ともに同様です。
-
ColdFusion Administrator インターフェースで「データとサービス」を選択します。
-
「新規のデータソースの追加」を行います。データソース名は、ColdFusion の変数命名規則に従っていればどのような名前でもかまいません。
JDBC ドライバーの場合は、「その他」を選択して「追加」ボタンをクリックします。
-
次に、ドライバーのプロパティを入力します。
- 「JDBC URL」は、次のような形式である必要があります: jdbc:esalesmanager:|connectionString|
- 典型的な接続文字列は次のようになります:
jdbc:esalesmanager:User=MyUsername;Password=MyPassword;URL=MyInstanceURL;TenantId=MyTenantId;
- 「ドライバクラス」は次のようになります:cdata.jdbc.esalesmanager.ESalesManagerDriver
- 「ドライバ名」の入力は任意で、これは単にColdFusion Administrator コンソールでデータソースを認識するために使われます。
-
ここで、作成したCDatae-Sales ManagerJDBC データソースの左側にあるチェックマークをクリックして、接続をテストしてください。
データソースのステータスが「OK」になると、使用可能な状態です。
-
次に、ColdFusion Markup ファイル(.cfm)を新規作成し、ColdFusion のwwwroot ディレクトリ("C:\ColdFusion2021\cfusion\wwwroot")に配置します。
次のコードは、データソースにクエリを実行します。
<cfquery name="e-Sales ManagerQuery" dataSource="CDatae-Sales ManagerJDBC"> SELECT * FROM Customer </cfquery>
CFTable を使用すると、HTML で素早くテーブルを出力できます。<cftable query = "e-Sales ManagerQuery" border = "1" colHeaders colSpacing = "2" headerLines = "2" HTMLTable maxRows = "500" startRow = "1"> <cfcol header="<b>Name</b>" align="Left" width=2 text="Name"/> <cfcol header="<b>Address</b>" align="Left" width=15 text="Address"/> ... </cftable>
HTML 部分を含むコード全体を以下に掲載します。<html> <head><title>CData Software | e-Sales Manager Customer Table Demo </title></head> <body> <cfoutput>#ucase("e-Sales Manager Customer Table Demo")#</cfoutput> <cfquery name="e-Sales ManagerQuery" dataSource="CDatae-Sales ManagerJDBC"> SELECT * FROM Customer </cfquery> <cftable query = "e-Sales ManagerQuery" border = "1" colHeaders colSpacing = "2" headerLines = "2" HTMLTable maxRows = "500" startRow = "1"> <cfcol header="<b>Name</b>" align="Left" width=2 text="Name"/> <cfcol header="<b>Address</b>" align="Left" width=15 text="Address"/> ... </cftable> </body> </html>
-
最後に、デフォルトのポート8500のブラウザでコードをローカルに実行します。これでe-Sales Manager のデータが入力されたテーブルが作成されました!
なお、CData JDBC ドライバはcfqueryparam 要素を使用したパラメータ化クエリもサポートしています。
次に例を示します。
SELECT * FROM Account WHERE name =
今日からはじめましょう
CData JDBC Driver for ESalesManager の 30日間無償トライアル をダウンロードして、Adobe ColdFusion でe-Sales Manager と連携したアプリケーションの作成をはじめましょう!ご不明な点があれば、サポートチームにお問い合わせください。