設定 FILE 配接器的限制
使用檔案配接器時的限制和規則。
檔案掩碼和檔名
檔案遮罩是一個字串，指定 FILE 接收處理常式從接收位置拾取的檔案類型。 檔案名稱是一個字串，指定 FILE 傳送處理常式寫入訊息的檔案名稱。
下列限制適用於檔案名稱和檔案遮罩屬性：
每個接收位置或傳送埠只能指定一個檔案遮罩或一個檔案名稱。
不允許完整路徑或部分路徑加上檔案遮罩或檔案名稱。 檔案遮罩和檔案名稱永遠代表不含路徑的名稱。
檔案遮罩和檔案名稱不區分大小寫。
檔名不能包含下列任何字元： <> / |" ? * ;
檔案遮罩不能包含下列任何字元： <> ： / |" ;
下列保留裝置名稱不能當做檔名使用：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 c:、 或fsutil 8dot3name query d:等等。 範例輸出如下所示：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 個字元。 (這是 MessageBox 資料庫的限制。)
檔案路徑不能以 “
\\？”開頭。對應的網路磁碟機代號不能用於檔案路徑，因為他們是以使用者工作階段為基礎。
「BizTalk 傳訊引擎」永遠會使用先前列示的項目，在設計階段驗證檔案名稱和檔案遮罩屬性。 此外，若配接器在動態連接埠上傳送訊息，FILE 配接器會在執行階段驗證檔案名稱和檔案遮罩屬性。
注意
FILE 配接器不會拾取系統檔案或唯讀檔案。 只會拾取硬碟的檔案，不會拾取裝置檔案。
在檔名中使用宏
您可以使用一組預先定義的巨集，以動態建立 FILE 傳送處理常式在其中寫入訊息的檔案。 在檔案系統上建立檔案之前，FILE 傳送處理常式會以其個別的值取代檔案名稱中的所有巨集。 您可以在一個檔案名稱中使用數個不同的巨集。
在使用 BizTalk 總管物件模型設定 FILE 傳送處理常式時，可以使用檔案名稱巨集。
若發生下列任何一種情況，FILE 傳送處理常式就不會以值取代巨集：
未設定對應的系統屬性。
巨集拼錯。
巨集的值包含檔案名稱中無效的符號。
若發生這些情況中的任何一項，FILE 傳送處理常式就會將檔案名稱中的巨集保留原狀，例如 Myfile_%MessageID%.xml。
下表列出支援的巨集，並描述 FILE 傳送處理常式如何取代它們。
| 巨集名稱 | 取代值 |
|---|---|
| %datetime% | Coordinated Universal Time (UTC) 日期時間格式為 YYYY-MM-DDThhmmss (例如，1997-07-12T103508)。 |
| %datetime_bts2000% | UTC 日期時間的格式為 YYYYMMDDhhmmsss，其中 sss 表示秒與毫秒 (例如，199707121035234 表示 1997/07/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% | FILE 配接器從中讀取訊息的檔案名稱。 檔案名稱包含副檔名但排除檔案路徑，例如 Sample.xml。 取代此屬性時，檔案配接器會從儲存在 FILE 中的絕對檔案路徑擷取檔名 。ReceivedFileName 內容屬性。 如果 context 屬性沒有值，例如，如果在檔案配接器以外的配接器上收到訊息，宏將不會取代，而且會保留在 (檔名中，例如 C：\Drop\%SourceFileName%) 。 注意： 這個宏的正確實作需要輸出訊息與收到的訊息相同。 |
| %SourceParty% | FILE 配接器從中接收訊息的來源合作對象名稱。 注意： 這個宏的正確實作需要輸出訊息與收到的訊息相同。 |
| %SourcePartyQualifier% | FILE 配接器從中接收訊息的來源合作對象辨識符號。 注意： 這個宏的正確實作需要輸出訊息與收到的訊息相同。 |
| %time% | UTC 時間的格式為 hhmmss。 |
| %time.tz% | 本地時間加上 GMT 的時區，格式為 hhmmssTZD (例如，124525+530)。 |
接收資料夾和目的地位置屬性
檔案接收位置是一個包含檔案系統或網路共用上之資料夾路徑的字串，而 FILE 接收處理常式會從此路徑讀取檔案。 檔案目的地位置是一個包含檔案系統或網路共用上之資料夾路徑的字串，而 FILE 傳送處理常式會從此路徑寫入檔案。
下列限制適用於接收資料夾和目的地位置屬性：
在您指定使用者中的屬性時，不需要有檔案系統或網路共用上的檔案路徑存在。
檔案路徑必須永遠是絕對路徑。
您可以使用通用命名慣例 (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 個字元。 (MessageBox 資料庫設有此限制。)
FILE 配接器不支援檔案路徑的 Unicode 規格 (例如，"\\?\")。
在接收配接器屬性上的限制只有：
請勿將接收資料夾屬性設為使用含有符號連結的「Microsoft Windows NT 分散式檔案系統」資料夾。 若您使用「Windows NT 分散式檔案系統」，只能使用 FILE 配接器接收位置中含有直接網路路徑的資料夾。
當文件傳送到 UNC 路徑，而且您有一部以上的伺服器在 FILE 配接器的接收位置上接收文件時，則只有一部伺服器會收取和處理傳送至該 UNC 路徑的大部分文件。 如需檔案重新命名的詳細資訊，請參閱檔案配接 器的檔案接收配接器一節。
僅針對傳送資料夾屬性的限制：
當 FILE 配接器在非伺服器的作業系統 (例如 Microsoft Windows Vista) 上執行時，可能沒有足夠的作業系統資源能同時處理批次中的全部訊息。
FILE 配接器會使用先前提及的規則，於設計階段驗證檔案路徑。 此外，若配接器會以 FILE 配接器透過動態連接埠來傳送訊息，則 FILE 配接器會在執行階段驗證訊息。