清除屬性值（預覽）

當對應的來源屬性為 null 或空白時，Microsoft Entra 佈建可以清除現有的目標屬性值。 此功能也稱為「空值配置」，當某個值從你的記錄系統中移除，且對應的值也必須從目標系統中移除時非常有用。

屬性值清除的設定在支援的配置整合中保持一致。 然而，原始碼結構編輯器以及原始碼系統表示空值的方式會因整合而有所不同。

預覽範圍與限制

• 以下項目目前提供預覽版，可清除屬性值：
  • API 驅動的入站配置至 Microsoft Entra ID 及 內部部署的 Active Directory。
  • Workday 的入站使用者配置至 Microsoft Entra ID 及 內部部署的 Active Directory。
  • SAP SuccessFactors 將使用者配置導入至 Microsoft Entra ID 及 內部部署的 Active Directory。
• 僅支援單一值屬性的清除。
• 此功能可用於 自訂安全屬性配置。
• 目前尚不支援在輸出應用程式佈建案例中清除屬性值，包括 Workday Writeback 和 SAP SuccessFactors Writeback。
• 不支援清除多值屬性。

屬性值如何被清除

清除屬性值的功能預設為停用，且必須明確啟用。 清除屬性值使用雙閘保護機制來防止意外資料遺失。 你必須為來源屬性及其對應的目標映射啟用「流通 Null 值」選項。

建立使用者時，null、空白或省略的來源值不會帶入目標屬性，除非你已設定 若為 null 時的預設值。 預設值僅在建立時生效。 在更新過程中，配置服務會清除目標值，而非套用建立時間的預設值。

先決條件

在您開始前，請確定：

• 你至少有 應用程式管理員 的角色。
• 你設定了一個配置應用程式及其屬性映射。
• 來源屬性存在於配置應用架構中，並有目標屬性映射。 欲了解更多，請參閱自訂 Microsoft Entra 屬性映射。

若要使用 API 驅動的 內部部署的 Active Directory 入站配置，請檢視額外的角色與伺服器前置條件，然後設定配置代理程式與 Active Directory 連線。

針對 HR 驅動的佈建，請先設定其中一個支援的輸入佈建應用程式：

• Workday 轉至 內部部署的 Active Directory。
• Workday 轉為 Microsoft Entra ID。
• SAP SuccessFactors 轉至 內部部署的 Active Directory。
• SAP SuccessFactors 轉至 Microsoft Entra ID。

啟用對來源屬性的空值流

首先，將來源結構屬性設定為 flow null 值。 來源結構編輯器的名稱會依配置整合而異。

1. 至少以應用程式管理員身份登入 Microsoft Entra 系統管理中心。
2. 導航至 Entra ID>Enterprise apps。
3. 搜尋並選擇你的配置應用程式。
4. 選擇 配置>屬性映射。
5. 打開你想設定的物件的屬性映射。
6. 展開 進階選項，然後選擇編輯來源屬性清單的選項。 選項名稱用來識別來源系統或連接器。
7. 在 Flow null values 欄位中，為每個可清除其映射目標屬性的來源屬性勾選核取方塊。
8. 選取 [儲存]。

在目標映射中啟用空值流

接著，為每個對應的目標屬性映射啟用空值流。

1. 返回屬性 映射 頁面。
2. 選擇你想清除的目標屬性的映射。
3. 選擇 流程空值。
4. 選擇 確定 以關閉映射編輯器。
5. 選擇 儲存 以儲存屬性映射。
6. 對每個必須接受空值的目標屬性重複這些步驟。

這兩種設定都是必須的。 如果來源結構屬性或目標映射未選擇 Flow 的 null 值 ，配置服務不會用 null 或空的原始碼值來清除目標屬性。

API 驅動的配置範例

以下範例說明如何設定 API 驅動的輸入佈建，以清除屬性值，並在 /bulkUpload 請求中傳送 null 值或空白值。

在原始結構中啟用空值流程

對於 API 驅動的配置，展開 「進階」選項，然後選擇 「編輯 API 使用者屬性」。 找到 Flow 的 null 值 欄位，並選擇可傳送 null 或空值的來源屬性。 在下方範例中，已針對 SCIM 擴充屬性 department 和 啟用 division。 此設定會指示佈建服務處理這些屬性的 null 值或空白值，並針對 null 流程評估目標屬性對應。

在目標映射中啟用空值流

開啟每個對應的目標屬性對應表，並選取 傳遞 Null 值。 以下範例將來源 SCIM 擴充屬性department映射到 Active Directory 屬性department，並啟用 Flow 的 null 值，當來源 SCIM 屬性為 null 或為空時，departmentActive Directory 中該屬性值會被清除。

傳送 null 或空值

在請求中包含屬性 /bulkUpload ，並將其值設為 JSON null 或空字串。

以下摘錄清除已匹配用戶的現有 department 值與 division 數值：

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:BulkRequest"
  ],
  "Operations": [
    {
      "method": "POST",
      "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
      "path": "/Users",
      "data": {
        "schemas": [
          "urn:ietf:params:scim:schemas:core:2.0:User",
          "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
        ],
        "externalId": "701984",
        "userName": "bjensen@example.com",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
          "department": null,
          "division": ""
        }
      }
    }
  ],
  "failOnErrors": null
}

使用你配置應用程式架構中的來源屬性名稱。 確保請求包含你設定所需的匹配屬性，例如 externalId。

關於提交請求的說明，請參閱 使用 Graph Explorer 快速啟動 API 驅動的入站配置 ，或使用 cURL 快速啟動 API 驅動的入站配置。

Workday 與 SAP SuccessFactors 佈建

對於 Workday 和 SAP SuccessFactor 的入站配置，連接器會在配置週期中直接從人力資源系統取得屬性值。 你不需要提交 /bulkUpload 清除屬性值的請求。

1. 請依照「 啟用來源屬性的空值流程」中的步驟操作。
2. 在 進階選項中，請選擇 Workday 的 Edit 屬性清單 ，或 SuccessFactors 的 Edit 屬性清單。
3. 僅對每個來源屬性選擇 Flow 的 null 值 ，其 null 或 empty 值應會移除映射的目標值。
4. 請針對每個對應的目標屬性，依照 在目標對應中啟用空值流程 中的步驟操作。
5. 在 Workday 或 SAP SuccessFactors 中清空該值。
6. 讓下一個配置週期處理來源變更，或使用 按需配置 來測試特定使用者。

Workday 使用 XPath 表達式，而 SAP SuccessFactors 則使用 JSONPath 表達式來取得原始屬性。 該屬性必須存在於佈建應用程式的結構描述中，且必須先由連接器擷取，佈建服務才能評估其值是否為 null 或空白。

若 null 值或空值應以後援值填入，或應保留現有的目標值而不是將其清除，請參閱 排解 HR 使用者更新問題。

確認屬性是否已清除

配置服務處理原始更新後，請在配置日誌及目標目錄中確認結果。

1. 在你的配置應用程式中，選擇 「配置日誌」。

2. 為使用者開啟配置事件。

3. 選擇 「修改屬性 」標籤。

4. 確認目標屬性顯示的新值為空白。

   

5. 確認該屬性在目標系統中物件上已不再有值。

在這個 內部部署的 Active Directory 範例中，API 來源屬性division映射到目標屬性 company。 對於 內部部署的 Active Directory，配置服務會移除屬性值，而不是寫入空字串。

排除清除屬性值的故障

如果目標屬性未被清除，請使用以下指引。

下一步

• 自訂 Microsoft Entra 屬性映射
• API 驅動的輸入佈建概念
• API 驅動的入站供應常見問題
• 排除 API 驅動的入站配置問題
• Microsoft Entra ID 與 Workday 整合參考
• Microsoft Entra ID 與 SAP SuccessFactors 整合參考
• 排解人力資源使用者建立問題
• 排解人力資源用戶更新問題