機械翻訳について

チュートリアル: ファイルの読取りおよびファイル・サーバーへのファイルの書込み

ファイル・サーバー・アクションを使用してFTPサーバー上の1つ以上のファイルを読み取ってから、Oracle Integrationの「ファイル・サーバー」にファイルを書き込む方法を学習します。

対象読者

このチュートリアルは、組織が「ファイル・サーバー」をすでに使用しているか、使用を検討している場合に最も役立ちます。 これは、チュートリアルで「ファイル・サーバー」を有効にして設定する必要があるためです。

このチュートリアルは、ファイル・サーバー・アクションを使用して実践的な演習を行う場合にも役立ちます。 ファイル・サーバー・アクションを使用するステップ・バイ・ステップの手順が必要な場合は、「Oracle Integration 3での統合の使用」の「ファイル・サーバー内のファイルとの対話」を参照してください。

このチュートリアル

前提条件

  • FTPサーバーへの呼出しFTP接続を設定し、Supplier_FTPという名前を付けます。

  • 「ファイル・サーバー」を有効にし、すべての設定ステップを完了します。

    「Oracle Integration 3でのファイル・サーバーの使用」の「ファイル・サーバーの管理」を参照してください。

  • ファイルを「ファイル・サーバー」に移動できるように、組織のFTPサーバーにファイルを配置します。 ファイル名とそのディレクトリを書き留めます。

ステップ1. スケジュール統合の作成とトリガーの定義

まず、スケジュール統合を作成します。 統合のトリガーには、2つのパラメータを渡します。

  1. ナビゲーション・ペインで、「設計」、「統合」の順にクリックします。

  2. 「作成」を選択します。

  3. 「スケジュール」を選択し、次のフィールドに入力します。

    フィールド 使用する値
    名前 Poll_For_New_Files

  4. 「作成」を選択します。

    統合キャンバスが表示され、オプションのメニューが表示されます。

  5. キャンバス上の任意の場所を選択してメニューを閉じます。

  6. キャンバスで、「スケジュール」アクションをポイントし、...を選択し、「編集」を選択します。


    「スケジュール」ボックスで、「…」ボタンが選択され、メニューが表示されます。 マウス・カーソルがメニューの「編集」オプションを示します。

  7. インテグレーションのトリガーのパラメータを定義します:

    これらのパラメータを使用すると、FTPサーバーから取得するファイルのパターンとパスを渡すことができます。

    1. +を選択し、次のフィールドに入力します。

      フィールド 使用する値
      パラメータ名 file_pattern
      デフォルト値 "*.csv"

    2. +を選択し、次のフィールドに入力します。

      フィールド 使用する値
      パラメータ名 directory
      デフォルト値 "/"

    3. 「保存」を選択します。

2つのパラメータを渡すスケジュール統合を作成しました。

ステップ2. FTPサーバーに接続し、ディレクトリ内のファイルをリスト

統合を作成したので、それにアクションを追加します。 起動アクションによってFTPサーバーがコールされ、特定のディレクトリ内のすべてのファイルがリストされます。 トリガーを定義したときに、そのディレクトリを統合のスケジュールに渡しました。

  1. +が表示されるまで、「スケジュール」ボックスから出てくる行を指し、+を選択します。


    マウス・カーソルは、「スケジュール」ボックスから出てくる行を指します。 プラス記号+ボタンが表示されます。

  2. 検索フィールドで、「仕入先」と入力し、前提条件タスクとして作成したSupplier_FTP接続を選択します。

    キャンバスに「起動」アクションが表示され、「基本情報の構成」パネルが表示されます。

  3. 次のフィールドに入力します。

    フィールド 使用する値
    エンドポイントにどのような名前を付けますか。 listFiles
    B2B取引パートナ・モード このチェックボックスは選択しないでください。

  4. 「Continue」を選択します。

  5. 「操作の選択」ドロップダウン・リストから、「ファイルのリスト」を選択します。

  6. 次のフィールドに入力します。

    フィールド 使用する値
    入力ディレクトリ /

    この値はプレースホルダーです。 後で、スケジュール済パラメータをそれにマップします。

    ファイル名パターン *.csv
    最大ファイル数 デフォルト値のままにします。
    最低年齢 デフォルト値のままにします。
    再帰的にファイルをリスト このオプションの選択を解除します。
    ファイル権限の無視 このオプションを選択解除したままにします。

  7. 「Continue」を選択します。

  8. 設定を確認し、「終了」を選択します。

リモートFTPサーバーへのコールの作成が終了しました。 この呼び出しは、特定のディレクトリ内のファイルを一覧表示します。

「起動」アクションの前に、マップ・アクションがキャンバスに表示されます。


キャンバスには3つのアクションが含まれます: スケジュール、マップおよび起動。

ヒント:

キャンバス上でアクションを水平に表示するには、ツールバーで「水平」 水平レイアウト・アイコンを選択します。

ステップ3. 統合のスケジュールから起動アクションにフォルダを渡します

起動アクションを定義しました。今度は、マップ・アクションを使用してディレクトリを動的に渡します。

  1. キャンバスで、「マップ」アクションをポイントし、...を選択し、「編集」を選択します。

    マッパーが表示されます。

  2. 左側の「ソース」リストで、構成した2つのパラメータを確認: directoryおよびfile_pattern。

  3. 右側の「ターゲット」リストで、「リスト・リクエスト」を展開し、「FTPリスト・ヘッダー」を展開します。

  4. 「ソース」リストで、directoryを選択し、「ターゲット」リストの「ディレクトリ」エントリにドラッグします。

  5. 「ソース」リストで、file_patternを選択し、「ターゲット」リストの「ファイル名パターン」エントリにドラッグします。


    マッパーでは、ディレクトリがディレクトリに接続され、file_patternがファイル名パターンに接続されます

  6. 「検証」を選択し、<を選択してキャンバスに戻ります。

  7. 変更を保存します。

ここで、統合のトリガーを使用してディレクトリをinvokeアクションに動的に渡します。

ステップ4. ファイルをループし、一度に1つずつ処理

統合は、起動アクションが返すすべてのファイルをループ処理する必要があります。 統合では、アクションごとに1つずつファイルを処理します。

  1. インテグレーションに各アクションを追加します:

    1. 「起動」ボックスの外にある矢印をポイントし、+を選択します。

    2. ポップアップで、「アクション」タブを選択します。

    3. スクロールして、「各」を選択します。

      「対象」の各アクションがキャンバスに表示され、「それぞれの構成」パネルが表示されます。

    4. パネルで、「編集」 「編集」アイコンを選択し、次のフィールドに入力します。

      フィールド 使用する値
      名前 ForEachFileFound

    5. 式の保存アイコンを選択します。

    6. 「入力ソース」パネルで、$listFiles、ListFileResponse、ListResponse、FileList、「ファイル」の順に展開します。

      「ファイル」は、各ファイルのプロパティをリストします。

    7. 「ファイル」エントリを「繰返し」要素フィールドにドラッグします。

      ファイルは、各ループが繰り返す要素です。

    8. 「現在のエレメント名」で、currentFileDetailsと入力します。

      これは、統合がループ内のファイル要素を参照するために使用する名前です。

    9. キャンバス内の任意の場所を選択して、パネルを閉じます。

  2. 各ループが各ファイルをどのように処理するかを指定します。

    最初のアクションはファイルをダウンロードします。

    1. キャンバスで、「For each action」のボックスで、+を選択します。

    2. 検索フィールドで、「仕入先」と入力し、前提条件タスクとして作成したSupplier_FTP接続を選択します。

      この接続により、FTPサーバーに接続できます。

    3. 次のフィールドに入力します。

      フィールド 使用する値
      エンドポイントにどのような名前を付けますか。 downloadFile
      B2B取引パートナ・モード このオプションを選択解除したままにします。

    4. 「Continue」を選択します。

    5. 次のフィールドに入力します。

      フィールド 使用する値
      操作の選択 「ファイルのダウンロード」を選択します。
      転送モードの選択 「バイナリ」を選択したままにします。
      入力ディレクトリ このフィールドは空白のままにします。 後で、マッパーを使用してこのフィールドを動的に移入します。
      ファイル名 このフィールドは空白のままにします。 後で、マッパーを使用してこのフィールドを動的に移入します。
      ダウンロード・ディレクトリ /stage/files

      これは、ダウンロードしたファイルを一時的に格納するOracle Integration内のロケーションです。

      ページのチェックボックス

      すべてのチェックボックスを選択解除したままにします。

    6. 「Continue」を選択します。

    7. 設定を確認し、「終了」を選択します。

    キャンバスに戻ります。 構成した「Invoke」アクションが「For」アクション内に表示され、その前に「Map」アクションが表示されます。 起動アクションは、ファイルをダウンロードし、一時的なロケーションに格納します。


    キャンバスには4つのアクションが含まれます: スケジュール、マップ、起動、およびそれぞれ。 それぞれに2つのアクションが含まれます: マップおよび呼出し。

  3. 関連するデータをInvokeアクションに渡します。

    このアクションにより、統合によって検出された各ファイルのループ内で、そのファイルがローカル・ステージング領域にダウンロードされます。

    1. 各アクションで、「マップ」アクションをポイントし、...を選択し、「編集」を選択します。

      マッパーが開きます。

    2. 左側の「ソース」リストで、CurrentFileDetailsを展開し、「ファイル」を展開します。

      コンテナには、ディレクトリ内のファイルのリストを収集したときから返された現在のファイルに関する情報が保持されます。

    3. 右側の「ターゲット」リストで、「リクエストのダウンロード」を展開します。

      このコンテナには、ファイルのダウンロード用に定義したアクションに関する情報が保持されます。

    4. 「ソース」リストで、「ディレクトリ」を選択し、「ターゲット」リストの「ディレクトリ」エントリにドラッグします。

    5. 「ソース」リストで、「ファイル名」を選択し、「ターゲット」リストの「ファイル名」エントリにドラッグします。


      マッパーでは、ディレクトリがディレクトリに接続され、ファイル名がファイル名に接続されます

    6. 「検証」を選択し、<を選択してキャンバスに戻ります。

    7. 変更を保存します。

ステップ5. ファイルを「ファイル・サーバー」に書き込みます

forループは、ファイルを一度に1つずつ処理します。 ファイルの処理後、統合によってファイルが「ファイル・サーバー」に書き込まれます。

  1. キャンバスの右側にある垂直ツールバーで、統合アクション・アイコンを選択し、「ファイル・サーバー」エントリを見つけます。

  2. 「ファイル・サーバー」エントリを、「各」アクション内の「起動」アクションに表示される+にドラッグします。

    このパネルでは、インテグレーションにアクションを追加する別の方法が提供されます。


    マウス・カーソルによって、「For each」ボックス内の「Invoke」アクションにある+にアクションがドロップされます

    「For each action」にファイル・サーバー・アクションが表示され、「FSネイティブ処理の構成」パネルが表示されます。

  3. 次のフィールドに入力します。

    フィールド 使用する値
    エンドポイントにどのような名前を付けますか。 writeFileToFileServer
    リソースの選択 ファイルを選択します。
    操作の選択 「ファイルの書込み」を選択します。
    出力ディレクトリの指定 /inbound/supplier/invoices

    これは、ファイルを「ファイル・サーバー」に書き込むディレクトリです。

    ファイル名 file.txt

    後で、マッパーでこの値を上書きします。 ファイル名をリストするときに取得したファイル名を使用します。

  4. 「Continue」を選択します。

  5. 設定を確認し、「終了」を選択します。

    キャンバスに戻ります。 構成したファイル・サーバー・アクションが「For each」アクション内に表示され、その前にマップ・アクションが表示されます。 ファイル・サーバー・アクションは、ファイルを「ファイル・サーバー」に書き込みます。


    キャンバスには4つのアクションが含まれます: スケジュール、マップ、起動、およびそれぞれ。 それぞれに4つのアクションが含まれます: マップ、起動、マップおよびファイル・サーバー。

    次に、書き込むファイルの名前とファイル自体をファイル・サーバー・アクションに渡す必要があります。

  6. 関連するデータをファイル・サーバーのアクションに渡します。

    1. 「ファイル・サーバー」アクションの前の「マップ」アクションを指し、...を選択し、「編集」を選択します。

      マッパーが開きます。

    2. 左側の「ソース」リストで、「downloadFileレスポンス(FTP)」、「ファイルをICSレスポンスにダウンロード」、「レスポンスのダウンロード」、「ICSファイル」、「ICSファイル」の順に展開します。

      要素は、FTPサーバーからファイルをダウンロードする操作の出力です。

    3. 右側の「ターゲット」リストで、「ファイル定義書込みリクエスト」を展開します。

      その子要素は、ファイル操作で受け入れられるプロパティです。

    4. 「ソース」リストで、「ファイル参照」を選択し、「ターゲット」リストの「ファイル参照」エントリにドラッグします。

      ステージング領域にダウンロードしたファイルの内容を統合のファイル・サーバー・アクションに渡します。

    5. 「ソース」リストの「ファイル参照」で、「プロパティ」を展開します。

    6. 「ソース」リストで、「ファイル名」を選択し、「ターゲット」リストの「出力ファイル名」エントリにドラッグします。

      ファイルの名前をファイル・サーバー・アクションに渡します。


      マッパーで、ファイル参照がファイル参照に接続され、ファイル名が出力ファイル名に接続されます

    7. 「検証」を選択し、<を選択してキャンバスに戻ります。

統合では、FTPサーバーからファイルのリストを取得し、ファイル・サーバー・アクションを使用してOracle Integrationの「ファイル・サーバー」にファイルを書き込みます。

ステップ6. 自分の行動を理解

統合でいくつかの重要なアクションを確認して、設計した統合を理解しましょう。

アクション 目的
スケジュール処理 オンデマンドまたはクロックで実行するスケジュール統合を作成しました。
アクションの起動 統合の最初のアクションは、FTPサーバーをコールしてディレクトリ内のファイルをリストすることです。 ディレクトリは、起動アクションより前のマップ・アクションを使用して指定します。
アクションごと 統合は、取得したファイルのリストにあるファイルをループします。 リスト内のファイルごとに、インテグレーションによって複数のアクションが実行されます。
  • アクションを起動: 統合によってファイルがダウンロードされます。
  • ファイル・サーバーの動作: 統合によって、ファイルがファイル・サーバーに書き込まれます。

さらに学ぶ

ファイルの暗号化および復号化など、ファイル・サーバー・アクションのすべてのオプションを確認するには、「Oracle Integration 3での統合の使用」の「ファイル・サーバー内のファイルとの対話」を参照してください。