各製品の資料を入手。
詳細はこちら →CData
こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。
Adobe ColdFusion は、Web アプリケーションおよびモバイルアプリケーション開発プラットフォームです。独自のスクリプト言語であるColdFusion Markup Language(CFML)を使用し、データドリブンなWeb サイトを作成したり、REST などのリモートサービスを生成したりすることができます。
ColdFusion とCData JDBC Driver for UMSaaSCloud を組み合わせると、ColdFusion のWeb アプリケーションやモバイルアプリケーションを、運用中のUM SaaS Cloud のデータにリンクできます。 これにより、アプリケーションの堅牢性と完成度を高めることができます。この記事では、JDBC ドライバーを使ってColdFusion マークアップファイルからUM SaaS Cloud のデータを入力したテーブルを作成する方法について詳しく説明します。
最適化されたデータ処理が組み込まれたCData JDBC ドライバは、リアルタイムUM SaaS Cloud のデータを扱う上で高いパフォーマンスを提供します。 UM SaaS Cloud にSQL クエリを発行すると、CData ドライバーはフィルタや集計などのUM SaaS Cloud 側でサポートしているSQL 操作をUM SaaS Cloud に直接渡し、サポートされていない操作(主にSQL 関数とJOIN 操作)は組み込みSQL エンジンを利用してクライアント側で処理します。 組み込みの動的メタデータクエリを使用すると、ネイティブのデータ型を使ってUM SaaS Cloud のデータを操作および分析できます。
Coldfusion とUM SaaS Cloud の接続を確立するには、JDBC 接続文字列が必要です。
デフォルトでは、本製品は本番環境に接続します。UMSaaSCloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。ユーザー / パスワード認証を使用している場合は、User にsandbox のユーザー名を設定してください。
UM SaaS Cloud は、Basic、OAuth、OAuthJWT(コンシューマーキー)など、複数の認証方式をサポートしています。ここではBasic 認証について説明します。認証情報の詳しい取得方法や他の認証方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。
Basic 認証は、セキュリティトークンとユーザー資格情報の使用に基づきます。Basic 認証を使用するには、AuthScheme をBasic に、User とPassword をログイン資格情報に設定し、SecurityToken を設定します。
デフォルトではSecurityToken が必要ですが、UM SaaS Cloud で信頼できるIP アドレスの範囲を設定することで、オプションにすることができます。
JDBC URL の作成の補助として、UM SaaS Cloud JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。
java -jar cdata.jdbc.umsaascloud.jar
接続を設定したのち、次の手順に従ってはじめにCData JDBC ドライバをColdFusion のlib ディレクトリに追加し、続けて新しいデータソースを追加、接続をテスト、ColdFusion マークアップファイルを作成し、最後にUM SaaS Cloud のデータとリアルタイム接続してColdFusion Markup Language(CFML)で記述されるテーブルに表示します。
cdata.jdbc.umsaascloud.jar
cdata.jdbc.umsaascloud.lic
Note:.lic ファイルをjar ファイルとともにコピーしないと、有効なライセンスがインストールされていないことを示すライセンスエラーが表示されます。 これは評価版、製品版ともに同様です。
jdbc:umsaascloud:AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;
次のコードは、データソースにクエリを実行します。
<cfquery name="UM SaaS CloudQuery" dataSource="CDataUM SaaS CloudJDBC"> SELECT * FROM Account </cfquery>CFTable を使用すると、HTML で素早くテーブルを出力できます。
<cftable query = "UM SaaS CloudQuery" border = "1" colHeaders colSpacing = "2" headerLines = "2" HTMLTable maxRows = "500" startRow = "1"> <cfcol header="<b>BillingState</b>" align="Left" width=2 text="BillingState"/> <cfcol header="<b>Name</b>" align="Left" width=15 text="Name"/> ... </cftable>HTML 部分を含むコード全体を以下に掲載します。
<html> <head><title>CData Software | UM SaaS Cloud Account Table Demo </title></head> <body> <cfoutput>#ucase("UM SaaS Cloud Account Table Demo")#</cfoutput> <cfquery name="UM SaaS CloudQuery" dataSource="CDataUM SaaS CloudJDBC"> SELECT * FROM Account </cfquery> <cftable query = "UM SaaS CloudQuery" border = "1" colHeaders colSpacing = "2" headerLines = "2" HTMLTable maxRows = "500" startRow = "1"> <cfcol header="<b>BillingState</b>" align="Left" width=2 text="BillingState"/> <cfcol header="<b>Name</b>" align="Left" width=15 text="Name"/> ... </cftable> </body> </html>
なお、CData JDBC ドライバはcfqueryparam 要素を使用したパラメータ化クエリもサポートしています。
次に例を示します。
SELECT * FROM Account WHERE name =
CData JDBC Driver for UMSaaSCloud の 30日間無償トライアル をダウンロードして、Adobe ColdFusion でUM SaaS Cloud と連携したアプリケーションの作成をはじめましょう!ご不明な点があれば、サポートチームにお問い合わせください。