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

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData ODBC ドライバーを使って、ColdFusion でJira Service Management のデータ をインポート・活用。

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

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

接続の設定

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

Jira Service Management 接続プロパティの取得・設定方法

任意のJira Service Management Cloud またはJira Service Management Server インスタンスへの接続を確立できます。接続するにはURL プロパティを設定します。

  • URL（例：https://yoursitename.atlassian.net）

カスタムフィールドへのアクセス

デフォルトでは、CData 製品はシステムフィールドのみを表示します。Issues のカスタムフィールドにアクセスするには、IncludeCustomFields を設定します。

Jira Service Management への認証

ベーシック認証

ローカルサーバーアカウントで認証するためには、次の接続プロパティを指定します。

  • AuthScheme：Basic に設定。
  • User：認証ユーザーのユーザー名に設定。
  • Password：認証ユーザーのパスワードに設定。

API トークン

Cloud アカウントに接続するには、APIToken を取得する必要があります。API トークンを生成するには、Atlassian アカウントにログインして「API トークン」 -> 「API トークンの作成」をクリックします。生成されたトークンが表示されます。

データに接続するには以下を設定します。

  • AuthScheme：APIToken に設定。
  • User：認証ユーザーのユーザー名に設定。
  • APIToken：作成したAPI トークンに設定。

ちなみに、Cloud アカウントへの接続でパスワード認証を使うことも可能ですが、非推奨となっています。

OAuth 2.0

Jira Service Management のOAuth 2.0 サポート（3LO）を活用して、ログインクレデンシャルなしでデータに接続することもできます。

この場合、AuthSchemeをすべてのOAuth フローでOAuth に設定する必要があります。また、すべてのシナリオでカスタムOAuth アプリケーションを作成して構成する必要があります。詳しくは、ヘルプドキュメントの「OAuth」セクションを参照してください。

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

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

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

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

              
      <cfquery name="Jira Service ManagementQuery" dataSource="CDataJira Service ManagementODBC">
        SELECT * FROM Requests
      </cfquery>
    CFTable を使用すると、HTML でテーブルを簡単に出力できます： 
              
        <cftable
        query = "Jira Service ManagementQuery"
        border = "1"
        colHeaders
        colSpacing = "2"
        headerLines = "2"
        HTMLTable
        maxRows = "500"
        startRow = "1">

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

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

        ...

      </cftable>
    HTML 部分を含む完全なコードは以下のとおりです： 
              
      <html>
      <head><title>CData Software | Jira Service Management Requests Table Demo </title></head>
      <body>
      <cfoutput>#ucase("Jira Service Management Requests Table Demo")#</cfoutput>
      <cfquery name="Jira Service ManagementQuery" dataSource="CDataJira Service ManagementODBC">

        SELECT * FROM Requests

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

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

        ...

      </cftable>
      </body>

      </html>
  6. 最後に、ブラウザでコードを実行します。Jira Service Management のデータを含むテーブルが表示されます。

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

SELECT * FROM Account WHERE name =

おわりに

CData ODBC Driver for Jira Service Management の 30日間無償トライアルをダウンロードして、Adobe ColdFusion でJira Service Management 連携アプリケーションの構築を始めましょう。ご不明な点がございましたら、サポートチームまでお問い合わせください。

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

Jira Service Management ODBC Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

Jira Service Management Icon Jira Service Management ODBC Driver お問い合わせ

Jira Service Desk ODBC Driver を使って、ODBC 接続をサポートするあらゆるアプリケーション・ツールからJira Service Desk にデータ連携。

Jira Service Desk データにデータベースと同感覚でアクセスして、Jira Service Desk データに使い慣れたODBC インターフェースで双方向連携。

この記事の内容

関連記事