機械翻訳について
  1. Oracle Integration Generation 2でのFTPアダプタの使用
  2. オーケストレートされた統合へのFTPアダプタ接続の追加
  3. 起動操作ページ

起動操作ページ

FTPアダプタの操作プロパティを入力します。 オーケストレートされた統合のすべてのFTP操作は同期されます。

ファイルに対して実行する次の操作のいずれかを選択します。 選択した操作に応じて、その操作に特に適用される様々なオプションおよびパラメータが表示されます。 すべての操作で、マッピングを介した動的ファイル名およびディレクトリがサポートされます。

ノート:

複数のファイルを読み取る操作は非推奨になりました。 このオプションは、新しい統合で「FTPアダプタ」接続を構成する際に、アダプタ・エンドポイント構成ウィザードで使用できませんが、既存の古い統合で表示できます。 また、Oracleでは、ループ機能(for-eachアクションなど)を使用して複数のファイルを読み取ることをお薦めします。

  • ファイルを読む: FTP/FTPS/sFTPのロケーションからファイルを読み取ります。 この操作では、単一のファイルを読み取ります。 スキーマを選択していない場合は、最大1 GBのファイル・サイズがサポートされます。 スキーマを選択した場合は、最大50 MBのファイル・サイズがサポートされます。

  • ファイルの書込み: 単一のファイルをターゲットFTPサーバーに書き込みます。

  • ファイルのリスト: 入力ディレクトリ内のファイルの名前を一覧表示します。 この操作は、データのないファイルのリストを返します。 これは、Linuxでのlsコマンドの実行に似ています。

  • ファイルを移動: 同じターゲットFTPサーバー上のあるロケーションから別のロケーションにファイルを移動します。

  • ファイルの削除: FTPサーバー上の単一ファイルを削除します。

  • ファイルのダウンロード: ステージング・アクティビティに使用するディレクトリを指定します。 このディレクトリを使用して、処理のために大きなファイルをステージングします。 この操作では、指定した論理ディレクトリに単一のファイルをダウンロードします。 ファイル・サイズのサポートは最大1 GBです。

    ノート:

    サイズが1 GB未満の暗号化ファイルを復号化しようとした場合、復号化後に1 GBを超えると、操作は失敗します。 これはZIPファイルにも適用されます。 ZIPファイルが1 GB未満の場合に解凍を選択すると、解凍後のファイル・サイズが1 GBを超えると、操作も失敗します。

    ノート:

    複数のファイルを読取り/ダウンロードする場合は、次の統合パターンを使用します。

    FTPリスト・ファイル(操作) > For Eachループ> FTP Read File (操作) > End For Eachループ

次の表に、「FTPアダプタ」起動のOperationsページに表示される主な情報を示します。 選択した操作に応じて、その操作に特に適用される様々なオプションおよびパラメータが表示されます。 各表は特定の操作に対応します。

各操作は、ZIPおよびGZIPファイル形式に対して実行できます。

ファイルの読取り

ノート:

"+"でマークされた要素は、マッパーでマップでき、実行時に動的に渡すことができます。

接続性エージェントを使用する場合、スキーマのない「ファイルを読む」操作では最大1 GBのサイズのファイルがサポートされます。 この制限は、「ファイルのダウンロード」操作と同じです。 変換にスキーマを使用している場合、ファイル・サイズ制限は50 MBです。 読取り操作用にFTPアダプタを構成する際に、ペイロードのサンプルXMLおよびJSONドキュメントを指定できます。

要素 説明

Select a Transfer Mode

転送モードを選択します。

  • ASCII: データを書式設定するための特殊制御文字を転送します。

  • Binary: ファイル・データのrawバイトを転送します。

+入力ディレクトリ

読み取るファイルを含むディレクトリの名前。 たとえば、/tmp/Oracle/inputなどです。

+ファイル名

読み取るファイルの名前。 名前はマッパーでも指定できます。 最大50 MBのファイル・サイズがサポートされています。

Write File

接続性エージェントを使用する場合、スキーマのない「ファイルの書込み」操作では最大1 GBのサイズのファイルがサポートされます。 この制限は、「ファイルのダウンロード」操作と同じです。 変換にスキーマを使用している場合、ファイル・サイズ制限は50 MBです。 書込み操作用にFTPアダプタを構成する際に、ペイロードのサンプルXMLおよびJSONドキュメントを指定できます。

要素 説明

Select a Transfer Mode

転送モードを選択します。

  • ASCII: データを書式設定するための特殊制御文字を転送します。

  • Binary: ファイル・データのrawバイトを転送します。

+出力ディレクトリ

ファイルの書込み先のディレクトリ・パス。 たとえば、/tmp/Oracle/outputなどです。

+ファイル名パターン

出力ディレクトリに転送するファイル名のパターン。 %%の中でパターンを使用します。 たとえば、Oracle%SEQ%ICS.txtの場合、Oracle1ICS.txt、Oracle2ICS.txtのように、ファイルが順に作成されます。 サポートされるファイル・パターンのリストを表示するには、情報アイコンをクリックします。

ノート: これらのパターンを使用すると、メッセージが同時にファイル・システムに書き込まれたり、ファイルが別々のノードに書き込まれたりした場合にメッセージが失われます。 ファイルが上書きされないようにするには、マッパーを使用してファイル名を明示的に割り当てます。 XPath関数を使用して、ファイル名が必ず一意になるようにすることもできます。

Append to Existing FileAppend to Existing File

選択した場合、既存のファイルの内容にファイルの内容が付加され、上書きされません。

ノート:
  • JSONまたはXMLコンテンツを追加する場合、最終ファイルは無効なXMLまたはJSONです。

  • 「既存のファイルに追加」オプションを使用してレコード別にレコードを書き込むと、ネットワーク呼出しが多すぎて最終的にプロセスが遅くなります。 かわりに、ステージング・ファイル・アクションを使用し、レコードをステージング・ディレクトリに書き込みます。 すべてのレコードが書き込まれたら、ステージング・ファイル・アクションとFTPアダプタの「ファイルの書込み」オプションで「ファイルのリスト」オプションを使用して、ファイルをFTPのロケーションに転送します。 このアプローチでは、処理時間が短縮され、FTPサーバーへのコールが多すぎないようになります。

  • 複数の書き込み操作を行うか、またはfor-eachループで書き込み操作を使用して、連続した追加を実行している可能性があります。 このシナリオでは、FTPサーバーが複数のノードまたはクラウド・サービスで実行されている場合、FTPサーバーはすべてのノード間ですぐにデータを同期する必要があります。 それ以外の場合、次のリクエストが別のノードに送られた場合、最終出力ファイルに矛盾があります。 代わりに、データを同期させる時間を与えるために、追加の前後に待機アクティビティを配置することもできます。

PGP暗号化/復号化 Oracle Integrationは、ファイルの公開キーを使用してPGP暗号化を実行し、機密データを保護し、機密性とプライバシを維持するために外部FTPサーバーに送信できます。 Oracle Integrationは、受信ファイルの秘密キーを使用してPGP復号化を実行し、暗号化されたコンテンツを復号化することもできます。
  • 外部FTPサーバーに送信されるファイルに対してPGP暗号化を実行: データを暗号化します。 これには、接続ページで公開キー、ASCII Armorおよび暗号化アルゴリズムを指定する必要があります。
  • 外部FTPサーバーにクリア・テキストとして送信される暗号化ファイルに対してPGP復号化を実行: 暗号化されたデータを復号化します。 このモードでは、接続ページで秘密キーと秘密キーのパスワードを作成する必要があります。
  • 外部FTPサーバーに送信されるファイルにPGP暗号化/復号化がありません: 暗号化または復号化は実行されません。
変更検出コードを含める 楕円曲線ディフィーヘルマン(ECDH)キーを使用してファイルを暗号化/復号化する場合は、このチェックボックスを選択します。 それ以外の場合、実行時に復号化中にアクティビティ・ストリームでエラーが発生します。 「楕円曲線ディフィーヘルマン(ECDH)キー・ペア使用時のPGPファイルの復号化の失敗」を参照してください。

RSAキーを使用してファイルを暗号化/復号化する場合、この選択はオプションです。
署名/署名の検証 Oracle Integrationは、秘密キーを使用して署名を実行して、レシーバが移動中にファイルの内容が変更されていないことを確認できます。 Oracle Integrationは、受信ファイルの公開キーを使用してシグネチャ検証を実行し、転送中にコンテンツが変更されていないことを確認することもできます。
  • 外部FTPサーバーに送信するファイルの署名を実行: シグネチャのみを生成してアタッチします。 これには、Connectionsページで署名するためのASCII armor、暗号アルゴリズム、署名秘密キーおよび署名秘密キーのパスワードを作成する必要があります。
  • 外部FTPサーバーに送信する必要がある着信署名ファイルの検証を実行: データ内に存在するシグネチャを確認します。 これにより、コネクション・ページに署名公開キーを作成する必要があります。
  • 外部FTPサーバーに送信されるファイルに署名/検証がありません: 署名または署名の検証は実行されません。

List Files

要素 説明

+入力ディレクトリ

読み取るファイルを含むディレクトリの名前。 たとえば、/tmp/Oracle/inputなどです。

+ファイル名パターン

入力ディレクトリからのファイルのリストに使用されるワイルドカード・パターンを指定します。 たとえば、order*.csvです。

最大ファイル数

一覧表示する必要があるファイル名の最大数。 最大値は1000です。

ノート: ファイルのリスト操作は、最後に変更された時間に従ってソート順にファイル・リストを返します。 10を最大ファイル数として選択し、11番目のファイルの最後の変更時間が10番目のファイルと同じ場合は、11番目のファイルも追加されます。 これは、タイムスタンプが異なるファイルを取得するまで続きます。

たとえば、ディレクトリに15個のファイルがあり、最大ファイル数として10を選択したとします。 10番目、11番目、12番目、および13番目のファイルのタイムスタンプが同じ場合、リスト・ファイルは13個のファイルを返します。

最小経過時間

表示するファイルの最小経過時間(秒)。 たとえば、ファイルが最後に変更された時間が午前02:28:45で、最小経過時間が80秒と定義されている場合、そのファイルは午前02:29:00と午前02:30:00に一覧表示されません。 02:30:05の後に掲載されます。

ファイルを再帰的にリスト

ディレクトリ内のファイルを、入力ディレクトリの下に再帰的に一覧表示します。

ファイルの移動

要素 説明

+ディレクトリ・パス

移動するファイルを含むディレクトリの名前。 たとえば、/tmp/Oracle/inputなどです。

+ファイル名

移動するファイルの名前。 移動するファイルのサイズに制限はありません。

+ターゲット・ディレクトリのパス

ファイルの移動先ディレクトリの名前。

+ターゲット・ファイル名

ターゲット・ディレクトリに書き込まれるファイルの名前。

上書き

ターゲット・ディレクトリのファイルを上書きする場合に選択します。

ファイルの削除

要素 説明

+ディレクトリ・パス

削除するファイルのディレクトリ・パス。

+ファイル名

削除するファイルの名前。

ファイル・ダウンロード

「ファイルのダウンロード」操作を使用すると、ダウンロード・ディレクトリを動的にマップできます。 これは、新しい統合でうまく機能します。 アダプタ・エンドポイント構成ウィザードで既存の「ファイルのダウンロード」操作を編集して、さらにファイルのダウンロード操作を追加してから、「完了」をクリックしてアダプタ・アーティファクトを再生成することもできます。 最大1 GBのファイル・サイズをダウンロードできます。

接続エージェントで「ファイルのダウンロード」操作を使用すると、ファイルを接続エージェント・サーバーからOracle Integrationにアップロードできます。 この操作では、最大1 GBのサイズのファイルをダウンロードおよびアップロードできます。 この操作は、FTPと接続エージェント間のネットワーク条件および接続エージェントとOracle Integrationによって時間がかかる場合があります。

要素 説明

Select a Transfer Mode

転送モードを選択します。

  • ASCII: データを書式設定するための特殊制御文字を転送します。

  • Binary: ファイル・データのrawバイトを転送します。

+入力ディレクトリ

読み取るファイルを含むディレクトリの名前を指定します。 たとえば、/tmp/Oracle/inputなどです。

+ファイル名

ダウンロードするファイルの名前。 これは、マッパーを使用してオーバーライドできます。

+ダウンロード・ディレクトリ

ステージ・ファイル・アクションに使用されるディレクトリの名前。 「ステージ・ファイル操作によるスケジュールされた統合におけるファイルの処理」を参照してください。

ディレクトリ・パスを二重引用符で囲んで入力しないでください。 引用符は誤ってディレクトリ名の一部として含まれています。

外部FTPサーバーからダウンロードした圧縮ファイルの解凍を実行します ダウンロードするファイルが圧縮モードの場合に選択します。 このオプションを選択すると、「zipディレクトリ構造の保持」オプションが表示されます。 このオプションを選択すると、ダウンロード・ディレクトリ内のコンテンツの解凍中にディレクトリ構造が保持されます。
外部FTPサーバーからダウンロードした暗号化ファイルのPGP復号化を実行します ダウンロードするファイルがPGP暗号化を使用して送信者によって暗号化され、機密性とプライバシを保護する場合に選択します。 復号化に必要な秘密キーは、このFTPサーバーに固有の接続にアップロードする必要があります。
外部FTPサーバーからダウンロードした署名付きファイルの検証を実行します ファイルの内容が転送中に変更されておらず、実際の送信者からのものであることを確認するために、ダウンロードするファイルにシグネチャ検証が必要な場合に選択します。 シグネチャ検証に必要な対応する公開キーを、このFTPサーバーに固有の接続にアップロードする必要があります。