SnapLogic を使用して Zendesk を外部サービスと連携
SnapLogic は、ノーコードでデータ連携フローを作成できる iPaaS(Integration Platform as a Service)です。CData JDBC Driver と組み合わせることで、Zendesk を含む250を超える SaaS、ビッグデータ、NoSQL ソースのリアルタイムデータに SnapLogic ワークフローからアクセスできます。
CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、リアルタイム Zendesk のデータ とのやり取りにおいて比類ないパフォーマンスを発揮します。外部ツールから複雑な SQL クエリが発行されると、ドライバーはフィルタや集計などのサポートされている SQL 操作を Zendesk に直接プッシュし、サポートされていない操作(多くの場合、SQL 関数や JOIN 操作)は内蔵の SQL エンジンを使用してクライアント側で処理します。動的なメタデータクエリ機能により、ネイティブデータ型を使用して Zendesk のデータ を操作できます。
SnapLogic から Zendesk に接続
SnapLogic から Zendesk のデータ に接続するには、CData Zendesk JDBC Driver をダウンロードしてインストールします。インストールウィザードに従って進めてください。インストールが完了すると、JAR ファイルはインストールディレクトリ(デフォルトでは C:/Program Files/CData/CData JDBC Driver for Zendesk/lib)に配置されます。
Zendesk JDBC Driver のアップロード
インストール後、Manager タブから SnapLogic 内の場所(例:projects/Jerod Johnson)に JDBC JAR ファイルをアップロードします。
接続の設定
JDBC Driver をアップロードしたら、Zendesk への接続を作成します。
- Designer タブに移動します
- Snaps から「JDBC」を展開し、「Generic JDBC - Select」snap をデザイナーにドラッグします
- Add Account をクリック(または既存のアカウントを選択)し、「Continue」をクリックします
- 次のフォームで、JDBC 接続プロパティを設定します:
- JDBC JARs に、先ほどアップロードした JAR ファイルを追加します
- JDBC Driver Class を cdata.jdbc.zendesk.ZendeskDriver に設定します
JDBC URL を Zendesk JDBC Driver の JDBC 接続文字列に設定します。例:
jdbc:zendesk:URL=https://subdomain.zendesk.com;User=my@email.com;Password=test123;RTK=XXXXXX;
注意:RTK はトライアルキーまたは製品キーです。詳細についてはサポートチームまでお問い合わせください。
組み込みの接続文字列デザイナー
JDBC URL の構築には、Zendesk JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
java -jar cdata.jdbc.zendesk.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Zendesk 接続プロパティの取得・設定方法
Zendesk に接続するには、https://{subdomain}.zendesk.com の形式でURL(Zendesk Support URL)を設定します。接続後、次のセクションの説明に従ってユーザー認証を行います。
また、TicketMetrics テーブルのアーカイブデータを扱うユーザーは、UseIncrementalAPI プロパティをTrue に設定する必要があります。
Zendesk への認証
Zendesk は、Zendesk インスタンスの設定に応じて、3種類の認証をサポートします。API トークン認証、OAuth 認証、Basic 認証(レガシー)です。
API トークン認証
API トークン認証を使用する場合は、E メールアドレスとApiToken を指定します。 AuthScheme をAPIToken に、User をE メールアドレスに設定し、Zendesk Support の管理画面で以下の設定を行います。
- Token アクセスを有効にします。
- Admin -> Channels-> API で、API トークンを管理します。一度にアクティブにできるトークンは1つだけです。トークンを削除すると、そのトークンは永久に無効化されます。
その他の認証方法についてはヘルプドキュメントを参照してください。
- 接続プロパティを入力したら、「Validate」をクリックし、「Apply」をクリックします
Zendesk のデータ の読み取り
接続の検証と適用後に開くフォームで、クエリを設定します。
- Schema name を「Zendesk」に設定します
- Table name を Zendesk のテーブルに設定します。スキーマ名を使用して、例:「Zendesk」.「Tickets」(ドロップダウンで利用可能なテーブルの一覧を確認できます)
- テーブルから使用する各項目の Output fields を追加します
Generic JDBC - Select snap を保存します。
接続とクエリを設定したら、snap の末尾をクリックしてデータをプレビューします(下図でハイライト表示)。
結果が期待通りであることを確認したら、追加の snap を使用して Zendesk のデータ を別のエンドポイントに送信できます。
Zendesk のデータ を外部サービスにパイプ
この記事では、データを Google スプレッドシートに読み込みます。サポートされている任意の snap を使用するか、別の CData JDBC Driver と Generic JDBC snap を使用して、外部サービスにデータを移動できます。
- 「Worksheet Writer」snap を「Generic JDBC - Select」snap の末尾にドロップします。
- Google Sheets に接続するためのアカウントを追加します
- Worksheet Writer snap を設定して、Zendesk のデータ を Google スプレッドシートに書き込みます
これで、完全に設定されたパイプラインを実行して、Zendesk からデータを抽出し、Google スプレッドシートにプッシュできます。
外部データを Zendesk にパイプ
上記の通り、SnapLogic で Zendesk 用の JDBC Driver を使用して Zendesk にデータを書き込むこともできます。まず、Generic JDBC - Insert または Generic JDBC - Update snap をダッシュボードに追加します。
- 既存の「Account」(接続)を選択するか、新しいものを作成します
- クエリを設定します:
- Schema name を「Zendesk」に設定します
- Table name を Zendesk のテーブルに設定します。スキーマ名を使用して、例:「Zendesk」.「Tickets」(ドロップダウンで利用可能なテーブルの一覧を確認できます)
- Generic JDBC - Insert/Update snap を保存します
これで、Zendesk にデータを書き込み、新しいレコードを挿入したり既存のレコードを更新したりする snap が設定されました。
詳細情報と無料トライアル
CData JDBC Driver for Zendesk を使用することで、SnapLogic で Zendesk のデータ を外部サービスと連携するパイプラインを作成できます。Zendesk への接続の詳細については、CData JDBC Driver for Zendesk ページをご覧ください。CData JDBC Driver for Zendesk の30日間無料トライアルをダウンロードして、今すぐお試しください。