レシピをインストールする前に

Oracle Integrationを使用してこれらの外部システムに正常に接続し、同期を実現するには、Oracle ERP Cloud、Apache KafkaおよびOracle Autonomous Transaction Processing (ATP)インスタンスで次の構成タスクを実行する必要があります。

Oracle ERP Cloudの構成

Oracle IntegrationからOracle ERP Cloud (またはOracle Procurement Cloud)インスタンスにアクセスするには、Oracle ERP Cloudに別のユーザー・アカウントが必要です。

「管理者」としてOracle ERP Cloudインスタンスにログインし、次のタスクを実行します。

Oracle Integrationのユーザー・アカウントを作成します。アカウントに設定したユーザー名とパスワードを書き留めます。このユーザー・アカウントの資格証明を使用して、Oracle IntegrationからOracle ERP Cloudに接続します。
ユーザー・アカウントに、次のロール/権限を割り当てます。詳細は、「統合ユーザーへの必要なロールの割当て」 (「Oracle IntegrationでのOracle ERP Cloudアダプタの使用」)を参照してください。
- Integration Specialist
- AttachmentsUser
- FND_MANAGE_CATALOG_SERVICE_PRIV
- ASM_IMPLEMENTATION_MANAGER_DUTY

別のユーザー・アカウントを作成し、そのアカウントにロール/権限を割り当てる以外に、Oracle ERP Cloudからサプライヤ・イベントを有効にする必要があります。「サプライヤ・イベントの有効化」を参照してください。

サプライヤ・イベントの有効化

Oracle Procurement Cloudから必要なサプライヤ・データの更新を取得するには、Oracle ERP Cloudでサプライヤの作成/更新イベントをサブスクライブする必要があります。

サプライヤの作成/更新イベントには、出力ペイロードのサプライヤ番号およびSupplierID属性が含まれます。 Oracle Integrationは、イベント属性を使用してサプライヤREST APIを起動し、必要なサプライヤ・データの更新をOracle Procurement Cloudから取得します。

Oracle ERP Cloudインスタンスにログインします。
ホーム・ページのナビゲータから「自分のエンタープライズ」をクリックし、「機能の更新」をクリックします。
「機能の概要」ページで、「使用可能な機能」タブを選択します。
機能領域検索フィールドにSuppliersと入力します。
サプライヤ機能領域に属するすべての使用可能な機能がリストされます。
Oracle Cloudを使用した使用可能アウトバウンド・サプライヤ・プロファイル統合機能の行で、「有効」をクリックします。
表示されるウィンドウで、Oracle Cloudを使用したアウトバウンド・サプライヤ・プロファイル統合の有効化機能の「有効化」チェック・ボックスを選択します。
「終了」をクリックします。

Apache Kafkaの構成

特定の構成タスクを完了して、Oracle IntegrationからApache Kafkaに正常に接続し、同期を実現します。

詳細は、「接続を作成するための前提条件」 (「Oracle IntegrationでのApache Kafkaアダプタの使用」)を参照してください。

Apache Kafka Cluster Bootstrap ServerのURLを取得します。

詳細は、「接続を作成するための前提条件」 (「Oracle IntegrationでのApache Kafkaアダプタの使用」)を参照してください。
接続エージェントのインストール
Apache Kafkaトピックの作成

接続エージェントのインストール

Apache Kafkaはオンプレミスでホストされており、ファイアウォールの背後にあるため、Apache Kafkaがクラウド内のアプリケーションと対話できるように接続エージェントをインストールして構成する必要があります。

接続エージェントをインストールする前に、次を確認します:

接続エージェントをインストールして構成するには:

エージェント・グループの作成。
エージェント・グループは、Oracle IntegrationからApache Kafka接続を構成するときに選択する必要があることに注意してください。
接続エージェントをダウンロードしてインストール。

Apache Kafkaトピックの作成

コマンド・プロンプトから次のコマンドを実行して、supplier_topicという名前のトピックを作成します:
```
kafka-topics.bat --zookeeper 127.0.0.1:2181 --topic supplier_topic --create –partitions 3 --replication-factor 1
```
トピックが作成されたことを示すメッセージが表示されます。
作成したトピックを表示するには、次のコマンドを実行します:
```
kafka-topics.bat --zookeeper 127.0.0.1:2181 –list
```
作成したsupplier_topicを含むトピックのリストが表示されます。

Oracle Autonomous Transaction Processing (ATP)の構成

特定の構成タスクを完了して、Oracle IntegrationからOracle ATPに正常に接続します。

次のステップでは、Oracle IntegrationからOracle ATP接続プロパティおよびセキュリティを構成するための情報および詳細を取得するために必要なタスクの概要を示します。詳細は、「Oracle IntegrationでのOracle Autonomous Transaction Processingアダプタの使用」の「接続を作成するための前提条件」を参照してください。

クライアント資格証明ウォレットをダウンロードします。
これは、クライアント・セキュリティ資格証明を含むzipファイルです。デフォルトでは、ファイル名はWallet_<databasename>.zipです。このファイルは任意のファイル名として保存できます。
データベース・サービス名を取得します。
サービス名は、クライアント資格証明ウォレットのtnsnames.oraファイルのものと同じである必要があります。
ウォレット・パスワードを取得します。
クライアント資格証明ウォレットのダウンロード中にウォレット・パスワードの入力を求められます。 Oracle IntegrationからのOracle ATP接続セキュリティの構成時に必要になるパスワードに注意してください。

前述の構成タスクに加えて、Oracle ATPインスタンスにデータベース表を設定して、サプライヤ情報を同期化する必要があります。「Oracle ATPデータベース表の作成」を参照してください。

Oracle ATPデータベース表の作成

Oracle Autonomous Database (Transaction Processing)インスタンスにログインします。
サービス・コンソールに移動し、左側のAutonomous Transaction Processingナビゲーション・メニューで「開発」をクリックします。
「データベース・アクション」をクリックします。
「データベース・アクション」ページの開発セクションで、SQLをクリックします。

データ定義言語を使用したデータベース・オブジェクトの定義と作成 - v_Supplierという名前のデータベース表 - 次の表に示すように、フィールドを指定します。

フィールド名	データ型	NOT NULL	主キー
v_SupplierId	number	Yes	Yes
v_SupplierName	varchar2(20)	-	-
v_SupplierNumber	number	-	-
v_BusinessRelationship	varchar2(20)	-	-
v_Status	varchar2(20)	-	-
v_DUNSNumber	int	-	-
v_TaxRegistrationNumber	varchar2(20)	-	-
v_TaxpayerId	varchar2(20)	-	-
v_TaxpayerCountryCode	varchar2(20)	-	-
v_SupplierTypeCode	varchar2(20)	-	-
v_TaxOrganizationType	varchar2(20)	-	-