讀取檔案 |
「讀取檔案」動作會在指定資料夾中搜尋定義的檔案類型,然後讀取該檔案中包含的資料,再將這些資料儲存到變數。
可以在下列索引標籤上設定「讀取檔案」動作的屬性。
Source
位置:指定來源資料夾所在的檔案系統。檔案系統或位置可包括本機檔案系統或網路共用、Librarian 或支援的雲端儲存位置。如需更多有關支援的雲端儲存位置的資訊,請參閱 Administration Console 的「
內文檔案名稱:指定動作從中進行讀取的檔案。您可以輸入資料夾位置及檔案名稱,或按一下「瀏覽」以找到並選取所需的檔案。或者,也可以透過新增變數來指定所需檔案,或對輸入的值新增特殊字元。
|
如果在「檔案偵測」下按一下以選取「等候檔案送達」核取方塊 (如下所示),則「檔案名稱」選項會變更為「要掃描的資料夾」選項。 |
要掃描的資料夾:指定要在其中尋找檔案的資料夾位置。您可以輸入資料夾位置或按一下「瀏覽」以找到並選取所需的資料夾。或者,也可以透過新增變數來指定要掃描的資料夾,或對輸入的值新增特殊字元。按一下以選取「檔案偵測」下的「等待檔案送達」核取方塊時可用。
掃描子資料夾:指定此動作還會監視「要掃描的資料夾」屬性指定資料夾的所有子資料夾。
檔案編碼:指定用於正在讀取的檔案的編碼方法。
檔案內容格式:指定資料內容類型。動作將根據此格式處理檔案的內容。
資料包含在 SOAP 訊息中:指定動作會尋找要包含在 SOAP 訊息中的資料。
被鎖定檔案逾時:指定嘗試開啟最初被其他應用程式鎖定的檔案的時間。
檔案偵測
等候檔案送達:指定如果資料夾中尚不存在該檔案,則動作會等待該檔案送達。
|
僅有在按一下以選取「等候檔案送達」核取方塊時提供檔案偵測選項。 |
偵測選項
掃描方法:指定用於在掃描資料夾中監視指定檔案是否送達的方法。
通知並輪詢:指定連續監視掃描資料夾,並且還會按照設定的時間間隔掃描資料夾。如果您擔心檔案系統的可靠性,則此選項很有用。如果連續掃描時錯過某個事件,則輪詢掃描將會確保偵測到該事件。如果您選取此選項,則能以毫秒、秒、分鐘或小時為單位指定輪詢間隔。
僅通知:指定連續監視掃描資料夾。
僅輪詢:指定系統按照設定的時間間隔對掃描資料夾進行掃描。如果您選取此選項,則能以毫秒、秒、分鐘或小時為單位指定輪詢間隔。
輪詢間隔:指定檔案掃描的頻率。為「掃描方法」選取「通知並輪詢」或「僅輪詢」時可用。
檔案模式:指定該動作用於識別要在其上執行該動作的檔案的篩選器。此篩選器可以包含萬用字元 (例如 ? 和 *) 或規則運算式 (例如 (?i)^.*\.csv$)。按一下 以檢視支援的規則運算式或萬用字元修飾詞的清單,然後按一下修飾詞以進行新增。您還可以透過新增變數來指定檔案模式,或對輸入的值新增特殊字元。
使用規則運算式:指定使用規則運算式來識別檔案模式。 當您選取此選項時,可以向先前的屬性新增規則運算式修飾詞,以便進一步控制搜尋條件。
檔案大小下限:指定要被接受為來源檔案的大小下限。
檔案大小上限:指定要被接受為來源檔案的大小上限。
檔案閒置時間:指定位於指定資料夾中的檔案可以處於閒置狀態,而仍被接受為來源檔案的最長時間。能夠以毫秒、秒、分鐘或小時為單位指定最長閒置時間,並且將會與檔案的「LastModifiedTime」屬性進行比較。
多個檔案排序順序
定義在多個檔案符合所指示檔案模式時,動作處理所指定資料夾中的檔案的順序。如果未在屬性頁面上指定任何排序順序,則排序過程會預設為依建立時間 (遞增) 排序,然後依檔案名稱 (遞增) 排序。最多可以指定四個排序條件。
順序:指定排序條件套用至指定資料夾中比對檔案的順序。
排序欄位:指定套用至比對檔案的條件。
方向:指定將排序欄位條件套用至比對檔案時,使用遞增或是遞減。
新增排序條件:指定更多排序條件。
輸出
將檔案內容儲存至變數:指定希望儲存檔案內容的變數。在輸入方塊中輸入變數。或者,也可以新增變數。
動作
名稱:指定動作的名稱。可以透過在欄位中輸入新名稱來取代預設名稱。
描述:指定動作的說明。
執行動作:指定所需的動作執行頻率。
永遠:指定只要發生事件就執行此動作。
從不:指定發生事件時不執行此動作。
根據變數有條件地執行:指定僅有在選取的變數滿足指定條件時,才會執行此動作。在僅有一個條件可以確定是否執行動作的情況下才可使用此選項。您選取此選項後,就可以在輸入方塊中建立條件陳述式。
變數:指定要用於條件陳述式的變數。在輸入方塊中輸入變數。按一下 以查看最近使用的變數的清單,或按一下「更多變數」以開啟「插入變數」對話方塊。
[關係運算子]:指定用於條件陳述式的關係運算子。按一下現有運算子以顯示其他運算子的清單,然後按一下要使用的運算子。如需更多資訊,請參閱「關係運算子」。清單中可用的運算子取決於您在「類型」選項中選取的是「文字」還是「十進位」。
值:指定用於條件陳述式的值。若要新增值,請按一下 ,按一下「<輸入一個值>」,輸入所需的值,然後按 Enter
。若要刪除值,請使用滑鼠右鍵按一下此值,然後按一下「刪除」。一些運算子 (例如 Is blank 和 Is not blank) 不需要指定值。在這些情況下,「值」欄位不可用。
類型:指定條件陳述式是評估文字值還是十進位值。
根據運算式有條件地執行:指定動作的執行條件。需要在多個條件陳述式的情況才能使用此選項。如果選取此選項,則可透過建立所需的條件陳述式,在輸入方塊中建立條件運算式。您可以在「樹狀檢視」索引標籤中建立和編輯條件運算式。按一下「文字檢視」索引標籤以檢視條件運算式的唯讀文字檢視。
[條件式連字符]:指定群組中的條件陳述式的條件式連字符。預設條件式連字符為 And。
按一下現有條件式連字符以顯示一個功能表,您可以使用下列其中一種方式來設定條件運算式:
And、Or、NotAnd、NotOr:按一下清單中要用於條件陳述式的條件式連字符。如需更多有關支援的條件式連字符的資訊,請參閱「條件式連字符」。
新增條件:按一下以將條件陳述式新增至目前群組。
新增群組:按一下以在目前群組新增一個條件陳述式子群組。
移除群組:按一下以刪除子群組。從子群組開啟功能表時可用。
全部清除:按一下以刪除所有條件陳述式 (包括子群組)。從最上方的群組開啟此功能表時可用。
:將條件陳述式新增至與此連字符相關聯的群組。顯示在運算式中每個條件式連字符的右側。
:刪除條件陳述式。當您指向某個現有條件陳述式時,顯示在該陳述式的右側。
變數:指定要用於條件陳述式的變數。在輸入方塊中輸入變數。按一下 以查看最近使用的變數的清單,或按一下「更多變數」以開啟「插入變數」對話方塊。
[關係運算子]:指定用於條件陳述式的關係運算子。按一下現有運算子以顯示其他運算子的清單,然後按一下要使用的運算子。如需更多資訊,請參閱「關係運算子」。清單中可用的運算子取決於您在「類型」選項中選取的是「文字」還是「十進位」。
值:指定用於條件陳述式的值。若要新增值,請按一下 ,按一下「<輸入一個值>」,輸入所需的值,然後按 Enter
。若要刪除值,請使用滑鼠右鍵按一下此值,然後按一下「刪除」。一些運算子 (例如 Is blank 和 Is not blank) 不需要指定值。在這些情況下,「值」欄位不可用。
類型:指定條件陳述式是評估文字值還是十進位值。
錯誤處理和診斷
忽略錯誤並繼續執行動作:指定如果動作失敗,則會繼續執行其餘動作。如果未選取此選項,並且動作失敗,則產生的行為會依多種因素而定,如下所示:
若失敗則重試:指定如果動作失敗,那麼 BarTender 會嘗試再次執行動作。
重試次數上限:指定 BarTender 將會再次嘗試執行動作的最大次數。選取「若失敗則重試」選項時可用。
重試間隔:指定 BarTender 在動作失敗後嘗試再次執行動作之前等待的時間長度。選取「若失敗則重試」選項時可用。