IntelliJ で Outlook のデータ に接続

CData JDBC Driver for Outlook を使用すると、Outlook を JDBC データソースとしてアクセスでき、IDE の迅速な開発ツールとの連携が可能になります。この記事では、データソース設定ウィザードを使用して IntelliJ で Outlook のデータ に接続する方法を説明します。

Outlook 用の JDBC データソースを作成

以下の手順で、ドライバー JAR を追加し、Outlook のデータ への接続に必要な接続プロパティを定義します。

1. Data Sources ウィンドウで右クリックし、Add Data Source -> DB Data Source をクリックします。

2. 表示される Data Source Properties ダイアログで、以下のプロパティを設定します。

   • JDBC Driver Files: このメニューの横にあるボタンをクリックし、インストールディレクトリにある JDBC Driver ファイル cdata.jdbc.api.jar を追加します。
   • JDBC Driver Class: このメニューで、リストから cdata.jdbc.api.APIDriver を選択します。

   • Database URL: JDBC URL プロパティに接続 URL を入力します。URL は jdbc:api: で始まり、セミコロンで区切られた接続プロパティを含みます。

     OAuth 認証の設定

     Microsoft Graph API は認証に OAuth 2.0 を使用します。OAuth 認証情報（Client ID と Client Secret）を取得するには、Microsoft Azure Portal でアプリケーションを登録する必要があります。

     OAuth 認証情報の取得

     1. Azure Portal にログインします。
     2. Azure Active Directory > App registrations に移動します。
     3. New registration をクリックして新しいアプリケーションを作成します。
     4. アプリケーション名を入力し、適切なアカウントの種類を選択します。
     5. Redirect URI をアプリケーションのコールバック URL に設定します（デスクトップアプリの場合は http://localhost:33333 など）。
     6. Register をクリックしてアプリケーションを作成します。
     7. アプリケーションの概要ページで Application (client) ID をコピーします。これが OAuthClientId になります。
     8. Certificates & secrets に移動して、新しいクライアントシークレットを作成します。
     9. クライアントシークレットの値をコピーします。これが OAuthClientSecret になります。
     10. API permissions に移動して、必要な Microsoft Graph API の権限を追加します：
         • Mail.Read - メールメッセージへのアクセス用
         • Contacts.Read - 連絡先へのアクセス用
         • Calendars.Read - カレンダーイベントへのアクセス用
         • Tasks.Read - To Do タスクへのアクセス用
         • offline_access - リフレッシュトークンの取得用
     11. Grant admin consent をクリックして、これらの権限を付与します。

     OAuth での接続

     以下の接続プロパティを設定して接続を確立してください：

     • AuthScheme：OAuth に設定します。
     • InitiateOAuth：GETANDREFRESH に設定します。CData API Profile for Outlook が OAuth プロセスを自動的に進め、アクセストークンを取得します。
     • OAuthClientId：Azure Portal の Application (client) ID に設定します。
     • OAuthClientSecret：Azure Portal のクライアントシークレットの値に設定します。
     • TenantId：Azure AD のテナント識別子（GUID または 'contoso.onmicrosoft.com' のようなドメイン名）に設定します。
     • CallbackURL：アプリ登録で指定したリダイレクト URI に設定します（デスクトップアプリの場合は http://localhost:33333 など）。

     接続文字列の例

     Profile=C:\profiles\Outlook.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;TenantId=your_tenant_id;CallbackUrl=http://localhost:33333;
     

     組み込みの接続文字列デザイナー

     JDBC URL の作成には、Outlook JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

     java -jar cdata.jdbc.api.jar
     

     接続プロパティに値を入力して、接続文字列をクリップボードにコピーします。

     

     一般的な JDBC URL は以下のとおりです。

     jdbc:api:Profile=C:\profiles\Outlook.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;TenantId=your_tenant_id;CallbackUrl=http://localhost:33333;

Outlook のデータ の編集と保存

スキーマ情報を取得するには、作成したデータソースを右クリックして Refresh Tables をクリックします。テーブルをクエリするには、テーブルを右クリックして Open Tables Editor をクリックします。