CData Mule コネクタをオンプレミスまたはクラウドにデプロイ

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData Mule Connector for SAPSuccessFactors は、SAP SuccessFactors データをMule アプリケーションに接続し、身近なSQL クエリで読み、書き、更新、削除機能を有効にします。Connector を使用することで、ユーザーはリアルタイムSAP SuccessFactors データにアクセスできるMule アプリケーションを簡単に作成できます。また、内部アクセスのためのオンプレミスサーバーへのデプロイや、ダイレクトクラウドアクセスのためのMuleSoft CloudHub へのデプロイが可能になります。

Mule アプリへのSAP SuccessFactors 接続を追加する

この記事では、CData Mule Connector for SAPSuccessFactors をアプリケーションに組み込み、そのアプリケーションをMuleSoft CloudHub およびオンプレミスサーバーにデプロイする手順を説明します。CData SAP SuccessFactors Connector に加えて、Mule およびAnypoint Studio をインストールする必要があります。

• CData MuleSoft Connector にSAP SuccessFactors 接続を埋め込みます。
• Anypoint Platform を介してMuleSoft CloudHub にデプロイ します。
• Anypoint Platform を介してオンプレミスサーバーにデプロイします。

SAP SuccessFactors 接続を埋め込む

以下のステップは、SAP SuccessFactors Connector をプロジェクトに追加し、接続とコネクタを構成する方法の概要です。

1. Anypoint Studio で新しいMule プロジェクトを作成します。
2. CData SAP SuccessFactors Connector をアプリケーションに追加します。
3. 新しいConnection を作成（または既存のものを編集）し、SAP SuccessFactors に接続するプロパティを設定します。（以下を参照）接続を設定したら、「Test Connection」をクリックしてSAP SuccessFactors への接続を確認します。

   Basic 認証またはOAuth with SAML アサーションを使用して、SAP SuccessFactors に認証できます。

   Basic 認証

   SAP SuccessFactors に正常に認証するには、次のプロパティの値を指定する必要があります。プロバイダーは、Cookie を使用してSAP SuccessFactors によって開かれたセッションを再利用することに注意してください。つまり、セッションを開く最初のリクエストでのみクレデンシャルが使用されます。その後、SAP SuccessFactors から返されたCookie が認証に使用されます。

   • Url: Success Factors をホストするサーバーのURL に設定。一部のサーバーがリストされています。SAP support documentation（外部リンク）。
   • User: アカウントのユーザー名に設定。
   • Password: アカウントのパスワードに設定。
   • CompanyId: 会社の一意の識別子に設定。

   OAuth 認証

   アクセストークンを取得するために使用される、次のプロパティの値を指定する必要があります。

   • Url: Success Factors をホストするサーバーのURL に設定。一部のサーバーがリストされています。SAP support documentation（外部リンク）。
   • User: アカウントのユーザー名に設定。
   • CompanyId: 会社の一意の識別子に設定。
   • OAuthClientId: API Center で生成されたAPI Key に設定。
   • OAuthClientSecret: SAML アサーションの署名に使用されるX.509 プライベートキー。プライベートキーは、「Registering your OAuth Client Application」でダウンロードした証明書に記載されています。
   • InitiateOAuth: GETANDREFRESH に設定。
4. Operation、Query タイプ、SQL クエリを使用してCData SAP SuccessFactors Connector を構成します。
5. アプリケーションを終了して保存します。

アプリケーションが完成したら、Anypoint Studio をAnypoint Platform と組み合わせて使用し、MuleSoft CloudHub インスタンスまたはオンプレミスサーバーにアプリケーションをデプロイできます。

MuleSoft CloudHub にデプロイする

1. 「Project」を右クリックし、「Anypoint Platform」->「Deploy to Cloud」を選択します。
2. デプロイメントを設定し、「Deploy Application」をクリックします。
3. デプロイが完了したら、Anypoint Platform Runtime Manager に移動してデプロイされたアプリケーションを管理します。

アプリケーションがデプロイされると、必要なパラメータを追加してApp URL に移動することで、Web 上のどこからでもアクセスできるようになります。

オンプレミスサーバーにデプロイする

Anypoint Platform を介してMule アプリケーションをオンプレミスサーバーにデプロイするには、Mule Server インスタンスをマシンにインストールする必要があります。以下のステップでは、Anypoint Platform にオンプレミスサーバーを追加し、Mule アプリケーションをデプロイする方法を説明します。

オンプレミスMule Server をAnypoint Platform に追加する

1. 実行中の場合、オンプレミスのMule Server を停止します。
2. Anypoint Platform に移動して「Add Server」をクリックし、サーバーを追加するセキュリティトークンを含むコマンドを表示します。

3. MuleSoft Runtime Manager Agent をセットアップします（Windows の場合、amc_setup.bat ... を実行）。

   %MULE_HOME%\bin> amc_setup -H 12ab3cd4-567e-8fa9-0123-4b56c7de8901---234567 MYSERVER

4. オンプレミスMule Server を開始します（Windows の場合、mule.bat を実行）。

   %MULE_HOME%\bin> mule

Mule アプリケーションをデプロイする

1. Anypoint Studio で、「project」を右クリックし、「Export」を選択します。
   • Mule フォルダにて、「Anypoint Studio Project to Mule Deployable Archive」を選択し、「Next」をクリックしてデプロイ可能なファイルを作成します。
2. Anypoint Platform Runtime Manager で「Applications」に移動し、「Deploy Application」をクリックします。
   • アプリケーションに名前を付けます。
   • Deployment Target としてオンプレミスサーバーを選択します。
   • 「Application File」の下で「Choose file」->「Upload file」とクリックし、エクスポートしたプロジェクトを選択します。
   • 「Deploy Application」をクリックします。

アプリケーションをオンプレミスサーバーにデプロイすると、サ－バーにアクセス可能な任意のブラウザからアクセスできるようになります。サーバーのアドレスとポートに移動し、アプリケーションに必要なURL パラメータを追加します。

これで、SAP SuccessFactors データを使用するMule アプリケーションがデプロイできました。Mule Connector for SAPSuccessFactors の30日間の無償トライアルをダウンロードして、Mule アプリケーションでCData の強力なデータ連携をご体感ください。