Salesforce Connect で SAP 外部オブジェクトを検索(API Server)
CData API Server を使用すると、Salesforce コンソールや Salesforce1 モバイルアプリなどのクラウドベースのアプリケーションからSAP のデータにアクセスできます。この記事では、API Server と Salesforce Connect を使用して、標準の Salesforce オブジェクトと一緒に SAP 外部オブジェクトにアクセスする方法を説明します。
SAP データ連携について
CData は、SAP のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- SAP R/3、SAP NetWeaver、SAP ERP / ECC 6.0、RFC によって公開されている SAP S/4 HANA オンプレミスデータを含む、すべてのエディションの SAP にアクセスできます。
- SQL ストアドプロシージャを通じて、IDoc または IDoc XML ファイルのサーバーへの送信、関数やクエリ用のスキーマの作成などのアクションを実行できます。
-
お客様の SAP インスタンスがホストされている場所に応じて、最適に接続できます。
- SAP S/4HANA クラウドパブリックエディションをご利用のお客様は、SAP NetWeaver Gateway 接続を使用します
- SAP S/4HANA プライベートエディションをご利用のお客様は、SAP ERP または SAP NetWeaver Gateway 接続のいずれかを使用します。
多くのユーザーは、SAP データをデータベースやデータウェアハウスにレプリケートするために当社のツールを活用していますが、Tableau、Power BI、Excel などの分析ツールとライブ SAP データを統合しているお客様も多数います。
はじめに
API Server のセットアップ
まだインストールしていない場合は、CData API Server をダウンロードしてください。API Server をインストールしたら、以下の手順に従ってセキュアな SAP OData サービスの作成を開始します。
SAP への接続
Salesforce Connect からSAP のデータを操作するには、まず SAP への接続を作成・設定します。以下の手順で API Server を設定してSAP のデータに接続します。
- まず、Connections ページに移動します。
-
Add Connection をクリックし、SAP 接続を検索して選択します。
-
SAP に接続するために必要な認証プロパティを入力します。
Java 版では、SAP system にJCo JAR ファイルで接続します。Jco JAR ファイルの使い方は、ヘルプドキュメントの「はじめに」を参照してください。
Windows 版では、SAP への接続はlibrfc32.dll、librfc32u.dll、NetWeaver、Web Services (SOAP) のどれかで行います。 ConnectionType 接続プロパティをCLASSIC (librfc32.dll)、CLASSIC_UNICODE (librfc32u.dll)、NETWEAVER、SOAP に設定します。
Note: librfc32.dll やその他のSAP 接続には対応しておりません。SAP インストールから対応する接続モジュールをマシンにインストールしておいてください。
すべてのSync はSAP にSOAP Web Service 経由での接続をサポートしています。SOAP アクセスには、Client、RFCUrl、User、Password の接続プロパティを入力します。ConnectionType はSOAP に設定します。
詳細情報はobtaining the connection properties を参照してください。
- 接続を設定したら、 Save & Test をクリックして接続が成功したことを確認します。
API Server のユーザー設定
次に、API Server を通じてSAP のデータにアクセスするユーザーを作成します。Users ページでユーザーを追加・設定できます。以下の手順でユーザーを設定・作成します。
- Users ページで、 Add User をクリックして Add User ダイアログを開きます。
-
次に、Role、Username、Privileges プロパティを設定し、Add User をクリックします。
-
その後、ユーザーの Authtoken が生成されます。各ユーザーの Authtoken やその他の情報は Users ページで確認できます。
SAP 用の API エンドポイントの作成
ユーザーを作成したら、SAP テーブル用の API エンドポイントを作成します。
-
まず、API ページに移動し、 Add Table をクリックします。
-
アクセスしたい接続を選択し、Next をクリックします。
-
接続を選択した状態で、各テーブルを選択し、Confirm をクリックしてエンドポイントを作成します。
OData URL の取得
SAP のデータへの接続を設定し、ユーザーを作成し、API Server にリソースを追加したので、これらのリソース用の OData プロトコルに基づいた簡単にアクセスできる REST API が利用可能になりました。API Server の API ページから、API の API エンドポイントを表示およびコピーできます。
SAP のデータ を外部データソースとして接続
以下の手順に従って、API Server が生成するフィードに接続します。
- Salesforce にログインし、設定 -> 開発 -> 外部データソース をクリックします。
- 「新規外部データソース」をクリックします。
- 以下のプロパティの値を入力します:
- 外部データソース:リストビューやレポートで使用するラベルを入力します。
- 名前:一意の識別子を入力します。
- 種類:「Salesforce Connect: OData 4.0」オプションを選択します。
URL:API Server の OData エンドポイントへの URL を入力します。URL の形式は https://your-server:your-port/api.rsc です。
注意:プレーンテキストはテスト専用です。本番環境では TLS を使用してください。
「形式」メニューで JSON を選択します。
- 「認証」セクションで、以下のプロパティを設定します:
- ID 種類:組織のすべてのメンバーが同じ資格情報を使用して API Server にアクセスする場合は、「指定プリンシパル」を選択します。組織のメンバーが独自の資格情報で接続する場合は、「ユーザーごと」を選択します。
- 認証プロトコル:Basic 認証を使用する場合は「パスワード認証」を選択します。
- 証明書:Salesforce からサーバーへの通信を暗号化・認証するために使用する証明書を入力または参照します。
- ユーザー名:API Server のユーザー名を入力します。
- パスワード:ユーザーの Authtoken を入力します。
SAP オブジェクトの同期
外部データソースを作成したら、以下の手順に従って、データソースの変更を反映する SAP 外部オブジェクトを作成します。SAP 外部オブジェクトの定義を SAP テーブルの定義と同期します。
- 作成した外部データソースのリンクをクリックします。
- 「検証して同期」をクリックします。
- 外部オブジェクトとして操作する SAP テーブルを選択します。
SAP のデータ を Salesforce オブジェクトとしてアクセス
SAP のデータ を外部データソースとして追加し、SAP テーブルを SAP 外部オブジェクトと同期したら、標準の Salesforce オブジェクトと同様に外部オブジェクトを使用できます。
-
フィルターリストビューを持つ新しいタブを作成:
-
標準 Salesforce オブジェクトと一緒に SAP 外部オブジェクトの関連リストを表示:
トラブルシューティング
一般的な接続の問題を避けるために、以下のチェックリストを使用できます:
- サーバーにパブリックアクセス可能な IP アドレスがあることを確認してください。これに関連して、OS レイヤーで、ファイアウォールが API Server が実行されているポートを開いていることを確認する必要があります。アプリケーションレイヤーでは、管理コンソールの Settings -> Security タブで信頼できる IP アドレスを追加していることを確認してください。
- 商用の信頼できる CA からの SSL 証明書で保護された接続を使用していることを確認してください。Salesforce は現在、自己署名証明書や内部 CA を受け入れていません。
API Server をホストしているサーバーが TLS 1.1 以上を使用していることを確認してください。.NET API Server を使用している場合は、.NET API Server の組み込みサーバーを使用することで実現できます。
IIS を使用している場合、TLS 1.1 および 1.2 はサポートされていますが、デフォルトでは有効になっていません。これらのプロトコルを有効にするには、MSDN のハウツーと Microsoft 技術リファレンスを参照してください。
Java エディションを使用している場合、TLS 1.2 は Java 8 ではデフォルトで有効ですが、Java 6 または 7 では有効ではありません。これらの以前のバージョンを使用している場合は、この Oracle ハウツーを参照してください。