Mitarbeiterdaten aus SuccessFactors-Aufgabe extrahieren
Mitarbeiterdaten aus SuccessFactors extrahieren
Die Aufgabe Mitarbeiterdaten aus SuccessFactors extrahieren automatisiert den Export von Mitarbeiterdaten aus SuccessFactors. Sie können zentrale Mitarbeiterdaten (Name, E-Mail, eindeutige ID), Mitarbeitermetadaten (Geschlecht, Rolle, Abteilung usw.) und Organisationshierarchiedaten (Manager, Standort) in einen wiederkehrenden Zeitplan importieren, den Sie festlegen. Nachdem Ihre Daten in Qualtrics importiert wurden, müssen sie mithilfe einer Datenlader-Aufgabe gespeichert werden, in der Regel die Aufgabe zum Laden von Benutzern in das EX-Verzeichnis.
Aufgabe „Mitarbeiterdaten aus SuccessFactors extrahieren“ einrichten
- Legen Sie einen ETL-Workflow an.
- Wählen Sie Datenquelle (ETL-Extraktor).
- Wählen Sie Mitarbeiterdaten aus SuccessFactors extrahieren.
- Wählen Sie ein zu verwendendes SuccessFactors-Konto aus.
- Wenn Sie ein neues SuccessFactors-Konto zur Verwendung hinzufügen möchten, klicken Sie auf Neues Benutzerkonto hinzufügen.
Tipp: Nachdem Sie auf Neues Benutzerkonto hinzufügen geklickt haben, werden Sie aufgefordert, Ihre SuccessFactors-Kontoinformationen einzugeben. Unter finden Sie Informationen zu Ihrem SuccessFactors-Konto, um Hilfe bei der Suche nach den erforderlichen Feldern zu erhalten.
- Klicken Sie auf Weiter.
- Vier Felder werden Ihnen automatisch zugeordnet. Diese Felder entsprechen zentralen Mitarbeiterdatenfeldern und werden in der Regel in Qualtrics importiert. Bei diesen Feldern handelt es sich um den Vornamen, Nachnamen, die E-Mail-Adresse und die eindeutige ID Ihres Mitarbeiters. Bei Bedarf können Sie diese Felder aus Ihrer Zuordnung entfernen.
- Um zusätzliche Felder für den Import hinzuzufügen, klicken Sie auf Feld hinzufügen.
Tipp: Die Qualtrics-Plattform unterstützt nicht mehrere Beschäftigungsverhältnisse für einen einzelnen Teilnehmer aus SuccessFactors. Wenn ein Feld mehrere Werte enthält, ruft der Extraktor den Wert ab, der zuletzt geändert wurde. Die Auswahl anderer Werte wird derzeit nicht unterstützt. Wenn Sie mehrere Datensätze für denselben Mitarbeiter in SuccessFactors haben, muss außerdem die Aufgabe Basistransformation verwendet werden, um alle Werte herauszufiltern, die nicht die Hauptbeschäftigung sind.
- Wählen Sie ein SuccessFactors-Feld aus, indem Sie auf das Feldfeld klicken und aus der Liste auswählen. Sie können auch den Feldnamen eingeben, um ihn schneller zu finden. Sie können entweder nach dem Feldnamen (falls verfügbar, z.B. „Geschlecht“) oder nach dem Feldpfad in SuccessFactors (z.B. personal_information/birth_name) suchen.
Tipp: Benutzerdefinierte Felder können durch Eingabe des entsprechenden SuccessFactors-Feldnamens importiert werden (z.B. personal_information/custom_fieldname). Benutzerdefinierte Felder werden in den Suchergebnissen nicht angezeigt, während Sie tippen. Benutzerdefinierte Felder müssen ein Teilfeld „lastModifiedDateTime“ aufweisen, um importiert werden zu können.
- Um ein Feld zu entfernen, klicken Sie auf das Minuszeichen ( – ) rechts neben dem Feld.
- Klicken Sie auf Weiter.
- Eine Vorschau wird angezeigt, die Ihnen ein Beispiel dafür zeigt, was für jedes ausgewählte Feld importiert wird.
- Wenn die Vorschau OK aussieht, klicken Sie auf Speichern. Wenn Sie Änderungen an Ihren Feldern vornehmen müssen, wählen Sie stattdessen die Drucktaste Zurück.
Nachdem Sie Ihre SuccessFactors-Aufgabe eingerichtet haben, müssen Sie Qualtrics mitteilen, wo Ihre Daten mit einer Datenlader-Aufgabe gespeichert werden sollen. In der Regel ist dies die Aufgabe zum Laden von Benutzern in das EX-Verzeichnis.
Suchen Ihrer SuccessFactors-Kontoinformationen
Nachdem Sie auf Neues Benutzerkonto hinzufügen geklickt haben, wird ein Bild angezeigt, in dem Sie die OAuth-Anmeldeinformationen aus SuccessFactors eingeben können. Informationen zu den Voraussetzungen für die Einrichtung finden Sie auf unserer Seite Configuring SuccessFactors Tasks with OAuth Credentials.
- Name: Dies ist die Kennzeichnung, die Sie Ihrem Konto geben. Dieses Feld wird nicht für die Authentifizierung verwendet.
- Benutzername: Ihre SAP-Benutzer-ID.
Warnung: Ihr Benutzername und Ihre SAP-Benutzer-ID können abweichen. Bei der Benutzer-ID wird zwischen Groß- und Kleinschreibung unterschieden.
- API-Schlüssel, privater Schlüssel des X.509-Zertifikats: Die X.509-Zertifikatsauthentifizierung fügt Ihren Daten eine zusätzliche Schutzschicht hinzu. Wenn Sie einen OAuth-Client mit diesem Zertifikat registrieren, wird auch ein API-Schlüssel generiert.
Tipp: Es gibt 2 Möglichkeiten, das Zertifikat und den privaten Schlüssel zu generieren. Sie können Ihr eigenes Zertifikat und Ihren eigenen privaten Schlüssel generieren, oder SAP hat die Möglichkeit, beim Registrieren der OAuth2-Client-Anwendung zu generieren, die Sie von SuccessFactors herunterladen können. Wenn Sie einen privaten Schlüssel generieren, muss dieser im PKCS8-Format vorliegen. Weitere Informationen finden Sie in der SAP-Dokumentation.
Weitere Informationen zu diesem Prozess finden Sie in der folgenden SAP-Dokumentation:
-
- OAuth2-Client-Anwendung registrieren
- X.509-Zertifikat in SAP SuccessFactors anlegen
- SAML-Assertion generieren
- Zugriffstoken anfordern
- Gültigkeit eines Zugriffstokens anzeigen
Tipp: Die letzten drei Dokumente in dieser Liste sind für SuccessFactors-Administratorbenutzer oder andere Benutzer mit der Berechtigung zum Erstellen von OAuth-Integrationen vorgesehen. Wenn Sie weitere Hilfe bei der Zertifikatsauthentifizierung benötigen, wenden Sie sich an den SuccessFactors-Support.
- Datacenter-Domäne: Ihre SuccessFactors-Domäne.
Tipp: Fügen Sie http:// nicht in die URL ein.
- Unternehmens-ID: Ihre SuccessFactors-Unternehmens-ID.
Einige der folgenden Felder finden Sie auf Ihrer SuccessFactors-Anmeldeseite:
- Ihr Benutzername wird in das Feld „Benutzername“ eingegeben.
Warnung: Ihr Benutzername und Ihre SAP-Benutzer-ID können abweichen. Bei der Benutzer-ID wird zwischen Groß- und Kleinschreibung unterschieden.
- Ihre Unternehmensnummer wird über den Anmeldefeldern angezeigt.
Beispiel: Eine beispielhafte Unternehmens-ID ist BenefitsSB.
- Ihre Datacenter-Domäne finden Sie in Ihrer URL, nachdem Sie sich bei SuccessFactors angemeldet haben.
Tipp: Fügen Sie http:// nicht in die URL ein.Beispiel: Eine Beispiel-Datacenter-Domäne ist apisalesdemo4.successfactors.com.
Wenn Sie Hilfe beim Zugriff auf Ihre SuccessFactors-Informationen benötigen, lesen Sie unsere Seite Konfigurieren von SuccessFactors-Aufgaben mit OAuth-Anmeldeinformationen, oder wenden Sie sich an den SuccessFactors-Support.
Fehlerbehebung für SuccessFactors-Aufgaben
Um Fehler in Ihrem Workflow zu beheben, gehen Sie zu den Workflow-Berichten, und zeigen Sie die Ausgabe Ihres Workflows an. Wenn Ihr Workflow fehlgeschlagen ist, enthält er Informationen darüber, warum er fehlgeschlagen ist.
Falsche Kontoanmeldedaten
Siehe SuccessFactors-Aufgaben mit OAuth-Credentials konfigurieren.
Importierte Felder sind leer
Die Aufgabe zum Extrahieren von Mitarbeiterdaten aus SuccessFactors zeigt alle nicht benutzerdefinierten Felder an, die mit einem SuccessFactors-Konto verknüpft sind. Es ist jedoch möglich, dass dem in der Aufgabe ausgewählten Feld keine Informationen in SuccessFactors zugeordnet sind. Stellen Sie sicher, dass der von Ihnen ausgewählte Feldpfad mit einem ausgefüllten Feld in SuccessFactors übereinstimmt. Beachten Sie, dass einige Feldnamen mit mehreren Standorten in SuccessFactors verknüpft sein können. Beispielsweise sind „/personal_information/created_by“ und „address_information/created_by“ unterschiedliche Felder!
Häufige Feldfehler
Diese Tabelle listet häufige Fehler und deren Behebungen auf. Diese Fehler treten auf, wenn Sie eine Vorschau Ihrer importierten Daten in der Aufgabe Mitarbeiterdaten aus SuccessFactors extrahieren anzeigen.
Fehlermeldung | Auflösung |
Die Anfrage des Vorschaudatensatzes war erfolgreich, aber es wurden keine Ergebnisse empfangen. | Wenden Sie sich an den SuccessFactors-Support, um zu erfahren, warum keine Datensätze zurückgegeben werden. |
Feldpfad {{Field Path Here}} kann nicht aus Antwort geparst werden. Feldpfad muss vom Typ “Boolesch” oder “Zeichenfolge” sein. | Dies ist eine Warnmeldung, die darauf hinweist, dass der Feldpfad kein Boolescher Wert oder String im Vorschaudatensatz war.
Prüfen Sie den Feldtyp im ODATA-Dictionary in SuccessFactors. |
Fehler beim Abrufen des OAuth-Tokens aus SuccessFactors: {{Error from SuccessFactors}}. | Credential-Fehler beim Anfordern des OAuth-Tokens. Der spezifische Grund wird in der Nachricht von SuccessFactors angezeigt.
Bekannte Gründe:
Um diesen Fehler zu beheben, aktualisieren Sie Ihre Anmeldeinformationen, damit sie korrekt sind. Weitere Informationen finden Sie unter SuccessFactors-Aufgaben mit OAuth-Anmeldeinformationen konfigurieren. |
Fehler von SuccessFactors beim Abrufen des Vorschaudatensatzes: {{Error from SuccessFactors}}. | Fehler bei OData-API-Aufruf aus SuccessFactors. Der spezifische Grund wird in der Nachricht von SuccessFactors angezeigt. Dieser Fehler tritt auf, weil die Eigenschaft nicht gefunden werden kann.
Weitere Informationen zur Behebung dieses Fehlers finden Sie unten im Unterabschnitt „Eigenschaft nicht gefunden“. |
Beim Abrufen des Vorschaudatensatzes von SuccessFactors ist ein unerwarteter interner Fehler aufgetreten. | Interner Fehler auf Qualtrics-Seite. Wenden Sie sich an den Qualtrics-Support. |
Eigenschaft nicht gefunden
Wenn Sie versuchen, benutzerdefinierte SuccessFactors-Felder zu importieren, kann das Format in unserer Feldauswahlliste nicht validiert werden. Wenn Sie bei der Vorschau Ihres Imports einen unerwarteten Fehler erhalten, z.B. „Ungültige Eigenschaftsnamen“, prüfen Sie in SuccessFactors, ob der Feldpfad korrekt ist.
Um ein Feld zu suchen, wechseln Sie zum Admin-Center in SuccessFactors, und navigieren Sie dann zu Ihrem OData-API-Datenverzeichnis.
Wechseln Sie von hier zur Registerkarte Entität, und suchen Sie das Feld, das Sie hinzufügen möchten. Stellen Sie sicher, dass das Feld vorhanden ist und dass der Feldpfad mit dem übereinstimmt, was Sie in der Qualtrics-Aufgabe „Mitarbeiterdaten aus SuccessFactors extrahieren“ hinzugefügt haben. Im Allgemeinen ist „PerPerson“ die Basisentität, mit der begonnen wird, um den richtigen Feldpfad zu finden. Wenn der Feldpfad korrekt ist und der Fehler weiterhin auftritt, wenden Sie sich an den SuccessFactors-Support, um Unterstützung zu erhalten.