SnapLogic を使用して Halo Service Desk を外部サービスと連携

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData JDBC Driver を SnapLogic で使用して、Halo Service Desk を外部サービスと連携する方法を説明します。

SnapLogic は、ノーコードでデータ連携フローを作成できる iPaaS(Integration Platform as a Service)です。CData JDBC Driver と組み合わせることで、Halo Service Desk を含む250を超える SaaS、ビッグデータ、NoSQL ソースのリアルタイムデータに SnapLogic ワークフローからアクセスできます。

CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、リアルタイム Halo Service Desk のデータ とのやり取りにおいて比類ないパフォーマンスを発揮します。外部ツールから複雑な SQL クエリが発行されると、ドライバーはフィルタや集計などのサポートされている SQL 操作を Halo Service Desk に直接プッシュし、サポートされていない操作(多くの場合、SQL 関数や JOIN 操作)は内蔵の SQL エンジンを使用してクライアント側で処理します。動的なメタデータクエリ機能により、ネイティブデータ型を使用して Halo Service Desk のデータ を操作できます。

SnapLogic から Halo Service Desk に接続

SnapLogic から Halo Service Desk のデータ に接続するには、CData Halo Service Desk JDBC Driver をダウンロードしてインストールします。インストールウィザードに従って進めてください。インストールが完了すると、JAR ファイルはインストールディレクトリ(デフォルトでは C:/Program Files/CData/CData API Driver for JDBC/lib)に配置されます。

Halo Service Desk JDBC Driver のアップロード

インストール後、Manager タブから SnapLogic 内の場所(例:projects/Jerod Johnson)に JDBC JAR ファイルをアップロードします。

アップロードされた JDBC Driver(Salesforce と QuickBooks Online の例)

接続の設定

JDBC Driver をアップロードしたら、Halo Service Desk への接続を作成します。

  1. Designer タブに移動します
  2. Snaps から「JDBC」を展開し、「Generic JDBC - Select」snap をデザイナーにドラッグします Generic JDBC snap をデザイナーに追加
  3. Add Account をクリック(または既存のアカウントを選択)し、「Continue」をクリックします
  4. 次のフォームで、JDBC 接続プロパティを設定します:
    • JDBC JARs に、先ほどアップロードした JAR ファイルを追加します
    • JDBC Driver Class を cdata.jdbc.api.APIDriver に設定します
    • JDBC URL を Halo Service Desk JDBC Driver の JDBC 接続文字列に設定します。例:

      jdbc:api:Profile=C:\profiles\HaloServiceDesk.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key;Domain=yourcompany.haloservicedesk.com';RTK=XXXXXX;

      注意:RTK はトライアルキーまたは製品キーです。詳細についてはサポートチームまでお問い合わせください。 接続の設定(Salesforce の例)

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

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

      java -jar cdata.jdbc.api.jar

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

      まず、Profile 接続プロパティをディスク上の HaloServiceDesk プロファイルの場所に設定します(例:C:\profiles\HaloServiceDesk.apip)。次に、ProfileSettings 接続プロパティを HaloServiceDesk の接続文字列に設定します(以下を参照)。

      HaloServiceDesk API プロファイル設定

      HaloServiceDesk では API キー認証を使用します。API キーは、HaloServiceDesk の「Administration」>「Integrations」>「Halo API」で確認・作成できます。

      接続するには、以下の接続プロパティを設定します。

      • AuthScheme:APIKey に設定します。
      • APIKey:HaloServiceDesk アカウントの API キーに設定します。
      • Domain:HaloServiceDesk インスタンスのホスト名に設定します(例:yourcompany.haloservicedesk.com)。
      組み込みの接続文字列デザイナーを使用して JDBC URL を生成(Salesforce の例)
  5. 接続プロパティを入力したら、「Validate」をクリックし、「Apply」をクリックします

Halo Service Desk のデータ の読み取り

接続の検証と適用後に開くフォームで、クエリを設定します。

  • Schema name を「API」に設定します
  • Table name を Halo Service Desk のテーブルに設定します。スキーマ名を使用して、例:「API」.「Assets」(ドロップダウンで利用可能なテーブルの一覧を確認できます)
  • テーブルから使用する各項目の Output fields を追加します
Select snap の設定(Salesforce の例)

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の末尾をクリックしてデータをプレビューします(下図でハイライト表示)。

snap の末尾をクリックしてデータをプレビュー

結果が期待通りであることを確認したら、追加の snap を使用して Halo Service Desk のデータ を別のエンドポイントに送信できます。

データのプレビュー(Salesforce の例)

Halo Service Desk のデータ を外部サービスにパイプ

この記事では、データを Google スプレッドシートに読み込みます。サポートされている任意の snap を使用するか、別の CData JDBC Driver と Generic JDBC snap を使用して、外部サービスにデータを移動できます。

  1. 「Worksheet Writer」snap を「Generic JDBC - Select」snap の末尾にドロップします。
  2. Google Sheets に接続するためのアカウントを追加します Google への接続
  3. Worksheet Writer snap を設定して、Halo Service Desk のデータ を Google スプレッドシートに書き込みます Google スプレッドシートへの書き込み

これで、完全に設定されたパイプラインを実行して、Halo Service Desk からデータを抽出し、Google スプレッドシートにプッシュできます。

Google スプレッドシートに書き込まれたデータ(Salesforce の例)

詳細情報と無料トライアル

CData API Driver for JDBC を使用することで、SnapLogic で Halo Service Desk のデータ を外部サービスと連携するパイプラインを作成できます。Halo Service Desk への接続の詳細については、CData API Driver for JDBC ページをご覧ください。CData API Driver for JDBC の30日間無料トライアルをダウンロードして、今すぐお試しください。

はじめる準備はできましたか?

API Driver で Halo Service Desk のライブデータに接続

Halo Service Desk に接続