Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Zřizování v Microsoft Entra může vymazat existující hodnotu cílového atributu, pokud je odpovídající zdrojový atribut null nebo prázdný. Tato funkce, označovaná také jako „zajištění hodnoty null“, je užitečná v případě, že je hodnota odebrána ze zdrojového systému a odpovídající hodnota musí být odebrána také z cílového systému.
Note
Vymazání hodnot atributů je aktuálně ve verzi Preview. Verze Preview zpřístupníme našim zákazníkům podle podmínek platných pro verze Preview. Tyto podmínky jsou uvedeny v celkových podmínkách produktů společnosti Microsoft pro online služby.
Konfigurace pro vymazání hodnot atributů je konzistentní napříč podporovanými integracemi zřizování. Editor zdrojového schématu a způsob, jakým zdrojový systém představuje hodnotu null, se ale může lišit podle integrace.
Rozsah a omezení
- Vymazání hodnot atributů je k dispozici ve verzi Preview pro:
- Příchozí zřizování řízené rozhraním API pro Microsoft Entra ID a místní Active Directory
- Zřizování uživatelských účtů z Workday do Microsoft Entra ID a místní služby Active Directory.
- Zřizování příchozích uživatelů SAP SuccessFactors pro Microsoft Entra ID a místní Active Directory
- Vymazání hodnot atributů je podporováno pouze pro atributy s jednou hodnotou.
- Tuto funkci lze povolit pro zřizování vlastních atributů zabezpečení.
- Vymazání hodnot atributů se v současné době nepodporuje pro scénáře zřizování odchozích aplikací, včetně zpětného zápisu Workday a zpětného zápisu SAP SuccessFactors.
- Vymazání atributů s více hodnotami se nepodporuje.
Vymazání hodnot atributů
Vymazání hodnot atributů je ve výchozím nastavení zakázané a jedná se o funkci výslovného souhlasu. Vymazání hodnot atributů používá mechanismus ochrany se dvěma bránami, který pomáhá zabránit náhodné ztrátě dat. Pro zdrojový atribut i jeho odpovídající mapování cíle musíte povolit možnost Propagovat hodnoty null.
| Zdrojová hodnota | Výsledek, je-li povoleno vyčištění |
|---|---|
| Atribut má neprázdnou hodnotu. | Služba zřizování vyhodnotí hodnotu pomocí nakonfigurovaného mapování atributů. |
| Atribut má hodnotu null nebo prázdnou hodnotu. | Během aktualizace služba zřizování vymaže existující hodnotu z mapovaného cílového atributu. |
| Pro zřizování řízené rozhraním API řekněme, že vynecháte atribut, pro který je povolený tok null. | Během aktualizace služba zřizování považuje atribut za prázdný a vymaže stávající mapovanou cílovou hodnotu. |
Při vytváření uživatele hodnota zdroje, která je null, prázdná nebo chybí, nevyplní cílový atribut, pokud nemáte nakonfigurováno Výchozí hodnota, pokud je hodnota null. Výchozí hodnota se použije pouze při vytváření. Během aktualizace služba provisioningu vymaže cílovou hodnotu místo použití výchozí hodnoty při vytvoření.
Note
Nakonfigurujte vymazání hodnoty atributu pouze pro atributy, u kterých musí prázdná nebo nulová zdrojová hodnota odebrat existující cílovou hodnotu. Nepovolujte ho pro atributy, které jsou vyžadovány ke spárování nebo vytvoření uživatele.
Předpoklady
Než začnete, ujistěte se, že:
- Máte alespoň roli správce aplikace .
- Nakonfigurovali jste zřizovací aplikaci a její mapování atributů.
- Zdrojový atribut existuje ve schématu zřizovací aplikace a má mapování cílových atributů. Další informace najdete v tématu Přizpůsobení mapování atributů Microsoft Entra.
Pro příchozí zřizování řízené rozhraním API pro místní službu služba Active Directory si projděte další požadavky na role a server a potom nakonfigurujte agenta zřizování a připojení k služba Active Directory.
Pro zřizování řízené personálním oddělením nejprve nakonfigurujte jednu z podporovaných příchozích zřizovacích aplikací:
- Workday do místní služby Active Directory.
- Workday na Microsoft Entra ID.
- SAP SuccessFactors pro místní Active Directory
- SAP SuccessFactors pro Microsoft Entra ID
Povolení toku hodnoty null pro zdrojový atribut
Nejprve nakonfigurujte atribut zdrojového schématu tak, aby předával hodnoty null. Název editoru zdrojového schématu se liší podle provisionovací integrace.
- Přihlaste se k Centrum pro správu Microsoft Entra jako alespoň správce aplikace.
- Přejděte na Entra ID>Podnikové aplikace.
- Vyhledejte a vyberte zřizovací aplikaci.
- Vyberte Zřizování>.
- Otevřete mapování atributů pro objekt, který chcete nakonfigurovat.
- Rozbalte rozšířené možnosti a pak vyberte možnost pro úpravu seznamu zdrojových atributů. Název možnosti identifikuje zdrojový systém nebo konektor.
- Ve sloupci Hodnoty null toku zaškrtněte políčko u každého zdrojového atributu, který může vymazat jeho mapovaný cílový atribut.
- Vyberte Uložit.
Povolte tok hodnot null v cílovém mapování
Dále pro každé mapování odpovídajícího cílového atributu povolte propagaci hodnoty null.
- Vraťte se na stránku mapování atributů .
- Vyberte mapování pro cílový atribut, který chcete vymazat.
- Vyberte nulové hodnoty toku.
- Výběrem možnosti OK zavřete editor mapování.
- Výběrem možnosti Uložit uložíte mapování atributů.
- Tento postup opakujte pro každý cílový atribut, který musí přijmout hodnotu null.
Obě nastavení jsou povinná. Pokud pro atribut zdrojového schématu nebo mapování cíle není vybrána možnost Flow null values, služba provisioningu nepoužije zdrojovou hodnotu null ani prázdnou zdrojovou hodnotu k vymazání cílového atributu.
Příklad zřizování řízeného rozhraním API
Následující příklad ukazuje, jak nakonfigurovat příchozí zřizování řízené rozhraním API pro vymazání hodnot atributů a odeslání hodnot null nebo prázdných hodnot v /bulkUpload požadavku.
Povolení toku hodnoty null ve zdrojovém schématu
V případě zřizování řízeného rozhraním API rozbalte rozšířené možnosti a pak vyberte Upravit atributy uživatele rozhraní API. Vyhledejte sloupec nulové hodnoty Flow a vyberte zdrojové atributy, které mohou odesílat nulové nebo prázdné hodnoty. V níže uvedeném příkladu je pro atributy rozšíření SCIM a department povolena možnost division. Toto nastavení dává službě zřizování pokyn, aby pro tyto atributy zpracovávala hodnoty null nebo prázdné hodnoty a vyhodnocovala mapování cílových atributů pro tok null.
Note
Povolení této možnosti jen u zdrojového atributu nesmaže cílovou hodnotu; cílové mapování musí také povolit propagaci hodnoty null, jak je popsáno v následující části.
Povolte tok hodnot null v cílovém mapování
Otevřete každé odpovídající mapování cílových atributů a vyberte možnost Přenášet hodnoty null. Následující příklad mapuje atribut rozšíření zdrojového SCIM department na atribut služby služba Active Directory department a povoluje tok hodnot null, takže když má zdrojový atribut SCIM hodnotu null nebo je prázdný, hodnota atributu department v služba Active Directory se vymaže.
Odeslání hodnot null nebo prázdných hodnot
Zahrňte atribut do /bulkUpload požadavku a nastavte jeho hodnotu na JSON null nebo prázdný řetězec.
Important
U provisioningu řízeného rozhraním API povolení nulových hodnot toku změní způsob, jakým se zpracovávají částečné datové části. Řekněme, že vynecháte zdrojový atribut, pro který je povolen průtok null; služba provisioningu pak vymaže namapovanou cílovou hodnotu. Neúplná nebo částečná datová část zdroje proto může neúmyslně vymazat existující hodnoty atributů. Osvědčeným postupem je zahrnout úplný zdrojový uživatelský záznam do každého hromadného požadavku pro úplnou i rozdílovou synchronizaci a použít explicitní řetězec JSON null nebo prázdný řetězec k vyžádání deterministického vymazání.
Následující výňatek vymaže existující department hodnoty a division hodnoty pro odpovídajícího uživatele:
{
"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
}
Použijte názvy zdrojových atributů ze schématu zřizovací aplikace. Ujistěte se, že požadavek obsahuje odpovídající atribut vyžadovaný vaší konfigurací, například externalId.
Pokyny k odeslání žádosti najdete v článku Rychlý start pro příchozí zřizování řízené rozhraním API pomocí Graph Exploreru nebo Rychlý start pro příchozí zřizování řízené rozhraním API pomocí cURL.
Nasazování Workday a SAP SuccessFactors
Pro příchozí provisioning v systémech Workday a SAP SuccessFactors konektor během cyklu provisioningu načítá hodnoty atributů přímo z personálního systému. K vymazání hodnoty atributu se neodesílá požadavek /bulkUpload.
- Postupujte podle kroků v povolení toku hodnoty null pro zdrojový atribut.
- V části Upřesnit možnosti vyberte upravit seznam atributů pro Workday nebo Upravit seznam atributů pro SuccessFactors podle potřeby.
- Vyberte možnost Přenášet hodnoty null pouze u těch zdrojových atributů, jejichž hodnota null nebo prázdná hodnota má odstranit namapovanou cílovou hodnotu.
- Postupujte podle kroků v části Povolení toku hodnot null v cílovém mapování pro všechny odpovídající cílové atributy.
- Vymažte hodnotu v Workday nebo SAP SuccessFactors.
- Počkejte, až další cyklus zřizování zpracuje změnu ve zdroji, nebo použijte zřizování na vyžádání k otestování konkrétního uživatele.
Aplikace Workday používá výrazy XPath a SAP SuccessFactors k načtení zdrojových atributů výrazy JSONPath. Atribut musí být přítomen ve schématu aplikace pro zřizování a konektor ho musí načíst dříve, než služba zřizování může vyhodnotit, zda má hodnotu null nebo je prázdný.
Note
Během přírůstkové synchronizace vrátí Aplikace Workday pouze změny zaznamenané v transakčním protokolu. Pokud není zjištěna změna atributu ve zdroji, viz Některé aktualizace atributů ve Workday chybí.
Pokud má hodnota null nebo prázdná hodnota vyplnit náhradní hodnotu nebo zachovat stávající cílovou hodnotu místo jejího vymazání, viz Řešení potíží s aktualizací uživatelů HR.
Ověření vymazání atributu
Jakmile služba zřizování zpracuje zdrojovou aktualizaci, ověřte výsledek v protokolech zřizování a cílovém adresáři.
V aplikaci zřizování vyberte Protokoly zřizování.
Otevřete událost procesu zřizování pro daného uživatele.
Vyberte kartu Změněné vlastnosti .
Ověřte, že cílový atribut zobrazuje prázdnou novou hodnotu.
Ověřte, že atribut již nemá hodnotu objektu v cílovém systému.
V tomto příkladu místní služby Active Directory se zdrojový atribut rozhraní API division mapuje na cílový atribut company.
V místním prostředí služby Active Directory služba zřizování odebere hodnotu atributu místo zapsání prázdného řetězce.
Řešení potíží s vymazáním hodnot atributů
Pokud cílový atribut není vymazán, použijte následující pokyny.
| Problém | Resolution |
|---|---|
| Hodnota null nebo prázdná je ignorována. | Ověřte, že je pro atribut zdrojového schématu i pro cílové mapování vybrána možnost Flow null values. |
| Nesprávný cílový atribut se vymaže. | Zkontrolujte mapování atributů a ověřte, že se zdrojový atribut mapuje na očekávaný cílový atribut. |
| Zdroj používá místo hodnoty null zástupnou hodnotu. | Nakonfigurujte zdrojovou integraci tak, aby místo zástupného symbolu vracela hodnotu null nebo prázdnou hodnotu, případně zástupný symbol před provisionováním transformujte. |
| Požadavek na zřizování řízený rozhraním API atribut nevymaže. | Použijte explicitní hodnotu ve formátu JSON null nebo hodnotu prázdného řetězce. Pokud se spoléháte na vynechání podřízeného atributu, ověřte, že jeho obsahující komplexní objekt nebo prvek kolekce zůstává v datové části. Ověřte také, že odpovídající atribut datové části identifikuje existujícího cílového uživatele. |
| Požadavek na zřizování řízený rozhraním API neočekávaně vymaže atribut. | Ověřte, že atribut nebyl vynechán z datové části. Pokud chcete zachovat stávající cílovou hodnotu, zahrňte její aktuální neprázdnou hodnotu. |
| Změna Workday nebo SAP SuccessFactors atribut nevymaže. | Ověřte, že konektor HR načetl změnu ve zdroji. Pomocí zřizování na vyžádání otestujte uživatele a zkontrolujte v protokolech zřizování zdrojovou hodnotu, kterou konektor vrátil. |
Další kroky
- Přizpůsobte mapování atributů Microsoft Entra
- Koncepty zřizování příchozích procesů řízených pomocí API
- Nejčastější dotazy týkající se příchozího zřizování řízeného rozhraním API
- Řešení potíží s příchozím zřizováním pomocí rozhraní API
- Referenční informace k integraci Microsoft Entra ID a Workday
- Microsoft Entra ID a referenční dokumentace k integraci SAP SuccessFactors
- Řešení potíží s vytvářením uživatelů personálního oddělení
- Řešení potíží s aktualizací uživatelů personálního oddělení