製品をチェック

Jira Service Desk Driver の30日間無償トライアルをダウンロード

 30日間の無償トライアルへ

製品の詳細

Jira Service Desk アイコン Jira Service Desk JDBC Driver 相談したい

Jira Service Desk データに連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。

Jira Service Desk データをR で分析

CData JDBC Driver で標準的なR 関数とお好みの開発環境を使ってJira Service Desk を分析。

加藤龍彦
ウェブデベロッパー

最終更新日:2023-09-21
jiraservicedesk ロゴ

CData

jdbc ロゴ画像
R ロゴ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Pure R スクリプトおよび 標準SQL を使って、R およびJava をインストール可能なあらゆるマシン上でJira Service Desk にアクセス。CData JDBC Driver for JiraServiceDesk とRJDBC package を使って、R でリモートJira Service Desk データ を利用できます。CData Driver を使うことで、業界が認めた基準で書かれたドライバーを活用して、オープンソースでポピュラーなR 言語のデータにアクセスできます。この記事では、ドライバーを使ってJira Service Desk にSQL クエリを実行する方法、および標準R 関数を呼び出してJira Service Desk をビジュアライズする方法について説明します。

R をインストール

マルチスレッドのMicrosoft R Open を実行すること、またはBLAS/LAPACK ライブラリにリンクされたオープン R を実行することによって、マルチスレッドおよびマネージドコードから利益を得られたドライバーのパフォーマンスにマッチできます。ここでは、Microsoft R Open 3.2.3 を使用します。CRAN レポジトリのJan. 1, 2016 snapshot からパッケージをインストールするために事前設定されています。このsnapshot は再現性を保証します。

RJDBC パッケージをロード

ドライバーを使うにはRJDBC パッケージをダウンロードします。RJDBC パッケージをインストールしたら、次のコードを入力してパッケージをロードします。

library(RJDBC)

JDBC データソースとしてJira Service Desk に接続

下記の情報を使いJira Service Desk にJDBC データソースとして接続します。

  • Driver Class:cdata.jdbc.jiraservicedesk.JiraServiceDeskDriver に設定。
  • Classpath:Driver JAR の場所を設定します。デフォルトではインストールディレクトリの[lib]サブフォルダです。

dbConnect やdbSendQuery のようなDBI 関数は、R にデータアクセスコードを書くための統一インターフェースを提供します。

driver <- JDBC(driverClass = "cdata.jdbc.jiraservicedesk.JiraServiceDeskDriver", classPath = "MyInstallationDir\lib\cdata.jdbc.jiraservicedesk.jar", identifier.quote = "'")

これで、DBI 関数を使ってJira Service Desk に接続しSQL クエリを実行する準備が整いました。dbConnect 関数を使ってJDBC 接続を初期化します。一般的なJDBC 接続文字列は次のとおりです。

conn <- dbConnect(driver,"ApiKey=myApiKey;User=MyUser;")

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

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

  • URL(例:https://yoursitename.atlassian.net)

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

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

Jira Service Management への認証

ベーシック認証

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

  • AuthSchemeBasic に設定。
  • User:認証ユーザーのユーザー名に設定。
  • Password:認証ユーザーのパスワードに設定。

API トークン

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

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

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

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

OAuth 2.0

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

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

スキーマ Discovery

ドライバーはJira Service Desk API をリレーショナルデータベース、ビュー、ストアドプロシージャとしてモデルします。次のコードを使ってテーブルリストを検出します。

dbListTables(conn)

SQL クエリの実行

dbGetQuery 関数を使ってJira Service Desk API がサポートするすべてのSQL クエリを実行できます:

requests <- dbGetQuery(conn,"SELECT RequestId, ReporterName FROM Requests WHERE CurrentStatus = 'Open'")

次のコマンドを使って、結果を[data viewer]ウィンドウで見ることができます。

View(requests)

Jira Service Desk データ をプロット

CRAN レポジトリで利用可能なあらゆるデータ初期化パッケージを使ってJira Service Desk を分析する準備が整いました。ビルトインバーのplot 関数を使って簡単なバーを作成できます。

par(las=2,ps=10,mar=c(5,15,4,2)) barplot(requests$ReporterName, main="Jira Service Desk Requests", names.arg = requests$RequestId, horiz=TRUE) A basic bar plot. (Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。