TIBCO Data Virtualization で SAP Ariba Procurement のデータ にリアルタイムアクセスする方法

CData TIBCO DV Adapter for SAP Ariba Procurement を使って、TIBCO Data Virtualization Studio でSAP Ariba Procurement のデータソースを作成し、TDV Server からSAP Ariba Procurement のデータにリアルタイムでアクセスする方法を解説します。

TIBCO Data Virtualization（TDV）は、複数の多様なデータソースへのアクセスを一元管理するエンタープライズデータ仮想化ソリューションです。CData TIBCO DV Adapter for SAP Ariba Procurement と組み合わせることで、TIBCO Data Virtualization 内からSAP Ariba Procurement のデータに直接フェデレーテッドアクセスが可能になります。この記事では、アダプターのデプロイと SAP Ariba Procurement に基づく新しいデータソースの作成手順を解説します。

CData TIBCO DV Adapter は、最適化されたデータ処理機能が組み込まれており、SAP Ariba Procurement のデータ とのインタラクションにおいて比類のないパフォーマンスを発揮します。SAP Ariba Procurement に対して複雑な SQL クエリを発行すると、アダプターはフィルタや集計などサポートされている SQL 操作を直接 SAP Ariba Procurement にプッシュします。組み込みの動的メタデータクエリにより、ネイティブのデータ型を使用してSAP Ariba Procurement のデータを操作・分析できます。

SAP Ariba Procurement TIBCO DV Adapter のデプロイ

  1. コンソールで、TDV Server のインストールディレクトリ内の bin フォルダに移動します。現在のバージョンのアダプターがインストールされている場合は、先にアンデプロイする必要があります。

    .\server_util.bat -server localhost -user admin -password ******** -undeploy -version 1 -name SAPAribaProcurement

  2. CData TIBCO DV Adapter をローカルフォルダに解凍し、解凍した場所から JAR ファイル（tdv.saparibaprocurement.jar）をサーバーにデプロイします。

    .\server_util.bat -server localhost -user admin -password ******** -deploy -package /PATH/TO/tdv.saparibaprocurement.jar

新しい JAR ファイルが正しくロードされるように、サーバーの再起動が必要な場合があります。再起動は、C:\Program Files\TIBCO\TDV Server <version>\bin にある composite.bat スクリプトを実行して行えます。サーバーを再起動した後は、TDV Studio への再認証が必要です。

再起動コマンドの例

.\composite.bat monitor restart

OAuth を使用して SAP Ariba Procurement で認証する

SAP Ariba Procurement は OAuth プロトコルを使用して認証を行いますが、TDV Studio は内部でブラウザベースの認証をサポートしていないため、OAuth トークンを取得するための簡単な Java アプリケーションを作成して実行する必要があります。取得したトークンは、アダプターから直接 SAP Ariba Procurement に接続するために使用されます。

Create the Java Application

  1. Create a new Java file with preferred name for example GenOAuthSettings.java. This Java file leverages the SAPAribaProcurementOAuth class contained within the TDV Adapter JAR to initiate a test connection and perform the required OAuth authentication flow
  2. Copy and insert the following code into the .java file:
    3. 
public class GenOAuthSettings {
    public static void main(String[] args) {
        try {
    	    if (args.length != 2) {
    			throw new Exception("Input must have two arguments: 'data source', 'connection string'");
    		}
    
    		String source = args[0].replace(" ", "").toLowerCase();
    		String connectionString = args[1];
    		String prefix;
    
    		if (source.equals("saparibaprocurement")) {
    			prefix = "jdbc:saparibaprocurement:";
    
    			com.cdata.cis.saparibaprocurement.SAPAribaProcurementOAuth oauth = new com.cdata.cis.saparibaprocurement.SAPAribaProcurementOAuth();
    
    			if (!connectionString.startsWith(prefix)) connectionString = prefix + connectionString;
    			oauth.generateOAuthSettingsFile(connectionString);
    		}
    		// More sources can be added below using the same format.  You must add the import statement and ensure the jar file resides in the classpath
			//            else if (source.equals("googlebigquery") || source.equals("bigquery")) {
			//                prefix = "jdbc:googlebigquery:";
			//
			//                com.cdata.cis.googlebigquery.GoogleBigQueryOAuth oauth = new com.cdata.cis.googlebigquery.GoogleBigQueryOAuth();
			//
			//                if (!connectionString.startsWith(prefix)) connectionString = prefix + connectionString;
			//                oauth.generateOAuthSettingsFile(connectionString);
			//            }
    		else {
				throw new Exception("Data Source not supported.  Available Data Sources: SAP Ariba Procurement");
			}
			
			System.out.println("Test Connection Successful!");
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}
  3. Place the .java file in the same directory as the tdv.saparibaprocurement.jar file. This is required to prevent classpath resolution errors during compilation and execution

Build and run the Java Application

  1. Open Console and navigate to the directory containing the .java file and adapter jar
  2. Compile the Java file using the following command:
    3. javac -cp .;tdv.saparibaprocurement.jar GenOAuthSettings.java
  3. Execute the application using one of the following commands:
    4. java -cp .;tdv.saparibaprocurement.jar GenOAuthSettings "SAPAribaProcurement" "connection string"

This command initiates the OAuth authentication flow and generates the OAuth settings file at the location specified in the OAuthSettingsLocation parameter. Once you deploy the adapter and authenticate, you can create a new data source for SAP Ariba Procurement in TDV Studio.

TDV Studio で SAP Ariba Procurement データソースを作成する

CData TIBCO DV Adapter for SAP Ariba Procurement を使用すると、SAP Ariba Procurement 用のデータソースを簡単に作成し、データソースをイントロスペクトしてリソースを TDV に追加できます。

データソースの作成

  1. データソースを追加するフォルダを右クリックし、New -> New Data Source を選択します。
  2. アダプター（例：SAP Ariba Procurement）が表示されるまでスクロールし、Next をクリックします。
  3. データソースに名前を付けます（例：CData SAP Ariba Procurement Source）。

  4. 必要な接続プロパティを入力します。

    それでは、SAP Ariba Procurement に接続していきましょう。接続するには、以下のプロパティを設定します。

    • ANID：Ariba Network ID
    • API：CData 製品にSAP Ariba データを取得させたいAPI を指定してください。ビジネスロールに基づき、Buyer またはSupplier API を選択します（可能な値は、PurchaseOrdersBuyerAPIV1、または PurchaseOrdersSupplierAPIV1 です）
    • Environment：接続先がテスト環境か本番環境かを指定してください（可能な値は、TEST またはPRODUCTION です）

    OAuth 認証

    続いて、接続プロパティを設定した後、認証のためにOAuth 接続を設定する必要があります。

    • AuthScheme をOAuthClient に設定します
    • サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります

    OAuth アプリケーションの作成について、詳しくはヘルプドキュメントをご確認ください。

    OAuth の自動リフレッシュ

    以下のプロパティを設定して、接続してみましょう。

    • APIKey：アプリケーション設定のApplication key
    • OAuthClientId：アプリケーション設定のOAuth Client Id
    • OAuthClientSecret：アプリケーション設定のOAuth Secret

    接続すると、CData 製品が自動でOAuth プロセスを完了します。

    1. CData 製品がSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします
    2. CData 製品がアクセストークンの期限が切れると自動的にリフレッシュします
    3. OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます

    NOTE：DV Adapter の OAuthSettingsLocation プロパティには、OAuth 認証（上記参照）を実行したときと同じ値を設定してください。

  5. Create & Close をクリックします。

データソースのイントロスペクト

データソースを作成したら、右クリックして Open を選択することでデータソースをイントロスペクトできます。ダッシュボードで Add/Remove Resources をクリックし、データソースの一部として含めるテーブル、ビュー、ストアドプロシージャを選択します。Next をクリックし、Finish をクリックして、選択した SAP Ariba Procurement のテーブル、ビュー、ストアドプロシージャをリソースとして追加します。

After creating and introspecting the data source, you are ready to work with SAP Ariba Procurement のデータ in TIBCO Data Virtualization just like you would any other relational data source. You can create views, query using SQL, publish the data source, and more.

データソースを作成してイントロスペクトしたら、他のリレーショナルデータソースと同様に TIBCO Data Virtualization でSAP Ariba Procurement のデータを操作できるようになります。ビューの作成、SQL によるクエリ、データソースの公開など、さまざまな操作が可能です。

はじめる準備はできましたか？

詳細：

TIBCO DV アダプタ

この記事の内容

関連記事