Anypoint Studio を使用した SAP SuccessFactors Connector 4.1 の設定 - Mule 4
Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。
Studio でコネクタを追加および設定する手順は、次のとおりです。
「アプリケーションログの表示」で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。
Studio で初めてコネクタを設定する場合は、「Anypoint Studio を使用したコネクタの設定」を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、「SAP SuccessFactors リファレンス」を参照してください。
Mule プロジェクトを作成する
Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。
-
Studio で、[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)] を選択します。
-
Mule プロジェクトの名前を入力して、[Finish (完了)] をクリックします。
コネクタを Mule プロジェクトに追加する
SAP SuccessFactors Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの pom.xml ファイルに必須の連動関係を追加します。
-
[Mule Palette (Mule パレット)] ビューで、[(X) Search in Exchange ((X) Exchange 内を検索)] をクリックします。
-
[Add Modules to Project (モジュールをプロジェクトに追加)] で、検索項目に「
successfactors」と入力します。 -
[Available modules (使用可能なモジュール)] で、[SuccessFactors] をクリックします。
-
[Add (追加)] をクリックします。
-
[Finish (完了)] をクリックします。
Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。
ソースの設定
ソースは、指定された条件が満たされたときにフローを開始します。 次のソースのいずれかを SAP SuccessFactors Connector で使用するように設定できます。
-
[HTTP] > [Listener]
設定されたホストとポートで要求を受信するたびにフローを開始する -
Scheduler
時間ベースの条件が満たされたときにフローを開始する
たとえば、HTTP リスナーを設定する手順は、次のとおりです。
-
[Mule Palette (Mule パレット)] ビューで、[HTTP] > [Listener] を選択します。
-
[Listener] を Studio キャンバスにドラッグします。
-
[Listener (リスナー)] 設定画面で、必要に応じて [Display Name (表示名)] 項目の値を変更します。
-
[Path (パス)] 項目の値を指定します。
-
[Connector configuration (コネクタ設定)] 項目の横にあるプラス記号 (+) をクリックして、アプリケーション内の HTTP Listener のすべてのインスタンスで使用できるグローバル要素を設定します。
-
[General (一般)] タブで、コネクタの接続情報を指定します。
-
[TLS] タブで、必要に応じてコネクタの TLS 情報を指定します。
-
[Advanced (詳細)] タブで、必要に応じて再接続戦略を含む再接続情報を指定します。
-
[Test Connection (接続をテスト)] をクリックして、Mule が指定されたサーバーに接続できることを確認します。
-
[OK] をクリックします。
フローにコネクタの操作を追加する
フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。
SuccessFactors Connector の操作を追加する手順は、次のとおりです。
-
[Mule Palette (Mule パレット)] ビューで [SuccessFactors] を選択し、目的の操作を選択します。
-
その操作を Studio キャンバスの入力元の右にドラッグします。
コネクタのグローバル要素を設定する
コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。グローバル要素を設定するには、コネクタが対象の SAP SuccessFactors システムにアクセスするために必要な認証ログイン情報を指定する必要があります。SuccessFactors Connector では、基本認証方式と OAuth 2.0 認証方式がサポートされます。
SuccessFactors Connector のグローバル要素を設定する手順は、次のとおりです。
-
Studio キャンバスで操作を選択します。
-
操作の設定画面で、[Connector configuration (コネクタ設定)] 項目の横にあるプラス記号 (+) をクリックし、グローバル要素設定項目にアクセスします。
-
[General (一般)] タブの [Connection (接続)] で、設定する認証方式を選択します。
ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。プロパティプレースホルダーを使用する利点とその設定方法については、「Anypoint Connector 設定」を参照してください。
-
[Advanced (詳細)] タブで、必要に応じて再接続戦略を含む再接続情報を指定します。
-
[Test Connection (接続をテスト)] をクリックして、Mule が指定されたサーバーに接続できることを確認します。
-
[OK] をクリックします。
基本認証
[Global Element Properties (グローバル要素のプロパティ)] 画面の [General (一般)] タブで次の情報を入力し、基本認証を設定します。
| パラメーター | 説明 |
|---|---|
Company ID (会社 ID) |
会社 ID。 |
User Name (ユーザー名) |
接続するためのユーザー名。 |
Password (パスワード) |
接続するためのパスワード。 |
Data Center’s Endpoint URL (データセンターのエンドポイント URL) |
SuccessFactors Web API URL。 |
Enable Session Reuse (セッション再利用を有効化) |
セッションが存続します。 |
次の画像は、基本認証設定の例を示しています。
![[Global Element Properties (グローバル要素プロパティ)] ウィンドウでの基本認証](_images/sap-successfactors-basic-config.png)
最初の項目は、コネクタが基本認証を使用して SuccessFactors に接続することを指定する場所を示しています。2 番目の項目は、基本認証に関連する項目を含む [General (一般)] タブを示しています。
OAuth SAML Bearer Assertion Authentication (OAuth SAML ベアラーアサーション認証)
OAuth 2.0 を使用して、ユーザーアカウントをホストするサービスにユーザー認証を委任します。詳細は、「コネクタの OAuth 2.0 の設定」または「CloudHub でのコネクタの OAuth 2.0 の設定」を参照してください。
グローバル要素設定画面の [General (一般)] タブで次の情報を入力し、SAML ベアラーアサーション認証を設定します。
| パラメーター | 説明 |
|---|---|
Client ID (クライアント ID) |
OAuth で使用するクライアント ID。 |
User ID (ユーザー ID) |
SuccessFactors アカウントへのログインに使用するユーザー ID。 |
The private key from the X.509 certificate (X.509 証明書からの非公開キー) |
SuccessFactors が生成した X.509 証明書から取得した非公開キー。 |
Company Id (会社 ID) |
会社 ID。 |
トークン URL |
OAuth ベアラートークンを生成するために ID プロバイダーに渡されるトークン URL (例: |
Authorization URL (認証 URL) |
SAML アサーションの取得に使用する ID プロバイダー URL (例: |
Data Center’s Endpoint URL (データセンターのエンドポイント URL) |
SuccessFactors Web API URL。 |
フローの実行方法
-
Package Explorer で、プロジェクトの名前を右クリックし、[Run As (別のユーザーとして実行)] > [Mule Application (Mule アプリケーション)] をクリックします。
-
アプリケーションの起動時にコンソールを確認します。エラーが発生していない場合、次のようなメッセージが表示されます。
************************************************************ INFO 2019-07-14 22:12:42,003 [main] org.mule.module.launcher.DeploymentDirectoryWatcher: ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + Mule is up and kicking (every 5000ms) + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ INFO 2019-07-14 22:12:42,006 [main] org.mule.module.launcher.StartupSummaryDeploymentListener: ********************************************************** * - - + DOMAIN + - - * - - + STATUS + - - * ********************************************************** * default * DEPLOYED * ********************************************************** ************************************************************************ * - - + APPLICATION + - - * - - + DOMAIN + - - * - - + STATUS + - - * ************************************************************************ * myapp * default * DEPLOYED * ************************************************************************text
アプリケーションログの表示
問題を確認するため、アプリケーションログを次の方法で表示できます。
-
アプリケーションを Anypoint Platform から実行している場合、アプリケーションログ出力は Anypoint Studio のコンソールウィンドウに表示されます。
-
コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログ出力は OS コンソールに表示されます。
アプリケーションのログファイル (log4j2.xml) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 MULE_HOME/logs/<app-name>.log でアプリケーションログを表示することもできます。ログパスは、アプリケーションログファイル log4j2.xml で設定できます。
次のステップ
グローバル要素と接続情報を設定したら、コネクタの他の項目を設定します。「追加設定情報」で、詳細な設定手順を参照してください。
