7.1 Designer 中的綱要映射規則任務

本節包含在 Designer 中執行與「綱要映射」規則相關之常見任務的指示:

7.1.1 存取綱要映射編輯器

「綱要映射」編輯器可讓您編輯「綱要映射」規則。 在 Designer 中存取「綱要映射」編輯器有三種不同的方法: 透過「大綱」檢視窗、透過「規則流程」檢視窗,或透過「規則集」檢視窗。

大綱檢視窗

  1. 在開啟的專案中,按一下「大綱」索引標籤。

  2. 按一下「顯示模型大綱」圖示。

  3. 選取您要於其上管理綱要映射規則的驅動程式,然後按一下右邊的加號。

  4. 連按兩下「綱要映射」圖示,以啟動「綱要映射」編輯器。

    按一下滑鼠右鍵,並選取「編輯」。

    Schema Mapping Policy

規則流程檢視窗

  1. 在開啟的專案中,按一下「大綱」索引標籤。

  2. 按一下「顯示規則流程」圖示。 Schema Mapping Policy

  3. 連按兩下「綱要映射」規則,以啟動「綱要映射」編輯器。

    按一下滑鼠右鍵,並選取「編輯規則」,以啟動「綱要映射」編輯器。

    Schema Mapping Policy

規則集檢視窗

  1. 在「規則集」檢視窗中,連按兩下「綱要映射」規則。

    以滑鼠右鍵按一下「綱要映射」規則,並選取「編輯」。

鍵盤支援

表 7-1 綱要映射編輯器的鍵盤支援

動作

描述

向上鍵

在「綱要映射」編輯器中,將游標上移。

向下鍵

在「綱要映射」編輯器中,將游標下移。

向左鍵

折疊顯示的資訊

向右鍵

展開顯示的資訊。

Insert

新增類別。

Ctrl+Insert

新增屬性。

Delete

刪除選定項目。

Enter

存取編輯模式。 第二次按下 Enter 時可認可變更。

Esc

離開編輯模式。

7.1.2 編輯綱要映射規則

「綱要映射」編輯器可讓您建立並編輯綱要映射規則。 若要顯示快顯功能表,請以滑鼠右鍵按一下項目。

圖 7-1 綱要映射編輯器的快顯功能表

移除或新增類別和屬性

移除類別或屬性

如果不想要讓某個類別或屬性映射到已連接系統中的類別或屬性,最佳的作法是將「綱要映射」規則中的類別或屬性完全移除。 有三種方法可以新增或移除「綱要映射」規則中的屬性和類別:

  • 選取要移除的類別或屬性,然後按一下滑鼠右鍵,再按一下「刪除」。
  • 選取要移除的類別或屬性,然後按一下右上角的「刪除」圖示
  • 選取要移除的類別或屬性,然後按 Delete 鍵。

您可以選取多個類別或屬性,以將其同時刪除。

  1. 按 Ctrl 並以滑鼠選取每個項目。

  2. 按 Delete 鍵刪除項目。

    Deleting Multiple Classes or Attributes
新增類別
  1. 在「綱要映射」編輯器中按一下滑鼠右鍵,然後按一下「新增類別映射」。

    選取右上角的「新增類別映射」圖示 Deleting Multiple Classes or Attributes

  2. 從 Identity Vault 的下拉式清單中選取要新增的類別。

  3. 從已連接系統的下拉式清單中選取要新增的類別。

  4. 若要儲存變更,請按一下「檔案」>「儲存」。

新增屬性
  1. 在「綱要映射」編輯器中按一下滑鼠右鍵,然後按一下「新增屬性映射」。

    選取右上角的「新增屬性映射」圖示 Deleting Multiple Classes or Attributes

  2. 從 Identity Vault 的下拉式清單中選取要新增的屬性。

  3. 從已連接系統的下拉式清單中選取要新增的屬性。

  4. 若要儲存變更,請按一下「檔案」>「儲存」。

重新整理應用程式綱要

如果你已修改應用程式中的綱要,則這些變更需要反應在「綱要映射」規則中。 若要讓新的綱要可供使用,請按一下工具列中的「重新整理應用程式綱要」圖示 Deleting Multiple Classes or Attributes

建立新類別或屬性映射時,您可在已連接應用程式的下拉式清單中看到新的綱要。

編輯項目

若要編輯映射,請連按兩下選定的列。 編輯器會就地顯示,可讓您編輯映射。

圖 7-2 綱要映射編輯器

Scheme Map Editor

排序項目

「綱要」編輯器可讓您根據 Identity Manager 或已連接系統,依照遞增順序排序項目。 若要排序,請按一下任一欄的標題。

圖 7-3 綱要映射編輯器的排序項目

Sorting Items

管理綱要

Designer 可讓您管理 Identity Vault 綱要以及任何已連接系統的綱要。 您可以輸入綱要並加以修改,還可將變更過的綱要部署回 Identity Vault 或已連接系統中。 若要管理 Identity Vault 綱要,請在「綱要映射」編輯器中按一下滑鼠右鍵,然後按一下「管理 Identity Vault 綱要」。 若要管理已連接系統的綱要,請在「綱要映射」編輯器中按一下滑鼠右鍵,然後按一下「管理應用程式綱要」。 如需如何管理綱要的相關資訊,請參閱 《Designer for Identity Manager 3:管理說明》中的「管理綱要」 。

7.1.3 測試綱要映射規則

Designer 隨附一套名為「規則模擬器」的工具。 該工具可讓您測試規則而不在生產環境中加以實作。 您可以透過「綱要映射」編輯器啟動「規則模擬器」,以便在修改規則後加以測試。

若要存取「規則模擬器」並測試「綱要映射」規則,請執行下列動作:

  1. 按一下工具列中的「啟動規則模擬器」圖示 Sorting Items

  2. 選取「輸入」以瀏覽至模擬事件的檔案。

    Policy Simulator
  3. 選取檔案,然後按一下「開啟」。

    此範例使用 com.novell.designer.policy\simulation\add\user.xml 檔案,該檔案會模擬使用者物件的「新增」事件。

    Policy Simulator

    「規則模擬器」會顯示使用者「新增」事件的輸入文件。

  4. 按「下一步」開始模擬。

    Policy Simulator

    「規則模擬器」會顯示「新增」事件的記錄、輸出文件,以及輸入文件與產生之輸出文件的比較。

    Policy Simulator
  5. 選取「追蹤」索引標籤,即可查看您透過 DSTRACE 會看到之「新增」事件的結果。

    Policy Simulator
  6. 選取「輸出」索引標籤,以檢視針對輸入文件執行「綱要映射」規則時產生的輸出文件。 在此範例中,輸出文件即為使用者「新增」事件。

  7. 選取「比較」索引標籤,以比較輸入文件的文字與產生的文件 (即輸出文件)。

  8. 按一下「重複」以選取不同的輸入文件,並查看該事件的結果。

  9. 當您完成「綱要映射」規則的測試時,請按一下「完成」,關閉「規則模擬器」。

7.1.4 存取綱要映射規則 XML

Designer 可讓您藉由使用 XML 編輯器或文字編輯器來檢視、編輯及驗證 XML。

檢視 XML 來源

您可以 XML 或以 XML 樹狀結構格式檢視「XML 來源」。

若要開啟「XML 來源」檢視窗,請執行下列動作:

  1. 按一下位於「綱要映射」編輯器之工作空間底部的「XML 來源」。

XML 編輯器會顯示行號。 若要查看行號,請以滑鼠右鍵按一下左邊界,然後選取「顯示行號」。

圖 7-4 綱要映射規則的行號

XML 編輯器會依功能展開或折疊 XML。 如果有些功能包含大量的 XML,您可以按一下位於左上角的減號圖示,以折疊 XML。 若要展開所有的 XML 功能,請按一下位於左上角的加號圖示。

每個元素的左邊界皆擁有其各自的加號或減號圖示。

圖 7-5 綱要映射規則 XML 的加號或減號

若要以樹狀結構格式檢視 XML,請執行下列動作:

  1. 按一下位於「綱要映射」編輯器之工作空間底部的「XML 樹狀結構」。

若要查看整個樹狀結構檢視窗,請展開列出的每個項目。

編輯 XML 來源

您可以透過 XML 編輯器編輯 XML。 您也可以透過 GUI 介面在此處進行變更。

圖 7-6 編輯綱要映射規則的 XML 來源

載入的預設編輯器與 .xml 檔案類型相關聯。 若找不到預設編輯器,則會載入系統文字編輯器。 「XML 來源」檢視窗功能是以進行載入的編輯器為基礎。

若要顯示 XML 編輯器包含的功能清單,請按一下滑鼠右鍵。

  • 復原: 復原上一個動作。

  • 回復檔案 將檔案回復到上一次儲存的版本。

  • 儲存: 儲存檔案。

  • 剪下: 剪下選定資訊。

  • 貼上: 將資訊貼至文件。

  • 向右移: 向右縮排。

  • 向左移: 向左縮排。

  • 附加 DTD 或 XML 綱要: 附加用於驗證規則的 DTD 或 XML 綱要檔案。

  • 驗證: 驗證 XML 程式碼。

  • 優先設定: 設定 XML 編輯器的優先設定。

若要為您的來源檢視窗選擇不同的 XML 編輯器,請執行下列動作:

  1. 按一下「主功能表」中的「視窗 > 優先設定」。

  2. 按一下「一般 > 編輯器 > 檔案關聯」。

  3. 選取檔案類型清單中的「*xml」。

  4. 從「關聯的編輯器」選取所需的編輯器 (如「Novell XML Editor」)。 若您要使用的編輯器未出現在清單中,可以按一下「新增」,然後將其新增至清單中。

  5. 按一下「確定」。

  6. 關閉並重新開啟「綱要映射」編輯器。 預設編輯器應在「XML 來源」檢視窗中載入。

驗證 XML 來源

XML 編輯器會驗證 XML 程式碼。 按一下滑鼠右鍵,然後選取「驗證」。 若出現錯誤,則在發生錯誤的該行上會顯示一個紅色的 x。 視窗底端的說明提供了該問題的相關資訊。

圖 7-7 驗證綱要映射規則

在此例中,<attr-name> 的結束標籤沒有相符的開始標籤。

7.1.5 綱要映射規則的其他選項

以滑鼠右鍵按一下「綱要映射」規則時,「大綱」檢視窗、「規則流程」檢視窗和「規則集」檢視窗中會出現多個選項。

大綱檢視窗的其他選項

  1. 在「大綱」檢視窗中,以滑鼠右鍵按一下「綱要映射」規則。

    • 將規則輸出至組態檔案: 將「綱要映射」規則儲存為 .xml 檔案。

    • 即時操作 > 部署規則: 將「綱要映射」規則部署至 Identity Vault。

    • 即時操作 > 比較規則: 比較 Designer 中的「綱要映射」規則與 Identity Vault 中的「綱要映射」規則。

    • 刪除: 刪除「綱要映射」規則。

    • 編輯: 啟動「綱要映射」編輯器。 如需相關資訊,請參閱節 7.1.2, 編輯綱要映射規則

    • 複製: 建立「綱要映射」規則的副本。

    • 另存新檔: 將「綱要映射」規則儲存為 .xml 檔案。

    • 模擬: 測試「綱要映射」規則。 如需相關資訊,請參閱節 7.1.3, 測試綱要映射規則

    • 內容: 可讓您重新命名「綱要映射」規則。

規則流程檢視窗的其他選項

  1. 在「規則流程」檢視窗中,以滑鼠右鍵按一下「綱要映射」規則。

    • 新增規則 > DirXML 程序檔: 使用 DirXML® 程序檔新增「綱要映射」規則。

    • 新增規則 > XSLT: 使用 XSLT 新增「綱要映射」規則。

    • 新增規則 > 綱要映射: 新增「綱要映射」規則,其中不包含資訊。

    • 新增規則 > 連結至現有規則: 可讓您瀏覽並選取現有的「綱要映射」規則,以連結至目前的「綱要映射」規則。

    • 新增規則 > 複製現有規則: 可讓您瀏覽至現有的「綱要映射」規則並加以選取,以複製到目前的「綱要映射」規則。

    • 編輯規則 > 綱要映射: 啟動「綱要映射」編輯器。 如需相關資訊,請參閱節 7.2.2, 編輯綱要映射規則

    • 刪除規則集的所有規則: 刪除選定規則集中的所有規則。

    • 移除規則集的所有規則: 移除選定規則集中的所有規則,但不刪除現有的規則。

    • 即時操作 > 輸入驅動程式: 從 Identity Vault 輸入現有的驅動程式。

    • 即時操作 > 部署驅動程式: 將現有的驅動程式部署到 Identity Vault 中。

    • 即時操作 > 驅動程式組態 > 輸入屬性: 可讓您從 Identity Vault 輸入屬性,並且比較 Identity Vault 和 Designer 中的屬性。

    • 即時操作 > 驅動程式組態 > 部署屬性: 可讓您將屬性從 Designer 佈署到 Identity Vault 中,並且比較 Designer 和 Identity Vault 中的屬性。

    • 即時操作 > 驅動程式狀態: 顯示驅動程式的狀態。

    • 即時操作 > 啟動驅動程式: 啟動驅動程式。

    • 即時操作 > 停止驅動程式: 停止驅動程式。

    • 即時操作 > 重新啟動驅動程式: 重新啟動驅動程式。

    • 模擬: 測試「綱要映射」規則。 如需相關資訊,請參閱節 7.1.3, 測試綱要映射規則

規則集檢視窗的其他選項:

  1. 在「規則集」檢視窗中,以滑鼠右鍵按一下「綱要映射」規則。

    • 移除規則集中的規則: 移除規則集中的「綱要映射」規則,但不刪除「綱要映射」規則。

    • 連結至現有規則: 可讓您瀏覽至另一個「綱要映射」規則,並將其連結至現有的規則。

    • 向上移: 依照規則的執行順序,將「綱要映射」規則向上移。

    • 向下移: 依照規則的執行順序,將「綱要映射」規則向下移。

    • 編輯: 啟動「綱要映射」編輯器。 如需相關資訊,請參閱節 7.2.2, 編輯綱要映射規則

    • 複製: 建立「綱要映射」規則的副本。

    • 另存新檔: 將「綱要映射」規則儲存為 .xml 檔案。

    • 模擬: 測試「綱要映射」規則。 如需相關資訊,請參閱節 7.1.3, 測試綱要映射規則

    • 將規則輸出至組態檔案: 將「綱要映射」規則儲存為 .xml 檔案。

    • 即時操作 > 部署規則: 將「綱要映射」規則部署至 Identity Vault。

    • 即時操作 > 比較規則: 比較 Designer 中的「綱要映射」規則與 Identity Vault 中的「綱要映射」規則。

    • 內容: 可讓您重新命名「綱要映射」規則。

    • 刪除: 刪除「綱要映射」規則。