使用 Microsoft Rules Composer 建立和管理要與規則集搭配使用的詞彙（預覽）

發行項
01/27/2025

適用於：Azure Logic Apps (標準)

重要

此功能處於預覽狀態，且受限於 Microsoft Azure 預覽版的補充使用規定。

詞彙是詞彙定義的集合，這些詞彙定義會針對規則條件和動作中使用的事實使用易記名稱。詞彙定義可讓規則集中的規則更容易閱讀、瞭解和共用特定商務網域中的多人。例如，負責將規則撰寫整合到新應用程式或現有應用程式的工具開發人員可能會取用詞彙。詞彙可彌合商務語意與實作之間的差距。

本指南說明如何使用 Microsoft Rules Composer 來建立及定義放在共用規則存放區中的詞彙。您可以選取要使用的數據源、建立新的詞彙，以及新增詞彙定義。您可以將詞彙版本儲存至規則存放區。

必要條件

下載並安裝 Microsoft Rules Composer。
包含您要新增詞彙之規則存放區的 XML 檔案。

詞彙如何讓規則更容易閱讀和瞭解？

您用來定義規則條件和動作的詞彙通常會使用網域或產業特定的命名法來表示。例如，電子郵件使用者會使用「從接收的郵件」和「之後接收的訊息」等詞彙來撰寫規則。保險業務分析師會使用「風險因素」和「保險金額」等詞彙來撰寫規則。

另一個範例是，核准狀態的變數可能會指向 XML 架構中的特定值。您可以改為建立與該變數值相關聯的詞彙定義，並使用「Status」作為易記名稱，而不是在規則中插入這個複雜表示法。然後，您可以在任意數目的規則中使用「狀態」。實作規則條件和規則動作的技術成品，例如 XML 物件和 XML 檔，位於此領域特定術語之下。不過，規則引擎可以從儲存該數據的數據表擷取對應的數據。

規則條件和動作是以可能具有詳細、難以讀取系結信息的數據源為基礎，這會告知使用者有關係結參考的內容。規則引擎可讓您建立詞彙，藉由提供直覺、特定領域術語，讓您能夠與規則條件和動作產生關聯，以簡化規則開發。

建立詞彙

開啟Microsoft規則編輯器。從 [ 規則存放區] 功能表中，選取 [ 載入]。
尋找並選取包含您要處理之規則存放區的 XML 檔案。
在 [事實總管] 視窗中，選取 [詞彙] 索引卷標。
在 [ 詞彙] 索引 標籤上，尋找 [ 詞彙] 資料夾。
開啟資料夾的快捷方式功能表，然後選取 [ 新增詞彙]。

Microsoft Rules Composer 會建立新的空白詞彙，其詞彙版本編號 為 1.0 做為預設版本。

在您可以使用詞彙之前，詞彙必須具有版本戳記。這項需求可確保詞彙定義不會變更並保留引用完整性，這表示任何使用該特定版本的規則集不會因為基礎詞彙變更而意外失敗。

下表描述可用來處理詞彙的其他快捷方式命令：

快速鍵命令	Task
新增版本	從選取的詞彙建立新的空白詞彙版本。您可以從其他詞彙版本複製詞彙定義，並將其貼到新版本。
貼上詞彙版本	在選取的詞彙中，將先前複製的詞彙定義從另一個詞彙版本貼上為新版本。
刪除	刪除選取的詞彙及其所有版本。

下表描述可用來處理詞彙版本的其他快捷方式命令：

快速鍵命令	Task
新增定義	啟動 [詞彙定義精靈]，以在選取的詞彙版本中建立新的定義。
儲存	儲存對所選詞彙版本及其定義的變更。
重新載入	重載選取的詞彙版本及其定義，包括捨棄該版本中所做的任何目前變更，以及從規則存放區還原內容的選項。

下表描述可用來處理詞彙版本的其他快捷方式命令：

快速鍵命令	Task
Modify	啟動 [詞彙定義精靈] 以變更選取的定義。
移至來源事實	針對選取的詞彙定義，請移至 .NET 元件或 XML 架構中的對應來源事實。

快速鍵命令	Task
選取根節點	從包含多個根節點的 XML 架構中，選取要載入的根節點。

下列各節提供這些工作的詳細資訊。

複製詞彙版本

當您想要在詞彙中進行變更時，請建立新的詞彙版本以反映變更。您可以從現有的詞彙版本建立複本，但版本號碼不同。

在 [事實總管] 視窗中，開啟詞彙版本的快捷方式功能表，然後選取 [複製]。
開啟詞彙的快捷方式功能表，然後選取 [ 貼上 RuleSet 版本]。

Microsoft Rules Composer 會建立新的詞彙版本，其定義與複製的版本相同，但號碼不同。

重要

當您建立新的詞彙版本時，使用舊版詞彙建立的規則仍會參考舊版。請務必更新這些規則與新詞彙版本之間的參考。

建立空的詞彙版本

將定義新增至詞彙版本之後，您可以建立具有不同數位的新空白詞彙版本，並儲存該版本以供稍後使用。

在 [事實總管] 視窗中，選取 [詞彙] 索引卷標。
在 [ 詞彙] 索引 標籤上，尋找要從中建立新版本的詞彙。
開啟詞彙的快捷方式功能表，然後選取 [ 新增版本]。

Microsoft Rules Composer 會建立具有不同數位的新空白詞彙版本。
開啟新詞彙版本的快捷方式功能表，然後選取 [ 儲存]。

您現在可以從其他詞彙版本複製詞彙定義，並將其貼到新版本。

重新命名詞彙

您必須先儲存所有詞彙定義版本，才能重新命名詞彙或規則集。這表示所有版本的詞彙定義。

在 [事實總管] 視窗中，選取 [詞彙] 索引卷標。
在 [詞彙] 索引標籤的 [詞彙] 資料夾中，尋找您要重新命名的詞彙。
選取詞彙，然後在 [ 屬性] 視窗中編輯名稱。

建立詞彙定義

您可以將詞彙定義建立為常數值、值範圍、一組值，或 .NET 元件或 XML 檔中的專案。若要建立詞彙定義，您可以使用詞彙定義精靈。

或者，您可以從 [.NET 類別] 索引標籤或 [XML 架構] 索引標籤選取事實，例如或 .NET 類別的成員，將事實拖曳至 [詞彙] 索引標籤，以建立新的詞彙定義。

例如，XML 節點

如果您選取公用變數， 仍然可使用 [取得 和設定 ] 選項，就像在 XML 定義精靈中一樣。

將常數值新增為詞彙定義

在 [ 詞彙] 索引 標籤的 [詞彙] 資料夾中。
在 [ 詞彙] 資料夾中，開啟您想要之詞彙版本的快捷方式功能表。
從詞彙版本的快捷方式功能表中，選取 [ 新增定義]。

您也可以從 [.NET 類別] 索引 標籤和 [XML 架構] 索引標籤 拖曳專案。

詞彙定義精靈隨即啟動，協助您建立定義。
在精靈中，選取 [ 常數值]、[值範圍] 或 [值集合]，然後選取 [ 下一步]。
提供下列資訊：

屬性說明

定義名稱 定義的名稱。

說明定義的描述。

定義類型 針對這項工作，選取 [ 常數值]。
在您準備就緒後，選取 [下一步]。
提供下列資訊：

屬性說明

定義類型 選取定義的系統數據類型。

顯示名稱 輸入不超過 512 個字元的名稱。

ReplTest1 輸入常數的值。
完成時，選取 [完成]。

屬性	說明
定義名稱	定義的名稱。
說明	定義的描述。
定義類型	針對這項工作，選取 [ 常數值]。

屬性	說明
定義類型	選取定義的系統數據類型。
顯示名稱	輸入不超過 512 個字元的名稱。
ReplTest1	輸入常數的值。

將值範圍新增為詞彙定義

在 [ 詞彙] 索引 標籤的 [詞彙] 資料夾中。
在 [ 詞彙] 資料夾中，開啟您想要之詞彙版本的快捷方式功能表。
從詞彙版本的快捷方式功能表中，選取 [ 新增定義]。

您也可以從 [.NET 類別] 索引 標籤和 [XML 架構] 索引標籤 拖曳專案。

詞彙定義精靈隨即啟動，協助您建立定義。
在精靈中，選取 [ 常數值]、[值範圍] 或 [值集合]，然後選取 [ 下一步]。
提供下列資訊：

屬性說明

定義名稱 定義的名稱。

說明定義的描述。

定義類型 針對這項工作，選取 [ 值範圍]。
在您準備就緒後，選取 [下一步]。
從 [ 定義類型 ] 清單中，選取定義的系統數據類型。
在 [步驟 1 - 指定 [範圍低] 和 [範圍高] 的顯示名稱/值，在數據表中選取 [範圍低]，然後選取 [ 編輯]。

在開啟的 [ 參數定義 ] 方塊中，只有 [使用常數值 ] 選項可供使用。
輸入常數值以指定較低的範圍，然後選取 [ 確定]。
針對 Range High 重複上述步驟，其必須超過 Range Low 值。
在 [步驟 2 - 指定範圍的顯示格式字串]，在 [顯示格式字串 ] 屬性中，輸入顯示格式字串。若要還原為預設的顯示格式字串，請選取 [ 預設值]。

注意

請確定您的格式字串包含使用大括弧的參數索引，例如，使用 {0} 和 {1} 作為高低範圍參數的佔位元。

下列範例顯示值範圍的範例詞彙定義：
在您準備就緒後，選取 [完成]。

屬性	說明
定義名稱	定義的名稱。
說明	定義的描述。
定義類型	針對這項工作，選取 [ 值範圍]。

將一組值新增為詞彙定義

在 [ 詞彙] 索引 標籤的 [詞彙] 資料夾中。
在 [ 詞彙] 資料夾中，開啟您想要之詞彙版本的快捷方式功能表。
從詞彙版本的快捷方式功能表中，選取 [ 新增定義]。

您也可以從 [.NET 類別] 索引 標籤和 [XML 架構] 索引標籤 拖曳專案。

詞彙定義精靈隨即啟動，協助您建立定義。
在精靈中，選取 [ 常數值]、[值範圍] 或 [值集合]，然後選取 [ 下一步]。
提供下列資訊：

屬性說明

定義名稱 定義的名稱。

說明定義的描述。

定義類型 針對這項工作，選取 [ 值集]。
在您準備就緒後，選取 [下一步]。
提供下列資訊：

屬性說明

定義類型 選取定義的系統數據類型。

顯示名稱 輸入不超過 512 個字元的名稱。

在 [定義值] 下，只有 [使用常數值] 選項可供使用。
若要將成員新增至集合，請輸入常數值，然後選取 [ 新增]。
針對您想要包含在集合中的值，重複上一個步驟。

下列範例顯示集合中的多個值：
若要在集合的相對順序內移動值，請在 [值] 方塊中選取值，然後選取 [向上] 或 [向下]。
若要從集合中移除成員，請在 [ 值 ] 方塊中選取值，然後選取 [ 移除]。
當您完成設定時，請選取 [ 完成]。

屬性	說明
定義名稱	定義的名稱。
說明	定義的描述。
定義類型	針對這項工作，選取 [ 值集]。

屬性	說明
定義類型	選取定義的系統數據類型。
顯示名稱	輸入不超過 512 個字元的名稱。

將 .NET 類別或類別成員新增為詞彙定義

開始之前，請務必將 .NET 元件放在 Microsoft Rules Composer 的本機目錄中。如果您更新 .NET 元件，請務必更新規則集版本的該元件參考。如需詳細資訊，請參閱更新 .NET 元件參考。

在 [ 詞彙] 索引 標籤的 [詞彙] 資料夾中。
在 [ 詞彙] 資料夾中，開啟您想要之詞彙版本的快捷方式功能表。
從詞彙版本的快捷方式功能表中，選取 [ 新增定義]。

您也可以從 [.NET 類別] 索引標籤拖曳 .NET 類別或類別成員。

詞彙定義精靈隨即啟動，協助您建立定義。
在精靈中，選取 [.NET 類別] 或 [類別成員]，然後選取 [ 下一步]。
提供下列資訊：

屬性說明

定義名稱 定義的名稱。

說明定義的描述。
在 [ 類別成員資訊] 區段中，選取 [ 流覽]。
尋找並選取您想要的元件，然後選取 [ 開啟]。
在 [ 選取系結] 方塊 中，展開元件節點。
選取類別，或展開類別並選取類別成員，然後選取 [ 確定]。
選擇下列其中一個步驟：
- 如果您選取類別，針對 [顯示名稱]，輸入不超過 512 個字元的名稱，然後選取 [ 完成]。
  
  您現在已完成本節。
- 如果您選取具有參數的類別成員，請選取 [ 下一步]。
  
  [ 指定顯示名稱 - .NET 類別或類別成員定義 ] 頁面隨即出現，讓您為每個參數提供值和顯示格式字串。
  1. 在 [步驟 1 - 指定每個參數的顯示名稱/值] 底下，在 [參數] 方塊中選取參數，然後選取 [編輯]。
  2. 針對 [參數值]，只能 使用 [使用常數值 ] 選項，因此請輸入常數值。
  3. 在 [步驟 2 - 指定顯示格式字串]，在 [顯示格式字串] 屬性中，輸入顯示格式字串。若要還原為預設的顯示格式字串，請選取 [ 預設值]。
    
    注意
    
    請確定您的格式字串包含使用大括弧的參數索引，例如，使用 {0} 和 {1} 作為參數的佔位元。
  4. 針對類別成員中的每個參數重複上述步驟。
    
    下列範例顯示類別成員中的多個參數：

屬性	說明
定義名稱	定義的名稱。
說明	定義的描述。

從 .NET 元件建立詞彙定義

您可以從 .NET 元件中的類別或類別成員建立詞彙定義，以定義述詞、自變數和動作。開始之前，請務必將 .NET 元件放在 Microsoft Rules Composer 的本機目錄中。如果您更新 .NET 元件，請務必更新規則集版本的該元件參考。如需詳細資訊，請參閱更新 .NET 元件參考。

在 [事實總管] 視窗中，選取 [.NET 類別] 索引標籤 。
從 .NET 元件底下，將類別或類別成員拖曳至現有的詞彙定義，其會出現在 [詞彙] 索引卷標上。

從 XML 檔項目或屬性建立詞彙定義

您可以從 XML 元素和屬性建立詞彙定義，方法是流覽 XSD 架構，並將專案拖曳至條件編輯器或動作編輯器，以定義述詞、自變數和動作。

在 [ 詞彙] 索引 標籤的 [詞彙] 資料夾中。
在 [ 詞彙] 資料夾中，開啟您想要之詞彙版本的快捷方式功能表。
從詞彙版本的快捷方式功能表中，選取 [ 新增定義]。

詞彙定義精靈隨即啟動，協助您建立定義。
在精靈中，選取 [ XML 檔案元素] 或 [屬性]，然後選取 [ 下一步]。
提供下列資訊：

屬性說明

定義名稱 定義的名稱。

說明定義的描述。
在 [ XML 檔資訊] 區段中，選取 [ 流覽]。
尋找並選取架構（.xsd）檔案，然後選取檔元素或屬性。
從 [ 類型 ] 清單中，選取與架構中所選項目或屬性類型相容的類型。

注意

引擎不會驗證已定義元素的存在和文件類型。如果您判斷提示沒有專案的 XML 檔，您會在運行時間收到錯誤。如果您判斷提示具有未知檔類型的 XML 檔，引擎只會忽略檔。

如果引擎無法在指定的類型與所選取檔案項目或屬性的類型之間執行有效的轉換，您就會在運行時間收到錯誤。
在 [ 選取作業] 區段中，選取指出您打算取得專案或屬性值或設定值的作業類型。
如果您選擇設定值，請選取 [下一步]，然後指定顯示格式。

[ 指定顯示名稱 - XML 檔案元素或屬性 ] 頁面隨即出現，讓您提供要使用的值和顯示格式字串。
1. 在 [步驟 1 - 指定每個參數的顯示名稱/值] 底下，在 [參數] 方塊中選取參數，然後選取 [編輯]。
2. 針對 [參數值]，只能 使用 [使用常數值 ] 選項，因此請輸入常數值。
3. 在 [步驟 2 - 指定顯示格式字串]，在 [顯示格式字串] 屬性中，輸入顯示格式字串。若要還原為預設的顯示格式字串，請選取 [ 預設值]。
  
  注意
  
  請確定您的格式字串包含使用大括弧的參數索引，例如，使用 {0} 和 {1} 作為參數的佔位元。
完成時，選取 [完成]。

下列範例顯示以 XML 檔案項目或屬性為基礎的詞彙定義詳細資料：

當您建立 XML 節點的詞彙定義時，系結的 XPath 運算式會根據稍早所述的規則，具有類似的預設值。不過，您可以在詞彙定義精靈中編輯這些值。表達式的變更會放在詞彙定義中，並反映在您從詞彙定義建置的任何規則自變數中。

共用方式為