【徹底解説】Wijmo Grid でSAP Ariba Source データバインド!インタラクティブWeb アプリ開発ガイド
SAP Ariba Source Connector は、SAP Ariba Source のデータ をWeb サービスとして提供し、ライブデータへの接続を可能にします。この記事では、JSONP 形式のSAP Ariba Source のデータをWijmo Grid から利用する方法を説明します。
API Server の設定
以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなSAP Ariba Source OData サービスを作成していきましょう。
SAP Ariba Source への接続
Salesforce Connect からSAP Ariba Source のデータを操作するには、まずSAP Ariba Source への接続を作成・設定します。
- API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
- 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「SAP Ariba Source」を選択します。
- 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
CData コネクタの追加方法はこちら >> - それでは、SAP Ariba Source への接続設定を行っていきましょう!
-
それでは、SAP Ariba Source に接続していきましょう。接続するには、以下のプロパティを設定します。
- API:CData 製品にSAP Ariba データを取得させたいAPI を指定してください。ビジネスロールに基づき、Supplier、Sourcing Project Management、またはContract API を選択します(可能な値は、SupplierDataAPIWithPaginationV4、SourcingProjectManagementAPIV2、または ContractAPIV1 です)
- DataCenter:アカウントのデータがホストされているデータセンター
- Realm:アクセスしたいサイト名
- Environment:テスト環境、または本番環境のいずれかを指定してください。(可能な値は、TEST またはPRODUCTION)
Supplier Data API またはContract API に接続する場合は、さらに以下のプロパティも設定してください。
- User:API 呼び出しを行うユーザーのId
- PasswordAdapter:認証するUser に関連付けられたパスワード
Supplier API に接続している場合は、ProjectId をデータを取得したいソーシングプロジェクトのId に設定してください。
OAuth 認証
続いて、接続プロパティの設定後、OAuth 認証を設定する必要があります。
- AuthScheme をOAuthClient に設定します
- サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります
OAuth アプリケーションの作成について、詳しくはヘルプドキュメントをご確認ください。
OAuth の自動リフレッシュ
以下のプロパティを設定して、接続してみましょう。
- APIKey:アプリケーション設定のApplication key
- OAuthClientId:アプリケーション設定のOAuth Client Id
- OAuthClientSecret:アプリケーション設定のOAuth Secret
接続すると、CData 製品が自動でOAuth プロセスを完了します。
- CData 製品がSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします
- CData 製品がアクセストークンの期限が切れると自動的にリフレッシュします
- OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます
- 接続情報の入力が完了したら、「保存およびテスト」をクリックします。
それでは、SAP Ariba Source に接続していきましょう。接続するには、以下のプロパティを設定します。
- API:CData 製品にSAP Ariba データを取得させたいAPI を指定してください。ビジネスロールに基づき、Supplier、Sourcing Project Management、またはContract API を選択します(可能な値は、SupplierDataAPIWithPaginationV4、SourcingProjectManagementAPIV2、または ContractAPIV1 です)
- DataCenter:アカウントのデータがホストされているデータセンター
- Realm:アクセスしたいサイト名
- Environment:テスト環境、または本番環境のいずれかを指定してください。(可能な値は、TEST またはPRODUCTION)
Supplier Data API またはContract API に接続する場合は、さらに以下のプロパティも設定してください。
- User:API 呼び出しを行うユーザーのId
- PasswordAdapter:認証するUser に関連付けられたパスワード
Supplier API に接続している場合は、ProjectId をデータを取得したいソーシングプロジェクトのId に設定してください。
OAuth 認証
続いて、接続プロパティの設定後、OAuth 認証を設定する必要があります。
- AuthScheme をOAuthClient に設定します
- サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります
OAuth アプリケーションの作成について、詳しくはヘルプドキュメントをご確認ください。
OAuth の自動リフレッシュ
以下のプロパティを設定して、接続してみましょう。
- APIKey:アプリケーション設定のApplication key
- OAuthClientId:アプリケーション設定のOAuth Client Id
- OAuthClientSecret:アプリケーション設定のOAuth Secret
接続すると、CData 製品が自動でOAuth プロセスを完了します。
- CData 製品がSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします
- CData 製品がアクセストークンの期限が切れると自動的にリフレッシュします
- OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます
API Server のユーザー設定
次に、API Server 経由でSAP Ariba Source にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。
- 「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
-
次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
-
その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。
SAP Ariba Source 用のAPI エンドポイントの作成
ユーザーを作成したら、SAP Ariba Source のデータ用のAPI エンドポイントを作成していきます。
-
まず、「API」ページに移動し、
「 テーブルを追加」をクリックします。
-
アクセスしたい接続を選択し、次へをクリックします。
-
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。
OData のエンドポイントを取得
以上でSAP Ariba Source への接続を設定してユーザーを作成し、API Server でSAP Ariba Source データのAPI を追加しました。これで、OData 形式のSAP Ariba Source データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。
API Server の設定
以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなSAP Ariba Source OData サービスを作成していきましょう。
SAP Ariba Source への接続
Salesforce Connect からSAP Ariba Source のデータを操作するには、まずSAP Ariba Source への接続を作成・設定します。
- Go to Settings and click Add Connection in the top-right.
- Select SAP Ariba Source. If it's not visible, toggle off Only Installed to view all connectors.
- Click Install Connector to auto-install. For a manual setup, choose Manual Install and upload the obtained ZIP file.
- Once installed, click SAP Ariba Source to configure connection settings.
- API:CData 製品にSAP Ariba データを取得させたいAPI を指定してください。ビジネスロールに基づき、Supplier、Sourcing Project Management、またはContract API を選択します(可能な値は、SupplierDataAPIWithPaginationV4、SourcingProjectManagementAPIV2、または ContractAPIV1 です)
- DataCenter:アカウントのデータがホストされているデータセンター
- Realm:アクセスしたいサイト名
- Environment:テスト環境、または本番環境のいずれかを指定してください。(可能な値は、TEST またはPRODUCTION)
- User:API 呼び出しを行うユーザーのId
- PasswordAdapter:認証するUser に関連付けられたパスワード
- AuthScheme をOAuthClient に設定します
- サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります
- APIKey:アプリケーション設定のApplication key
- OAuthClientId:アプリケーション設定のOAuth Client Id
- OAuthClientSecret:アプリケーション設定のOAuth Secret
- CData 製品がSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします
- CData 製品がアクセストークンの期限が切れると自動的にリフレッシュします
- OAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます
- Click Save & Test to validate and complete the connection setup.
それでは、SAP Ariba Source に接続していきましょう。接続するには、以下のプロパティを設定します。
Supplier Data API またはContract API に接続する場合は、さらに以下のプロパティも設定してください。
Supplier API に接続している場合は、ProjectId をデータを取得したいソーシングプロジェクトのId に設定してください。
OAuth 認証
続いて、接続プロパティの設定後、OAuth 認証を設定する必要があります。
OAuth アプリケーションの作成について、詳しくはヘルプドキュメントをご確認ください。
OAuth の自動リフレッシュ
以下のプロパティを設定して、接続してみましょう。
接続すると、CData 製品が自動でOAuth プロセスを完了します。
SAP Ariba Source 用のAPI エンドポイントの作成
ユーザーを作成したら、SAP Ariba Source のデータ用のAPI エンドポイントを作成していきます。
-
まず、「API」ページに移動し、
「 テーブルを追加」をクリックします。
-
アクセスしたい接続を選択し、次へをクリックします。
-
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。
OData のエンドポイントを取得
以上でSAP Ariba Source への接続を設定してユーザーを作成し、API Server でSAP Ariba Source データのAPI を追加しました。これで、OData 形式のSAP Ariba Source データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。
- 必要なWijmo、jQuery、およびKnockout ライブラリをロードします。
<script src="http://code.jquery.com/jquery-1.11.1.min.js"></script> <script src="http://code.jquery.com/ui/1.11.0/jquery-ui.min.js"></script> <script src="http://cdn.wijmo.com/themes/aristo/jquery-wijmo.css"></script> <script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20143.59.min.css"></script> <script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20143.59.min.js"></script> <script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20143.59.min.js"></script> <script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20143.59.min.js"></script> <script src="http://cdn.wijmo.com/interop/wijmo.data.ajax.3.20143.59.js"></script> <script src="http://cdn.wijmo.com/wijmo/external/knockout-2.2.0.js"></script> <script src="http://cdn.wijmo.com/amd-js/3.20143.59/knockout-3.1.0.js"></script> <script src="http://cdn.wijmo.com/interop/knockout.wijmo.3.20143.59.js"></script>
-
ViewModel を作成し、ODataView を使用して接続します。
-
データバインド:以下は、いくつかのページングボタンを備えたシンプルなテーブルです。マークアップのbody セクションに貼り付けることができます。
リアルタイムでライブSAP Ariba Source データを編集 Vendors
以下は結果のグリッドです。フィルタリング、ソート、編集、保存ができます。