RazorSQL からJira Service Desk データに連携。

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData JDBC Driver for JiraServiceDesk を使って、各種ツールからJira Service Desk データにアクセスすることが可能になります。本記事では、Jira Service Desk データにRazorSQL のウィザードから連携利用する方法を紹介します。

Jira Service Desk JDBC Data Source の設定

1. RazorSQL アプリケーションを開いて、Connections メニューから、Add Connection Profile -> Other -> JDBC にナビゲートします。
2. Connection Wizard で、以下を設定します：
   • Driver Location:JDBC Driver のインストールディレクトリのlib サブフォルダに設定します。
   • Driver Class: ドライバークラスを cdata.jdbc.jiraservicedesk.JiraServiceDeskDriver に設定します。
   • Username:ユーザー名。（ユーザー名をブランクにして、JDBC URL 内で設定することも可能です。）
   • Password:パスワード。（ユーザー名をブランクにして、JDBC URL 内で設定することも可能です。）

   • JDBC URL:接続パラメータを入力します：jdbc:jiraservicedesk: から始まるJDBC URL を入力します。接続プロパティをカンマ区切りで書きます。

     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」セクションを参照してください。

     一般的なURL ：:

     jdbc:jiraservicedesk:ApiKey=myApiKey;User=MyUser;

3. 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」セクションを参照してください。

Jira Service Desk からテーブルを選択してクエリを実行

接続を確立後、Wizard が閉じ、接続はコネクションパネルで接続が利用可能になります。テーブルをクエリしてみます。