ColdFusion で ODBC 経由のServiceNow のデータをリアルタイムにインポートしてアプリケーションを構築

Dibyendu Datta
Lead Technology Evangelist

CData ODBC ドライバーを使って、ColdFusion でServiceNow のデータをインポート・活用。

Adobe ColdFusion は、Web およびモバイルアプリケーションの開発プラットフォームです。独自のスクリプト言語である ColdFusion Markup Language（CFML）を使用して、データ駆動型の Web サイトを作成したり、REST などのリモートサービスを生成したりできます。ColdFusion を CData ODBC Driver for ServiceNow と組み合わせることで、ColdFusion の Web およびモバイルアプリケーションとServiceNow のライブデータを連携できます。これにより、アプリケーションをより堅牢で完全なものにすることができます。この記事では、ODBC ドライバーを使って、ColdFusion マークアップファイル内でServiceNow のデータを取得してテーブルを作成する方法を説明します。

ServiceNow データ連携について

CData は、ServiceNow のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています：

CData はデータには REST API を、スキーマには SOAP API を使用するため、最適化されたパフォーマンスを実現できます。
Schedules、Timelines、Questions、Syslogs などの ServiceNow オブジェクトの読み取り、書き込み、更新、削除ができます。
SQL ストアドプロシージャを使用して、カートへのアイテム追加、注文の送信、添付ファイルのダウンロードなどのアクションを実行できます。
Basic（ユーザー名とパスワード）、OKTA、ADFS、OneLogin、PingFederate 認証スキームを含め、ServiceNow に安全に認証できます。

多くのユーザーは、Tableau、Power BI、Excel などのお気に入りの分析ツールからライブ ServiceNow データにアクセスし、CData ソリューションを使用して ServiceNow データをデータベースやデータウェアハウスに統合しています。

はじめに

このチュートリアルを進めるには、CData ODBC Driver for ServiceNow と Adobe ColdFusion をインストールする必要があります。

接続の設定

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最終ステップです。Microsoft ODBC データソースアドミニストレーターを使って ODBC DSN を作成・設定できます。

ServiceNow はOAuth 2.0 認証標準を利用しています。OAuth を使って認証するには、ServiceNow にOAuth アプリを登録してOAuthClientId を取得しなければなりません。OAuth 値の他に、Instance、User、およびPassword の指定が必要です。

OAuth 認証を介した接続について詳しくは、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

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

DSN を作成したら、以下の手順に従って、新しいデータソースを追加し、接続をテストし、ColdFusion マークアップファイルを作成し、最後にServiceNow のデータをインポートして ColdFusion でテーブルに表示します。

ColdFusion 管理インターフェースから、Data & Services を選択します。
ここで「Add New Data Source」をクリックします。データソース名は、ColdFusion の変数命名規則に準拠していれば任意の名前で構いません。ODBC ドライバーの場合は「ODBC Socket」を選択し、「Add」ボタンをクリックします。
ODBC DSN ドロップダウンメニューから CData ServiceNow Sys を選択します。Advanced Settings セクションでは、Connection String は空白のままにしておきます。なお、この入力フィールドで指定されたプロパティは、DSN 設定で指定されたものを上書きします。
次に、先ほど作成した CDataServiceNowODBC データソースの左側にあるチェックマークを押して、接続をテストします。データソースが「OK」ステータスを報告したら、使用する準備ができています。

次に、新しい ColdFusion マークアップファイル（.cfm）を作成し、ColdFusion の wwwroot ディレクトリ（「C:\ColdFusion2021\cfusion\wwwroot」）に配置します。

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

          
      <cfquery name="ServiceNowQuery" dataSource="CDataServiceNowODBC">
        SELECT * FROM incident
      </cfquery>

CFTable を使用すると、HTML でテーブルを簡単に出力できます：

          
        <cftable
        query = "ServiceNowQuery"
        border = "1"
        colHeaders
        colSpacing = "2"
        headerLines = "2"
        HTMLTable
        maxRows = "500"
        startRow = "1">

        <cfcol header="<b>sys_id</b>" align="Left" width=2 text="sys_id"/>

        <cfcol header="<b>priority</b>" align="Left" width=15 text="priority"/>

        ...

      </cftable>

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

          
      <html>
      <head><title>CData Software | ServiceNow incident Table Demo </title></head>
      <body>
      <cfoutput>#ucase("ServiceNow incident Table Demo")#</cfoutput>
      <cfquery name="ServiceNowQuery" dataSource="CDataServiceNowODBC">

        SELECT * FROM incident

      </cfquery>
      <cftable
        query = "ServiceNowQuery"
        border = "1"
        colHeaders
        colSpacing = "2"
        headerLines = "2"
        HTMLTable
        maxRows = "500"
        startRow = "1">
        <cfcol header="<b>sys_id</b>" align="Left" width=2 text="sys_id"/>

        <cfcol header="<b>priority</b>" align="Left" width=15 text="priority"/>

        ...

      </cftable>
      </body>

      </html>