OData 接続の設定

Objective

After completing this lesson, you will be able to oData 接続を設定します。

受信 OData サービス接続設定

このレッスンでは、受信 OData サービス接続の設定について説明します。OData とそのアプリケーションを理解することは、異なるシステム間のシームレスな統合を作成するために不可欠です。

OData サービスの SAP BTP 宛先設定 (航空会社の一覧を示す結果の JSON 応答を指す矢印あり)。

OData の概要

OData (Open Data Protocol) は、RESTful API を構築および使用するための標準化されたプロトコルです。これにより、標準操作セットによるさまざまなデータソースに対するクエリおよび更新の登録および利用が可能になります。

OData サービス接続の設定ステップ

SAP Business Technology Platform (BTP) を使用して OData サービス接続を設定するステップを見ていきましょう。

SAP BTP サブアカウントへのアクセス

環境を管理する SAP BTP サブアカウントにナビゲートします。

宛先メンバーの作成

宛先タイプ: OData サービス名選択

URL: OData サービスの URL を入力します。例: https://services.data.org.ounble

プロキシタイプ: インターネット名選択

認証: 認証を必要としないサービス (オープンで無償の services.data.org など) の場合は、認証なしを設定します。ただし、パートナやその他のクラウドシステムへの実際の接続の大部分では、OAuth、Basic 認証、API キーなど、何らかの形式の認証が必要です。

接続の保存とテスト

接続設定を保存し、正しく設定され、アクセス可能であることを確認します。

実用的な洞察:ビジネスの例

外部プロバイダからのシップメントトラッキングデータを統合する必要があるロジスティクス会社で働いているとします。

統合: OData を使用してシップメントプロバイダの API に接続し、シップメントステータスを取得し、内部追跡システムを更新します。

安全なアクセス: OAuth 認証を実装して、サードパーティデータへの安全なアクセスを確保します。

接続のテスト

このレッスンでは、OData サービス接続の初期設定に基づいて、接続が適切にテストされ、ユニバーサルモデルに統合されていることを確認するための最終ステップについて説明します。

正常終了した SAP BTP 宛先接続チェックと、その宛先を使用した OData サービス接続の後続設定を示す複合イメージ。

接続チェック実行

接続チェック機能 (スノーフレークなどのアイコンで表されることが多い) をインタフェースで使用します。

このテストでは、設定したパラメータが正しいかどうか、および OData サービスへの接続を正常に確立できるかどうかを確認します。

OData 接続のユニバーサルモデルへの統合

接続のチェック後、次のステップは接続を Universal Model に統合することです。

ユニバーサルモデル設定セクションにナビゲートします。

新しい接続を作成し、接続タイプとして OData を選択します。

サービスパスの設定

OData サービス設定から取得したサービスパスを入力します。このサービスパスにより、接続する OData サービス内の特定のデータセットに移動します。

例: 航空会社データを統合する場合、サービスパスは次のようになります: https://services.data.org/airlines.ounble

フィルタおよびキー項目設定

データのフィルタ: フィルタを適用して、データの特定のサブセットに焦点を当てます。たとえば、データセットをフィルタリングして、特定の航空会社に関連するレコードのみを含めることができます。

デフォルトキー項目: データセット内のレコードを一意に識別するキー項目を設定します。このキー項目により、各レコードに個別にアクセスして管理することができます。

例: UUID (Universal Unique Identifier) を各レコードを一意に識別するためのデフォルトキー項目として使用します。

Reader 関数の概要

OData 接続を確立した後の重要なステップは、Reader 関数を使用してこの接続からデータを取得することです。Reader 関数を使用すると、OData 接続によって適用されるモデルエンティティからデータを直接読み込むことができます。

保存前に項目マッピングおよび一般情報タブの詳細を示す、SAP の 'READODATA' 機能の設定を示す複合イメージ。

リーダ関数の概要

Reader 関数は、モデルエンティティからデータを抽出できる重要な機能です。この機能を設定することで、確立された OData 接続からデータをシームレスにクエリして取得することができます。

Reader 関数を設定するステップ

Reader 関数を設定して使用し、OData 接続からデータを読み込むプロセスを見ていきましょう。

基本項目の入力

環境名: 作業する環境の名前を指定します。

関数名: Reader 関数に意味のある名前を割り当てて、その目的を識別しやすくします。

関数タイプ: 関数タイプとしてリーダを選択します。

Reader 関数の設定

リーダタイプ選択: タイプ項目をクリックし、リーダを選択します。

接続名の指定: 以前に確立した OData 接続の名前を入力します。これにより、Reader 関数で正しいソースからデータが取得されるようになります。

入力モデルエンティティ: 読み込み元のデータ構造を表すモデルエンティティを定義します。データのソースエンティティとして機能します。

読込項目の選択

取得するモデルエンティティ内の特定のフィールドを選択します。データ要件に基づいて複数のフィールドを選択できます。

例: 接続が顧客データベースにリンクされている場合は、CustomerID、CustomerName、E-mail、OrderHistory などのフィールドを選択できます。

環境機能の有効化

リーダ機能の設定後、環境を有効化して、すべての設定が正しく適用されていることを確認します。

データの表示

モデルエンティティ内の機能画面にナビゲートします。

モデルエンティティおよび設定された Reader 関数を選択します。

データの表示をクリックして、OData 接続から取得されたデータを表示します。

リーダ機能を使用してデータを取得すると、ODATA 接続で選択された 3 つの航空会社が表示されます。最後に、データをリーダ関数またはモデルエンティティ関数に表示することができます。これは、ODATA インテグレーションのステップを段階的に説明したものです。

OData サービスからのロー JSON 応答と、SAP アプリケーション内の同じ航空会社データの対応するテーブル表示を示す比較。

送信 OData 接続設定

送信 OData 接続により、OData サービスにデータを書き戻すことができます。これは、システム間で双方向にデータを更新または共有する必要があるシナリオで重要です。

設定画面と書き込まれる値のデータテーブルを示す、SAP OData ライタ設定の図。

送信 OData 接続の設定

送信 OData 接続を設定し、OData サービスにデータを書き戻すために必要なコンポーネントを設定するには、以下の手順に従います。

ユーザの書込をサポートする OData サービスを選択

に接続している OData サービスでデータ書込操作が許可されていることを確認します。たとえば、航空会社 OData サービスでは、データの戻入がサポートされています。

新しいモデルエンティティ名の登録

モデルエンティティの作成: 最初に、SAP 環境内に新しいモデルエンティティを作成します。このモデルエンティティには、OData サービスにライトバックするデータが格納されます。

例: 航空会社データを書き戻す場合、モデルエンティティに FlightID、PassengerName、DepartureTime、Status などのフィールドが含まれる場合があります。

ライタ関数の設定

必須情報の入力: OData サービスへのデータ書込を可能にするために必要な詳細をライタ機能に設定します。

環境名: 作業している環境の名前を入力します。

機能名: ライタ機能の説明的な名称を選択します。

機能タイプ: 機能タイプとしてライタを選択します。

OData 接続の指定: 確立した送信 OData 接続の名前を入力します。

入力モデルエンティティ: 新たに作成したモデルエンティティをライトバックするデータソースとして定義します。

書込対象項目のマッピング: OData サービスに書き込むモデルエンティティの項目を識別し、マッピングします。

モデルエンティティを保存して有効化する

ライタ機能の設定後、設定を保存し、モデルエンティティを有効化して変更を適用します。

ライタ関数の実行

モデルエンティティ内の機能画面にナビゲートします。

設定したライタ機能を選択し、それを実行して OData サービスにデータを書き込みます。

ODATA フォームに示されているように、新しいデータが挿入されたことがわかります。

ライタでは、ODATA の一部のデータを削除または更新できない挿入ライタのみを使用できます。

OData サービスに挿入される SAP テーブルのデータ、および新しく追加された航空会社レコードによる結果の JSON 応答を示す比較。