Freigeben über


Behandeln von Problemen bei der Benutzeraktualisierung bei der Personalbereitstellung

Null- und leere Werte werden nicht wie erwartet verarbeitet

Gilt für:

  • Workday für die lokale Active Directory-Benutzerbereitstellung
  • Workday zur Benutzerbereitstellung von Microsoft Entra
  • SAP SuccessFactors zur Benutzerbereitstellung in lokalem Active Directory
  • SAP SuccessFactors zur Microsoft Entra-Benutzerbereitstellung
Problembehandlung Einzelheiten
Problem Sie haben die App für die eingehende Bereitstellung erfolgreich konfiguriert. Sie erhalten einen leeren oder NULL-Wert von der HR-App. Sie erwarten, dass der Bereitstellungsdienst den entsprechenden Zielattributwert im lokalen Active Directory/in der lokalen Microsoft Entra ID-Instanz löscht. Der Vorgang schlägt jedoch mit dieser Fehlermeldung fehl: InvalidAttributeSyntax-LdapErr: The syntax is invalid. The parameter is incorrect. Error in attribute conversion operation, data 0, v3839
Verursachen Der Bereitstellungsdienst verfügt nicht über eine Standardlogik für die Verarbeitung von NULL-Werten. Wenn der Bereitstellungsdienst eine leere Zeichenfolge von der Quell-App erhält, versucht er, den Wert "as-is" (wie vorhanden) an die Ziel-App zu übergeben. In diesem Fall unterstützt der Bereitstellungsconnector von lokalen Active Directory-Instanzen das Festlegen leerer Zeichenfolgenwerte nicht. Daher wird der zuvor genannte Fehler angezeigt.
Auflösung Überprüfen Sie die Bereitstellungsprotokolle. Identifizieren Sie Attribute im Ziel-Active Directory, die NULL- oder leere Zeichenfolgenwerte empfangen. Aktualisieren Sie die Attributzuordnung für solche Attribute, um eine Ausdruckszuordnung zu verwenden. Siehe die empfohlenen Lösungen.

Empfohlene Auflösungen

Angenommen, das Attribut BusinessTitle, das dem AD-Attribut jobTitle zugeordnet ist, ist in Workday NULL oder leer.

  • Option 1: Verwenden Sie die Funktion Switch , um auf leere oder NULL-Werte zu überprüfen und einen nicht leeren Literalwert zu übergeben.

Switch([BusinessTitle],[BusinessTitle],"","N/A")

  • Option 2: Verwenden Sie die Funktion IgnoreFlowIfNullOrEmpty, um leere oder NULL-Attribute in der Nutzlast auszulassen, die an das lokale Active Directory/Microsoft Entra ID gesendet werden.

    IgnoreFlowIfNullOrEmpty([BusinessTitle])

Einige Aktualisierungen von Workday-Attributen fehlen

Gilt für:

  • Workday für die lokale Active Directory-Benutzerbereitstellung
  • Workday zur Benutzerbereitstellung von Microsoft Entra
Problembehandlung Einzelheiten
Problem Sie haben die Workday-App für eingehende Bereitstellungen erfolgreich konfiguriert und erfolgreich eine Verbindung mit der Workday-Mandanten-URL hergestellt. Sie beobachten, dass der Flow bestimmter Attributaktualisierungen von Workday verzögert wird oder dass die Attributänderungen von Workday in manchen Fällen während der inkrementellen Synchronisierung nicht wie erwartet ablaufen.
Verursachen Während der inkrementellen Synchronisierung fragt die Bereitstellungs-App das Workday-Transaktionsprotokoll nach Änderungen an der primären Workerentität ab und bearbeitet nur Änderungen, die vom Transaktionsprotokoll von Workday nachverfolgt werden.
Wenn Änderungen an einem Workday-Attribut in Ihrem Setup nicht im Transaktionsprotokoll von Workday nachverfolgt werden, ruft Microsoft Entra ID diese Änderung nicht ab. Beispiel: Das LocalReference Workday-Attribut ist Teil der Standardmäßigen Attributzuordnung und verfügt über XPATH wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Local_Reference/wd:ID[@wd:type='Locale_ID']/text(). Dieses Attribut ist Teil der Entität Business_Site_Summary_Data. Eine Änderung des Werts dieses Attributs in Workday wird nicht im Workday-Transaktionsprotokoll angezeigt. Daher wird während der inkrementellen Synchronisierung der neue Wert dieses Attributs nur angezeigt, wenn sich ein Attribut, das der primären Workerentität zugeordnet ist, auch während des Synchronisierungsintervalls ändert.
Auflösung Wenn Sie dieses Verhalten häufig beobachten, wenn Änderungen an bestimmten Workday-Attributen nicht weitergeleitet werden, wird empfohlen, regelmäßig eine wöchentliche oder monatliche vollständige Synchronisierung vorzunehmen.

Das Attribut wurde nicht gefunden.

Gilt für:

  • Workday für die lokale Active Directory-Benutzerbereitstellung
  • Workday zur Benutzerbereitstellung von Microsoft Entra
  • Workday für die lokale Active Directory-Benutzerbereitstellung
  • SAP SuccessFactors zur Benutzerbereitstellung in lokalem Active Directory
  • API-gesteuerte Bereitstellung in lokalem Active Directory
Problembehandlung Einzelheiten
Problem Der folgende Fehlercode wird angezeigt: HybridSynchronizationActiveDirectoryCannotFindAttribute.
Verursachen Der Attributname wurde im Active Directory-Schema unter „Attribut“ nicht gefunden.
Auflösung Wenn das Attribut kürzlich zu Active Directory hinzugefügt wurde, starten Sie den Bereitstellungs-Agent neu, da das Schema beim Start zwischengespeichert wird.

Benutzerabgleich mit extensionAttribute funktioniert nicht

Gilt für:

  • Workday zur Benutzerbereitstellung von Microsoft Entra
  • SAP SuccessFactors zur Microsoft Entra-Benutzerbereitstellung
Problembehandlung Einzelheiten
Problem Angenommen, Sie verwenden extensionAttribute3 in Microsoft Entra-ID, um die Mitarbeiter-ID zu speichern, und Sie ordnen sie dem Workday WorkerID - oder SuccessFactors personIdExternal-Attribut für den Benutzerabgleich zu. Bei dieser Konfiguration tritt beim Abgleich des Bereitstellungsprozess ein Fehler auf. Dieses Problem wirkt sich sowohl auf die Benutzererstellung als auch auf Updates aus.
Verursachen Die Microsoft Entra-ID OnPremisesExtensionAttributes (extensionAttributes1-15) kann nicht als übereinstimmende Attribut verwendet werden, da der $filter Parameter der Azure AD Graph-API das Filtern nach extensionAttributes nicht unterstützt.
Auflösung Verwenden Sie Microsoft Entra ID OnPremisesExtensionAttributes (extensionAttributes1-15) nicht als übereinstimmendes Attributpaar. Verwenden Sie die employeeID.

Updates für das E-Mail-Attribut der Microsoft Entra-ID werden nicht unterstützt

Gilt für:

  • Workday zur Benutzerbereitstellung von Microsoft Entra
  • SAP SuccessFactors zur Microsoft Entra-Benutzerbereitstellung
  • API-gesteuerte Bereitstellung von Microsoft Entra ID
Problembehandlung Einzelheiten
Problem Sie haben die Bereitstellung von E-Mail-Attributen von Ihrem HR-System auf die Microsoft Entra-ID konfiguriert. Eine Aktualisierung des mail-Attributs funktioniert nicht, obwohl die Bereitstellungsprotokolle einen Datensatz für das mail-Attribut anzeigen.
Verursachen Der Bereitstellungsconnector für Microsoft Entra unterstützt das Festlegen des E-Mail-Attributs während der Benutzerbereitstellung nicht, da dieses Attribut von Microsoft Exchange Online verwaltet wird.
Auflösung Nach dem Erstellen des Benutzers legt das Zuweisen der Exchange Online-Lizenz dem Benutzer automatisch den Benutzerprinzipalnamen als E-Mail-Adresse fest. Verwenden Sie das Exchange Online-Portal oder PowerShell, um das E-Mail-Attribut zu aktualisieren.

Bereitstellen des Felds „Letzter Arbeitstag“ über Workday

Gilt für:

  • Workday für die lokale Active Directory-Benutzerbereitstellung
  • Workday zur Benutzerbereitstellung von Microsoft Entra
Problembehandlung Einzelheiten
Problem Sie haben die Attributzuordnung für das Workday-Attribut „Letzter Arbeitstag“ (StatusTerminationLastDayOfWork) in der Bereitstellungs-App konfiguriert. Die Aktualisierung von „Letzter Arbeitstag“ erfolgt jedoch erst nach dem Kündigungsdatum, obwohl Sie „Letzen Arbeitstag“ vorher abrufen möchten.
Verursachen In Workday wird das Feld „Letzter Arbeitstag“ erst nach dem Kündigungsdatum im Arbeitsprofil festgelegt. Daher kann der Workday-Bereitstellungsconnector dieses Datum nicht vor dem Kündigungsdatum abrufen.
Auflösung Erstellen Sie in Workday eine Bereitstellungsgruppe namens „Vergangene letzte Arbeitstage der Arbeitnehmer“. Fügen Sie automatisierung in Workday hinzu, um Dieser Gruppe Benutzer zuzuweisen, wenn der letzte Arbeitstag eines Mitarbeiters erreicht ist. Fügen Sie im Microsoft Entra-Bereitstellungsauftrag ein Workday XPATH-Attribut hinzu, um diese Gruppenzuweisung abzurufen.
  • Beispiel:
    `LastDayOfWorkWorkers = wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned' and wd:Provisioning_Group=" Workers past Last Day of Work"]/wd:Provisioning_Group/text()`

Verwenden Sie dieses Feld in der Attributzuordnungslogik für das AccountDisabled-Flag.

  • Beispiel:
    `Switch([LastDayOfWorkWorkers], Switch([Active], , "1", "False", "0", "True"), 'Workers past Last Day of Work', "True")`

Verarbeitungsverzögerung der Arbeitstage

Gilt für:

  • Workday für die lokale Active Directory-Benutzerbereitstellung
  • Workday zur Benutzerbereitstellung von Microsoft Entra
Problembehandlung Einzelheiten
Problem Während der inkrementellen Synchronisierung kann es zu einer Verzögerung von 12-18 Stunden bei der Verarbeitung des Kündigungsereignisses für Mitarbeiter in den Regionen Asien-Pazifik und Australien/Neuseeland kommen.
Verursachen Die Workday Integration System User (ISU)-Konten rufen immer Daten basierend auf der Pazifischen Zeitzone ab. Der Connector implementiert derzeit keine spezielle Abfrage zum Verarbeiten von Kündigungsdatensätzen, die für eine Zeitzone spezifisch sind.
Auflösung Es gibt zwei mögliche Problemumgehungen:
  1. Verwenden Sie die Bereitstellung bei Bedarf, um das Beendigungsereignis eines bestimmten Benutzers zu verarbeiten.

  2. Erstellen Sie in Workday eine Bereitstellungsgruppe namens "Terminated Workers". Aktualisieren Sie den Beendigungsgeschäftsprozess in Workday, um Benutzern diese Gruppe zuzuweisen, wenn die Beendigung erfolgt. Fügen Sie im Microsoft Entra-Bereitstellungsauftrag ein Workday XPATH-Attribut hinzu, um diese Gruppenzuweisung abzurufen.

  • Beispiel:
    `TerminatedWorkers = wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned' and wd:Provisioning_Group="Terminated Workers"]/wd:Provisioning_Group/text()`

Verwenden Sie dieses Feld in der Attributzuordnungslogik für das AccountDisabled-Flag.

  • Beispiel:
    `Switch([TerminatedWorkers], Switch([Active], , "1", "False", "0", "True"), "Terminated Workers", "True")`

Nächste Schritte