Mule アプリケーションからCvent のデータにアクセス:CData JDBC Driver

CData JDBC ドライバとHTTP、SQL を組み合わせれば、Cvent のデータのJSON エンドポイントに接続できるMule アプリケーションを簡単に作成できます。

古川えりか
コンテンツスペシャリスト

最終更新日:2022-07-28

この記事で実現できるCvent 連携のシナリオ

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

CData JDBC Driver for Cvent はCvent のデータをMule アプリケーションと連携することで、読み、書き、更新、削除といった機能をおなじみのSQL クエリを使って実現します。JDBC ドライバーを使えば、Cvent のデータをバックアップ、変換、レポート作成、分析するMule アプリケーションをユーザーは簡単に作成できます。

本記事では、Mule プロジェクト内でCData JDBC Driver for Cvent を使用して、Cvent のデータのWeb インターフェースを作成する方法を紹介します。作成したアプリケーションを使えば、HTTP 経由でCvent のデータをリクエストして、JSON 形式で結果を取得できます。まったく同様の手順で、すべてのCData JDBC ドライバで250 を超えるデータソースのWeb インターフェースを作成できます。手順は以下のとおりです。

  1. Anypoint Studio で新しいMule プロジェクトを作る。
  2. Message Flow にHTTP コネクタを追加する。
  3. HTTP コネクタのアドレスを設定する。 HTTP コネクタを追加・設定
  4. HTTP コネクタの追加後、Database Select コネクタを同じフローに追加する。
  5. データベースへの新しい接続を作成し(または既存の接続を編集し)、プロパティを設定する。
    • 接続を「Generic Connection」に設定
    • Required Libraries セクションでCData JDBC ドライバのJAR ファイルを指定する(例:cdata.jdbc.cvent.jar)。 JAR ファイルを追加(Salesforce の場合)。
    • Cvent の接続文字列にURL を指定

      Cvent への認証を行う前に、ワークスペースとOAuth アプリケーションを作成する必要があります。

      ワークスペースの作成

      ワークスペースを作成するには:

      1. Cvent にサインインし、App Switcher(ページ右上の青いボタン) -> Admin に移動します。
      2. Admin メニューから、Integrations -> REST API に移動します。
      3. Developer Management の新しいタブが立ち上がります。新しいタブでManage API Access をクリックします。
      4. Workspace を作成し、名前を付けます。開発者にアクセスさせたいスコープを選択します。スコープは、開発者がアクセスできるデータドメインを制御します。
        • All を選択すると、開発者は任意のスコープ、およびREST API にこれから追加されるスコープを選択できます。
        • Custom を選択すると、開発者がOAuth アプリで選択できるスコープを、選択したスコープに制限できます。本製品によって公開されるすべてのテーブルにアクセスするには、次のスコープを設定する必要があります。
          event/attendees:readevent/attendees:writeevent/contacts:read
          event/contacts:writeevent/custom-fields:readevent/custom-fields:write
          event/events:readevent/events:writeevent/sessions:delete
          event/sessions:readevent/sessions:writeevent/speakers:delete
          event/speakers:readevent/speakers:writebudget/budget-items:read
          budget/budget-items:writeexhibitor/exhibitors:readexhibitor/exhibitors:write
          survey/surveys:readsurvey/surveys:write

      OAuth アプリケーションの作成

      Workspace を設定して招待すると、開発者はサインアップしてカスタムOAuth アプリを作成できます。手順については、ヘルプドキュメントカスタムOAuth アプリケーションの作成を参照してください。

      Cvent への接続

      OAuth アプリケーションを作成したら、次の接続プロパティを設定してCvent に接続します。

      • InitiateOAuthGETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
      • OAuthClientId:OAuth アプリケーションに関連付けられたClient ID。これは、Cvent Developer Portal のApplications page ページにあります。
      • OAuthClientSecret:OAuth アプリケーションに関連付けられたClient secret。これは、Cvent Developer Portal のApplications page ページにあります。

      組み込みの接続文字列デザイナ

      JDBC 用のURL の作成にサポートが必要な場合は、Cvent JDBC Driver に組み込まれた接続文字列デザイナを使用できます。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行してください。

      java -jar cdata.jdbc.cvent.jar

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

    • Driver クラス名をcdata.jdbc.cvent.CventDriver に指定します。 設定したデータベース接続(Salesforce の場合)。
    • 「接続テスト」をクリックします。
  6. SQL Query Text をCvent のデータをリクエストするためのSQL クエリに設定します。例えば、SELECT Id, Title FROM Events WHERE Virtual = 'true'Select オブジェクトを設定(Salesforce の場合)
  7. Transform Message コンポーネントをフローに追加します。
  8. Output スクリプトを次のように設定して、ペイロードをJSON に変換します。
    %dw 2.0
    output application/json
    ---
    payload
            
    Transform Message コンポーネントをフローに追加
  9. Cvent のデータを閲覧するには、HTTP コネクタ用に設定したアドレスに移動します(デフォルトでは、localhost:8081):http://localhost:8081。Web ブラウザおよびJSON エンドポイントを使用可能な他のツール内で、Cvent のデータをJSON として利用できます。

これで、カスタムアプリケーションおよび他のさまざまなBI、帳票、ETL ツールからCvent のデータを(JSON データとして)扱うための簡易なWeb インターフェースを作成できました。Mule アプリケーションからお好みのデータソースにアクセスできる、JDBC Driver for Cvent の30日の無償評価版のダウンロードはこちらから。

関連コンテンツ

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

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