搜尋並取代

「搜尋並取代」動作在指定來源中搜尋文字或字元並使用提供的內容進行取代。

搜尋並取代索引標籤

Source

來源：指定要對其執行動作的資料的來源。
- 內嵌範本：
  - 值：使用此輸入方塊，可以輸入您希望動作使用的資料。或者，也可以透過新增變數來指定資料，或對輸入的值新增特殊字元。
  - 匯入：開啟「開啟檔案」對話方塊，讓您可以瀏覽並選取包含所需資料的檔案。系統會將此檔案的內容匯入到「值」輸入方塊中。
  - 匯出：開啟「儲存檔案」對話方塊，讓您可以將「值」輸入方塊中的內容另存為外部檔案。您可以將值另存為新檔案或取代現有檔案的內容。
  - 編輯內嵌值 ：開啟「值」對話方塊，在其中可以編輯內嵌來源的值。
- 變數：
  - 變數：輸入要用於來源的變數。或者，按一下以選取最近使用的變數，或按一下「更多變數」以開啟「插入變數」對話方塊。
- 外部檔案：
  - 位置：指定來源資料夾所在的檔案系統或位置。檔案系統或位置可以是暫存區資料夾、本機檔案系統或網路共用、Librarian 或支援的雲端儲存位置。如需更多有關支援的雲端儲存位置的資訊，請參閱 Administration Console 的「雲端儲存頁面」。
  - 內文檔案名稱：指定檔案路徑。您可以輸入資料夾位置和檔案名稱，或按一下「瀏覽」以找到並選取所需的檔案 (當「位置」設定為「暫存區」時，「瀏覽」選項無法使用)。或者，也可以透過新增變數來指定檔案，或對輸入的值新增特殊字元。
  - 檔案編碼：指定來源檔案使用的編碼配置。

選項

Show CR/LF/HT characters:Specifies that carriage return («CR»), line feed («LF»), and horizontal tab («HT») control characters are displayed when you enter them in the Search for and Replace with boxes.These characters are otherwise not visible.
搜尋：指定要在來源中搜尋的文字或字元。或者，也可以透過新增變數來指定搜尋字詞，或對輸入的值新增特殊字元。還可以透過規則運算式或萬用字元修飾詞，讓搜尋變得更加明確。

搜尋方法：指定執行搜尋時使用的方法。

文字：僅搜尋輸入的文字。
使用萬用字元 (* 和 ?)：透過使用萬用字元展開或縮小搜尋來進行搜尋。
使用規則運算式：透過使用規則運算式展開或縮小搜尋來進行搜尋。

搜尋文字含有變數或運算式：指定搜尋文字中包含一或多個變數或運算式，在此類情況下會在作業執行之前處理搜尋文字中的變數或運算式。

取代為：指定希望用來取代搜尋文字或字元的文字或字元。輸入所需取代內容。或者，也可以透過新增變數來指定取代內容，或對輸入的值新增特殊字元。
- 取代文字含有變數或運算式：指定取代文字中包含一或多個變數；在此類情況下會在動作執行之前處理取代文字中的變數。
出現
- 所有出現：指定取代找到的搜尋文字或字元的所有實例。
- 僅限第一次出現：指定僅取代找到的搜尋文字或字元的第一個實例。
- 第一 {#} 次出現：指定針對搜尋文字或字元，取代找到的指定數目的執行個體 (依找到的順序進行取代)。

輸出

將輸出儲存至變數：指定要用於儲存動作輸出的變數。輸入所需的變數。或者，也可以新增變數。

動作索引標籤

動作

名稱：指定動作的名稱。可以透過在欄位中輸入新名稱來取代預設名稱。
描述：指定動作的說明。
執行動作：指定所需的動作執行頻率。
- 永遠：指定只要發生事件就執行此動作。
- 從不：指定發生事件時不執行此動作。
- 根據變數有條件地執行：指定僅有在選取的變數滿足指定條件時，才會執行此動作。在僅有一個條件可以確定是否執行動作的情況下才可使用此選項。您選取此選項後，就可以在輸入方塊中建立條件陳述式。
  
  輸入方塊控制項
  - 變數：指定要用於條件陳述式的變數。在輸入方塊中輸入變數。按一下以查看最近使用的變數的清單，或按一下「更多變數」以開啟「插入變數」對話方塊。
  - [關係運算子]：指定用於條件陳述式的關係運算子。按一下現有運算子以顯示其他運算子的清單，然後按一下要使用的運算子。如需更多資訊，請參閱「關係運算子」。清單中可用的運算子取決於您在「類型」選項中選取的是「文字」還是「十進位」。
  - 值：指定用於條件陳述式的值。若要新增值，請按一下，按一下「<輸入一個值>」，輸入所需的值，然後按 Enter。若要刪除值，請使用滑鼠右鍵按一下此值，然後按一下「刪除」。一些運算子 (例如 Is blank 和 Is not blank) 不需要指定值。在這些情況下，「值」欄位不可用。
  - 類型：指定條件陳述式是評估文字值還是十進位值。
- 根據運算式有條件地執行：指定動作的執行條件。需要在多個條件陳述式的情況才能使用此選項。如果選取此選項，則可透過建立所需的條件陳述式，在輸入方塊中建立條件運算式。您可以在「樹狀檢視」索引標籤中建立和編輯條件運算式。按一下「文字檢視」索引標籤以檢視條件運算式的唯讀文字檢視。
  
  輸入方塊控制項 (樹狀檢視索引標籤)
  - [條件式連字符]：指定群組中的條件陳述式的條件式連字符。預設條件式連字符為 And。
    
    按一下現有條件式連字符以顯示一個功能表，您可以使用下列其中一種方式來設定條件運算式：
    - And、Or、NotAnd、NotOr：按一下清單中要用於條件陳述式的條件式連字符。如需更多有關支援的條件式連字符的資訊，請參閱「條件式連字符」。
    - 新增條件：按一下以將條件陳述式新增至目前群組。
    - 新增群組：按一下以在目前群組新增一個條件陳述式子群組。
    - 移除群組：按一下以刪除子群組。從子群組開啟功能表時可用。
    - 全部清除：按一下以刪除所有條件陳述式 (包括子群組)。從最上方的群組開啟此功能表時可用。
  - :將條件陳述式新增至與此連字符相關聯的群組。顯示在運算式中每個條件式連字符的右側。
  - :刪除條件陳述式。當您指向某個現有條件陳述式時，顯示在該陳述式的右側。
  - 變數：指定要用於條件陳述式的變數。在輸入方塊中輸入變數。按一下以查看最近使用的變數的清單，或按一下「更多變數」以開啟「插入變數」對話方塊。
  - [關係運算子]：指定用於條件陳述式的關係運算子。按一下現有運算子以顯示其他運算子的清單，然後按一下要使用的運算子。如需更多資訊，請參閱「關係運算子」。清單中可用的運算子取決於您在「類型」選項中選取的是「文字」還是「十進位」。
  - 值：指定用於條件陳述式的值。若要新增值，請按一下，按一下「<輸入一個值>」，輸入所需的值，然後按 Enter。若要刪除值，請使用滑鼠右鍵按一下此值，然後按一下「刪除」。一些運算子 (例如 Is blank 和 Is not blank) 不需要指定值。在這些情況下，「值」欄位不可用。
  - 類型：指定條件陳述式是評估文字值還是十進位值。

錯誤處理和診斷

忽略錯誤並繼續執行動作：指定如果動作失敗，則會繼續執行其餘動作。如果未選取此選項，並且動作失敗，則產生的行為會依多種因素而定，如下所示：

動作位於「群組」動作中
- 如果在「群組」動作的「執行」索引標籤中為「執行動作」屬性指定了「依順序」，則不會執行該「群組」動作中的任何進一步動作。此「群組」動作外的任何動作都不會受到影響。
- 如果在「群組」動作的「執行」索引標籤中為「執行動作」屬性指定了「平行」，則系統會忽略錯誤並執行該「群組」動作中的其他動作。此「群組」動作外的任何動作都不會受到影響。
動作不位於「群組」動作中
- 如果在事件的「執行」索引標籤中為「執行動作」屬性指定了「依順序」，則不會執行該事件中的任何進一步動作。
- 如果在事件的「執行」索引標籤中為「執行動作」屬性指定了「平行」，則系統會忽略錯誤並執行該事件中的其他動作。

若失敗則重試：指定如果動作失敗，那麼 BarTender 會嘗試再次執行動作。
- 重試次數上限：指定 BarTender 將會再次嘗試執行動作的最大次數。選取「若失敗則重試」選項時可用。
- 重試間隔：指定 BarTender 在動作失敗後嘗試再次執行動作之前等待的時間長度。選取「若失敗則重試」選項時可用。