Oracle ERP CloudからFTPサーバーへの購買オーダーのエクスポート
このレシピを使用して、Oracle ERP Cloudビジネス・イベントをサブスクライブします。 このレシピは、購買オーダーの作成時にOracle ERP Cloudが呼び出すビジネス・イベントをサブスクライブし、購買オーダー・データをFTPファイル・サーバー上のファイルに書き込みます。
ノート:
このレシピは、統合ストアでERP Cloud - FTPサーバー | ビジネス・イベントとして使用できます。 Oracleには、サンプルとしてのみこのレシピが用意されています。 レシピはガイダンスのみを目的としており、エラーがないことは保証されていません。 このレシピはサポートされていません。
概要
このレシピは、Oracle ERP Cloudビジネス・イベント・サービスに登録します。 購買オーダーが作成されると、Oracle ERP Cloudビジネス・イベント・サービスによって統合が起動され、購買オーダー・データがFTPファイル・サーバー上のファイルに追加されます。
Oracle Integrationに埋め込まれたSFTPサーバーである「ファイル・サーバー」にファイルを格納できます。
Oracle ERP Cloudの購入イベントによって統合がトリガーされます。 インテグレーションでは、FTPファイル・サーバーにCSVファイルを保存する検索値から読み取り、オーダーの値をCSVファイルのフィールドにマッピングし、最後にオーダーの値を含む行をファイルに追加します。 ファイルが存在しない場合は、新しいファイルが作成されます。
CSVファイルには、次のフィールドが含まれています:
- Creation Date
- 順序番号
- サプライヤ
- バイヤー名
- 通貨
- 総計
Order Number
フィールドは必須です。 残りのフィールドはオプションです。
統合の実行中に問題が発生した場合は、障害ハンドラによって問題とその原因がログに追加されます。 これらのログを使用して、問題をトラブルシューティングできます。
このレシピのインストールによって生成される統合には、次の名前が付けられます: Oracle ERP Cloud FTP Server Business Event
。
システムおよびアクセスの要件
- Oracle Integration
- Oracle ERP Cloud
- ファイル・サーバー
レシピのインストール、構成および実行
レシピのインストール、構成および実行の詳細は、「統合アクセラレータおよびレシピの開始」を参照してください。
レシピをインストールした後、統合を実行する前に、次のことを行う必要があります:
Oracle ERP CloudおよびOracle Integrationの構成
Oracle ERP Cloudビジネス・イベントをサブスクライブする必要があります:
-
Oracle ERP Cloud接続で使用するFusion Applicationsユーザーを作成し、次のロールを割り当てます:
- 統合スペシャリスト
- AttachmentsUser
-
FND_MANAGE_CATALOG_SERVICE_PRIV
このロールはカスタム・ロールにのみ追加できます。 カスタム・ロールの作成の詳細は、「ERPの保護」の「カスタム・ロール」を参照してください。
これは、Oracle ERP Cloudに接続するためにERP接続で指定するユーザーです。
これらのロールの詳細は、「Oracle IntegrationでのOracle ERP Cloudアダプタの使用」の「統合ユーザーへの必要なロールの割当て」を参照してください。
-
統合のコール時に使用するOracle ERP CloudのCSF (資格証明セット・フレームワーク)キーを作成します:
- ServiceInvokerロールを持つOracle Integrationユーザーを使用して、CSFキーを作成します。
- 「イベント・サブスクリプションのOracle ERP Cloudの構成」のステップ1から5に従います。
購買オーダー・イベントは、Oracle ERP Cloudでデフォルトで有効になっています。
その他のイベントを有効にする方法の詳細は、「Oracle IntegrationでのOracle ERP Cloudアダプタの使用」の「サポートされているSCMおよび調達のビジネス・イベント」を参照してください。
ファイル・サーバーの有効化
CSVファイルを格納するために外部FTPファイル・サーバーを使用している場合は、このセクションをスキップします。 FTPファイル・サーバーにアクセスできることを確認してください。
「ファイル・サーバー」を使用している場合は、「ファイル・サーバー」へのアクセスに使用するユーザーに対して有効にする必要があります。
これらのステップを実行する前に、「ファイル・サーバー」が有効であることを確認してください。 「ファイル・サーバー」を有効にする方法については、「Oracle Integrationでのファイル・サーバーの使用Generation 2」の「ファイル・サーバー」の有効化を参照してください。
- 「メイン」メニューから、「統合」、「設定」、「ファイル・サーバー」、「ユーザー」の順に選択します。
-
「ファイル・サーバー」へのアクセスに使用するユーザーを検索します。
レシピのインストールに使用したユーザーと同じユーザーを使用できます。
- 「有効化」列のスイッチがオンになっていることを確認します。
- このユーザーの「ホーム・フォルダ」値を書き留めます。 ディレクトリを構成するには、この値が必要です。
統合参照の構成
ホーム・フォルダを使用するには、ディレクトリ・ルックアップの値を編集する必要があります:
- 「メイン」メニューから、「統合」を選択し、次に「ルックアップ」を選択します。
- ORCL-BRT-FTP_FOLDERを開きます。
-
directoryプロパティ名のProperty_Value列で、
/InputDirectory
をCSVファイルを格納するフォルダへのパスに置き換えます。「ファイル・サーバー」を使用している場合は、ユーザーの「ファイル・サーバー」を有効にしたときに書き留めたパスを入力します。
- filenameプロパティ名のProperty_Value列で、
CVS
を、オーダー・データを格納するファイルに使用する名前に置き換えます。 たとえば:PurchaseOrders.csv
ERP接続の構成
ERPインスタンスのインスタンスおよび資格証明を使用するには、ERP接続を構成する必要があります:
- 「メイン」メニューから、「統合」を選択し、次に「接続」を選択します。
- 「Oracle ERP Cloud接続」を検索して開きます。
- 「接続プロパティ」セクションの「ERP Cloudホスト」フィールドに、Oracle ERP CloudインスタンスにアクセスするためのURLを入力します。
-
「セキュリティ」セクションで、セキュリティ・ポリシーを選択し、Oracle ERP Cloudにアクセスするための資格証明を入力します。
詳細は、「接続セキュリティの構成」 (「Oracle IntegrationでのOracle ERP Cloudアダプタの使用」)を参照してください。
- 「保存」をクリックし、<をクリックして「接続」リストに戻ります。
FTP接続の構成
サーバーおよび資格証明を使用するには、FTP接続を構成する必要があります:
-
外部FTPを使用している場合は、FTPサーバーが実行されるIPとポートを調べます。
「ファイル・サーバー」を使用している場合は、そのIPとポートを確認します:
- 「メイン」メニューから、「統合」、「設定」、「ファイル・サーバー」、「設定」の順に選択します。
- 「一般」セクションから、IPおよびポートをコピーします。
- 「メイン」メニューから、「統合」を選択し、次に「接続」を選択します。
- 「Oracle FTP接続」を検索して開きます。
- 「接続プロパティ」セクションで、次のフィールドの値を入力します:
- FTPサーバーのホスト・アドレス: 外部FTPファイル・サーバーのIPまたはファイル・サーバー設定からコピーしたIP。
- FTPサーバー・ポート: 外部FTPファイル・サーバーのポートまたはファイル・サーバー設定からコピーしたポート。
- SFTP接続: Yes
- 「セキュリティ」セクションで、Oracle Integrationインスタンスのユーザー名とパスワードを入力します。
レシピのテスト
レシピを構成したら、レシピをアクティブ化してテストできます:
-
統合をアクティブ化します。
統合のアクティブ化方法の詳細は、「Oracle Integrationでの統合の使用」の「統合のアクティブ化」を参照してください。
-
Oracle ERP Cloudでオーダーを作成します。
-
「モニタリング」ページを確認して、統合が正常に実行されたことを確認します:
- Oracle Integrationで、「メイン」メニューから、「モニタリング」、「統合」、「トラッキング」の順に選択します。
- 統合を検索します。
-
統合が完了したら、プライマリ識別子をクリックして統合インスタンスを開きます。
フローが緑色で強調表示され、正常に実行されたことを示します。
をクリックして、「アクティビティ・ストリームの表示」を選択します。
- 統合のフローおよびメッセージを確認します。
- 確認が終了したら、「閉じる」をクリックします。
-
FTPクライアントを使用してファイル・サーバーに接続し、CSVファイルを格納したディレクトリを開き、CVSを開いて、オーダー・データがファイルに追加されたことを確認します。
「「ファイル・サーバー」の有効化」で書き留めた情報でFTPクライアントを使用して「ファイル・サーバー」に接続できます。
「ファイル・サーバー」でフォルダ・アクセスを構成する方法の詳細は、「Oracle Integrationでのファイル・サーバーの使用Generation 2」の「フォルダの構成およびファイルのリストの表示」を参照してください。
関連ドキュメント
Oracle ERP Cloudアダプタ、Oracle FTPアダプタおよび「ファイル・サーバー」の詳細は、次を参照してください: