ColdFusion で JDBC 経由でリアルタイム e-Sales Manager のデータをインポートしてアプリケーションを構築

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData JDBC Driver を使用して、ColdFusion で e-Sales Manager のデータをインポートして活用する方法を説明します。

Adobe ColdFusion は、Web およびモバイルアプリケーションの開発プラットフォームです。独自のスクリプト言語である ColdFusion Markup Language（CFML）を使用して、データ駆動型のWeb サイトを構築したり、REST などのリモートサービスを生成したりできます。

ColdFusion と CData JDBC Driver for e-Sales Manager Remixを組み合わせると、ColdFusion の Web およびモバイルアプリケーションを e-Sales Manager の運用データに接続できます。 これにより、アプリケーションをより堅牢で完成度の高いものにできます。この記事では、 JDBC Driver を使用して、ColdFusion マークアップファイル内で e-Sales Manager データを含むテーブルを作成する方法を説明します。

CData JDBC Driver は、最適化されたデータ処理機能を組み込んでおり、e-Sales Manager のデータとのリアルタイム連携において圧倒的なパフォーマンスを提供します。 複雑な SQL クエリを 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 Driver を ColdFusion の lib ディレクトリに追加し、新しいデータソースを追加し、接続をテストし、 ColdFusion マークアップファイルを作成して、最終的に e-Sales Manager のデータとリアルタイムに接続し、ColdFusion Markup Language（CFML）で記述されたテーブルに表示します。

  1. e-Sales Manager 用の JDBC Driver と lic ファイルを「C:\Program Files\CData[product_name]\lib」から 「C:\ColdFusion2021\cfusion\wwwroot\WEB-INF\lib」にコピーします。 
                cdata.jdbc.esalesmanager.jar
            cdata.jdbc.esalesmanager.lic

    注意：.lic ファイルを jar と一緒にコピーしないと、有効なライセンスがインストールされていないことを示すライセンスエラーが表示されます。 これはトライアル版と製品版の両方に当てはまります。

  2. ColdFusion 管理画面から、Data & Services を選択します。
  3. ここで「Add New Data Source」をクリックします。データソース名は、ColdFusion の変数命名規則に従っていれば任意の名前を指定できます。 JDBC Driver の場合は「other」を選択し、「Add」ボタンをクリックします。
  4. 次に、ドライバーのプロパティを入力します。
    • JDBC URL は次の形式で指定します： jdbc:esalesmanager:|connectionString|
    • 一般的な接続文字列は次のようになります：

      jdbc:esalesmanager:User=MyUsername;Password=MyPassword;URL=MyInstanceURL;TenantId=MyTenantId;

    • Driver Class：cdata.jdbc.esalesmanager.ESalesManagerDriver
    • Driver Name は任意で、ColdFusion 管理コンソールでデータソースを識別するためだけに使用されます。
  5. 作成した CDatae-Sales ManagerJDBC データソースの左側にあるチェックマークをクリックして、接続をテストします。 データソースが「OK」ステータスを報告すれば、使用可能な状態です。
  6. 次に、新しい ColdFusion マークアップファイル（.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>
  7. 最後に、デフォルトポート 8500 でブラウザからコードをローカルで実行します。e-Sales Manager データが入力されたテーブルが表示されます。

なお、CData JDBC Driver は cfqueryparam 要素を使用したパラメータ化クエリもサポートしています。 例： 

SELECT * FROM Account WHERE name =

おわりに

CData JDBC Driver for e-Sales Manager の30日間の無償トライアルをダウンロードして、 Adobe ColdFusion で e-Sales Manager に接続したアプリケーションの構築を始めましょう。 ご不明な点があれば、サポートチームまでお問い合わせください。

はじめる準備はできましたか？

e-Sales Manager Remixi Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

e-Sales Manager Remix Icon e-Sales Manager Remix JDBC Driver お問い合わせ

商品、在庫、発送状況などのe-Sales Manager データを組み込んだ強力なJava アプリケーションを迅速に作成して配布できます。

この記事の内容

関連記事