Anypoint Studio を使用した SAP S/4HANA OData Connector 2.7 の設定 - Mule 4

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​「SAP S/4HANA OData Connector リファレンス」​を参照してください。

Mule プロジェクトを作成する

Anypoint Studio で、コネクタを追加して設定する新しい Mule プロジェクトを作成します。

  1. Studio のメインメニューから、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

SAP S/4HANA OData 用 Anypoint Connector を Mule プロジェクトに追加して、プロジェクトの XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​pom.xml​ ファイルに必須の連動関係を追加します。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ で、検索項目に「​sap s/4hana odata​」と入力します。

  3. [Available modules (使用可能なモジュール)]​ で、そのコネクタ名をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。コネクタの操作をパレットから Anypoint Studio キャンバスにドラッグすると、XML コードにコネクタの名前空間とスキーマの場所が自動的に入力されます。

このコネクタで使用できるソース操作は次のとおりです。

  • HTTP リスナー
    ブラウザーまたは ​curl​ などのコマンドを使用してアプリケーションを開始します。

  • スケジューラー
    指定された間隔でアプリケーションを開始します。

Studio で、選択した入力操作を ​[Mule Palette (Mule パレット)]​ からキャンバスの ​[Source (ソース)]​ パネルにドラッグし、必須パラメーターを入力します。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

SAP S/4HANA OData Connector の操作を追加する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ ビューで ​[SAP S/4HANA OData]​ を選択してから、目的の操作を選択します。

  2. その操作を Studio キャンバスの入力元の右にドラッグします。

グローバル設定要素

Mule アプリケーションで SAP S/4HANA OData Connector を使用するには、アプリケーションで使用するコネクタ操作のコネクタグローバル要素を設定します。

プロジェクトの ​src/main/resources​ フォルダーにある設定ファイル ​mule-artifact.content​ のプレースホルダー値を配置できます。

ログイン情報をグローバル設定コンテンツに入力するか、ログイン情報の値が含まれる設定ファイルを参照することができます。 メンテナンスをシンプルにして、プロジェクトを再利用しやすくするために、設定ファイルを使用することをお勧めします。これらの値を別個のファイルに保存しておくと、アクセスログイン情報が異なる場合があるさまざまな環境 (本番、開発、QA など) にデプロイする必要がある場合に便利です。

グローバル要素の設定

[Global Element Properties (グローバル要素のプロパティ)]​ 設定ダイアログを使用して、SAP S/4HANA OData Connector のグローバル要素を設定します。

  1. プロジェクトで、キャンバスの下部にある ​[Global Elements (グローバル要素)]​ タブをクリックします。

  2. [Global Configuration Elements (グローバル設定要素)]​ 画面で、​[Create (作成)]​ をクリックします。

    [Create (作成)] ボタンが含まれる [Global Configuration Elements (グローバル設定要素)] 画面
  3. [Choose Global Type (グローバル種別を選択)]​ ウィザードで、​[Connector Configuration (コネクタ設定)]​ を展開し、​[SAP S 4HANA Config (SAP S 4HANA 設定)]​ を選択して ​[OK]​ をクリックします。

  4. [General (一般)]​ タブで次の値を設定します。

    1. [Connection (接続)]​ ドロップダウンメニューで、接続種別を選択します。

      • Basic authentication (基本認証)
        基本認証の場合、次の必須の値を入力します。

        • Service Base URL (サービスベース URL)
          管理する SAP S/4HANA インスタンスの URL。

        • Username (ユーザー名)
          セッションの初期化に使用するユーザー名。

        • Password (パスワード)
          ユーザーの認証に使用するパスワード

      • OAuth 2 Application Connection Provider (OAuth 2 アプリケーション接続プロバイダー)

          OAuth 2.0 認証の場合、次の必須情報を入力します。
          ** *Service base URL (サービスベース URL)*​ +
          コネクタからアクセスする SAP S/4HANA システムのサービスプロバイダーのベース URL。その他のすべてのエンドポイントはこのベース URL から派生します。
          ** *Client ID (クライアント ID)*​ +
          サービスプロバイダーに登録されている OAuth クライアント ID。
          ** *Client Secret (クライアントシークレット)*​ +
          クライアント ID に対応し、サービスプロバイダーに登録されている OAuth クライアントシークレット。
          ** *Token URL (トークン URL)*​ +
          アクセストークンを提供するエンドポイントの URL に対応するトークン URL。
        .. *[OK]*​ をクリックします。
        . *[Test Connection (接続をテスト)]*​ をクリックして、アクセスログイン情報が正しいことを確認します。
        . *[Connection (接続)]*​ セクション内の ​*[Advanced (詳細)]*​ タブをクリックして、次の値を設定します。
        Studio 項目 説明

        Discovery Service Enabled (検出サービス有効化)

        サービス検出の機能の切り替え。無効になっている場合、サービス検出相対パスが適用されません。

        Discovery Service Path (検出サービスパス)

        自動サービス検出に使用するベース URL からサービスへの相対パス。

        Service directory (サービスディレクトリ)

        すべての SAP サービスの共通 HTTP ディレクトリ。このパラメーターを空白にして、[unlisted services (リストされていないサービス)] リストで各サービスの HTTP ディレクトリを個別に指定することもできます。

        Unlisted services (リストされていないサービス)

        検出されたサービスのリストに追加するサービスのリスト。

        Service discovery resolution timeout (サービス検出解決タイムアウト)

        サービス検出の接続タイムアウト。

        Service discovery timeout unit (サービス検出タイムアウト単位)

        サービス検出解決タイムアウト設定で使用する時間単位。

        Default headers (デフォルトヘッダー)

        送信される各要求に含めることができるカスタムヘッダー。

        Default query parameter (デフォルトクエリパラメーター)

        送信される各要求に含めるカスタムクエリパラメーター。

        TLS configuration (TLS 設定)

        TLS 設定。

        Proxy configuration (プロキシ設定)

        プロキシを介して要求を実行するための設定。

        Connection timeout (接続タイムアウト)

        要求の接続タイムアウト。

        Connection timeout unit (接続タイムアウト単位)

        要求の接続タイムアウト単位。

        Client timeout (クライアントタイムアウト)

        要求のクライアントタイムアウト。

        Client timeout unit (クライアントタイムアウト単位)

        要求のクライアントタイムアウト単位。

  5. 設定ウィンドウの ​[Advanced (詳細)]​ タブをクリックして、次の値を設定します。

    Studio 項目 説明

    Time zone (タイムゾーン)

    S/4Hana から返される日付オブジェクトが変換されるタイムゾーン。

    Batch buffer size (バッチバッファサイズ)

    バッチ要求をメモリ内に保持するためにコネクタで使用できる最大メモリ。追加のメモリが必要な要求はすべてディスクでバッファされます。

    Buffer unit (バッファ単位)

    バッチバッファサイズパラメーターを表す測定単位。

    Response timeout (応答タイムアウト)

    要求の応答タイムアウト。

    Response timeout unit (応答タイムアウト単位)

    要求の応答タイムアウト単位。

  6. [OK]​ をクリックして、グローバルコネクタ設定を保存します。

次のステップ

SAP S/4HANA OData Connector を Studio で使用するための設定が完了したら、​「例」​トピックで Studio に関するその他の情報を参照してください。