LINQPad でConfluence のデータを操作する方法

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

LINQPad でConfluence にLINQ クエリを実行する方法を解説します。

CData ADO.NET Provider for Confluence は、LINQ やEntity Framework などの標準のADO.NET インターフェースを使ってConfluence の操作を実現します。この記事では、LINQPad から接続してLINQ クエリを実行する方法を説明します。

必要なもの

本記事の手順を実行してLINQPad からConfluence に接続するには、以下の3つの製品が必要になります。

Confluence の環境
LINQPad
CData ADO.NET Provider for Confluence。右側のサイドバーから30日間無償トライアルがダウンロードできます

データモデルの作成

CData ADO.NET Provider for Confluence およびLINQPad をダウンロード・インストールしたら、Visual Studio で新しいクラスライブラリプロジェクトを作成します。

ADO.NET Provider の利用に必要となるEF 6を設定する方法については、ヘルプドキュメントを参照してください。

プロジェクトを右クリックし、［追加］→［新しい項目］→［ADO.NET Entity Data Model］をクリックします。ダイアログが表示されたら、データベースから［Code First］を選択します。［New Connection］をクリックして、表示されたウィザードで接続文字列オプションを指定します。

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

任意のConfluence Cloud またはConfluence Server インスタンスへの接続を確立できます。接続するにはURL 接続プロパティを設定します。例えば、https://yoursitename.atlassian.net です。

Confluence への認証

Confluence は、次の認証メソッドをサポートしています：API トークン、Basic 認証、OAuth 2.0、SSO。

API トークン - Confluence Cloud アカウント

トークンの取得

アカウント認証にはAPI トークンが必要です。API トークンを生成するには、Atlassian アカウントにログインしてAPI トークン -> API トークンの作成を選択します。生成されたトークンが表示されます。

トークンを使用する認証

Cloud アカウントへの認証を行うには、以下を入力します。

AuthScheme：APIToken に設定。
User：Confluence サーバーに認証する際に使用されるユーザー。
APIToken：現在認証されているユーザーに紐づくAPI トークン。
Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。

Basic 認証 - Confluence Server インスタンス

Server インスタンスへの認証を行うには、以下のように指定します。

AuthScheme：Basic に設定。
User：Confluence インスタンスに認証する際に使用されるユーザー。
Password：Confluence サーバーに認証する際に使われるパスワード。
Url：Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。

ヘルプドキュメント

一般的な接続文字列は次のとおりです。

User=admin;APIToken=myApiToken;Url=https://yoursitename.atlassian.net;Timezone=America/New_York;

希望するテーブルおよびビューを選択して［Finish］をクリックし、データモデルを作成します。
プロジェクトをビルドします。生成されたファイルを使ってLINQPad でConfluence 接続を作成できます。

LINQPad でConfluence のデータに接続

必要な接続プロパティを取得してデータモデルアセンブリを作成したら、以下の手順に従ってLINQPad でデータモデルを使いはじめましょう。

LINQPad を開き［接続の追加］をクリックします。
［Use a typed data context from your own assembly］オプションを選択します。
［Entity Framework DbContext］を選択します。
［Path to Custom Assembly］ボックスの横にある［参照］をクリックして、プロジェクトフォルダを参照します。bin フォルダの下の.dll または.exe を参照します。
DbContext の名前を選択します。
接続文字列をApp.Config に保存した場合は、App.Config へのパスを指定します。