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

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