ColdFusion で JDBC 経由でリアルタイム SAP Netweaver Gateway のデータをインポートしてアプリケーションを構築

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

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

CData JDBC Driver は、最適化されたデータ処理機能を組み込んでおり、SAP Netweaver Gateway のデータとのリアルタイム連携において圧倒的なパフォーマンスを提供します。 複雑な SQL クエリを SAP Netweaver Gateway に発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を SAP Netweaver Gateway に直接プッシュし、 サポートされていない操作（多くの場合 SQL 関数や JOIN 操作）は組み込みの SQL エンジンがクライアント側で処理します。 組み込みの動的メタデータクエリ機能により、ネイティブのデータ型を使用して SAP Netweaver Gateway のデータを操作・分析できます。

SAP Netweaver Gateway への接続を設定

ColdFusion と SAP Netweaver Gateway 間の接続を確立するには、JDBC 接続文字列が必要です。

SAP Gateway 接続プロパティの取得・設定方法

SAP Gateway のテーブルにアクセスするには、次の接続プロパティを設定します。

• URL = お使いの環境のURL、またはサービスの完全URL。例えば、完全URL は次のようになります：https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/。この例では、環境URL は次のようになります：https://sapes5.sapdevcenter.com。CustomUrlParams プロパティを使用して、追加プロパティを追加します。
• Namespace = 適切なService Namespace。先ほどの例では、IWBEP が名前空間です。サービスへの完全URL が指定されている場合は任意です。
• Service = データを取得するサービス。先ほどの例では、サービスはGWSAMPLE_BASIC です。完全URL が指定されている場合は必須ではありません。
• CustomUrlParams = HTTP リクエストに含まれる必要のある追加プロパティ；例えばsap-client=001&sap-language=EN。

SAP Gateway への認証

SAP Gateway はBasic 認証、OAuth 2.0 認証、SAP BTP Destination 認証を許可します。

Basic 認証

Basic 認証を有効にするには、以下のプロパティを設定します。

• AuthScheme = Basic。
• User = SAP Gateway へのログインに使用するユーザー名。
• Password = SAP Gateway へのログインに使用するパスワード。

上記のプロパティを設定したら、接続の準備は完了です。ローカルデータにアクセスするには、個人の認証情報を使用します。

他の認証方法については、ヘルプドキュメントの「接続の確立」セクションを参照してください。

組み込みの接続文字列デザイナー

JDBC URL の構築をサポートするために、SAP Netweaver Gateway JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

java -jar cdata.jdbc.sapgateway.jar

データソースの追加とテーブルの作成

接続を設定したら、次の手順に従って CData JDBC Driver を ColdFusion の lib ディレクトリに追加し、新しいデータソースを追加し、接続をテストし、 ColdFusion マークアップファイルを作成して、最終的に SAP Netweaver Gateway のデータとリアルタイムに接続し、ColdFusion Markup Language（CFML）で記述されたテーブルに表示します。

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

               cdata.jdbc.sapgateway.jar
               cdata.jdbc.sapgateway.lic
           

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

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

     jdbc:sapgateway:User=user;Password=password;URL=https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/;

   • Driver Class：cdata.jdbc.sapgateway.SAPGatewayDriver
   • Driver Name は任意で、ColdFusion 管理コンソールでデータソースを識別するためだけに使用されます。
   
5. 作成した CDataSAP Netweaver GatewayJDBC データソースの左側にあるチェックマークをクリックして、接続をテストします。 データソースが「OK」ステータスを報告すれば、使用可能な状態です。
6. 次に、新しい ColdFusion マークアップファイル（.cfm）を作成し、ColdFusion の wwwroot ディレクトリ（「C:\ColdFusion2021\cfusion\wwwroot」）に配置します。

   以下のコードでデータソースにクエリを実行します：

               
           <cfquery name="SAP Netweaver GatewayQuery" dataSource="CDataSAP Netweaver GatewayJDBC">
             SELECT * FROM SalesOrderLineItems
           </cfquery>
       

   CFTable を使用すると、HTML でテーブルを素早く出力できます：

               
             <cftable
             query = "SAP Netweaver GatewayQuery"
             border = "1"
             colHeaders
             colSpacing = "2"
             headerLines = "2"
             HTMLTable
             maxRows = "500"
             startRow = "1">
   
             <cfcol header="<b>ProductID</b>" align="Left" width=2 text="ProductID"/>
   
             <cfcol header="<b>Quantity</b>" align="Left" width=15 text="Quantity"/>
   
             ...
   
           </cftable>
       

   HTML 部分を含む完全なコードは以下のとおりです：

               
           <html>
           <head><title>CData Software | SAP Netweaver Gateway SalesOrderLineItems Table Demo </title></head>
           <body>
           <cfoutput>#ucase("SAP Netweaver Gateway SalesOrderLineItems Table Demo")#</cfoutput>
           <cfquery name="SAP Netweaver GatewayQuery" dataSource="CDataSAP Netweaver GatewayJDBC">
   
             SELECT * FROM SalesOrderLineItems
   
           </cfquery>
           <cftable
             query = "SAP Netweaver GatewayQuery"
             border = "1"
             colHeaders
             colSpacing = "2"
             headerLines = "2"
             HTMLTable
             maxRows = "500"
             startRow = "1">
             <cfcol header="<b>ProductID</b>" align="Left" width=2 text="ProductID"/>
   
             <cfcol header="<b>Quantity</b>" align="Left" width=15 text="Quantity"/>
   
             ...
   
           </cftable>
           </body>
   
           </html>
       

7. 最後に、デフォルトポート 8500 でブラウザからコードをローカルで実行します。SAP Netweaver Gateway データが入力されたテーブルが表示されます。

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

SELECT * FROM Account WHERE name =  

おわりに

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