製品をチェック

無償トライアル:

無償トライアルへ

製品の情報と無償トライアルへ:

Backlog JDBC Driver

Backlog データ連携のパワフルなJava アプリケーションを素早く作成して配布。

データ連携でお困りですか？

お問い合わせ

記事の内容

関連記事

KNIME でBacklog のJDBC ドライバーを有効にする


KNIME の標準データアクセスコンポーネントを使用してBacklog でチャートとレポートを作成します。

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

backlog ロゴ画像

JDBC Driver

jdbc ロゴ画像
KNIME ロゴ画像

CData JDBC Driver for Backlog の強みの一つは、クロスプラットフォームのサポートであり、主要なBI ツールとの統合を可能にします。以下のステップに従って、KNIME のBacklog にアクセスし、レポートデザイナを使用してBacklog からチャートを作成します。

CData JDBC Driver for Backlog を使用することで、JDBC データソースとしてBacklog にアクセスでき、IDE の迅速な開発ツールとの統合が可能になります。この記事では、データソース構成ウィザードを使用してIntelliJ のBacklog に接続する方法を示します。

Backlog データへの新しいJDBC 接続を定義します。

  1. Report Designer 機能をインストールします。［File］->［Install KNIME Extensions］とクリックし、［Report］でフィルタリングします。
  2. 新しいワークフローで［File］->［Preferences］をクリックし、［KNIME］->［Databases］でノードを展開し cdata.jdbc.backlog.jar を追加します。
  3. ドライバーJAR　は、インストールディレクトリのlib サブフォルダにあります。 CData drivers added to a KNIME workflow.
  4. ［Node Repository］ビューで［Database］->［Read/Write］とノードを展開し、［Database Reader］をワークフローエディターにドラッグします。 The DataReader that will load Backlog data into the workflow with a SELECT query.(QuickBooks is shown.)

  5. ［Database Reader］をダブルクリックし、次のプロパティを設定します。

    • Database Driver:メニューでドライバーの名前(cdata.jdbc.backlog.BacklogDriver)を選択します。

    • Database URL:接続プロパティを入力します。jdbc:backlog: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続くJDBC URL を入力します。

      Backlog への接続に使用できる認証方法は、API キーおよびOAuth の2つです。

      API キー認証

      ApiKey およびURL をログインクレデンシャルに設定します。 ApiKey を取得するには：

      1. Backlog の個人設定ページを開きます。
      2. 「API」セクションをクリックして、「メモ」にAPI キーについての説明を追加し、「登録」ボタンをクリックします。トークンが生成されます。
      3. ApiKey にAPI キーを指定します。
      4. URL はBacklog のテナントURL から取得できます。

      OAuth 認証

      ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントを参照してください。

      ビルトイン接続文字列デザイナ

      JDBC URL の構成については、Backlog JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

      java -jar cdata.jdbc.backlog.jar

      接続プロパティを入力し、接続文字列をクリップボードにコピーします。

      Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

      JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

      以下は一般的なJDBC URL です。

      jdbc:backlog:ApiKey=YOUR_API_KEY;Url=https://yourURL.backlog.com;
    • User Name:認証に使用されるユーザー名
    • Password:認証に使用されるパスワード
    • SQL Statement:［SQL Statement］ボックスにSQL クエリを入力するか、テーブルをダブルクリックします。この記事では、チャートの作成に以下のクエリを用います。 SELECT Id, ProjectID FROM Issues

  6. ［Fetch Metadata］をクリックして接続を確認します。

    The SELECT statement defined in the Database Reader properties.(QuickBooks is shown.)
  7. ［Database Reader］を［Data to Report］ノードに接続し、データセットを様々なデータ可視化コントロールに提供します。［Execute］をクリックし、ワークフローの上部にある［Edit Report］をクリックしてレポートデザイナパースペクティブを開きます。 A Database Reader linked to provide data to a Database Report.
  8. ライブデータに基づいてレポートを作成できます。チャートを作成するには、チャートコントロールをパレットからレポートデザイナにドラッグします。表示されるウィザードでは、KNIME で使用可能なフィルタリングおよび集約コントロールを使用できます。 A Chart created with the report designer.

トラブルシューティング

次のリストは一般的なエラーを解決する方法を示しています。

  • ［Row1］という重複するIdが見つかりました。:このエラーを解決するには、KNIME インストールディレクトリにあるknime.ini ファイルに-Dknime.database.fetchsize=0を追加します。