FTPアダプタのユース・ケースについて

「FTPアダプタ」ユース・ケースについて

FTPアダプタは次のシナリオで使用できます。

FTPアダプタのOracle ERP Cloud Adapterへの統合

このユースケースは、トリガー・ファイル・メカニズムを使用してセキュアなFTPの場所からOracle ERP Cloudにデータをロードする方法を説明します。データは、オーケストレーションのためにOracle Integrationに送信されます。 Oracle Integrationは、トリガー・ファイルをポーリングするための統合フローをスケジュールします。

スケジュールによってトリガーされるオーケストレートされる統合を作成します。
「起動」パレットから、FTPアダプタを統合キャンバスにドラッグします。
FTPアダプタを構成して、次のタスクを実行します。
- readTriggerFileの名前を指定します。
- *.TRGのファイル名パターンを指定します。
- トリガー・ファイルの読取り元の入力ディレクトリを指定します。
- トリガー・ファイル形式としてCSVファイルからスキーマを定義します。
「アクション」パネルで、FTPアダプタの下に割当てアクションを追加して、変数のセットを宣言します。
- ExtactFileNameの名前を指定します。
- 式ビルダーで、変数を構成します(相対パスから名前が*.TRGのZIPファイルを抽出するなど)。
ファイルを一時的にOracle Integrationにダウンロードしてステージングするには、Assignアクションの下に2番目の起動「FTPアダプタ」を追加します。
FTPアダプタを構成して、次のタスクを実行します。
- DownloadFileの名前を指定します。
- 「Download to ICS」操作を選択します。
- 入力ディレクトリおよびダウンロード・ディレクトリ・パスを指定します。
- 「Unzip the File」オプションを選択します。
  統合に「Stage File」アクションまたは新規エンドポイント(FTPアダプタなど)が追加されるたびに、統合にマッパーが自動的に追加されます。マッパーが「Assign」アクションとDownloadFileのFTPアダプタの間に表示されます。

マッパーにおいて、ソース抽出ZIPファイルをターゲットのDownloadFileToICSのファイル名要素にマッピングします。
ZIPファイルに複数のファイルが含まれている場合があるため、「For-Each」アクションを統合のDownloadFIleのFTPアダプタの下にドラッグします。このアクションによって繰り返された要素に対する繰り返しが可能になります。
繰り返し要素および現在の要素名を指定します。
入力ディレクトリから各ファイルを読み込むには、「For-Each」アクションの下に「Stage File」アクションを追加して、次のように構成します。
- 式ビルダーで、ファイルの読取り元のファイル名およびディレクトリを指定します。
- データ構造を含むCSVファイルをロードしてスキーマ・ファイルを指定します。
ファイルがOracle Integrationにステージングされている場合は、ステージ・ファイル・アクションの下に2番目のFor-Eachアクションを追加して、各レコードを反復処理します。
- 繰返し要素名および現在の要素名を追加します。
2番目の「Stage File」アクションを追加して、各レコードを新しいファイルに書き込みます。
- WriteRecordToFileの名前を指定します。
- 式ビルダーで、名前および出力ディレクトリを設定します。エンリッチされたすべてのデータがステージングされたファイルに追加されます。新規ERPファイルのスキーマ・ファイルはソース・ファイルと同じ構造を使用します。

自動的に追加されたマッパーでデータ・マッピングおよび変換を実行します。関数、演算子およびXSLはERPの新規ファイルの強化および変換に役立ちます。
WriteRecordToFileの「Stage File」アクションの下に「Stage File」アクションを追加して、ビジネス・データ詳細を含むマニフェスト・ファイルを書き込みます。
- CreateManifestの名前を指定します。
- 式ビルダーで「Write File」オプションおよび「Append to Existing File」を選択します。
CreateManifestの「Stage File」アクションの上にある自動的に作成されたマッパー内に、マニフェスト・ファイルのコンテンツを定義します。
CreateManifestの「Stage File」アクションの下に「Stage File」アクションを追加して、ERPクラウド・エンドポイントに送信する前に再度圧縮します。
- 式ビルダーで「ZIP Files」オプションを選択します。
- 連結するZIPファイル名および圧縮するディレクトリを選択します。
統合の最後にOracle ERP Cloud Adapterを選択し、ERP Financialアプリケーションにデータをインポートします。
- 「Import Payable Invoices」操作を選択します。
  
  データのロードおよび処理が完了したら、電子メール通知をトリガーする必要があります。
- 「Email Notification」を選択します。
- 失敗したレコードに関する詳細を取得するコールバックを定義します。
Oracle ERP Cloud Adapterの上にあるマッパーで、エンドポイントのファイル参照を定義して、ERPシステムがそれに応じて再圧縮されたファイルを処理するようにします。
統合をアクティブ化し、「Runtime Health」ページからアクティビティ・ストリームを監視します。アクティビティ・ストリームおよび診断ログがダウンロードできます。
統合を保存してアクティブ化します。
統合を呼び出します。
アクティビティ・ストリームおよび診断ログを監視します。

JSONからXMLへの特殊文字変換

JSONペイロードにXMLで有効でない特殊文字が含まれていると、これらの文字はJSONからXMLに変換されるときに文字列に置き換えられます。

たとえば、次のJSONペイロードがあるとします : { "_id": { "$oid": "52cdef7f4bab8bd67529c6f7" } }

次に、「JSONサンプル」ペイロード形式と<<inline>>を選択して、ペイロードをコピーしてAdapter Endpoint Configuration Wizardのテキスト・フィールドに貼り付けます。

マッパーでは、フィールド$oidは文字列値_0x646c72_oidで表されます。

特殊文字と対応するXML変換文字列のリストは次のとおりです:

特殊文字	マッパーで表される変換された値
`" "`	`_0x737063_`
`"/"`	`_0x736c68_`
`"\"`	`_0x626c68_`
`":"`	`_0x636c6e_`
`";"`	`_0x73636e_`
`"("`	`_0x6c7072_`
`")"`	`_0x727072_`
`"&"`	`_0x616d70_`
`","`	`_0x636d61_`
`"#"`	`_0x706e64_`
`"?"`	`_0x717374_`
`"<"`	`_0x6c7374_`
`">"`	`_0x677274_`
`"start"`	`_0x737472_`
`"@"`	`_0x617472_`
`"$"`	`_0x646c72_`
`"{"`	`_0x6c6362_`
`"}"`	`_0x726362_`
`"%"`	`_0x706572_`