WebLogic のコネクションプールからSharePointに接続

CData JDBC Driver for SharePoint を使えば、標準的な手順に沿ってSharePoint のデータ をJava Web アプリケーションに統合できます。この記事では、CData JDBC Driver for SharePoint をWebLogic Server にデプロイする方法を説明します。

はじめに

---

WebLogic Server へのJDBC ドライバーのデプロイ

ドライバーをデプロイするには、ドライバーJAR をクラスパスに追加します。.lic ファイルは、JAR と同じフォルダに配置する必要があります。 これらのファイルは、インストールディレクトリのlib サブフォルダに格納されています。

すべてのドメインにドライバーを追加する場合は、WL_HOME\common\bin\commEnv.cmd/sh にあるWEBLOGIC_CLASSPATH 環境変数の先頭にJAR のパスを追加します。このスクリプトは WL_HOME\common\bin\ にあります。以下に例を示します。

set WEBLOGIC_CLASSPATH=your-installation-directory\lib\cdata.jdbc.sharepoint.jar;%WEBLOGIC_CLASSPATH%

WebLogic 12.2.1 では、特定のドメインにドライバーを追加する場合、ドライバーJAR と.lic ファイルをDOMAIN_HOME\lib（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib）に配置するだけで済みます。これらのファイルは、起動時にサーバーのクラスパスに追加されます。

以前のバージョンでは、手動でドライバーをクラスパスに追加する必要があります。setDomainEnv.cmd/sh のPRE_CLASSPATH 環境変数の先頭に、以下の内容を追加します。このスクリプトは、対象ドメインのフォルダのbin サブフォルダにあります。

set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.sharepoint.jar;%PRE_CLASSPATH%

これらの変更を行った後、サーバーを再起動します。

SharePoint 用JDBC データソースの作成

ドライバーをデプロイしたら、WebLogic 管理コンソールにログインして接続を作成します。

1. ドメイン構造ツリーで、Services -> Data Sources -> New -> Generic Data Source をクリックします。
2. JDBC Data Source Properties ページで、以下の情報を入力します。
   • Name: ユーザーフレンドリーな名前を入力します（例：sharepointjdbc）。
   • JNDI Name: JDBC データソースのバインド先のパスを入力します（例：jdbc/SharePoint）。

   • Database Type: Other を選択します。

   

3. Next をクリックしてデフォルトオプションを使用します。最後のページで、以下の情報を入力してTest Configuration をクリックします。

   • Driver Class Name: ドライバークラスを入力します（cdata.jdbc.sharepoint.SharePointDriver）。

   • URL: JDBC URL を入力します。一般的なJDBC URL は次のとおりです。

     jdbc:sharepoint:User=myuseraccount;Password=mypassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;SharePointEdition=SharePointOnPremise;

     Microsoft SharePoint への接続

     URL の設定：

     Microsoft SharePoint では、2つの範囲でデータを操作できます。グローバルなMicrosoft SharePoint サイト全体を対象にするか、個々のサイトのみを対象にするかを選択できます。

     グローバルなMicrosoft SharePoint サイトですべてのリストおよびドキュメントを操作したい場合は、URL 接続プロパティをサイトコレクションURL に設定しましょう。以下のような形式です。

     https://teams.contoso.com

     個々のサイトのリストおよびドキュメントのみを扱いたい場合は、URL 接続プロパティを個々のサイトURL に設定してください。以下のような形式です。

     https://teams.contoso.com/TeamA

     続いて、お使いの環境に適した認証プロパティを設定していきましょう。詳細な設定手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご参照ください。

     Microsoft SharePoint Online

     SharePointEdition を"SharePoint Online" に設定し、User およびPassword にはSharePoint へのログオンで使用するクレデンシャル（例：Microsoft Online Services アカウントのクレデンシャル）を設定します。

     Microsoft SharePoint Online は様々なクラウドベースアーキテクチャをサポートしており、それぞれ異なる認証スキームが利用できます。

     • Microsoft Entra ID（Azure AD）
     • ADFS、Okta、OneLogin、またはPingFederate SSO ID プロバイダーを介したシングルサインオン（SSO）
     • Azure MSI
     • Azure パスワード
     • OAuthJWT
     • SharePointOAuth

     Microsoft SharePoint オンプレミス

     Microsoft SharePoint オンプレミスでは、多くのオンプレミス環境に対応した認証方式をサポートしています。

     • Windows（NTLM）
     • Kerberos
     • ADFS
     • 匿名アクセス

     まずSharePointEdition を"SharePoint On-Premises" に設定しましょう。

     Windows（NTLM）認証

     これは最も一般的な認証方式です。そのため、CData 製品ではNTLM をデフォルトとして使用するよう事前設定されています。Windows のUser およびPassword を設定するだけで接続できます。

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

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

     java -jar cdata.jdbc.sharepoint.jar
     

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

     
   • Database User Name: JDBC URL で指定していない場合は、ユーザー名を入力します。
   • Password: JDBC URL で指定していない場合は、パスワードを入力します。
   

JDBC データソースをデプロイするサーバーを選択すると、SharePoint のデータ に接続できるようになります。

その他のWebLogic 連携

上記の手順では、シンプルなコネクションプーリングシナリオでのドライバー設定方法を説明しました。その他のユースケースや詳細については、Oracle Fusion Middleware ドキュメントのWebLogic Data Sources 章のJDBC セクションを参照してください。