SAP OData ​

Microsoftは、インターネット経由でのデータ交換を容易にするためにOpen Data Protocol（OData）を提供しています。 この仕様は、International Organization for Standardization（ISO）とInternational Electrotechnical Commission（IEC）の両方によって承認されており、HTTPプロトコルに依存するREST（Representational State Transfer）アーキテクチャに準拠しています。 SAPはODataサポートをSAP NetWeaver Gatewayに統合しています。 SAP NetWeaverには、ODataサービスを設計、実装、デプロイ、テストするためのツールが含まれています。 SAP ODataコネクターを使用して、オンプレミスSAP（SAP BWおよびSAP BW/4HANAを含むSAP Business Suiteアプリケーション）、SAP S/4HANA Cloud, Private Edition、およびSAP S/4HANA Cloud, Public Editionインスタンスに接続できます。 このコネクターを使用すると、数百ものOData APIをすぐに利用でき、発注書、購買依頼、請求書、製品などのデータソースを操作できます。 このコネクターは、インスタンスに設定できる利用可能なすべてのカスタムODataサービスにも対応しています。

APIバージョン ​

このコネクターの標準アクションは、V2およびV4仕様を使用するSAP API Business HubファミリーのOData APIとカスタムODataサービスをサポートしています。 SAP ODataコネクターは、システム間の通信を保護するために、さまざまな認証タイプをサポートしています。

トリガーとアクション ​

このコネクターは、次のトリガーとアクションをサポートしています:

• 新規オブジェクト
• 更新されたオブジェクト
• オブジェクトの作成
• オブジェクトの更新
• オブジェクトの検索
• オブジェクトの削除
• オブジェクトのアップサート
• IDによるオブジェクトの詳細取得
• カスタムアクション
• 一括データの抽出
• バッチリクエスト

サポートされるオブジェクトタイプ ​

利用可能なオブジェクトタイプは、選択したサービスによって異なります。 アクションまたはトリガー設定で指定したサービスによって、Objectドロップダウンに表示されるオブジェクトが決まります。

たとえば、Service入力フィールドでAPI_PRODUCT_SRVサービスを指定すると、そのサービスに定義されているすべてのオブジェクトタイプを選択できます。

特定のオブジェクトを選択すると、そのオブジェクト固有の入力フィールドがさらに表示されます。 その後、これらのオブジェクトへのデータピルのマッピングを開始できます。

関連レコードの操作 ​

SAP ODataサービスでレコードを取得または変更する場合、そのレコードと関連するレコードの両方を操作したいことがあります。 たとえば、顧客レコードとその関連住所です。 これを行うには、すべてのアクションに存在するrelated records入力フィールドを使用できます。 この入力フィールドは、関連する子レコードや孫レコードまで選択できる複数選択ツリーのドロップダウンです。

この入力を選択すると、新しい入力フィールド（作成/更新アクション用）と新しい出力フィールド（トリガー、検索、取得アクション用）が表示されます。 これにより、ジョブ実行時間を最小限に抑え、レシピの複雑さを軽減できます。

カタログサービスの有効化 ​

Workatoでは、アクションの作成時にドロップダウンメニューからODataサービスを選択するか、サービス名を手動で入力するかをユーザーが選択できます。

ODataカタログサービス

Workatoでこの機能を有効化する際は、次の点を考慮してください:

• OAuth2.0認証を通じてオンプレミスSAP Business Suiteアプリケーションでこの機能を有効にするには、OData v2の場合はスコープ/IWFND/SG_MED_CATALOG_0002、OData v4の場合は/IWFND/OV4:CONFIGを、WorkatoコネクションフィールドScopesに追加で（カンマ区切りで）追加し、OAuth2.0 Client IDにスコープをプロビジョニングする際にトランザクションコードSOAUTH2にも追加します。
• SAP S/4HANA Cloudでこの機能を有効にするには、通信ユーザーに通信シナリオを割り当てSAP_COM_0449ます。

追加機能 ​

SAP ODataは、次の機能に対する追加サポートを提供します:

• 選択したエンティティに対するCreate、Update、Delete、Get、Query、およびReplace操作。
• 次のクエリオプション: $expand（ナビゲーションプロパティを選択）、$select （レスポンス内の必要なフィールドを選択）、$filter、$orderby、$top、および$skip。
• ODataエンドポイントの利用。
• ページネーション。
• OAuth Authorization Code Grant、OAuth 2.0 SAML Bearer Assertion、Client Certificate-Based、およびBasic Authenticationを使用して保護されたOData API。
• オンプレミスエージェントを使用して、企業ファイアウォールの背後にあるものを含む任意のオンプレミスSAPアプリケーションに接続する機能。