Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerOracle EBS 12.2 Connector v2.3
Oracle E-Business Suite 12.2 用 Anypoint Connector (EBS 12.2 Connector) は、Mule Runtime Engine (Mule) インテグレーションと Oracle E-Business Suite 12.2 アプリケーションの間の接続を促進します。
Oracle EBS には、さまざまな種類のインテグレーションに対応するための各種のテクノロジーや製品が含まれています。エンタープライズアプリケーションには、次のものが特に広く使用されています。
データ中心のインテグレーション。
Oracle E-Business Suite Integrated SOA Gateway (ISG) を使用した Web サービスによるインテグレーション。
次の図は、MuleSoft Oracle EBS Connector のインテグレーションアーキテクチャを示しています。
このコネクタを使用するには、以下に精通している必要があります。
Oracle E-Business Suite
お使いの Oracle EBS バージョンの Web サービスおよびインテグレーションのシナリオ
Anypoint Connector
Anypoint Studio
Mule の概念
Mule フローの要素とグローバル要素
以下も必要です。
対象リソースへの接続をテストするための Oracle EBS ログイン情報
Anypoint Studio
Oracle EBS の Web サービス設定
Oracle EBS 12.2 Connector を設定するには、Oracle EBS で REST Web サービスを設定して [Integration Repository (インテグレーションリポジトリ)] 経由で公開する必要があります。Oracle EBS を設定する方法についての詳細は、コネクタの使用方法を参照してください。
FND_WEB_SEC PL/SQL サービス
このコネクタを使用するには、Oracle EBS で FND_WEB_SEC PL/SQL サービスがデプロイされている必要があります。
REST サービスロケーター
このコネクタを使用するには、Oracle EBS で REST サービスロケーターが REST サービスとしてデプロイされている必要があります。
小文字の WADL 名
デプロイされた PL/SQL に対応した WADL には別名として小文字の内部名が必要です。たとえば、HR_ABSENCE_TYPE_API
という内部名を持つ PLSQL Interface : Absence Attendance Type
をデプロイするには、そのサービスの別名が hr_absence_type_api
となっている必要があります。
ソフトウェアの要件および互換性情報については、「コネクタリリースノート」を参照してください。
<dependency>
<groupId>com.mulesoft.connectors</groupId>
<artifactId>mule-oracle-ebs-122-connector</artifactId>
<version>x.x.x</version>
<classifier>mule-plugin</classifier>
</dependency>
xml
x.x.x
を使用しているコネクタに対応するバージョンに置き換えます。
最新の pom.xml
ファイル情報を取得するには、 Anypoint Exchange でコネクタにアクセスし、[Dependency Snippets (連動関係スニペット)] をクリックします。
Anypoint Studio には、Studio プロジェクトにコネクタを追加する 2 つの方法があります。
Studio タスクバーの Exchange ボタンから
[Mule Palette (Mule パレット)] ビューから
Studio で Mule プロジェクトを作成します。
Studio タスクバーの左上にある Exchange アイコン (X) をクリックします。
Exchange で、[Login (ログイン)] をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
Exchange で、「ebs」を検索します。
コネクタを選択して [Add to project (プロジェクトに追加)] をクリックします。
画面の指示に従ってコネクタをインストールします。
Studio で Mule プロジェクトを作成します。
[Mule Palette (Mule パレット)] ビューで、[(X) Search in Exchange ((X) Exchange 内を検索)] をクリックします。
[Add Modules to Project (モジュールをプロジェクトに追加)] で、検索項目に「ebs」と入力します。
[Available modules (使用可能なモジュール)] で、このコネクタの名前をクリックします。
[Add (追加)] をクリックします。
[Finish (完了)] をクリックします。
REST サービスの場所をデプロイして、コンシュームするコネクタの PL/SQL サービスを後で公開できるようにします。「関連情報」セクションの『Oracle Developer’s Guide Tutorial (オラクル開発者ガイドチュートリアル)』へのリンクを参照してください。
次の手順は、PL/SQL Adjustment API を REST サービスとしてデプロイする方法を示しています。同じガイドがすべての PL/SQL に適用されます。
[Integration Administrator (インテグレーション管理者)] ロールを持つユーザーとして Oracle E-Business Suite にログインします。
ナビゲーションメニューから [Integrated SOA Gateway] 職責と [Integration Repository (インテグレーションリポジトリ)] リンクを選択します。
[Integration Repository (インテグレーションリポジトリ)] タブで [Search (検索)] をクリックして [Search (検索)] のメインページにアクセスします。
[Show More Search Options (検索オプションをさらに表示)] をクリックして追加の検索項目を表示します。
次のキー検索値を検索条件として入力します。
Category (カテゴリ): Interface Subtype
Category Value (カテゴリ値): PL/SQL
Internal Name (内部名): FA_ADJUSTMENT_PUB
[Go (実行)] をクリックして検索を実行します。
[Adjustments API] リンクをクリックすると、インターフェースの詳細が表示されます。
[REST Service Locator (REST サービスロケーター)] インターフェース名リンクをクイックすると、インターフェースの詳細ページが開きます。
[REST Web Service (REST Web サービス)] タブで、次の情報を入力します。
重要: デプロイする Web サービスの別名は次の条件を満たす必要があります。
1) 内部名である。
2) 小文字である。別名情報は、[Service Alias (サービスの別名)] 表示ラベルにあります。この例では、別名は fa_adjustment_pub です。
[Deploy (デプロイ)] をクリックして、サービスを Oracle E-Business Suite WebLogic 環境にデプロイします。
REST サービスのデプロイが成功すると、[REST Service Status (REST サービスの状況)] 項目が [Deployed
(デプロイ済み)] となり、[View WADL (WADL を表示)] リンクが表示されます。
[View WADL (WADL を表示)] リンクをクリックすると、デプロイされたサービスの WADL 記述が表示されます。
コネクタの操作を Anypoint Studio キャンバスにドラッグします。
コネクタのグローバル要素を設定します。
項目 | 説明 |
---|---|
Host (ホスト) |
Oracle EBS インスタンスのホスト。 |
Port (ポート) |
Oracle EBS Web サービスのポート。 |
SSL enabled (SSL が有効) |
オンの場合、コネクタは HTTP ではなく HTTPS を使用して Web サービスコールを実行します。 |
Username (ユーザー名) |
Oracle EBS Web サービスにログインするためのユーザー名。 |
Password (パスワード) |
ユーザー名のパスワード。 |
Rest Service Locator alias (REST サービスロケーターの別名) |
デプロイ時に内部名 |
FND Web Sec alias (FND Web Sec 別名) |
デプロイ時に内部名 |
Responsibility name (職責名) |
操作を実行するために必要な Oracle EBS 職責名。この項目には |
Responsibility application name (職責アプリケーション名) |
操作を実行するために必要なアプリケーションの短縮名。 |
Security group name (セキュリティグループ名) |
(省略可能) Oracle EBS インスタンスのセキュリティグループキー (デフォルトは |
NLS language (NLS 言語) |
(省略可能) Oracle EBS インスタンスの NLS 言語 (デフォルトは |
Org. ID (組織 ID) |
(省略可能) Oracle EBS インスタンスの組織 ID。 |
コネクタを使用するときに要求と応答を記録するには、Mule アプリケーションの log4j2.xml
設定ファイルの Loggers
要素に次の行を追加して、ロガーを設定します。
<AsyncLogger name="name="org.mule.service.http.impl.service.HttpMessageLogger" level="DEBUG"/>
xml
次の例は、AsyncLogger
行が追加された Loggers
要素を示しています。
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<AsyncLogger name="org.mule.service.http.impl.service.HttpMessageLogger" level="DEBUG" additivity="false">
<appender-ref ref="Console" level="debug"/>
</AsyncLogger>
</Loggers>
</Configuration>
xml
アプリケーションログは次の方法で表示できます。
アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。
コマンドラインから Mule を使用してアプリケーションを実行している場合、次のようになる。
アプリケーションログは OS コンソールに表示されます。
アプリケーションのログファイル (log4j2.xml
) でログファイルパスがカスタマイズされていない場合、次のデフォルトの場所でアプリケーションログを表示することもできます。
MULE_HOME/logs/<app-name>.log
アプリケーションログについての詳細は、「ログの設定」を参照してください。
次の手順に従って、Web サービスと PL/SQL の呼び出しの Oracle EBS 12.2 グローバル要素を作成します。
Studio で新しい Mule プロジェクトを作成し、新しいフローの提供元として HTTP リスナーを選択します。
新しい HTTP リスナーのグローバル要素設定を追加します。
[Host (ホスト)] パラメーターと [Port (ポート)] パラメーターに次の値を指定します。
パラメーター | 値 |
---|---|
Host (ホスト) |
0.0.0.0 |
Port (ポート) |
8081 |
[Save (保存)] をクリックします。
新しいグローバル設定を HTTP リスナーに割り当てます。
[HTTP Listener (HTTP リスナー)] で、[Path (パス)] に /start
という値を設定します。
[Transform Message] 要素をドラッグし、次のコードを追加します。
%dw 2.0
output application/xml
ns ns0 http://xmlns.oracle.com/apps/per/rest/hr_location_api/create_location/
---
{
ns0#InputParameters: {
ns0#P_VALIDATE: 0,
ns0#P_EFFECTIVE_DATE: now,
ns0#P_LOCATION_CODE: "HR- MuleSoft Office",
ns0#P_DESCRIPTION: "Description Office"
}
}
dataweave
新しい Oracle E-Business Suite 12.2 コンポーネントをフローにドラッグします。
[General (一般)] タブで、Oracle E-Business Suite 12.2 Connector のグローバル要素にその環境値を設定します。
Oracle E-Business Suite 12.2 Connector のプロパティエディターで、[PL/SQL] を [hr_location_api
]、[Operation (操作)] を CREATE_LOCATION
に設定します。
次の内容を [Message (メッセージ)] > [Body (本文)] セクションにコピーします。
#[payload]
プロジェクトを保存し、Mule アプリケーションとして実行します。
http://127.0.0.1:8081/start
に移動し、アプリケーションをテストします。
<?xml version="1.0" encoding="UTF-8"?>
<mule xmlns:oracle-ebs122="http://www.mulesoft.org/schema/mule/oracle-ebs122"
xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
xmlns:http="http://www.mulesoft.org/schema/mule/http"
xmlns="http://www.mulesoft.org/schema/mule/core"
xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http
http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/ee/core
http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
http://www.mulesoft.org/schema/mule/oracle-ebs122
http://www.mulesoft.org/schema/mule/oracle-ebs122/current/mule-oracle-ebs122.xsd">
<configuration-properties file="mule-app.properties"/>
<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" basePath="/" >
<http:listener-connection host="0.0.0.0" port="8081" />
</http:listener-config>
<oracle-ebs122:config name="Oracle_ebs122_Config" doc:name="Oracle-ebs122 Config" >
<oracle-ebs122:plsql-connection host="${config.host}"
port="${config.port}" username="${config.username}"
password="${config.password}"
restServiceLocatorAlias="${config.restServiceLocatorAlias}"
fndWebSecAlias="${config.fndWebSecAlias}"
responsibility="${config.responsibility}"
respApplication="${config.respApplication}"
securityGroup="${config.securityGroup}"
nlsLanguage="${config.nlsLanguage}"
orgId="${config.orgId}"/>
</oracle-ebs122:config>
<flow name="oracle-ebs122Flow">
<http:listener doc:name="Listener" config-ref="HTTP_Listener_config"
path=“/start”/>
<ee:transform doc:name="Transform Message" >
<ee:message >
<ee:set-payload ><![CDATA[%dw 2.0
output application/xml
ns ns0 http://xmlns.oracle.com/apps/per/rest/hr_location_api/create_location/
---
{
ns0#InputParameters: {
ns0#P_VALIDATE: 0,
ns0#P_EFFECTIVE_DATE: now,
ns0#P_LOCATION_CODE: "HR- MuleSoft BA",
ns0#P_DESCRIPTION: "Buenos Aires Office"
}
}]]></ee:set-payload>
</ee:message>
<ee:variables >
<ee:set-variable variableName="payload" ><![CDATA[%dw 2.0
output application/xml
ns ns0 http://xmlns.oracle.com/apps/per/rest/hr_location_api/create_location/
---
{
ns0#InputParameters: {
ns0#P_VALIDATE: 0,
ns0#P_EFFECTIVE_DATE: now,
ns0#P_LOCATION_CODE: 'LocCode001’,
ns0#P_DESCRIPTION: 'Location 001’
}
}]]></ee:set-variable>
</ee:variables>
</ee:transform>
<oracle-ebs122:invoke-pl-sql-rest-service
doc:name="Invoke PL/SQL REST Service"
config-ref="Oracle_ebs122_Config"
operation="CREATE_LOCATION" plSql="hr_location_api">
<oracle-ebs122:input ><![CDATA[#[payload]]]></oracle-ebs122:input>
</oracle-ebs122:invoke-pl-sql-rest-service>
</flow>
</mule>
xml
『Oracle Developer’s Guide Tutorial (オラクル開発者ガイドチュートリアル)』の 「Deploying a REST Service (REST サービスのデプロイ)」セクション
Oracle E-Business Suite Documentation Web Library (Oracle E-Business Suite ドキュメント Web ライブラリ)