ファイルアダプタ構成時の制限事項

[アーティクル]
07/21/2023

ファイルアダプターを使用する場合の制限事項と規則。

ファイルマスクとファイル名の取得

ファイルマスクは、ファイル受信ハンドラが受信場所から取得するファイルの種類を指定する文字列です。ファイル名は、ファイル送信ハンドラがメッセージを書き込むファイルの名前を指定する文字列です。

ファイル名およびファイルマスクのプロパティには、次の制限が適用されます。

各受信場所または送信ポートに指定できるファイルマスクまたはファイル名は 1 つだけです。
ファイルマスクまたはファイル名と共に完全パスまたはパスの一部を使用することはできません。ファイルマスクおよびファイル名は、常にパスを除いた名前を表します。
ファイルマスクとファイル名では、大文字と小文字が区別されません。
ファイル名には、次の文字を含めることはできません: <> : / |" ? * ;
ファイルマスクには、次の文字を含めることはできません: <> : / |" ;
予約されたデバイス名 (CON、PRN、AUX、CLOCK$、NUL、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、および LPT9) は、ファイル名として使用できません。また、これらの名前を拡張子と組み合わせて使用することはできません。
Windows ディスクボリュームでは、既定で 8.3 (8dot3) の名前付け規則が使用され、短いファイル名と長いファイル名が使用されます。システム以外のディスクボリュームでは、8dot3 の名前付け規則が無効になり、長いファイル名のみが使用されます。

8dot3 が有効になっている場合、ファイルとそのファイル拡張子は短い名前に変換されます。たとえば、 testabcdefgh.docx はに testab~1.doc変換されます。ファイル名が短縮され、ファイル拡張子がから .docx に短縮されていることに doc注意してください。

この動作は、ファイルアダプターがファイルを受け取る方法に影響します。ファイルマスクがに *.xml設定されている場合、拡張子と拡張子の両方 *.xml に *.xmln 一致するファイルが取得されます。

ディスクで 8dot3 名前付け規則が有効になっているかどうかを確認するには、管理者としてコマンドプロンプトを開き、「」またはfsutil 8dot3name query d:「」などと入力fsutil 8dot3name query c:します。サンプル出力は次のようになります。
```
C:\WINDOWS\system32>fsutil 8dot3name query c:
The volume state is: 0 (8dot3 name creation is enabled).
The registry state is: 2 (Per volume setting - the default).

Based on the above two settings, 8dot3 name creation is enabled on c:
```
ファイルアダプターは FindFirstFile 関数を使用します。この関数には、短いファイル名と長いファイル名を持つ検索結果が含まれます。フォルダー内の短いファイル名と長いファイル名を表示するには、コマンドプロンプトを開き、フォルダーに移動して、「」と入力します dir /x。コマンドプロンプトで、「」と入力 dir c:\foldername /xすることもできます。

ボリュームの 8dot3name 設定を変更した場合、新しいファイルでは新しい設定が使用されます。既存のファイルは、移動されるまで名前を保持します。

目的のファイルのみを取得し、高負荷時にパフォーマンスを向上 (オーバーヘッドを軽減) するには、8dot3name が無効になっているボリュームを使用するようにファイルアダプターを構成することをお勧めします。
ファイルパス、ファイルマスク、およびファイル名の長さの合計 (マクロによる代入を除く) は 256 文字以下にしてください (これは、メッセージボックスデータベースの制限です)。
ファイルパスを "\\?"で始めることはできません。
割り当てられたネットワークドライブ名は、ユーザーセッションに基づいているため、ファイルパスでは使用できません。

BizTalk メッセージングエンジンでは、上記の項目を使用して、デザイン時に常にファイル名およびファイルマスクのプロパティを検証します。また、ファイルアダプタでは、アダプタが動的ポートでメッセージを送信する場合、実行時にファイル名およびファイルマスクのプロパティを検証します。

注意

ファイルアダプタでは、システムファイルまたは読み取り専用のファイルは取得されません。ディスク上のファイルのみが取得され、デバイスファイルは取得されません。

ファイル名でのマクロの使用

一連の定義済みマクロを使用して、ファイル送信ハンドラがメッセージを書き込むファイルを、動的に作成できます。ファイルシステム上にファイルを作成する前に、ファイル送信ハンドラによって、ファイル名に含まれるすべてのマクロが個別の値に置き換えられます。 1 つのファイル名で複数の異なるマクロを使用できます。

ファイル名のマクロは、BizTalk エクスプローラーオブジェクトモデルを使用したファイル送信ハンドラーの構成時に使用できます。

次のいずれかの条件に当てはまる場合、ファイル送信ハンドラはマクロを値に置き換えません。

対応するシステムプロパティが設定されていない場合
マクロのスペルが間違っている場合
マクロの値に、ファイル名には無効な記号が含まれている場合

上記のいずれかの条件に当てはまる場合、ファイル送信ハンドラは、ファイル名に含まれるマクロを変更しません (例、Myfile_%MessageID%.xml)。

次の表は、サポートされているマクロと、ファイル送信ハンドラによってそのマクロがどのような形式に置換されるのかを示しています。

マクロ名	代入値
%datetime%	YYYY-MM-DDThhmmss 形式の協定世界時 (UTC) の日時 (例、1997-07-12T103508)。
%datetime_bts2000%	YYYYMMDDhhmmsss 形式の UTC 日時。sss は秒およびミリ秒を表します (たとえば、199707121035234 は 1997 年 7 月 12 日 10 時 35 分 23 秒 400 ミリ秒を表します)。
%datetime.tz%	ローカルの日時に GMT のタイムゾーンを加えた YYYY-MM-DDThhmmssTZD 形式の日時 (例、1997-07-12T103508+800)。
%DestinationParty%	送信先パーティの名前。この値は、メッセージコンテキストプロパティ BTS.DestinationPartyから取得されます。
%DestinationPartyQualifier%	送信先パーティの修飾子。この値は、メッセージコンテキストプロパティ BTS.DestinationPartyQualifierから取得されます。
%MessageID%	BizTalk Server 内のメッセージのグローバル一意識別子 (GUID)。値は、メッセージコンテキストプロパティ BTS から直接取得されます。MessageID。
%SourceFileName%	ファイルアダプタが読み取るメッセージが存在するファイルの名前。ファイル名には、拡張子は含まれますが、ファイルパスは含まれません (例、Sample.xml)。このプロパティを置き換えると、ファイルアダプターは FILE に格納されている絶対ファイルパスからファイル名を抽出します。ReceivedFileName コンテキストプロパティ。コンテキストプロパティに値がない場合 (たとえば、ファイルアダプター以外のアダプターでメッセージを受信した場合)、マクロは置換されず、そのままファイル名に残ります (たとえば、C:\Drop\%SourceFileName%) 。メモ：このマクロを正しく実装するには、出力メッセージが受信メッセージと同じメッセージであることが必要です。
%SourceParty%	ファイルアダプタが受信したメッセージの受信元パーティの名前。メモ：このマクロを正しく実装するには、出力メッセージが受信メッセージと同じメッセージであることが必要です。
%SourcePartyQualifier%	ファイルアダプタが受信したメッセージの受信元パーティの修飾子。メモ：このマクロを正しく実装するには、出力メッセージが受信メッセージと同じメッセージであることが必要です。
%time%	hhmmss 形式の UTC 時刻。
%time.tz%	ローカルの日付に GMT のタイムゾーンを加えた hhmmssTZD 形式の日付 (例、124525+530)。

受信フォルダーと宛先の場所のプロパティの概要

ファイルの受信場所は、ファイル受信ハンドラーで読み取るファイルが存在するファイルシステムまたはネットワーク共有上のフォルダーのパスを含む文字列です。ファイルの送信先は、ファイル送信ハンドラーで書き込むファイルが存在するファイルシステムまたはネットワーク共有上のフォルダーのパスを含む文字列です。

受信フォルダーおよび送信先のプロパティには、次の制限が適用されます。

ユーザーのプロパティを指定する場合、その時点でファイルシステムまたはネットワーク共有上のファイルパスが存在する必要はありません。
ファイルパスは、絶対パスである必要があります。
ファイルパスは、汎用名前付け規則 (UNC) 形式 (\\server>\<<share> など) を使用して指定できます。
ファイルパスが UNC 形式の場合、サーバー名には次の文字を含めてはなりません: ' ~ ! @ # $ ^ & * ( ) = + [ ] { } \ | ;: ' " 、 <> / ? ;
ファイルパスのどの部分にも親フォルダー記号 (\..\) および現在のフォルダー記号 (\.\) を使用できません。
ファイルパスでは、大文字と小文字が区別されません。
ファイルパスには、次の文字を含めることはできません: <> : / |" ? * ;
予約されたデバイス名 (CON、PRN、AUX、CLOCK$、NUL、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、および LPT9) は、ファイルパスでは使用できません。
ファイルパス、ファイルマスク、またはファイル名の長さの合計 (マクロでの代入を除く) は 256 文字以下にしてください (これはメッセージボックスデータベースの制限です)。
ファイルアダプターは、ファイルパスの Unicode 仕様 (たとえば、"\\?\") をサポートしません。

受信フォルダーのプロパティのみに、次の制限が適用されます。
受信フォルダーのプロパティには、シンボリックリンクのある Microsoft Windows NT の分散ファイルシステムを使用しているフォルダーを設定しないでください。 Windows NT の分散ファイルシステムを使用している場合、ファイルアダプターの受信場所には、直接的なネットワークパスのフォルダーのみを使用できます。
ドキュメントが UNC パスに送信され、ファイルアダプターの受信場所でサーバーが受信するドキュメントが複数ある場合、その UNC パスに送信されたドキュメントの大半は、1 台のサーバーのみで取得および処理されます。ファイル名の変更の詳細については、「ファイルアダプター」の「ファイル受信アダプター」セクションを参照してください。

送信フォルダーのプロパティのみに、次の制限が適用されます。
Microsoft Windows Vista など、サーバーでないオペレーティングシステムでファイルアダプターを実行している場合、すべてのメッセージを同時にバッチ処理するために必要なオペレーティングシステムリソースが不足する場合があります。

ファイルアダプターでは、上記のルールを使用して、デザイン時にファイルパスを検証します。さらに、ファイルアダプターを使用する動的ポート経由でメッセージを送信する場合、実行時にメッセージを検証します。

次の方法で共有

ファイルアダプタ構成時の制限事項

ファイルマスクとファイル名の取得

ファイル名でのマクロの使用

受信フォルダーと宛先の場所のプロパティの概要

フィードバック

その他のリソース

次の方法で共有

ファイル アダプタ構成時の制限事項

ファイル マスクとファイル名の取得

ファイル名でのマクロの使用

受信フォルダーと宛先の場所のプロパティの概要

フィードバック

その他のリソース

ファイルアダプタ構成時の制限事項

ファイルマスクとファイル名の取得