機械翻訳について

ステージ・ファイル・アクションとのスケジュール統合でのファイルの処理

ステージ・ファイル・アクションを使用して、スケジュール統合でファイルまたはファイル参照を処理できます。 ステージ・ファイル・アクションでは、FTPアダプタによってダウンロードされた各ファイルを処理できます。 ステージ・ファイル・アクションでは、Oracle Integrationに認識されているステージングされたロケーションにあるファイルの読取り(およびトレーラの削除)、書込み、zip、解凍、暗号化、復号化およびリストを行うことができます。

ステージ・ファイル・アクションは、トレーラを読み取ったり、参照先ファイルをステージング・ロケーションで解凍したりすることもできます。 ステージ・ファイル・アクションは、アダプタの機能に類似しています。 ただし、アダプタとは異なり、ステージング・ファイル・アクションを使用するために接続を作成する必要はありません。 ステージ・ファイル・アクションには、資格証明プロパティおよびセキュリティ・ポリシーがありません。 ステージング・ファイル・アクションは、読取りおよび書込み操作のファイル形式を定義できるという点で、FileアダプタおよびFTPアダプタとは異なります。 ステージ・ファイル・アクションでファイルや添付を処理または処理するには、Oracle Integrationで使用できる必要があります。 FTPアダプタでダウンロード操作を使用するか、マルチパートまたはMTOMアタッチメントを返すSOAP/REST APIを使用して、Oracle Integrationでファイルを使用可能にします。 Oracle Integrationフローは、RESTアダプタを使用してRESTエンドポイントとして公開され、マルチパート・アタッチメントを受け入れるためのインタフェースを公開すると、リクエストがエンドポイントにポストされると、Oracle Integrationにファイルが自動的にステージングされます。

たとえば、次のように統合にステージ・ファイル・アクションを含めることができます:

  • 次の設定を使用してFTPアダプタを構成します:

    • 「ファイルのダウンロード」操作

    • 「ファイルの解凍」オプション

    • 入力ディレクトリとダウンロード・ディレクトリ・パス

  • ZIPファイルには複数のファイルが含まれている可能性があるため、FTPアダプタの後にfor-eachアクションを構成して、繰返し要素を反復します。

  • 入力ディレクトリから各ファイルを読み取るには、次のように入力ディレクトリから各ファイルを読み取るために、for-eachアクションの後にステージ・ファイル・アクションを構成します:

    • 式ビルダーで、ファイルの読取り元のファイル名およびディレクトリを指定します。

    • データ構造を含むカンマ区切り値(CSV)ファイルをロードして、スキーマ・ファイルを指定します。

ノート:

  • スキーマ名に特殊文字を使用しないでください(#など)。 そうしないと、統合のアクティブ化が失敗します。

  • ステージ・ファイル・アクションは、.zipファイル形式のみをサポートしています。 たとえば、入力ファイルが.gz形式の場合、Oracle Integrationはファイルの内容を解凍または読み取ることができません。

ファイル参照の処理

ファイル全体の読取り、セグメントのファイルの読取りまたはファイルの解凍を選択すると、プロセスへのファイル参照を指定できます。

この機能には、次の利点があります:

  • ファイル参照を提供するアップストリーム操作を処理します。 たとえば、RESTアダプタ接続を使用すると、アタッチメントをアタッチメント・フォルダにダウンロードできます。 RESTアダプタにはファイル参照が用意されていますが、ファイル名またはディレクトリが指定されていません。 ステージ・ファイル・アクションは、これら両方のオプションを提供します。

    次の操作はファイル参照を提供します:

    • アタッチ参照(RESTアダプタ・アタッチ)

    • ストリーム参照(RESTアダプタ起動レスポンス)

    • MTOM (SOAPアダプタの場合は接続レスポンスを起動します)

    • FileReference (FTPアダプタの場合)

  • 暗号化されたコンテンツを処理するための前提条件を提供します。 これは、他のアダプタが復号化操作を複製する必要がないことを意味します。

  • コンテンツを後処理操作として暗号化します。 このため、他のアダプタでは暗号化操作を複製する必要はありません。

ローカル・ファイルの作成

ローカル・ファイルの動作については、次の点に注意してください:

  • ローカルOracle Integrationフォルダは、統合内からステージ・ファイル書込み操作を使用してのみ作成できます。

  • 統合スコープ内では、そのファイルをさらに処理することができます。

  • 読み取り、書き込みなどのステージ・ファイル操作を使用すると、ファイルが使用可能なスコープ内の内容を読み取ることができます。

  • このファイルは、作成されたスコープ外には表示されません。

  • ステージング・ファイル書き込み関連の変数をマッピング操作で使用して、この仮想ファイルを指すことができます。

  • 統合がファイルの可視性の範囲外に移動すると、ローカル・ファイルが削除されます。

ステージ・ファイル・アクションの構成

「ステージ・ファイル」パネルでステージング・ファイル・アクションを構成できます。

アタッチ・エージェントのファイル/添付ファイル機能でステージ・ファイル・アクション操作を使用する場合の制限

「ステージ・ファイル」パネルでステージ・ファイル・アクションを構成する場合、接続エージェントでの一部の操作の使用には制限があることに注意してください。
  • ファイルのリスト操作: 接続エージェントを介してアップロードされたファイルは、ファイルのリスト操作では使用できません。
  • セグメント内のファイル全体の読取りおよびファイルの読取り操作: 接続エージェントを介してアップロードされたファイルは、ファイル参照を使用してのみ読み取ることができます。
  • Zipファイル操作: 接続エージェントを介してアップロードされたファイルは、Zipファイル操作では使用できません。
  • ファイルの解凍操作: 接続エージェントを介してアップロードされたファイルは、ファイル参照を使用してのみ解凍できます。

ステージ・ファイル・パネルのオープン

ノート:

異なるファイル形式およびレコード構造で作業している場合、ステージ・ファイル操作ではレコード構造を定義するスキーマ・ルート要素を共有できません。 異なるファイル形式およびレコード構造の解析中は、ターゲット・ネームスペースまたはルート要素名のいずれかが一意である必要があります。
  1. 次のいずれかの方法で、ステージ・ファイル・アクションを統合に追加します:
    • キャンバスの横にある「アクション」 統合アクション・アイコンをクリックし、「ステージ・ファイル」アクションを適切なロケーションにドラッグします。
    • ステージ・ファイル・アクションを追加するロケーションで「追加」アイコンをクリックし、「ステージ・ファイル」を選択します。

  2. 「基本情報」ページのフィールドに入力し、「続行」をクリックします。

    「構成操作」ページが表示されます。

ステージ・ファイル操作の構成

「構成操作」ページでは、実行するファイル操作を定義できます。 ファイル全体の読取り、チャンク化されたサイズのファイルの読取り、ファイルの解凍、ファイルの書込み、ファイルのzipまたはファイルのリストを選択できます。式ビルダーを使用して、操作の詳細を作成します。 式ビルダーには、これらの詳細を指定するためのすべてのアップストリーム・ソース(割当て、各アクションの呼出し、接続など)が表示されます。 「証明書をアップロード」ページで構成したPretty Good Privacy (PGP)認証キーを使用して、ファイルの暗号化および復号化を選択することもできます。 「外部サービスに接続するための証明書のアップロード」を参照してください。

  1. ドロップダウン・リストから、実行するステージ・ファイル操作を選択します。 ページがリフレッシュされ、選択に適したフィールドが表示されます。 一部のステージ・ファイル・アクション操作で接続エージェントを使用する場合、制限があります。 「アタッチ・エージェントのファイル/添付ファイル機能でステージ・ファイル・アクション操作を使用する場合の制限」を参照してください。

    全体ファイルを読む

    表7-1 - ファイル全体の読取り

    プロパティ 説明

    ファイル参照の構成

    • Yes: ファイル参照を提供するアップストリーム操作を処理する場合に選択します。 選択すると、ファイル参照を指定します。

    • No: ファイル名を処理する場合に選択します。

    ファイル参照の指定

    「ファイル参照の構成」に対してYesを選択すると表示されます。

    フィールドをクリックし、次のいずれかの方法でファイル参照を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    ファイル名を指定

    (「ファイル参照の構成」に対していいえを選択すると表示されます。)

    フィールドをクリックし、次のいずれかの方法でファイル名(/compress:schedule/compress:start Timeなど)を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。

    ノート: ファイル・サイズは10 MB未満にする必要があります。 10 MBを超えるファイルについては、「セグメント内のファイルの読み取り」の操作を使用してください。

    読み込むディレクトリを指定
    フィールドをクリックし、次のいずれかの方法でファイルの読取り元のディレクトリ(/compress:schedule/compress:start Timeなど)を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    トレーラの削除

    トレーラの削除、最後の行の削除、または最後のn行の削除を行わない場合に選択します。

    コンテンツの復号化

    チェック・ボックスを選択し、ファイルの復号化に使用するターゲットのロケーションの秘密キーを選択します。
    確認

    「コンテンツの復号化」を選択すると、「検証」チェック・ボックスが有効になり、名前が「コンテンツの検証」に変わります。

    復号化中に内容を検証するキーを選択します。

    1. 「コンテンツの検証」を選択します。
    2. 使用するキーをリストから選択します。

    使用するPGPキーは、「証明書」ページでアップロードします。 「外部サービスに接続するための証明書のアップロード」を参照してください。

    セグメント内のファイルの読み取り

    このオプションを使用すると、セグメント(チャンク)内のファイルを読み取ることができます。 チャンク・ファイルを使用すると、一度に1つの論理チャンクで大きなファイルを処理できます。 論理チャンク(セグメント)は巨大なファイルから取り出され、ファイルをメモリー制約内にとどめることができます。

    繰返し要素および複数のネームスペースを含む大規模なXMLファイルを読み取ることもできます。 ユースケースが提供されます。

    「複数のネームスペースを含む大規模なXMLファイルの読取り」を参照してください。

    ノート:

    • Oracle Integration 3の推奨セグメント・サイズは、セグメント当たり2000レコードです(構成可能)。 Oracle Integration Generation 2統合(固定セグメント・サイズが200)がOracle Integration 3で初めてオープンされると、セグメント・サイズのデフォルトは2000になります。 必要に応じて、要件に基づいてこの値を変更します。

    • 「セグメント内のファイルの読み取り」操作を選択した場合、不透明またはJSONスキーマは指定できません。 その場合は、次のランタイム・エラーが表示されます: 
      NXSD has infinite loop.
Flow has bad NXSD or bad input file which is causing infinite loop.
Either NXSD is not designed properly or input file is not compatible with
NXSD. Processing of file at stage read was not advancing and looping at same
location in input file.
Please download ICS flow and review NXSD file or inspect input file to ensure
there are no infinite loop.
Stage Read Failed

    表7-2 - セグメント内の読取りファイル

    プロパティ 説明

    ファイル参照の構成

    • Yes: ファイル参照を提供するアップストリーム操作を処理する場合に選択します。

    • No: ファイル名を処理する場合に選択します。

    ファイル参照の指定

    「ファイル参照の構成」に対してYesを選択すると表示されます。

    フィールドをクリックし、次のいずれかの方法でファイル参照を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。

    ファイル名を指定

    (「ファイル参照の構成」に対していいえを選択すると表示されます。)

    フィールドをクリックし、次のいずれかの方法でファイル名を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。

    「セグメント内のファイルの読み取り」オプションは、スコープ部分を含むステージ・ファイル・アクションを作成します。 これにより、スコープ内のアクション(for-eachアクション、追加のstageファイル・アクションなど)をドラッグして、より複雑なシナリオを実現できます。

    読み込むディレクトリを指定
    フィールドをクリックし、次のいずれかの方法でファイルを読み取るディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    セグメント・サイズ

    セグメント・サイズを入力します。 セグメント・サイズは、セグメントごとに200レコードにデフォルト設定されますが、変更できます。 最小値は200レコードで、最大値は2000レコードです。 チャンク・ファイルを使用すると、一度に1つの論理チャンクで大きなファイルを処理できます。 論理チャンク(セグメント)は巨大なファイルから取り出され、ファイルをメモリー制約内にとどめることができます。

    順次処理

    セグメントを順番に読み取る場合に選択します。
    トレーラの削除

    トレーラの削除、最後の行の削除、または最後のn行の削除を行わない場合に選択します。

    ファイルの書込み

    ノート:

    • ステージ・ファイルに書き込む場合、ヘッダーの組込みサポートはありません。 ヘッダーを明示的にファイルに書き込むことで、ヘッダーを作成する必要があります。
    • 複数のステージ・ファイル・アクション書込み操作により、ループ内の同じステージ・ファイルにデータを追加すると、データが上書きされます。 これにより、データが失われます。

    表7-3 - ファイルの書込み

    プロパティ 説明
    ファイル名を指定
    フィールドをクリックし、次のいずれかの方法でファイル名を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    出力ディレクトリを指定
    フィールドをクリックし、次のいずれかの方法で出力ディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    Append

    オプションで、既存のファイルにレコードを追加することを選択します。

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

    マッパーでのファイル属性値の取得

    マッパー・レスポンスでファイルのsizeおよび「チェックサム」属性値を計算する場合は、このチェック・ボックスのみを選択します。 選択すると、ICSFileの下のレスポンス・マッパーで両方の属性が有効になります。 デフォルトでは、size属性と「チェックサム」属性はマッパー・レスポンスで無効になっています。これは、両方の属性の値を計算するとパフォーマンスが高くなるためです。

    暗号化 チェック・ボックスを選択し、ファイルの暗号化に使用するターゲットのロケーションの公開キーを選択します。
    Sign

    「暗号化」を選択すると、「署名」チェック・ボックスが有効になり、名前が「コンテンツに署名」に変わります。

    ファイルに署名するプライベートPGPキーを選択します。

    1. 「コンテンツに署名」を選択します。
    2. 使用するPGPキーをリストから選択します。

    使用するPGPキーは、「証明書」ページでアップロードします。 「外部サービスに接続するための証明書のアップロード」を参照してください。

    ZIPファイル

    表7-4 - Zipファイル

    プロパティ 説明
    ファイル名を指定
    フィールドをクリックし、次のいずれかの方法でファイル名を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    ディレクトリを指定して圧縮
    フィールドをクリックし、次のいずれかの方法で圧縮するディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    出力ディレクトリを指定
    フィールドをクリックし、次のいずれかの方法でZIPファイルの出力ディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    マッパーでのファイル属性値の取得

    マッパー・レスポンスでファイルのsizeおよび「チェックサム」属性値を計算する場合は、このチェック・ボックスのみを選択します。 選択すると、ICSFileの下のレスポンス・マッパーで両方の属性が有効になります。 デフォルトでは、size属性と「チェックサム」属性はマッパー・レスポンスで無効になっています。これは、両方の属性の値を計算するとパフォーマンスが高くなるためです。

    ファイルの解凍

    表7-5 - 解凍ファイル

    プロパティ 説明

    ファイル参照の構成

    • Yes: ZIPファイル参照を提供するアップストリーム操作を処理する場合に選択します。 選択すると、ファイル参照と、ファイルを解凍するディレクトリを指定します。

    • No: ZIPファイルを処理する場合に選択します。

    ファイル参照の指定

    「ファイル参照の構成」に対してYesを選択すると表示されます。

    フィールドをクリックし、次のいずれかの方法でファイル参照を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。

    ZIPファイル名を指定

    (「ファイル参照の構成」に対していいえを選択すると表示されます。)

    フィールドをクリックし、次のいずれかの方法で読み取るZIPファイル名を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    Zipファイル・ディレクトリを指定
    フィールドをクリックし、次のいずれかの方法でファイルを解凍するディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    解凍するディレクトリを指定
    フィールドをクリックし、次のいずれかの方法で解凍するディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    マッパーでのファイル属性値の取得

    マッパー・レスポンスでファイルのsizeおよび「チェックサム」属性値を計算する場合は、このチェック・ボックスのみを選択します。 選択すると、ICSFileの下のレスポンス・マッパーで両方の属性が有効になります。 デフォルトでは、size属性と「チェックサム」属性はマッパー・レスポンスで無効になっています。これは、両方の属性の値を計算するとパフォーマンスが高くなるためです。

    ファイルの暗号化

    表7-6 - ファイルの暗号化

    プロパティ 説明
    ファイル参照の指定
    フィールドをクリックし、次のいずれかの方法でファイル参照を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    ファイル名を指定
    フィールドをクリックし、次のいずれかの方法でファイル名を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    出力ディレクトリを指定
    フィールドをクリックし、次のいずれかの方法で出力ディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    マッパーでのファイル属性値の取得

    マッパー・レスポンスでファイルのsizeおよび「チェックサム」属性値を計算する場合は、このチェック・ボックスのみを選択します。 選択すると、ICSFileの下のレスポンス・マッパーで両方の属性が有効になります。 デフォルトでは、size属性と「チェックサム」属性はマッパー・レスポンスで無効になっています。これは、両方の属性の値を計算するとパフォーマンスが高くなるためです。

    ファイルを暗号化するPGPキーの指定 ファイルの暗号化に使用するターゲットのロケーションの秘密キーを選択します。 1 GBまでのサイズのファイルを暗号化できます。

    マッパーを使用する場合、暗号化はマッピングのために要素として表示されることに注意してください。
    コンテンツの署名 公開PGPキーを選択してファイルに署名します。
    1. チェック・ボックスを選択します。
    2. 暗号化中にファイルの署名に使用するPGPキーを選択します。

    使用するPGPキーは、「証明書」ページでアップロードします。 「外部サービスに接続するための証明書のアップロード」を参照してください。

    ファイルの復号化

    表7-7 - ファイルの復号化

    プロパティ 説明
    ファイル参照の指定
    フィールドをクリックし、次のいずれかの方法でファイル参照を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    ファイル名を指定
    フィールドをクリックし、次のいずれかの方法でファイル名を指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    出力ディレクトリを指定
    フィールドをクリックし、次のいずれかの方法で出力ディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    マッパーでのファイル属性値の取得

    マッパー・レスポンスでファイルのsizeおよび「チェックサム」属性値を計算する場合は、このチェック・ボックスのみを選択します。 選択すると、ICSFileの下のレスポンス・マッパーで両方の属性が有効になります。 デフォルトでは、size属性と「チェックサム」属性はマッパー・レスポンスで無効になっています。これは、両方の属性の値を計算するとパフォーマンスが高くなるためです。

    ファイルを復号化するPGPキーの指定 ファイルの復号化に使用するターゲット・ロケーションの秘密キーを選択します。 最大1 GBのサイズのファイルを復号化できます。

    マッパーを使用する際、復号化はマッピングのための要素として表示されることに注意してください。
    コンテンツの検証 PGPキーを選択してファイルを検証します。
    1. チェック・ボックスを選択します。
    2. 復号化中にファイルの検証に使用するPGPキーを選択します。

    使用するPGPキーは、「証明書」ページでアップロードします。 「外部サービスに接続するための証明書のアップロード」を参照してください。

    ファイルのリスト

    表7-8 - リスト・ファイル

    プロパティ 説明
    ファイルを一覧表示するディレクトリを指定
    フィールドをクリックし、次のいずれかの方法でファイルをリストするディレクトリを指定します:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。
    使用するファイル・パターンを指定

    出力ディレクトリに転送するファイル名のパターンを指定します。 サポートされているパターンのリストの?アイコンをクリックします。

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

    ファイルを再帰的にリストする場合に選択します。
    マッパーでのファイル属性値の取得

    マッパー・レスポンスでファイルのsizeおよび「チェックサム」属性値を計算する場合は、このチェック・ボックスのみを選択します。 選択すると、ICSFileの下のレスポンス・マッパーで両方の属性が有効になります。 デフォルトでは、size属性と「チェックサム」属性はマッパー・レスポンスで無効になっています。これは、両方の属性の値を計算するとパフォーマンスが高くなるためです。

  2. 完了したら、「続行」をクリックします。

    読取りまたは書込みステージ・ファイル操作を選択した場合、「スキーマ・オプション」ページが表示されます。

スキーマ・ファイルの定義

「スキーマ・オプション」ページでは、スキーマを定義できます。 このページは、ステージ・ファイルの読取りまたは書込み操作を選択した場合に表示されます。

  1. 次の詳細を入力します。

    プロパティ 説明
    ファイルの内容の構造を指定しますか?

    転送するファイルのスキーマ形式を定義する場合は「Yes」を選択します。 スキーマは不要で不透明なファイル(GIFまたはPNGファイルなど)を送信する場合は、「No」を選択します。

    ファイル内容の構造を記述するために、次のいずれかの選択肢が使用されますか?
    オプションを選択します。

    • サンプル区切りドキュメント(マージ。 CSV): CSVファイルから新しいスキーマを作成する場合に選択します。 このパネルの後続のページで、スキーマの作成元となるCSVファイルの選択が要求されます。

    • XMLスキーマ(XSD)ドキュメント: XMLスキーマ(XSD)ファイルから新しいスキーマを作成する場合に選択します。 ネストしたXMLスキーマ・ファイルを含むZIPファイルをアップロードできます。

    • サンプルXMLドキュメント(単一ネームスペースまたはネームスペースなし): 単一またはネームスペースなしのサンプルXMLファイルから新規スキーマを作成する場合に選択します。

    • サンプルJSONドキュメント: JSONファイルから新しいスキーマを作成する場合に選択します。 このオプションは、「全体ファイルを読む」または「ファイルの書込み」操作を選択した場合にのみ表示されます。

  2. 完了したら、「続行」をクリックします。

スキーマ形式の定義

「スキーマ・オプション」ページでの選択に基づいて、「フォーマット定義」ページでは、スキーマを作成するファイルを選択できます。 このページは、ステージ・ファイルの読取りまたは書込み操作を選択した場合に表示されます。

  1. 選択したスキーマ・オプションに基づいた指示に従います:

    ノート:

    Oracleは、ドキュメント化されていない注釈で手動で更新されたスキーマを証明しません。 これらのスキーマを指定する場合は、裁量を使用します。 たとえば、Oracle Integration 3でドキュメント化されておらず、動作保証されていない構造体で注釈が付けられたOracle SOA Suiteスキーマを使用すると、ランタイム・エラーが発生する可能性があります。

    • サンプル区切りドキュメント(CSVなど)(表7-9)

    • XML Schema (XSD)ドキュメント(表7-10)

    • サンプルXMLドキュメント(単一またはNameSpaceなし)(表7-11)

    • JSONドキュメントの例(表7-12)

    表7-9 - サンプル区切りドキュメント(CSVなど)

    要素 説明

    • Select the Delimited Data File

    スキーマ・ファイルを作成するカンマ区切り値(CSV)ファイルをドラッグ・アンド・ドロップします。 ファイルの内容がページの下部に表示されます。

    • Enter the Record Name

    レコード名を入力します。 これは、CSVファイルから列ヘッダーとして選択されたレコード名の作成済スキーマ・ファイルの親要素になります。

    • Enter the Recordset Name

    レコードセット名を入力します。 これは、作成済スキーマ・ファイルのルート要素になります。

    • Select the Field Delimiter

    次のサポートされているファイル・デリミタ・オプションからいずれかを選択します。

    • 単一の空白

    • カンマ

    • セミコロン

    • タブ

    • パイプ(たとえば、Name|City|Country)

    • Character Set

    文字セットを選択します。 選択した値は、サンプル・データ・ファイルの読取り中にエンコーディング形式として使用されます。

    • Optionally Enclosed By

    この値に指定した区切り文字が出現すると、処理中に無視されます。 たとえば、次のようなレコードを処理するとします。

    Fred,"2 Old Street, Old Town,Manchester",20-08-1954,0161-499-1718

    選択した「Field Delimiter」が","で、「Optionally Enclosed By」の値がquot; (")の場合、2 Old Street, Old Town,Manchesterの値は1つのレコード列として扱われます。

    • 最初の行を列ヘッダーとして使用

    デフォルトで、選択したCSVファイルの最初の行を列ヘッダーとして表示します。

    • 連結解除

    CSVファイルを別のウィンドウで編集する場合に選択します。

    • Mark All As Optional

    スキーマ・ファイル内で選択して要素をオプションとしてマーク付けします。 デフォルトでは、すべての要素が必須です。 表の各列で使用するデータ型(string、byte、integerなど)を選択して、特定の要素をオプションとしてマーク付けすることもできます。 このオプションを使用して、すべての要素をオプションとすることもできますが、このページを検証するには少なくとも一つの必須要素が必要です。 このチェックボックスは、大部分のエレメントをオプションとして選択する便利なメソッドです。

    表7-10 - XML Schema (XSD)ドキュメント

    要素 説明

    • Select a New File

    既存のXMLスキーマ・ファイルまたはスキーマ・アーカイブ・ファイルをファイル・システムからドラッグ・アンド・ドロップします。

    • Selected File Name

    選択したスキーマ・ファイル名が表示されます。

    • 要素名を選択してください

    スキーマ要素を選択します。 このフィールドは、XMLスキーマ・ファイルが選択された後に表示されます。 要素名は、アップロードされたスキーマ・ファイル内のルート要素として扱われます。

    • 繰返しバッチ要素の選択
    フィールドをクリックしてスキーマの繰返しノードを指定し、次のいずれかの方法でペイロード・チャンクをサポートします:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。

    表7-11 - サンプルXMLドキュメント(単一またはNameSpaceなし)

    要素 説明

    • Select a New File

    サンプルXMLドキュメントをファイル・システムからドラッグ・アンド・ドロップします。 ファイルには、名前空間または単一の名前空間が含まれていない必要があります。

    • Selected File Name

    選択したスキーマ・ファイル名が表示されます。

    • Select the Schema Element

    スキーマ要素を選択します。 このフィールドは、サンプルXMLファイルが選択された後に表示されます。 要素名は、アップロードされたスキーマ・ファイル内のルート要素として扱われます。

    • 繰返しバッチ要素の選択
    フィールドをクリックしてスキーマの繰返しノードを指定し、次のいずれかの方法でペイロード・チャンクをサポートします:
    • 手動入力。
    • リストから選択します。
    • 「開発者ビューにスイッチ」 ビューのスイッチアイコンをクリックして、「ソース」ツリーを開きます。

    表7-12 - サンプルJSONドキュメント

    要素 説明

    • Select a New File

    ファイル・システムからサンプルJSONドキュメントをドラッグ・アンド・ドロップします。

    • Selected File Name

    選択したスキーマ・ファイル名が表示されます。

    • Select the Schema Element

    スキーマ要素を選択します。 このフィールドは、JSONファイルが選択された後に表示されます。 要素名は、アップロードされたスキーマ・ファイル内のルート要素として扱われます。

  2. フィールドに入力し、「続行」をクリックします。

  3. 「サマリー」ページで選択内容を確認し、「終了」をクリックします。

統合キャンバスのステージ・ファイル・アクションの確認

設計が完了すると、ステージ・ファイル・アクションが統合キャンバスに表示されます。

  • 「セグメント内のファイルの読み取り」操作を使用してステージ・ファイル・アクションを設計した場合は、スコープ部分が作成されます。 アイコンの上にカーソルを置くと、セグメンテーション(チャンク)が有効であることを示すメッセージが表示されます。

    追加のアクションをステージ・ファイル・アクションのスコープ部分にドラッグして、タスクを実行できます。 たとえば、ステージ・ファイル・アクションにfor-eachアクションを追加して、大きなファイルのセグメント化されたチャンクを一度に1レコードずつ処理できます。 子ステージ・ファイル・アクションを追加して、各チャンクに対してさらに処理を実行することもできます。 ただし、子ステージ・ファイル・アクションで追加のチャンクを構成することはできません。


    　

    ノート:

    変数が、「セグメント内のファイルの読み取り」操作で構成され、ステージ・ファイルのアクション・ループ内で更新されたステージ・ファイル・アクションのループ外で宣言されている場合、その変数の最後に更新された値はループ外で使用できます。 そのような場合、並行性の問題を避けるためにDOP (並列度)を1に設定します。

  • 「セグメント内のファイルの読み取り」操作以外の操作を使用してステージ・ファイル・アクションを設計した場合、スコープ部分は含まれません。

統合設計を完了し、メッセージ内のフィールド(ファイル・ストレージ関連のパラメータを含む)をトラッキングするためのビジネス識別子を構成します。

関連ドキュメント
次の項では、統合でステージ・ファイル・アクションを使用する例を示します: