こんにちは。CData Software Japanリードエンジニアの杉本です。
この記事は Web API Advent Calendar 2021 15日目です。
最近ちまちまとSAPの勉強（主にAPI・RFC周りですが）をしているのですが、Web API Advent Calendar 2021 11日目に @nanaki11 さんが、ES5で SAP Gateway のAPI Demo環境が試せるよ！ と書いているのを見て、居ても立ってもいられず、試しました！
今回はその環境構築から、Postman と CData Driver を使ったAPIアクセス方法までをざっくりお届けしたいと思います。
以下の英語記事でも詳しい手順が解説されています。
ちなみに、ES5とはなんぞやと調べてみたら、以下の記事で詳しく紹介されていました。
SAP Netweaver Gatewayとは、SAP ERPと他のシステムを接続する際のハブとなるシステムです。SAP ERPからデータを抽出するODataサービスを作るときに必要になります。 SAP ES5は、SAP Netweaver Gatewayのデモシステムであり、ES5で公開されているODataを利用してアプリ開発を試すことができます。
環境構築
とりあえず以下のURLにアクセスして、SAPアカウントでログインしましょう。
https://register.sapdevcenter.com/SUPSignForms
以下のようにUser InformationとTerms and Conditions の確認を行って、「Register」をクリックします。
登録が完了すると、数分後にメールアドレスにログインURLなどが送られてきます。
メールにはSAP NetWeaver のURLと各種ログイン情報が書かれているのでアクセスしてログインしてみましょう！
以下のようにログインできて、UIのロードが行われます。
が、なぜかいきなりエラー画面・・・！
まだ構成中なのかな？ と思ったので、一旦間を開けてアクセスしてみたところ、無事以下のようなUI画面が表示できました！
API アクセスを試してみる
環境構築が完了したら、APIアクセスを試してみましょう。
APIアクセスにはPostmanを使いました。
SAP Gateway APIはODataに準拠しているので、まずは$metadataにアクセスして利用できるリソースを確認してみます。
「/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/$metadata」でアクセスできるようですね。
GET /sap/opu/odata/IWBEP/GWSAMPLE_BASIC/$metadata HTTP/1.1 Host: sapes5.sapdevcenter.com Authorization: Basic XXXXXX
認証はBasic認証で通るので、「Authorization」タブで「Basic Auth」を選択して、ログインに利用したUsernameとPasswordを指定します。
これで「Send」をクリックすると、以下のようにMetadataが取得できました。
テーブルライクにアクセスできるEntitySetだけ抜き出してみると、以下のようなラインナップがありました。
<EntitySet Name="BusinessPartnerSet" EntityType="GWSAMPLE_BASIC.BusinessPartner" sap:content-version="1"/> <EntitySet Name="ProductSet" EntityType="GWSAMPLE_BASIC.Product" sap:content-version="1"/> <EntitySet Name="SalesOrderSet" EntityType="GWSAMPLE_BASIC.SalesOrder" sap:updatable="false" sap:content-version="1"/> <EntitySet Name="SalesOrderLineItemSet" EntityType="GWSAMPLE_BASIC.SalesOrderLineItem" sap:content-version="1"/> <EntitySet Name="ContactSet" EntityType="GWSAMPLE_BASIC.Contact" sap:content-version="1"/> <EntitySet Name="VH_SexSet" EntityType="GWSAMPLE_BASIC.VH_Sex" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_CountrySet" EntityType="GWSAMPLE_BASIC.VH_Country" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_AddressTypeSet" EntityType="GWSAMPLE_BASIC.VH_AddressType" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_CategorySet" EntityType="GWSAMPLE_BASIC.VH_Category" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_CurrencySet" EntityType="GWSAMPLE_BASIC.VH_Currency" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_UnitQuantitySet" EntityType="GWSAMPLE_BASIC.VH_UnitQuantity" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_UnitWeightSet" EntityType="GWSAMPLE_BASIC.VH_UnitWeight" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_UnitLengthSet" EntityType="GWSAMPLE_BASIC.VH_UnitLength" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_ProductTypeCodeSet" EntityType="GWSAMPLE_BASIC.VH_ProductTypeCode" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_BPRoleSet" EntityType="GWSAMPLE_BASIC.VH_BPRole" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/> <EntitySet Name="VH_LanguageSet" EntityType="GWSAMPLE_BASIC.VH_Language" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:pageable="false" sap:content-version="1"/>
一覧の「SalesOrderSet」を試してみましょう。
「/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/SalesOrderSet」にGETリクエストを送ります。
レスポンスはJSONでほしいので「Accept: application/json」を指定しました。
GET /sap/opu/odata/IWBEP/GWSAMPLE_BASIC/SalesOrderSet HTTP/1.1 Host: sapes5.sapdevcenter.com Accept: application/json Authorization: Basic XXXXX
以下のように無事取得できました！
ただ、デフォルトはデータが多いので「$top=10」などの取得条件を付与したほうがいいですね。
CData SAP Netweaver Gateway から接続してみる
せっかくなので、CData で提供している「SAP Netweaver Gateway」Driverからも接続してみました。
今回はODBCを利用しますが、特にテクノロジーは問いません。以下のURLからトライアルがダウンロードできます。
インストール完了後、以下のような接続設定画面が立ち上がるので必要な情報を入力します。
| プロパティ名 | 値 | 備考 |
|---|---|---|
| Auth Scheme | Basic | |
| URL | 例）https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/ | APIエンドポイントを指定します。 |
| User | 例）P1234567890 | |
| Password | 例）YOUR_USER_PASSWORD |
入力後「接続のテスト」をクリックして、以下のメッセージが表示されればOKです。
これだけだと物足りないので、Microsoft の BIツール、Power BIからも接続してみます。
Power BI Desktopを立ち上げて「データを取得」からODBCを選択し
先程接続設定を行った「CData SAPGateway Source」を選択します。
認証方法は先程設定しているので「Windows」タブの「現在の資格情報を使用する」を選択して接続してください。
あとは、ODataのリソースがテーブル一覧として表示されるので、好きなテーブルを選択すればPower BI にデータを読み込むことができます。
おわりに
SAP はなかなか検証環境を手に入れるのが難しいですが、これはいいですね！
