使用 XSLT 轉換 XML

「使用 XSLT 轉換 XML」動作會使用 XSLT 樣式表將其他應用程式的輸出 XML 從原始的 XML 格式轉換為另一個 XML 格式。然後會將重新格式化的 XML 置於輸出變數中。

可以在下列索引標籤上設定「使用 XSLT 轉換 XML」動作的屬性。

轉換索引標籤

Source

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

XSLT 樣式表

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

輸出

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

動作索引標籤

動作

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

錯誤處理和診斷

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

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

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