Oracle EBSSpoke を設定
ベーシック認証を使用してServiceNowインスタンスと Oracle EBSインスタンスを統合し、ServiceNow要求を認証します。
始める前に
- 統合ハブサブスクリプションを要求します。
- Oracle EBS スポークを有効化します。
- Oracle EBSアカウントへのアドミンアクセス
- 必要なロール:admin
Oracle Database 12C 以降のバージョンの設定
REST API Oracle 展開し、ServiceNow 接続を設定することで、Oracle E-Business Suite スポークで動作するように Database 12C 以降のバージョンを構成します。
始める前に
必要なロール:admin
手順
- から ServiceNow® Store Oracle Database 12c および 18c の Oracle E-Business Suite スポークの依存関係 プロジェクトファイルを Oracle_e-business_suite spoke_dependencies.zip でダウンロードし、必要なローカルフォルダーに保存します。
- Oracle_e-business_suite spoke_dependencies.zip ファイルのコンテンツを解凍します。
-
SQL Developer または SQL クライアントで、APPS スキーマ内のすべての PKB ファイルと PLS ファイルをコンパイルします。
図 : 1. -
Oracle EBS サーバーで、 Oracle EBSREST API を展開します。
拡張機能ごとに REST API を有効にする手順については、「 REST Web サービスの展開」を参照してください。
これらの手順は、すべての PLS ファイルに対して行う必要があります。各 PLS ファイルを展開する際には、関連する値を指定する必要があります。ここでは、例として XXSN_CREATE_PO_PKG.pls を使用して手順を概説します。
-
コンパイル済みパッケージ .pls ファイルをコピーして、次の各ディレクトリーにアップロードします。
- $PO_TOP/patch/115/sql/tmp/
- $PO_TOP/patch/115/sql/
注:$PO_TOP を、パッケージが属するモジュール ($AP_TOP、$PO_TOP など) に置き換えていることを確認してください。 -
Oracle EBSサーバーの PuTTY にログインし、データ連携リポジトリパーサーを実行します。
- iLDT (* .ildt) ファイルを生成するには、次の構文を使用してデータ連携リポジトリパーサーを実行します。
$IAS_ORACLE_HOME/perl/bin/perl $FND_TOP/bin/irep_parser.pl -g -v -username=sysadmin po:patch/115/sql:XXSN_CREATE_PO_PKG.pls:12.0=$PO_TOP/patch/115/sql/tmp/XXSN_CREATE_PO_PKG.pls - XXSN_CREATE_PO_PKG.pls ファイルの .ildt ファイルを生成していない場合は、
poと$PO_TOPを必要なTopに置き換えます。 - XXSN_CREATE_PO_PKG.pls ファイルの .ildt ファイルを生成していない場合は、
XXSN_CREATE_PO_PKG.plsを必要なパッケージ名に置き換えます。
図 : 2. - iLDT (* .ildt) ファイルを生成するには、次の構文を使用してデータ連携リポジトリパーサーを実行します。
-
次のコマンドを実行して、生成された iLDT ファイルをデータ連携リポジトリにアップロードします。
$FND_TOP/bin/FNDLOAD apps/apps 0 Y UPLOAD $FND_TOP/patch/115/import/wfirep.lct XXSN_CREATE_PO_PKG_pls.ildt注:XXSN_CREATE_PO_PKG_を必要なパッケージ名に置き換えます。図 : 3. - システムアドミニストレーターとしてOracleE-Business Suite インスタンスにログインします。
-
[統合された SOAP ゲートウェイ] の責任に切り替えて、[データ連携リポジトリ] を選択します。
図 : 4. -
内部名 XXSN_CREATE_PO_PKG の Web サービスを検索します。
図 : 5. -
検索結果のリンクをクリックして、インターフェイスパッケージで利用可能なメソッドのリストにアクセスします。
図 : 6. 注:PLC/SQL インターフェイスタイプでは、SOAP Web サービスと REST Web サービスの両方を利用できます。ただし、この手順は REST Web サービスに焦点を当てています。 -
[REST Web サービス] タブをクリックします。
- このサービスのエイリアスを設定します。たとえば、hr です。
- [展開] をクリックします。
-
[REST Web サービス] タブをクリックして、[PO の作成] メソッドを表示します。
図 : 7. 図 : 8. -
一意のサービスエイリアス名を入力し、[PO の作成] メソッドを選択して、[展開] をクリックします。
図 : 9. サービスが正常に展開されたことを示す確認メッセージが表示されます。 - [WADL の表示] をクリックして、サービスがホストされているサービスエンドポイントの物理的な場所にアクセスします。
-
[権限許可] タブを開き、[PO の作成] を選択して、[権限の作成] をクリックします。
図 : 10. -
付与対象タイプを選択し、Web サービスを使用するための権限を付与するユーザー名を入力して、[権限を作成] をクリックします。
図 : 11. 権限が正常に作成されたことを示す確認メッセージが表示されます。図 : 12. 注:権限を取り消すには、[権限許可] タブの [権限を取り消す] をクリックし、必要なユーザーを選択します。 -
必要なすべてのアクションに対して上記の手順を実行し、次の表の [リソースパス] 列に示されているものと同じ名前 (それぞれのアクションに関連付けられている名前) を使用していることを確認します。
-
サーバーを再起動し、PuTTY を使用して、 Oracle EBSサーバーへのログイン時に次の手順を実行します。
- コマンド cd $ADMIN_SCRIPTS_HOME および ./adadminsrvctl.sh stop を実行します。
- WebLogic パスワードと EBS パスワードを入力します。
- コマンド ./adadminsrvctl.sh start を実行します。
- WebLogic パスワードと EBS パスワードを入力します。
- ステータスを確認するには、コマンド ./adadminsrvctl.sh status を実行します。
-
コンパイル済みパッケージ .pls ファイルをコピーして、次の各ディレクトリーにアップロードします。
-
Oracle EBSSpoke の認証情報レコードを作成します。
- 移動先 接続 & 認証情報 > 認証情報.
-
[New] をクリックします。
「作成する認証情報のタイプは?」というメッセージが表示されます。
- [基本認証情報] を選択します。
-
フォームに、これらの値を入力します。
フィールド 説明 名前 認証情報レコードを識別する一意の名前たとえば、OEBS Cred を入力します。 ユーザー名 Oracle EBSインスタンスにログインするためのユーザー名 パスワード Oracle EBSインスタンスにログインするためのパスワード 有効 認証情報レコードを積極的に使用するオプションです。 - [送信] をクリックします。
-
Oracle EBSSpoke の接続レコードを作成します。
- 移動先 接続 & 認証情報 > 接続と認証情報エイリアス.
- Oracle EBSSpoke のレコードを開きます。
- [接続] タブで、[新規] をクリックします。
-
フォームに、次の値を入力します。
フィールド 説明 名前 接続レコードを一意に識別する名前です。たとえば、OEBS Conn を入力します。 認証情報 Oracle EBSSpoke 用に作成された認証情報レコードです。 接続 URL Oracle EBSインスタンスに接続するための接続 URL です。 - [送信] をクリックします。
Oracle Database 19C 以降のバージョンの設定
REST API Oracle 展開し、ServiceNow 接続を設定することで、Oracle E-Business Suite スポークで動作するように Database 19C 以降のバージョンを構成します。
始める前に
必要なロール:admin
手順
- から ServiceNow® Store Oracle Database 19c 以降の Oracle EBS スポークの依存関係 プロジェクトファイルを Oracle_e-business_suite spoke_dependencies.zip でダウンロードし、必要なローカルフォルダーに保存します。
- Oracle_e-business_suite spoke_dependencies.zip ファイルのコンテンツを解凍します。
- SQL Developer または SQL クライアントで、APPS スキーマ内のすべての PKB ファイルと PLS ファイルをコンパイルします。
-
モジュールパッケージの参照を確認して、展開に適した値を特定します。
次の表に、各Oracle EBSモジュールに必要な. pls ファイル名、 $TOP 変数、製品ショートコードおよびサービスエイリアスを示します。以下の手順でモジュール固有のパス、製品コード、またはエイリアスを参照する場合は、この表の値を使用します。
モジュール パッケージ (.pls ファイル名) $TOP変数 製品コード サービスエイリアス 総勘定元帳 xxsn_gl_integration_pkg.pls $GL_TOP glxxsn_gl_integration_pkgAP - サプライヤー xxsn_supplier_integration_pkg.pls $AP_TOP APxxsn_supplier_integration_pkg購入 xxsn_po_integration_pkg.pls $PO_TOP POxxsn_po_integration_pkg買掛金 xxsn_ap_integration_pkg.pls $AP_TOP APxxsn_ap_integration_pkg固定資産 xxsn_fa_integration_pkg.pls $FA_TOP faxxsn_fa_integration_pkg調達 xxsn_pon_integration_pkg.pls $PON_TOP ポンxxsn_pon_integration_pkgインベントリ xxsn_inv_integration_pkg.pls $INV_TOP 請求書xxsn_inv_integration_pkg共通 xxsn_common_integration_pkg.pls $FND_TOP fndxxsn_common_integration_pkg売掛金 xxsn_ar_integrations_pkg.pls $AR_TOP APxxsn_ar_integrations_pkg注文管理 xxsn_om_integration_pkg.pls $ONT_TOP ONTxxsn_om_integration_pkg -
Oracle EBS サーバーで、 Oracle EBS REST API を展開します。
拡張機能ごとに REST API を有効にする手順については、「 REST Web サービスの展開」を参照してください。
これらの手順は、すべての PLS ファイルに対して行う必要があります。各 PLS ファイルを展開する際には、関連する値を指定する必要があります。ここでは、 例として xxsn_gl_integration_pkg.pls を使用して手順を概説します。
-
コンパイル済みパッケージ .pls ファイルをコピーして、次の各ディレクトリーにアップロードします。
- $GL_TOP/patch/115/sql/tmp/
- $GL_TOP/patch/115/sql/
注:$GL_TOP を、パッケージが属するモジュールの $TOP 変数に置き換えてください。モジュールごとの正しい $TOP 変数については、前のステップのモジュールパッケージ参照テーブルを参照してください。 -
アップロードされた .pls ファイルに
777権限を付与します。SFTP クライアントで、 .pls ファイルを右クリックし、[ プロパティ] をクリックして、 Octal 権限値を 0777 に設定します。
注:統合リポジトリパーサーがファイルを処理するには、777 の権限が必要です。このステップがないと、次のサブステップのコマンドは失敗します。 -
Oracle EBSサーバーの PuTTY にログインし、データ連携リポジトリパーサーを実行します。
- iLDT (* .ildt) ファイルを生成するには、次の構文を使用してデータ連携リポジトリパーサーを実行します。
$IAS_ORACLE_HOME/perl/bin/perl $FND_TOP/bin/irep_parser.pl -g -v -username=sysadmin gl:patch/115/sql:xxsn_gl_integration_pkg.pls:12.0=$GL_TOP/patch/115/sql/xxsn_gl_integration_pkg.pls - xxsn_gl_integration_pkg.pls ファイルの .ildt ファイルを生成していない場合は、
glと$GL_TOPを、必要なモジュールの製品コードと $TOP 変数に置き換えます。モジュールごとの正しい値については、前の手順のモジュールパッケージ参照表を参照してください。 - xxsn_gl_integration_pkg.pls ファイルの .ildt ファイルを生成していない場合は、
xxsn_gl_integration_pkg.plsを必要なパッケージ名に置き換えます。
- iLDT (* .ildt) ファイルを生成するには、次の構文を使用してデータ連携リポジトリパーサーを実行します。
-
次のコマンドを実行して、生成された iLDT ファイルをデータ連携リポジトリにアップロードします。
$FND_TOP/bin/FNDLOAD apps/apps 0 Y UPLOAD $FND_TOP/patch/115/import/wfirep.lct xxsn_gl_integration_pkg_pls.ildt注:xxsn_gl_integration_pkg_必要なパッケージ名に置き換えます。 - システムアドミニストレーターとしてOracleE-Business Suite インスタンスにログインします。
-
[統合された SOAP ゲートウェイ] の責任に切り替えて、[データ連携リポジトリ] を選択します。
-
内部名「 xxsn_gl_integration_pkg」の Web サービスを検索します。
-
検索結果のリンクをクリックして、インターフェイスパッケージで使用可能なメソッドのリストにアクセスします。
注:PLC/SQL インターフェイスタイプでは、SOAP Web サービスと REST Web サービスの両方を利用できます。ただし、この手順は REST Web サービスに焦点を当てています。
-
[REST Web サービス] タブをクリックします。
- [ サービスエイリアス ] フィールドに、モジュールのサービスエイリアスを入力します。モジュールごとの正しいエイリアス値については、前のステップのモジュールパッケージ参照表を参照してください。注:サービスエイリアスは、モジュールパッケージ参照テーブルの [サービスエイリアス ] 列の値と完全に一致する必要があります。エイリアスは大文字と小文字を区別します。
- [展開] をクリックします。
- [ サービスエイリアス ] フィールドに、モジュールのサービスエイリアスを入力します。モジュールごとの正しいエイリアス値については、前のステップのモジュールパッケージ参照表を参照してください。
-
[ REST Web サービス ] タブをクリックして、総勘定元帳統合サービスメソッドを表示します。
-
一意のサービスエイリアス名を入力し、必要なメソッドを選択して、[ 展開] をクリックします。
サービスが正常に展開されたことを示す確認メッセージが表示されます。
- [WADL の表示] をクリックして、サービスがホストされているサービスエンドポイントの物理的な場所にアクセスします。
-
[ 助成] タブを開き、必要な方法を選択して、[ 助成を作成] をクリックします。
-
付与対象タイプを選択し、Web サービスを使用するための権限を付与するユーザー名を入力して、[権限を作成] をクリックします。
権限が正常に作成されたことを示す確認メッセージが表示されます。注:権限を取り消すには、[権限許可] タブの [権限を取り消す] をクリックし、必要なユーザーを選択します。
- 必要なすべてのアクションに対して上記の手順を実行し、次の表の [リソースパス] 列に示されているものと同じ名前 (それぞれのアクションに関連付けられている名前) を使用していることを確認します。
-
サーバーを再起動し、PuTTY を使用して、 Oracle EBSサーバーへのログイン時に次の手順を実行します。
- コマンド cd $ADMIN_SCRIPTS_HOME および ./adadminsrvctl.sh stop を実行します。
- WebLogic パスワードと EBS パスワードを入力します。
- コマンド ./adadminsrvctl.sh start を実行します。
- WebLogic パスワードと EBS パスワードを入力します。
- ステータスを確認するには、コマンド ./adadminsrvctl.sh status を実行します。
-
コンパイル済みパッケージ .pls ファイルをコピーして、次の各ディレクトリーにアップロードします。
-
Oracle EBSSpoke の認証情報レコードを作成します。
- 移動先 接続 & 認証情報 > 認証情報.
-
[New] をクリックします。
「作成する認証情報のタイプは?」というメッセージが表示されます。
- [基本認証情報] を選択します。
-
フォームに、これらの値を入力します。
フィールド 説明 名前 認証情報レコードを識別する一意の名前たとえば、OEBS Cred を入力します。 ユーザー名 Oracle EBSインスタンスにログインするためのユーザー名 パスワード Oracle EBSインスタンスにログインするためのパスワード 有効 認証情報レコードを積極的に使用するオプションです。 - [送信] をクリックします。
-
Oracle EBSSpoke の接続レコードを作成します。
- 移動先 接続 & 認証情報 > 接続と認証情報エイリアス.
- Oracle EBSSpoke のレコードを開きます。
- [接続] タブで、[新規] をクリックします。
-
フォームに、次の値を入力します。
フィールド 説明 名前 接続レコードを一意に識別する名前です。たとえば、OEBS Conn を入力します。 認証情報 Oracle EBSSpoke 用に作成された認証情報レコードです。 接続 URL Oracle EBSインスタンスに接続するための接続 URL です。 - [送信] をクリックします。