設定 File 配接器
如何設定檔案配接器、讀取安全性建議，以及檢視必要的許可權。
您可以使用BizTalk Server系統管理，或以程式設計方式建立接收位置並傳送埠。 本主題著重于 BizTalk Server 管理主控台。 如需程式設計步驟，請移至 建立接收位置或以程式設計方式傳送埠。
重要
從 BizTalk Server 2016 開始，您可以使用檔案配接器連線到 Azure 檔案共用。 Azure 儲存體帳戶必須掛接在BizTalk Server上。 開始使用 Windows 上的 Azure 檔案儲存體 會列出掛接步驟。
安全性建議
FILE 配接器負責在 BizTalk Server 的某個目錄中傳輸檔案。 建議您依照這些指導方針，來保護和部署您作業環境中的 FILE 配接器。
請勿開啟埠以連線到周邊網路中檔案共用。 您應該在具有高度信任的環境中使用 FILE 配接器，例如內部網路。
在接收位置的卸載目錄中設定強式任意存取控制清單 (DACL) 。 例如，您必須對檔案接收位置收取訊息的目錄設定讀取、寫入、刪除檔案及刪除子資料夾與檔案的權限，使得只有授權的使用者可以在此位置中放置訊息。
當您使用 FILE 配接器收取重要資料時，建議您使用「網際網路通訊協定安全性」(IPSec)。
必要權限
配接器處理常式會在為配接器處理常式選取之主機實例的安全性內容下執行。 主機實例會 Logon 使用[主機名稱- BizTalk 管理中的主機實例屬性] 中的 屬性。 此 Logon 帳戶必須具有檔案配接器使用之任何資料夾或共用的特定許可權。
處理常式所使用的主機實例使用者帳戶需要下列許可權。 表示✔需要許可權。 空白專案表示不需要許可權。
| 權限 | 接收處理常式 | 傳送處理常式 |
|---|---|---|
| 完整控制 | ✔ 如果存取檔案共用) ，請在共用層級 ( |
|
| 周遊資料夾 / 執行檔案 | ✔ 在檔案層級 |
|
| 列出資料夾/讀取資料 | ✔ 在檔案層級 |
✔ 在檔案層級 |
| 讀取屬性 | ✔ 在檔案層級 |
|
| 讀取擴充屬性 | ✔ 在檔案層級 |
|
| 建立檔案 / 寫入資料 | ✔ 在檔案層級 |
|
| 建立資料夾 / 附加資料 | ✔ 在檔案層級 |
|
| 刪除子資料夾及檔案 | ✔ 在檔案層級 |
✔ 在檔案層級 |
| 讀取權限 | ✔ 在檔案層級 |
|
| 變更 | ✔ 如果存取檔案共用) ，請在共用層級 ( |
提示
在檔案層級，開啟檔案或資料夾的 進階許可權 ，以查看這些許可權。
注意
每個主控件只可和一個接收處理常式建立關聯。
設定接收位置
注意
完成下列程式之前，您必須先新增單向接收埠。 請參閱 如何建立接收埠。
在 [BizTalk Server管理主控台] 中，依序展開 [管理] BizTalk Server [管理]、[BizTalk 群組]、[應用程式] 和 [您要建立接收位置] 底下的應用程式。
在左窗格中，按一下 [ 接收埠] 節點。 然後在右窗格中，使用滑鼠右鍵按一下與現有接收位置關聯的接收埠，或是您要與新接收位置關聯的接收埠，然後按一下 [屬性]。
在 [ 接收埠內容] 對話方塊的左窗格中，選取 [ 接收位置]，然後在右窗格中按兩下現有的接收位置，或按一下 [ 新增 ] 來建立新的接收位置。
在 [ 接收位置屬性] 對話方塊的 [ 傳輸 ] 區段中，從下拉式清單中選取 [檔案類型 ]，然後按一下 [ 設定 ] 來設定接收位置的傳輸屬性。
在 [ 一般 ] 索引標籤中，執行下列動作：
使用 作法 接收資料夾 必要。 輸入檔案系統、網路共用或檔案接收處理常式讀取檔案所在的 Azure 檔案共用資料夾路徑。 您可以直接在 [ 接收資料夾 ] 文字方塊中輸入路徑，或使用 [ 流覽 ] 按鈕從檔案系統中選取路徑。 流覽資料夾時，您也可以使用 [建立新資料夾] 建立新的資料夾。
如果使用 Azure 檔案儲存體共用，請輸入\\yourfilestoragename.file.core.windows.net\yourfilesharename。
類型： 字串
注意： 請勿將 Receive 資料夾 屬性設定為使用 NT 分散式檔案系統與符號連結的資料夾。 如果您使用 NT 分散式檔案系統，您只能在檔案配接器接收位置中使用具有直接網路路徑的資料夾。
如需此屬性的限制，請參閱 設定檔案配接器時的限制。
注意： 傳送埠或接收位置的 URI 不能超過 256 個字元。檔案遮罩 必要。 指定檔案的遮罩。 此遮罩可包含標準萬用字元值 "*"。
預設值： *.xml
類型： 字串
如需此屬性的限制，請參閱 設定檔案配接器時的限制。公用位址 指定此位置的公用位址。 BizTalk Server 會對外部夥伴公開此位址。
若未指定此屬性，執行階段引擎會以下列位址取代：
file:// <Receive 資料夾> / <檔案遮罩>
此屬性值必須有配接器前置詞。
類型： 字串
最小長度： 0
最大長度： 256重試計數 指定當網路共用上的接收位置暫時無法使用時，嘗試存取該接收位置的次數。
預設值： 5
類型： 長
最小值： 0
最大值： MAX_LONG重試間隔 (分) 指定當網路共用上的接收位置暫時無法使用時，嘗試存取該接收位置的重試間隔時間 (以分為單位)。
預設值： 5 分鐘
類型： 長
最小值： 0
最大值： MAX_LONG在 [ 驗證] 索引 標籤上，執行下列動作：
使用 作法 當主控件沒有存取網路共用的權限時，即使用這些認證 只有在使用網路共用或 Azure 檔案共用時才需要。
預設值： 假
類型： 布林使用者名稱 如果使用網路共用，請輸入可存取共用的使用者名稱。
如果使用 Azure 檔案儲存體共用，請輸入儲存體帳戶的名稱。
類型： 字串
注意： 如果有多個對應至相同網路共用的接收位置已設定為替代認證，則所有接收位置都必須使用相同的認證。 若您嘗試使用一組以上的認證，Windows 不允許您從相同電腦建立多個連至共用網路伺服器的連線。密碼 如果使用網路共用，請輸入可存取網路共用之帳戶的密碼。
如果使用 Azure 檔案儲存體共用，請輸入儲存體帳戶存取金鑰;列在Azure 入口網站中。
類型： 字串在 [ 批次處理] 索引標籤 中，執行下列動作：
使用 作法 一個批次的訊息數量 指定以一個批次提交的訊息數量上限。
預設值： 5
類型： Int
最小值： 1
最大值： 256批次大小上限 (位元組) 指定一個批次的總位元組上限。
預設值： 102400
類型： Int
最小值： 1024
最大值： MAX_LONGFILE 配接器將會限制先到達任一值 (訊息數目上限或是允許位元組上限) 的批次。
選取 [確定]。
在 [ 接收位置屬性 ] 對話方塊中輸入適當的值，以完成接收位置的設定，然後按一下 [ 確定 ] 以儲存設定。 如需 [接收位置屬性] 對話方塊的詳細資訊，請參閱 如何建立接收位置。
設定傳送埠
在 BizTalk Server 管理主控台中，建立新的傳送埠，或按兩下現有的傳送埠加以修改。 請參閱 如何建立傳送埠。 設定所有傳送埠選項，並在 [一般] 索引標籤的 [傳輸] 區段中指定[類型] 選項的FILE。
選取[類型] 旁的 [設定] 按鈕。
在 [ 一般 ] 索引標籤中，執行下列動作：
使用 作法 目的地位置 必要。 輸入檔案系統、公用共用或 Azure 檔案共用上位置的路徑，以寫入輸出訊息。 您可以直接在 [目的地位置] 中輸入路徑，或使用 [ 流覽 ] 按鈕從檔案系統中選取路徑。 在 [ 流覽 資料夾] 對話方塊中流覽資料夾時，您也可以按一下 [ 建立新資料夾] 來建立新的資料夾。
如果使用 Azure 檔案儲存體共用，請輸入\\yourfilestoragename.file.core.windows.net\yourfilesharename。
類型： 字串
注意： 傳送埠或接收位置的 URI 不能超過 256 個字元。檔案名稱 指定 FILE 傳送處理常式寫入訊息的檔案名稱。
如需此屬性的限制，包括在檔案名中使用宏，請參閱 設定檔案配接器時的限制。複製模式 定義將訊息寫入檔案時使用的複製模式。 有效值為：
Append。 若檔案存在，FILE 傳送處理常式會開啟檔案，並將訊息附加到檔案結尾。 若檔案不存在，FILE 傳送處理常式會建立新檔案。
覆寫。 若檔案存在，FILE 傳送處理常式會開啟檔案，並覆寫其內容。 若檔案不存在，FILE 傳送處理常式會建立新檔案。
建立新項目。 若檔案不存在，FILE 傳送處理常式會建立新檔案並寫入檔案。 若檔案已存在，FILE 傳送處理常式會報告錯誤，然後依照傳送埠的一般配接器重試邏輯來處理。 此為 FILE 傳送處理常式的預設複製模式。允許寫入時快取 定義將訊息寫入檔案時是否使用檔案系統快取。
有效的選項包括：
假 請勿使用檔案系統快取。
真 使用檔案系統快取。
預設值： False 重要事項： 將此屬性設定為 True 可能會增加檔案介面卡的效能，而當電源遺失，且並非所有資料都寫入磁片時，可能會遺失資料。寫入時使用暫存檔 定義是否先將輸出檔寫入暫存檔，然後等寫入作業完成後再重新命名檔案。 如果啟用此選項，則會使用 BTS-WIP副檔名來建立暫存檔。
有效選項為
真 檔案配接器會在寫入目的檔案夾時建立暫存檔案。
假 寫入目的檔案夾時，檔案配接器不會建立暫存檔案。
預設值：False注意：只有在CopyMode屬性設定為[新建] 的值時，才能使用此選項在 [ 驗證] 索引 標籤上，執行下列動作：
使用 作法 當主控件沒有存取網路共用的權限時，即使用這些認證 只有在使用網路共用或 Azure 檔案共用時才需要。
預設值： 假
類型： 布林使用者名稱 如果使用網路共用，請輸入可存取共用的使用者名稱。
如果使用 Azure 檔案儲存體共用，請輸入儲存體帳戶的名稱。
類型： 字串密碼 如果使用網路共用，請輸入可存取網路共用之帳戶的密碼。
如果使用 Azure 檔案儲存體共用，請輸入儲存體帳戶存取金鑰;列在Azure 入口網站中。
類型： 字串選取 [確定] 儲存設定。
設定動態傳送埠的屬性
動態傳送埠不提供 BizTalk Server 管理主控台中的任何傳輸組態選項，因為這些屬性會隨著與訊息關聯的內容屬性一起提供。 這些屬性可以在自訂管線或協調流程中設定。 若要在協調流程中設定訊息組態屬性，您可以執行下列動作：
將 建構訊息 圖形新增至協調流程。
設定 建構訊息 圖形以建構新的訊息。 (例如 Message_2)
將 訊息指派 圖形新增至 建構訊息 圖形。
將程式碼新增至 [訊息指派 ] 圖形，以初始化您所建構的訊息，以及設定訊息的適當組態屬性。 下列程式碼會初始化名為 Message_2的訊息，該訊息是使用 建構訊息圖形所建構 ，然後設定訊息的兩個組態屬性。 在此實例中，Message_1 原先是由協調流程接收：
Message_2=Message_1; Message_2(FILE.CopyMode)= 0; //0=Append Message_2(FILE.AllowCacheOnWrite)= true; Message_2(FILE.UseTempFileOnWrite)= true;
設定接收或傳送處理常式
在 BizTalk Server 管理主控台中，依序展開 [BizTalk Server系統管理]、[BizTalk 群組]、[平臺設定] 和 [配接器]。
在展開的配接器清單中，按一下 [ 檔案]，在右窗格中，以滑鼠右鍵按一下您要設定的接收或傳送處理常式。 選取 [屬性] 。
在 [ 主機名稱] 清單中，選取要執行處理常式的主機。
按一下 [確定]。