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

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

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

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

1. Report Designer 機能をインストールします。［File］->［Install KNIME Extensions］とクリックし、［Report］でフィルタリングします。
2. 新しいワークフローで［File］->［Preferences］をクリックし、［KNIME］->［Databases］でノードを展開し cdata.jdbc.suitecrm.jar を追加します。
3. ドライバーJAR　は、インストールディレクトリのlib サブフォルダにあります。
4. ［Node Repository］ビューで［Database］->［Read/Write］とノードを展開し、［Database Reader］をワークフローエディターにドラッグします。

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

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

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

     次の接続プロパティを設定すると、V4.1 API 経由でSuiteCRM データに接続できます。

     • Schema：suitecrmv4 に設定。
     • Url：SuiteCRM アプリケーションに紐づいているURL（例：http://suite.crm.com）に設定。
     • User：SuiteCRM に紐づいているユーザーに設定。
     • Password：SuiteCRM に紐づいているパスワードに設定。

     SuiteCRM メタデータの取得は高負荷になる可能性があることに注意してください。メタデータのキャッシュ で説明しているように、メタデータをローカルに格納することをお勧めします。

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

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

     java -jar cdata.jdbc.suitecrm.jar

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

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

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

     jdbc:suitecrm:URL=http://mySuiteCRM.com;User=myUser;Password=myPassword;
   • User Name:認証に使用されるユーザー名
   • Password:認証に使用されるパスワード
   • SQL Statement:［SQL Statement］ボックスにSQL クエリを入力するか、テーブルをダブルクリックします。この記事では、チャートの作成に以下のクエリを用います。 SELECT Name, Industry FROM Accounts

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

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

トラブルシューティング

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

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