CData Zendesk BizTalk Adapter の要請応答送信ポートを構成

Biztalk Adapter を要請応答送信ポートと共に使用して、BizTalk でアップデートグラムとデータ操作 SQL を実行します。

加藤龍彦
デジタルマーケティング

最終更新日:2021-07-17

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

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

ここでは、CData BizTalk Adapter for Zendesk を使用し、静的な要請応答送信ポートを作成、構成、テストする手順を説明します。静的な要請応答送信ポートを使用してコマンドを実行し、BizTalk の結果にアクセスすることができます。送信ポートを使用することで、アップデートグラムコマンド、SQL コマンド、ストアドプロシージャ操作を実行できます。

送信ポートを作成し構成する

静的な要請応答送信ポートを作成し、アダプタをトランスポートタイプとして使用するように構成します。

  1. 未実行の場合、BizTalk 管理コンソールで BizTalk アプリケーションを開きます。
  2. BizTalk アプリのノードで、[Send Ports]を右クリックし、[New]->[Static Solicit-Response Send Port]を選択すると、送信ポートプロパティのダイアログが表示されます。
  3. 送信ポートのプロパティで、受信ポートの名前を入力します。
  4. [Transport Type]メニューで、CData.Zendesk を選択します。
  5. [Send Pipeline]メニューで、デフォルトオプションの[PassThruTransmit]を選択します。
  6. [Receive Pipeline]メニューで、デフォルトオプションの[PassThruReceive]を選択します。
Send port properties for a solicit-response send port that is configured for the adapter.(Salesforce is shown.)

アダプタを構成する

[Transport Properties]ダイアログで、アダプタが実行するコマンドを定義します。

  1. 送信ポートのプロパティで、[Configure]ボタンをクリックします。アダプタのトランスポートプロパティダイアログが表示されます。
  2. [CommandType]プロパティで、実行したいコマンドタイプを選択します。
  3. SQL コマンドを実行したい場合は、[SQL Command]のボックスにコマンドを入力してください。
プロパティとその機能についての説明は、ヘルプドキュメントの[Adapter Configuration]を参照してください。 The Adapter Transport  Properties dialog.(Salesforce is shown.)

Zendesk への接続を構成する

[Connection String Options]ダイアログで、Zendesk への接続に必要な資格情報とその他のプロパティを設定します。

  1. 送信ポートのプロパティで、[Configure]をクリックします。アダプタのプロパティダイアログが表示されます。
  2. [Connection String]プロパティのボタンをクリックします。[Connection String Options]ダイアログが表示されます。
  3. 接続プロパティを入力します。下は一般的な接続文字列です。

    URL=https://subdomain.zendesk.com;User=my@email.com;Password=test123;

    Zendesk 接続プロパティの取得・設定方法

    Zendesk に接続するには、https://{subdomain}.zendesk.com の形式でURL(Zendesk Support URL)を設定します。接続後、次のセクションの説明に従ってユーザー認証を行います。

    また、TicketMetrics テーブルのアーカイブデータを扱うユーザーは、UseIncrementalAPI プロパティをTrue に設定する必要があります。

    Zendesk への認証

    Zendesk は、Zendesk インスタンスの設定に応じて、3種類の認証をサポートします。API トークン認証、OAuth 認証、Basic 認証(レガシー)です。

    API トークン認証

    API トークン認証を使用する場合は、E メールアドレスとApiToken を指定します。 AuthSchemeAPIToken に、User をE メールアドレスに設定し、Zendesk Support の管理画面で以下の設定を行います。

    1. Token アクセスを有効にします。
    2. Admin -> Channels-> API で、API トークンを管理します。一度にアクティブにできるトークンは1つだけです。トークンを削除すると、そのトークンは永久に無効化されます。
    最後に、APIToken をアクティブなAPI トークンに設定します。

    その他の認証方法についてはヘルプドキュメントを参照してください。

  4. [Test Connection]をクリックして値を確認し、接続を確認します。
プロパティとその機能の説明については、ヘルプドキュメントの[Connection String Options]チャプターを参照してください。
アダプタfor Zendesk のアップデートグラムチュートリアル]では、要請応答送信ポートを使用して、Zendesk にアップデートグラムを挿入するシンプルなアプリケーションを作成する手順を説明します。

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

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