使用自訂驗證

注意事項

• 您至少必須具有維度的擁有者或中繼資料管理員權限，才能建立、編輯或刪除自訂驗證。
• 針對視點中的所有節點，按節點類型來執行節點類型驗證。
• 只要視點是階層，就會針對視點中的所有節點執行階層集驗證。
• 執行要求之後，會對節點狀態執行驗證 (亦即，節點在確認要求之後的樣子)。在執行要求之前，您無法對節點狀態執行驗證。
• 提交、核准或確認要求時，或是執行驗證時，都會強制驗證。下表描述在不同環境定義中執行驗證時所執行的自訂驗證：

建立自訂驗證

1. 檢查要為其新增驗證的資料鏈物件。請參閱：
   • 檢查應用程式
   • 檢查維度
   • 檢查節點類型
   • 檢查階層集
2. 執行下列一個動作：
   • 若為應用程式、節點類型、階層集，以及「通用」應用程式中的維度：按一下驗證頁籤中的建立。
   • 若為「通用」以外之應用程式中的維度：按一下驗證頁籤中的自訂子頁籤，然後按一下建立
3. 輸入驗證的名稱和選擇性描述，然後按一下建立。

   驗證會顯示在驗證檢查程式中。

編輯自訂驗證

1. 檢查要為其編輯自訂驗證的資料鏈物件。
2. 執行下列一個動作：
   • 若為應用程式、節點類型、階層集，以及「通用」應用程式中的維度：按一下驗證頁籤中的編輯。
   • 若為「通用」以外之應用程式中的維度：按一下驗證頁籤中的自訂子頁籤，然後按一下編輯
3. 在驗證檢查程式的一般頁籤中，按一下編輯以編輯驗證名稱或描述。
4. 在定義頁籤中，輸入下列資訊來定義驗證：
   • 已啟用旗標：指定是否強制自訂驗證。預設會停用驗證，而且您只有在符合下列條件時才能予以啟用：
     • 定義有效的表示式
     • 至少設定一個觸發器動作或特性
     • 定義失敗訊息

     註：

     您也可以從節點類型或階層集檢查程式的「驗證」頁籤啟用或停用驗證。請參閱啟用、停用或刪除自訂驗證。
   • 表示式：按一下定義表示式 (或 ，具體取決於您的主題) 開啟表示式產生器，然後定義驗證的業務邏輯。請參閱使用表示式以定義自訂商業邏輯。

     驗證的表示式必須傳回布林值。如果表示式傳回 True 值，即通過驗證。如果表示式傳回 False 值，則驗證失敗，並會顯示失敗訊息。

   • 觸發器動作：選取將導致驗證執行的一或多個要求動作，或選取全部核取方塊以選取所有動作。
   • 觸發器特性：選取將導致驗證執行的一或多個特性 (如果它們已更新)，或選取全部核取方塊以選取所有特性。
     • 對於節點類型驗證，指派給該節點類型的所有特性都可供選取。
     • 對於階層集驗證，指派給階層集所參照之任何節點類型的所有特性都可供選取。

     提示：

     針對要求中的每個觸發器動作和觸發器特性，執行驗證。這表示，如果您新增數個觸發器特性，但全部都失敗，則會收到數個失敗訊息。您應該新增仍然會對要求強制商業邏輯的最小數目的觸發器特性或動作。

   • 要求狀態：選取自訂驗證在要求相關內容中執行的狀態：
     • 已確認 (預設值)：在視點套用要求項目和動作之後，對資料進行驗證評估。在「已確認」狀態評估資料條件時，會將要求中移除或刪除的節點排除在外。
     • 已視覺化：在視點套用要求項目和動作之前，對資料進行驗證評估。在「已視覺化」狀態評估資料條件時，會將要求中移除或刪除的節點包含在內。

       註：

       使用「已視覺化」狀態的驗證，只會在驗證要求項目時執行，不會在驗證視點時執行。
   • 嚴重性：在要求提交、核准和確認階段，以及在驗證視點與匯出維度時選取驗證的嚴重性 (錯誤、警告、忽略)。請參閱瞭解驗證嚴重性。
   • 失敗訊息：輸入在驗證失敗時向使用者顯示的訊息。
5. 按一下儲存。

啟用、停用或刪除自訂驗證

1. 檢查要為其啟用、停用或刪除自訂驗證的資料鏈物件。
2. 執行下列一個動作：
   • 若為應用程式、節點類型、階層集，以及「通用」應用程式中的維度：按一下驗證頁籤中的編輯。
   • 若為「通用」以外之應用程式中的維度：按一下驗證頁籤中的自訂子頁籤，然後按一下編輯
3. 在您要採取動作之驗證旁邊的動作欄中，按一下 ，然後選取下列其中一個選項：
   • 啟用 (只有在停用驗證時才可以使用)
   • 停用 (只有在啟用驗證時才可以使用)
   • 刪除
4. 在確認訊息中按一下是，然後按一下儲存。

自訂驗證範例

在此範例中，將在 Corporate Planning 應用程式中新增「科目」節點類型的驗證，亦即所有節點名稱的開頭都必須是與節點父項相同的字元。下列螢幕擷取畫面顯示已建立的自訂驗證。

驗證具有此定義：

• 「已啟用」旗標設為 True。
• 如果節點名稱的開頭是與節點父項名稱第一個字元相同的字元，則表示式會傳回 True 值，否則會傳回 False 值。
• 驗證的觸發器動作是「新增」和「重新命名」，而觸發器特性是「名稱」。
• 如果科目節點的開頭是與其父節點不同的字元，則失敗訊息會指出驗證失敗。

若要測試驗證，請嘗試提交針對「科目」節點類型新增節點的要求，而節點的名稱開頭是與其父項第一個字元不同的字元。在此情況下，會於父節點 OFS_Total Revenue 下嘗試新增名稱為 Project Revenue 的節點。

在提交要求時，會收到驗證錯誤，指出節點名稱的開頭必須是與其父節點相同的字元。