PowerBuilder からJira Service Management のデータに接続してみた

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

この記事ではCData ADO.NET Provider を使ってPowerBuilder からJira Service Management にアクセスする方法を説明します。

CData ADO.NET providers は、PowerBuilder を含むMicrosoft .NET をサポートするあらゆるプラットフォームまたは開発テクノロジーから使用できる、使いやすい標準準拠のデータプロバイダーです。この記事では、CData ADO.NET Provider for JiraServiceDesk をPowerBuilder で使う方法について説明します。

CData ADO.NET Provider for JiraServiceDesk を使ってデータを取得し読み書きを実行する基本的なPowerBuilder アプリケーションを作成する方法について説明します。

新規WPF Window Application ソリューションで、接続プロパティに必要なすべてのビジュアルコントロールを追加します。一般的な接続文字列は次のとおりです：
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」セクションを参照してください。
.NET コントロールからDataGrid コントロールを追加します。

DataGrid コントロールのカラムを設定します。Account テーブルからいくつかのカラムを以下に示します：


<DataGrid AutoGenerateColumns="False" Margin="13,249,12,14" Name="datagrid1" TabIndex="70" ItemsSource="{Binding}">
<DataGrid.Columns>
    <DataGridTextColumn x:Name="idColumn" Binding="{Binding Path=Id}" Header="Id" Width="SizeToHeader" />
    <DataGridTextColumn x:Name="nameColumn" Binding="{Binding Path=RequestId}" Header="RequestId" Width="SizeToHeader" />
		...
	</DataGrid.Columns>
</DataGrid>

CData ADO.NET Provider for JiraServiceDesk アセンブリへの参照を追加します。

DataGrid 接続

ビジュアルエレメントが設定されたら、Connection、Command、およびDataAdapter のような標準のADO.NET オブジェクトを使ってSQL クエリの結果をDataTable に表示することができます：

System.Data.CData.JiraServiceDesk.JiraServiceDeskConnection conn
conn = create System.Data.CData.JiraServiceDesk.JiraServiceDeskConnection(connectionString)

System.Data.CData.JiraServiceDesk.JiraServiceDeskCommand comm
comm = create System.Data.CData.JiraServiceDesk.JiraServiceDeskCommand(command, conn)

System.Data.DataTable table
table = create System.Data.DataTable

System.Data.CData.JiraServiceDesk.JiraServiceDeskDataAdapter dataAdapter
dataAdapter = create System.Data.CData.JiraServiceDesk.JiraServiceDeskDataAdapter(comm)
dataAdapter.Fill(table)
datagrid1.ItemsSource=table.DefaultView

上のコードは、指定したクエリからDataGrid にデータをバインドできます。