各製品の資料を入手。
詳細はこちら →
CData Jira Service Management BizTalk Adapter の要請応答送信ポートを構成
Biztalk Adapter を要請応答送信ポートと共に使用して、BizTalk でアップデートグラムとデータ操作 SQL を実行します。
最終更新日：2021-07-17
この記事で実現できるJira Service Management 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
ここでは、CData BizTalk Adapter for JiraServiceDesk を使用し、静的な要請応答送信ポートを作成、構成、テストする手順を説明します。静的な要請応答送信ポートを使用してコマンドを実行し、BizTalk の結果にアクセスすることができます。送信ポートを使用することで、アップデートグラムコマンド、SQL コマンド、ストアドプロシージャ操作を実行できます。
送信ポートを作成し構成する
静的な要請応答送信ポートを作成し、アダプタをトランスポートタイプとして使用するように構成します。
- 未実行の場合、BizTalk 管理コンソールで BizTalk アプリケーションを開きます。
- BizTalk アプリのノードで、［Send Ports］を右クリックし、［New］->［Static Solicit-Response Send Port］を選択すると、送信ポートプロパティのダイアログが表示されます。
- 送信ポートのプロパティで、受信ポートの名前を入力します。
- ［Transport Type］メニューで、CData.JiraServiceDesk を選択します。
- ［Send Pipeline］メニューで、デフォルトオプションの［PassThruTransmit］を選択します。
- ［Receive Pipeline］メニューで、デフォルトオプションの［PassThruReceive］を選択します。
アダプタを構成する
［Transport Properties］ダイアログで、アダプタが実行するコマンドを定義します。
- 送信ポートのプロパティで、［Configure］ボタンをクリックします。アダプタのトランスポートプロパティダイアログが表示されます。
- ［CommandType］プロパティで、実行したいコマンドタイプを選択します。
- SQL コマンドを実行したい場合は、［SQL Command］のボックスにコマンドを入力してください。
Jira Service Management への接続を構成する
［Connection String Options］ダイアログで、Jira Service Management への接続に必要な資格情報とその他のプロパティを設定します。
- 送信ポートのプロパティで、［Configure］をクリックします。アダプタのプロパティダイアログが表示されます。
- ［Connection String］プロパティのボタンをクリックします。［Connection String Options］ダイアログが表示されます。
- 接続プロパティを入力します。下は一般的な接続文字列です。
ApiKey=myApiKey;User=MyUser;Jira Service Management 接続プロパティの取得・設定方法
任意のJira Service Management Cloud またはJira Service Management Server インスタンスへの接続を確立できます。接続するにはURL プロパティを設定します。
- URL（例：https://yoursitename.atlassian.net）
カスタムフィールドへのアクセス
デフォルトでは、CData 製品はシステムフィールドのみを表示します。Issues のカスタムフィールドにアクセスするには、IncludeCustomFields を設定します。
Jira Service Management への認証
ベーシック認証
ローカルサーバーアカウントで認証するためには、次の接続プロパティを指定します。
- AuthScheme：Basic に設定。
- User：認証ユーザーのユーザー名に設定。
- Password：認証ユーザーのパスワードに設定。
API トークン
Cloud アカウントに接続するには、APIToken を取得する必要があります。API トークンを生成するには、Atlassian アカウントにログインして「API トークン」 -> 「API トークンの作成」をクリックします。生成されたトークンが表示されます。
データに接続するには以下を設定します。
- AuthScheme：APIToken に設定。
- User：認証ユーザーのユーザー名に設定。
- APIToken：作成したAPI トークンに設定。
ちなみに、Cloud アカウントへの接続でパスワード認証を使うことも可能ですが、非推奨となっています。
OAuth 2.0
Jira Service Management のOAuth 2.0 サポート（3LO）を活用して、ログインクレデンシャルなしでデータに接続することもできます。この場合、AuthSchemeをすべてのOAuth フローでOAuth に設定する必要があります。また、すべてのシナリオでカスタムOAuth アプリケーションを作成して構成する必要があります。詳しくは、ヘルプドキュメントの「OAuth」セクションを参照してください。
- ［Test Connection］をクリックして値を確認し、接続を確認します。
［アダプタfor JiraServiceDesk のアップデートグラムチュートリアル］では、要請応答送信ポートを使用して、Jira Service Management にアップデートグラムを挿入するシンプルなアプリケーションを作成する手順を説明します。
