オーケストレーションされた統合の起動接続の場合

機械翻訳について

オーケストレーションされた統合の起動接続の場合

次のページでは、オーケストレーションされた統合で「Fileアダプタ」起動接続を構成する方法について説明します。

基本情報ページ

基本情報パラメータを入力します。

要素説明

要素	説明
エンドポイントにどのような名前を付けますか。	他のユーザーが接続について理解できるようにわかりやすい名前を指定します。たとえば、`FileReadWriteConnection`です。名前に使用できるのは、英字、数字、アンダースコアおよびハイフンです。次のものは使用できません。スペース(たとえば、`My FTP Connection`) 特殊文字(`#;83&`または`righ(t)now4`など) マルチバイト文字
このエンドポイントでは何が行われますか。	必要に応じて、接続の職責の説明を入力します。たとえば: `この接続はファイルをディレクトリに転送します。`

エンドポイントにどのような名前を付けますか。

他のユーザーが接続について理解できるようにわかりやすい名前を指定します。たとえば、FileReadWriteConnectionです。名前に使用できるのは、英字、数字、アンダースコアおよびハイフンです。次のものは使用できません。

スペース(たとえば、My FTP Connection)
特殊文字(#;83&またはrigh(t)now4など)
マルチバイト文字

このエンドポイントでは何が行われますか。

必要に応じて、接続の職責の説明を入力します。たとえば: この接続はファイルをディレクトリに転送します。

起動操作ページ

「Fileアダプタ」操作プロパティを入力します。

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

ファイルの読取り: ファイルのロケーションからファイルを読み取ります。この操作では、単一のファイルを読み取ります。スキーマを選択していない場合は、最大1 GBのファイル・サイズがサポートされます。スキーマを選択した場合は、最大50 MBのファイル・サイズがサポートされます。
ファイルの書込み: 単一のファイルをターゲット・ファイル・サーバーに書き込みます。
ファイルのリスト: 入力ディレクトリ内のファイルの名前を一覧表示します。この操作は、データのないファイルのリストを返します。これは、Linuxでのlsコマンドの実行に似ています。
ファイルを移動: 同じターゲット・ファイル・サーバー上のあるロケーションから別のロケーションにファイルを移動します。
ファイルの削除: ファイル・サーバー上の単一ファイルを削除します。
ファイルのダウンロード: ステージング・アクティビティに使用するディレクトリを指定します。このディレクトリを使用して、大きなファイルを処理して処理します。この操作では、指定した論理ディレクトリに単一のファイルをダウンロードします。ファイル・サイズのサポートは最大1 GBです。

ノート:
複数のファイルを読取り/ダウンロードする場合は、次の統合パターンを使用します。
ファイル・リスト・ファイル(操作) > For Eachループ>ファイル読取りファイル(操作) >各ループの終了

次の表に、「Fileアダプタ」起動のOperationsページに表示される主な情報を示します。選択する操作に応じて、その操作に固有のさまざまなオプションとパラメータが表示されます。各表は特定の操作に対応しています。

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

ファイルの読取り

ノート:

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

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

要素	説明
入力ディレクトリ	読み取るファイルを含むディレクトリの名前。たとえば、`/tmp/Oracle/input`などです。
ファイル名	読み取るファイルの名前。名前は、マッパーによって提供されることもできます。最大50 MBのファイル・サイズがサポートされています。

ファイルの書込み

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

要素説明

要素	説明
Specify an Output Directory	ファイルを書き込むディレクトリ・パス。たとえば、`/tmp/Oracle/output`などです。
File Name Pattern	出力ディレクトリに転送するファイル名のパターン。 `%%`の中でパターンを使用します。たとえば、`Oracle%SEQ%ICS.txt`の場合、`Oracle1ICS.txt`、`Oracle2ICS.txt`のように、ファイルが順に作成されます。サポートされているファイル・パターンのリストは、情報アイコンをクリックしてください。ノート: これらのパターンを使用すると、メッセージが同時にファイル・システムに書き込まれたり、ファイルが別々のノードに書き込まれたりした場合にメッセージが失われます。ファイルが上書きされないようにするには、マッパーを使用してファイル名を明示的に割り当てます。 XPath関数を使用して、ファイル名が必ず一意になるようにすることもできます。
Append to Existing FileAppend to Existing File	選択した場合、既存のファイルの内容にファイルの内容が付加され、上書きされません。ノート: 「既存のファイルに追加」オプションを使用してレコード別にレコードを書き込むと、ネットワーク呼出しが多すぎて最終的にプロセスが遅くなります。かわりに、ステージング・ファイル・アクションを使用し、レコードをステージング・ディレクトリに書き込みます。すべてのレコードが書き込まれたら、ステージ・ファイル・アクションで「ファイルのリスト」オプションを使用し、「Fileアダプタ」オプションを使用してファイルをファイルのロケーションに転送します。この方法では、処理時間が短縮され、ファイル・サーバーへのコールが多すぎるのを防ぎます。複数の書き込み操作を行うか、またはfor-eachループで書き込み操作を使用して、連続した追加を実行している可能性があります。このシナリオでは、ファイル・サーバーが複数のノードまたはクラウド・サービスで実行されている場合、すべてのノード間でデータを即時に同期する必要があります。それ以外の場合、次のリクエストが別のノードに送られた場合、最終出力ファイルに矛盾があります。代わりに、データを同期させる時間を与えるために、追加の前後に待機アクティビティを配置することもできます。

Specify an Output Directory

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

File Name Pattern

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

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

Append to Existing FileAppend to Existing File

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

ノート:

「既存のファイルに追加」オプションを使用してレコード別にレコードを書き込むと、ネットワーク呼出しが多すぎて最終的にプロセスが遅くなります。かわりに、ステージング・ファイル・アクションを使用し、レコードをステージング・ディレクトリに書き込みます。すべてのレコードが書き込まれたら、ステージ・ファイル・アクションで「ファイルのリスト」オプションを使用し、「Fileアダプタ」オプションを使用してファイルをファイルのロケーションに転送します。この方法では、処理時間が短縮され、ファイル・サーバーへのコールが多すぎるのを防ぎます。
複数の書き込み操作を行うか、またはfor-eachループで書き込み操作を使用して、連続した追加を実行している可能性があります。このシナリオでは、ファイル・サーバーが複数のノードまたはクラウド・サービスで実行されている場合、すべてのノード間でデータを即時に同期する必要があります。それ以外の場合、次のリクエストが別のノードに送られた場合、最終出力ファイルに矛盾があります。代わりに、データを同期させる時間を与えるために、追加の前後に待機アクティビティを配置することもできます。

ファイルのリスト

要素	説明
入力ディレクトリ	読み取るファイルを含むディレクトリの名前。たとえば、`/tmp/Oracle/input`などです。
File Name Pattern	入力ディレクトリのファイルのリストに使用するワイルドカード・パターンを指定します。たとえば、`order*.csv`です。
最大ファイル数	リストされるファイル名の最大数。最大値は1000です。注意: ファイルのリスト操作は、最後に変更された時間に従ってソート順にファイル・リストを返します。 10を最大ファイル数として選択し、11番目のファイルの最後の変更時間が10番目のファイルと同じ場合は、11番目のファイルも追加されます。これは、タイムスタンプが異なるファイルを取得するまで続きます。たとえば、ディレクトリに15個のファイルがあり、最大ファイル数として10を選択したとします。 10番目、11番目、12番目、および13番目のファイルのタイムスタンプが同じ場合、リスト・ファイルは13個のファイルを返します。
最小経過時間	ファイルが表示される最小経過時間(秒単位)。たとえば、ファイルが最後に変更された時間が02:28:45 AMで、最小年齢が80秒と定義されている場合、ファイルは02:29:00 AMと02:30:00 AMに表示されません。 02:30:05の後に掲載されます。
ファイルを再帰的に処理	ディレクトリ内のファイルを入力ディレクトリの下に再帰的にリストします。

ファイルを移動

要素	説明
ディレクトリ・パス	移動するファイルを含むディレクトリの名前。たとえば、`/tmp/Oracle/input`などです。
ファイル名	移動されるファイルの名前。移動するファイルのサイズに制限はありません。
ターゲット・ディレクトリ・パス	ファイルを移動するディレクトリの名前。
ターゲット・ファイル名	ターゲット・ディレクトリに書き込まれるファイルの名前。
ファイルの上書き	ターゲット・ディレクトリのファイルを上書きする場合に選択します。

ファイルの削除

要素	説明
ディレクトリ・パス	削除するファイルへのディレクトリ・パス。
ファイル名	削除するファイルの名前。

ファイル・ダウンロード

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

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

要素説明

要素	説明
入力ディレクトリ	読み取るファイルを含むディレクトリの名前を指定します。たとえば、`/tmp/Oracle/input`などです。
ファイル名	ダウンロードするファイルの名前。これは、マッパーを使用してオーバーライドすることができます。
ダウンロード・ディレクトリ	ステージ・ファイル操作に使用されるディレクトリの名前。「ステージ・ファイル操作によるスケジュールされた統合におけるファイルの処理」を参照してください。ディレクトリ・パスを二重引用符で囲んで入力しないでください。引用符は誤ってディレクトリ名の一部として含まれています。

入力ディレクトリ

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

ファイル名

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

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

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

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

スキーマの起動ページ

スキーマ・プロパティを入力します。

要素	説明
ファイルの内容の構造を指定しますか?	Yes: ファイルの転送に使用するスキーマ形式を定義する場合に選択します。このオプションを使用すると、最大50 MBのファイルを読み書きできます。 No: スキーマが不要で、ファイルを添付ファイルとして送信する場合に選択します。サーバーとの間で大きなファイルをストリーミングする場合は、通常、いいえを選択します。このオプションを使用すると、最大1 GBのファイルを読み書きできます。
次の選択肢の中のどれをファイル・コンテンツの構造の説明に使用しますか。	オプションを選択します。サンプル区切り文書(CSVなど): コンマ区切り値(CSV)ファイルから新しいスキーマ・ファイルを作成する場合に選択します。このウィザードの後続のページで、スキーマの作成元となるCSVファイルの選択が求められます。 XMLスキーマ(XSD)文書: 既存のスキーマ・ファイルを選択します。このウィザードの後続のページで、既存のスキーマ(XSD)ファイルをファイル・システムから選択することが求められます。 Oracle Integrationの外部で作成されたネイティブ以外のスキーマをアップロードすることもできます。「XSDファイルの機能」を参照してください。 XMLドキュメントのサンプル(名前空間の単一または非): ペイロードにサンプルのXMLコンテンツを提供する場合に選択します。サンプルJSONドキュメント: ペイロードにJSONコンテンツのサンプルを提供する場合に選択します。

要素

説明

ファイルの内容の構造を指定しますか?

Yes: ファイルの転送に使用するスキーマ形式を定義する場合に選択します。このオプションを使用すると、最大50 MBのファイルを読み書きできます。
No: スキーマが不要で、ファイルを添付ファイルとして送信する場合に選択します。サーバーとの間で大きなファイルをストリーミングする場合は、通常、いいえを選択します。このオプションを使用すると、最大1 GBのファイルを読み書きできます。

次の選択肢の中のどれをファイル・コンテンツの構造の説明に使用しますか。

オプションを選択します。

サンプル区切り文書(CSVなど): コンマ区切り値(CSV)ファイルから新しいスキーマ・ファイルを作成する場合に選択します。このウィザードの後続のページで、スキーマの作成元となるCSVファイルの選択が求められます。
XMLスキーマ(XSD)文書: 既存のスキーマ・ファイルを選択します。このウィザードの後続のページで、既存のスキーマ(XSD)ファイルをファイル・システムから選択することが求められます。 Oracle Integrationの外部で作成されたネイティブ以外のスキーマをアップロードすることもできます。

「XSDファイルの機能」を参照してください。
XMLドキュメントのサンプル(名前空間の単一または非): ペイロードにサンプルのXMLコンテンツを提供する場合に選択します。
サンプルJSONドキュメント: ペイロードにJSONコンテンツのサンプルを提供する場合に選択します。

XSDファイルの機能

アダプタは、ターゲット・ネームスペースのないXSDファイルのアップロードをサポートしています。このような場合、XSDファイルにサロゲート名前空間が追加され、すべてのメッセージが使用されます:
```
http://xmlns.oracle.com/cloud/adapter/nxsd/surrogate
```

アダプタは、他のXSDをインポートおよび含めることができる複雑なXSDをサポートしています。 ZIPファイルに含まれているXSDは、HTTPロケーションからXSDをインポートできます。アダプタ・エンドポイント構成ウィザードで読取りおよび書込み操作用にアダプタを構成する場合は、すべてのXSDファイルをZIPファイルに追加してアップロードする必要があります。

次の例では、アップロードするZIPファイルの階層は次のとおりです:

zipxsd.zip
  first.xsd
  second (folder)
    second.xsd

first.xsdはsecond.xsdをインポートします。

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" 
xmlns:tns="http://xmlns.oracle.com/first" 
targetNamespace="http://xmlns.oracle.com/first" 
      xmlns:tns1="http://xmlns.oracle.com/second"> 
<xs:import schemaLocation="./second/second.xsd" 
targetNamespace="http://xmlns.oracle.com/second"/>
<xs:import schemaLocation="https://example.com/fscmService/ItemServiceV2?
XSD=/xml/datagraph.xsd" targetNamespace="commonj.sdo"/>
<xs:element name="book"> 
  <xs:complexType> 
    <xs:sequence> 
      <xs:element name="isbn" type="xs:string"/>
      <xs:element name="title" type="xs:string"/> 
      <xs:element name="author" type="tns1:author"/> 
    </xs:sequence> 
  </xs:complexType>  
</xs:element> 
</xs:schema>

second.xsdの内容は次のとおりです。

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" 
xmlns:tns="http://xmlns.oracle.com/second" 
targetNamespace="http://xmlns.oracle.com/second"> 
<xs:import schemaLocation="https://example.com/fscmService/ItemServiceV2?
XSD=/mycompany/apps/scm/productModel/items/itemServiceV2/ItemAttachment.xsd" 
targetNamespace="http://xmlns.oracle.com/apps/scm/productModel/items/itemServiceV2/"/>
<xs:complexType name="author">
    <xs:sequence> 
       <xs:element name="name" type="xs:string"/>  
       <xs:element name="address" type="xs:string"/> 
    </xs:sequence> 
</xs:complexType> 
<xs:element name="Admin">
    <xs:complexType>
          <xs:sequence>
             <xs:element name="AdminName" type="xs:string"/>
             <xs:element name="AdminAdd" type="xs:string"/>
          </xs:sequence>
    </xs:complexType>
</xs:element>
</xs:schema>

ノート:

HTTPSのロケーションからインポートする場合は、必ずSSL証明書をOracle Integrationにインポートしてください。

ファイルの内容 - 定義ページ

フォーマット定義パラメータを入力します。

フォーマット・コンテンツに表示されるフィールド - 定義ページは、スキーマ・ページでの選択内容によって決まります:

ノート:

トリガー(インバウンド)方向でアダプタを構成する場合、スキーマの選択はサポートされません。 Basic InfoページでYesを選択してエンドポイントのスキーマを定義しても、Format Contents - 定義ぺージでスキーマをアップロードできます。ただし、このスキーマは使用されません。添付ファイルとしてファイルを転送するには、Basic Infoページで「No」を選択する必要があります。
アダプタは、オーケストレートされた統合の起動接続としてのみ構成できます。

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	文字セットを選択します。選択した値は、サンプル・データ・ファイルを読み取るときに、エンコーディング・フォーマットとして使用されます。このフィールドは、ファイル転送中の文字エンコーディングに使用されます。アダプタに送信されるデータが特定のエンコーディング形式の場合は、アダプタで同じエンコーディング形式を選択します。それ以外の場合は、最終的に書き込まれたファイルに文字が失われることがあります。これによりファイルも破損します。たとえば、RESTアダプタがUTF-8エンコーディングを使用しており、アダプタがASCIIキャラクタ・セットで構成されている場合、ファイルが破損する可能性があります。アダプタで同じUTF-8エンコーディングを選択すると、問題は解決します。
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つのレコード列として扱われます。「囲み文字(オプション)」を使用する場合、その文字をフィールドの一部にすることはできません。したがって、次の項目は無効です: `a,b",c` (このシナリオでは、`"`が2つ目のフィールドの一部です) `a,"b,c",d` (このシナリオでは、「囲み文字(オプション)」 (`'"'`)を使用して2つ目のフィールドが作成されます。ただし、2つ目のフィールド値のコンテンツは`','`です。)
終了者	選択したCSVファイルの最初の行をデフォルトで列ヘッダーとして表示します。行の終わりを終了するオプションを選択します。 ${eol} \n \r\n \r
連結解除	CSVファイルを個別のウィンドウで編集する場合に選択します。
最初の行を列ヘッダーとして使用	最初の行を列ヘッダーとして使用する場合に選択します。
Mark All As Optional	スキーマ・ファイル内で選択して要素をオプションとしてマーク付けします。デフォルトでは、すべての要素が必須です。表の各列で使用するデータ型(string、byte、integerなど)を選択して、特定の要素をオプションとしてマーク付けすることもできます。このオプションを使用して、すべての要素をオプションとすることもできますが、このページを検証するには少なくとも一つの必須要素が必要です。このチェックボックスは、要素の大部分をオプションとして選択するのに便利な方法を提供しています。

ファイル・システムから既存のXMLスキーマまたはスキーマ・アーカイブを選択します

スキーマ・アーカイブには、ネストされた入力を持つ単一の最上位スキーマを含めることができ、絶対パスまたは相対パスを含む要素を含めることができます。

要素	説明
ファイルを選択します	使用する既存のスキーマ・ファイルを選択します。
Selected File Name	選択したスキーマ・ファイル名が表示されます。
Select the Schema Element	スキーマ要素を選択します。このフィールドは、スキーマ・ファイルが選択された後で表示されます。要素名は、アップロードされたスキーマ・ファイルのルート要素として処理されます。

ファイル・システムからサンプルXMLドキュメントを指定します

XMLドキュメントには、ネームスペースまたは単一のネームスペースのみを含めないでください。

要素	説明
ファイルを選択します	使用する既存のXMLドキュメントを選択します。
Selected File Name	選択したスキーマ・ファイル名が表示されます。
Select the Schema Element	スキーマ要素を選択します。このフィールドは、スキーマ・ファイルが選択された後で表示されます。要素名は、アップロードされたスキーマ・ファイルのルート要素として処理されます。

ファイル・システムからサンプルJSONドキュメントを指定します

要素	説明
ファイルを選択します	使用する既存のJSONファイルを選択します。
Selected File Name	選択したファイル名が表示されます。
Select the Schema Element	スキーマ要素を選択します。このフィールドは、スキーマ・ファイルが選択された後で表示されます。要素名は、アップロードされたスキーマ・ファイルのルート要素として処理されます。

サマリー・ページ

指定したアダプタ構成値は、Summaryページで確認できます。

要素	説明
サマリー	ウィザードのそれまでのページで定義した構成の値のサマリーが表示されます。表示される情報は、アダプタによって異なる場合があります。一部のアダプタでは、選択したビジネス・オブジェクトおよび操作名が表示されます。生成されたXSDファイルが提供されるアダプタの場合は、XSDリンクをクリックしてそのファイルの読取り専用バージョンを表示します。前のページに戻って値を更新するには、左側のパネルの適切なタブ、または「戻る」をクリックします。構成の詳細を取り消すには、「取消」をクリックします。