SSIS を使ってJira Service Management のデータをSQL Server にインポート

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

SQL Server に基幹業務データのバックアップを保管しておくことは、ビジネス上のセーフティネットとなります。また、ユーザーはSQL Server のバックアップデータからレポーティングや分析を簡単に行うことができます。

ここでは、SQL サーバー SSIS ワークフロー内でCData SSIS Tasks for JiraServiceDesk を使用して、Jira Service Management のデータをMicrosoft SQL Server データベースに転送する方法を説明します。

Components の追加

開始するには、新しいJira Service Management ソースとSQL Server ADO.NET 転送先を新しいデータフロータスクに追加します。

新しいコネクションマネジャーを作成

以下のステップに従って、接続マネジャーでJira Service Management 接続プロパティを保存します。

1. Connection Manager ウィンドウで、右クリックで［New Connection］ を選択します。Add SSIS Connection Manager ダイアログが表示されます。
2. ［Connection Manager type］メニューでJiraServiceDesk を選択します。CData Jira Service Management Connection Manager が表示されます。
3. 接続プロパティを構成します。

   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」セクションを参照してください。

Jira Service Management Source の構成

以下のステップに従って、Jira Service Management の抽出に使用するクエリを指定します。

1. Jira Service Management ソースをダブルクリックしてソースコンポーネントエディタを開きます。
2. ［Connection Manager］メニューで、以前作成した接続マネジャーを選択します。
3. データの書き出しに使用するクエリを指定します。例： SELECT RequestId, ReporterName FROM Requests WHERE CurrentStatus = 'Open'
4. Jira Service Management Source コントロールを閉じて、ADO.NET Destination に接続します。

SQL Server Destination を構成する

以下のステップに従って、Jira Service Management をロードするSQL サーバーテーブルを指定します。

1. ADO.NET Destination を選択して、新しい接続を追加します。接続するサーバーおよびデータベースの情報を入力。
2. Data access モードメニューで、［table or view］を選択します。
3. ［Table Or View］メニューで、設定するテーブルまたはビューを選択します。
4. ［Mappings］画面で必要なプロパティを設定します。

プロジェクトの実行

プロジェクトを実行できるようになりました。SSIS Task の実行が完了すると、データベースにJira Service Management のデータが入力されます。