CData JDBC Driver を使用して SAP SuccessFactors を IBM WebSphere に接続

IBM WebSphere は、多くのエンタープライズレベルの Java アプリケーションやサービスを実行する強力なアプリケーションサーバーです。CData JDBC Driver for SAP SuccessFactors と組み合わせることで、IBM WebSphere アプリケーションは複雑な API を使用せずに、標準 SQL クエリで SAP SuccessFactors に接続し、データを操作できます。これにより、連携作業の簡素化、開発工数の削減、重要なビジネスデータへの安全なリアルタイムアクセスが可能になります。

前提条件

1. SAP SuccessFactors アカウントへのアクセス（API 権限付き）
2. IBM WebSphere Application Server（構成済みで実行中）
3. CData JDBC Driver for SAP SuccessFactors
4. デプロイ用の Java Servlet WAR アプリケーション

Note: この記事では Salesforce をデモ用のデータソースとして使用していますが、同じ手順で CData が提供する 250 種類以上の JDBC Driver に接続できます。

はじめに

ステップ1：CData JDBC Driver for SAP SuccessFactors のダウンロードとインストール

CData JDBC Driver for SAP SuccessFactors をダウンロードしてインストールします。インストールすると .jar ファイルが提供されます：cdata.jdbc.sapsuccessfactors.jar

ステップ2：IBM WebSphere のインストールと構成

1. IBM 公式サイトから IBM WebSphere のアカウントを作成します。
2. IBM WebSphere Application Server のドキュメントを参照して、ローカルシステムに IBM WebSphere Application Server をインストール・構成します。
3. アプリケーションサーバーのインストールが完了したら、ブラウザで管理コンソールを使用して WebSphere Server を起動します：https://your-server:9043/ibm/console

ステップ3：SAP SuccessFactors 用の JDBC プロバイダーとデータソースの設定

1. Resources に移動し、JDBC セクションを展開して、JDBC providers を選択して新しいプロバイダーを作成します

2. ドロップダウンメニューから適切なスコープを選択します

3. New をクリックして JDBC プロバイダーを追加します
• データベースタイプとして User defined を選択します
• implementation class name として cdata.jdbc.sapsuccessfactors.SAPSuccessFactorsConnectionPoolDataSource を入力します
• プロバイダーの名前を入力します（例：User defined JDBC Provider）
• classpath フィールドに JDBC ドライバー JAR ファイルのフルパスを入力します
• Next をクリックし、Finish をクリックして、マスター構成に変更を保存します

4. JDBC プロバイダーが作成されたら、JDBC データソースを追加します。
• Data Source Name や JNDI name などの基本情報を入力します
• 先ほど作成した JDBC provider を選択します（例：CData SAP SuccessFactors Provider）
• Implementation class name を指定します：cdata.jdbc.sapsuccessfactors.SAPSuccessFactorsConnectionPoolDataSource
• Data Store Helper Class Name を追加します：com.ibm.websphere.rsadapter.GenericDataStoreHelper
• 必要に応じて authentication aliases を設定してセキュリティを構成します
• Summary ページですべての詳細を確認し、Finish をクリックしてデータソースの作成を完了します

5. 一覧から新しく作成したデータソースを選択し、Custom properties を開きます
6. URL プロパティに JDBC 接続文字列を追加し、OK を押します。例：

   jdbc:sapsuccessfactors:RTK=5246...;User=username;Password=password;CompanyId=CompanyId;Url=https://api4.successfactors.com;

   SAP SuccessFactorsへの接続

   それでは、SAP SuccessFactors に接続していきましょう。CData 製品は、デフォルトで有効になっているOData API を介してSAP SuccessFactors と通信します。追加の権限が必要な場合は、SAP サポートサイトをご確認ください。

   認証方法として、Azure AD 認証、SAP IAS 認証、OAuth 認証（推奨）、Basic 認証（非推奨）のいずれかを使用してSAP SuccessFactors に認証できます。

   必要な接続プロパティ

   選択したAuthScheme に関わらず、SAP SuccessFactors 環境を識別するために以下の接続プロパティを設定しましょう。

   • URL：SuccessFactors をホストするサーバーのURL
   • CompanyId：SAP SuccessFactors テナントに割り当てられた一意の識別子。この値はAPI 認証に必要で、組織固有のものです

   OAuth 認証

   SAP SuccessFactors では、OAuth 認証を2種類のグラント種別でサポートしています。

   • SAP SuccessFactors LMS インスタンスのクライアントグラント種別
   • SAML-2 Bearer グラント種別

   OAuth 認証を有効にするには、すべてのOAuth フローでカスタムOAuth アプリケーションを作成し、適切なプロパティを設定する必要があります。

   デスクトップアプリケーションでカスタムOAuth アプリケーションの資格情報を使用して認証するには、OAuth アクセストークンを取得し、更新する必要があります。これらを設定すると、接続の準備が整います。

   OAuth アクセストークンの取得およびリフレッシュ

   以下のプロパティを設定してください。

   • InitiateOAuth：GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します
   • OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId
   • CallbackURL：カスタムOAuth アプリケーションの登録時に定義されたリダイレクトURI
   • OAuthClientSecret （クライアントグラント種別のみ）：アプリケーションの登録時に割り当てられたクライアントシークレット
   • PrivateKey （SAML-2 Bearer グラント種別のみ）：カスタムOAuth アプリケーションの作成時にダウンロードした秘密鍵証明書のパス、またはその証明書のbase64 でエンコードされた内容

   接続すると、CData 製品がデフォルトブラウザでSAP SuccessFactors のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えてください。

   アプリケーションにアクセス許可を与えると、CData 製品がOAuth プロセスを完了します。

   1. CData 製品がSAP SuccessFactors からアクセストークンを取得し、それを使ってデータをリクエストします
   2. OAuth 値はOAuthSettingsLocation で指定されたパスに保存されます。これらの値は接続間で永続化されます

   アクセストークンの期限が切れた際は、CData 製品が自動でアクセストークンをリフレッシュします。

   カスタムOAuth アプリケーションの作成やその他の認証方法については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご確認ください。

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

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

         java -jar cdata.jdbc.sapsuccessfactors.jar
         

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

   

   Note: URL プロパティが利用できない場合は、作成してから JDBC 接続文字列を追加してください。

   Tip: URL プロパティに入力する前に、必ずドライバーで接続文字列をテストしてください。
7. データソースを開き、Test Connection を選択します

ステップ4：Web アプリケーションのビルド

1. お好みの Java フレームワーク（Servlet、JSP、Spring）を使用して Web アプリケーションをビルドします。生成される .war ファイルは通常、次のような構造になります：

		SAP SuccessFactorsServletApp.war
		|--webcontent
		|  |--index.jsp                 -- JSP ページ（エントリーポイント）
		|  |
		|  |--WEB-INF/                  -- ブラウザから直接アクセス不可
		|     |--web.xml                 -- デプロイメント記述子
		|     |
		|     |--classes/                  -- コンパイル済み .class ファイル
		|       |--com/example/SAP SuccessFactors/
		|          |--SAP SuccessFactorsServlet.class
		|
		|--lib/                      -- 依存 JAR ファイル
		|--cdata.jdbc.sapsuccessfactors.jar
	

2. JDBC または JPA を使用してデータアクセスロジックを定義し、JNDI 名でデータソースを参照します
3. この記事では、JDBC 接続の設定と Java Servlet アプリケーションのデプロイについて説明します
4. プロジェクトを WAR（Web Application Archive）または EAR（Enterprise Archive）ファイルとしてパッケージ化してデプロイします
• ターミナルで以下のコマンドを使用して Java ファイルをコンパイルします：

  			cd webcontent
  			jar cvf ..\SAP SuccessFactorsServletApp.war *
  		

ステップ5：WebSphere に SAP SuccessFactors アプリケーションをデプロイ

1. WebSphere 管理コンソールで Applications に移動し、Install New Application を選択します
2. WAR ファイルを参照してアップロードし、インストールウィザードを進めます。

ステップ6：WebSphere から SAP SuccessFactors のデータ を取得

1. コンテキストルートを使用してアプリケーションにアクセスします：http://hostname:port/context-root/page
Note: ブラウザで開く前に、デプロイしたアプリケーションが起動していることを確認してください。

これでソースから取得したデータを表示できるようになりました。データは IBM WebSphere を通じて直接アクセスできます。このセットアップは、Servlet を WebSphere にデプロイして JDBC ドライバーを使用して SAP SuccessFactors データを取得する方法を示しており、SAP SuccessFactors を活用した高度なエンタープライズアプリケーションを構築するための強固な基盤となります。

SAP SuccessFactors から IBM WebSphere への接続を始めましょう

CData JDBC Connector を使用して、今すぐ SAP SuccessFactors から IBM WebSphere への接続を始めましょう。30日間の無料トライアルをダウンロードして、アプリケーションへの安全でリアルタイムなデータアクセスがいかに簡単に実現できるかをお試しください。ご不明な点がございましたら、サポートチームがいつでもお手伝いします。