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

1. Klicken Sie auf das Navigationsmenü in der oberen linken Ecke.
   
2. Wählen Sie Workflows.
3. Klicken Sie auf Workflow erstellen.
4. Legen Sie fest, ob der Workflow Eingeplant oder Ereignisbasiert sein soll. Einen Vergleich dieser Optionen finden Sie unter Eingeplante Workflows vs. Ereignisbasierte Workflows.
   Tipp: Im Allgemeinen empfehlen wir, einen eingeplanten Workflow zu verwenden, damit Ihre Mitarbeiterdaten regelmäßig aktualisiert werden.
5. Bei Bedarf können Sie Ihren Workflow umbenennen, indem Sie oben auf den Workflow-Namen klicken.
   
6. Legen Sie fest, wann der Workflow ausgeführt werden soll (bei einem eingeplanten Workflow) oder welches Ereignis den Workflow auslöst (bei einem ereignisbasierten Workflow).
7. Klicken Sie auf das Pluszeichen (+), und wählen Sie Aufgabe.
8. Wählen Sie Mitarbeiterdaten aus SuccessFactors extrahieren.
   
9. Wählen Sie ein zu verwendendes SuccessFactors-Konto aus.
   
10. 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.
11. Klicken Sie auf Weiter.
12. 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.
    
13. 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 mit der Kennzeichnung „isPrimary“ ab, wie in SuccessFactors angegeben. 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.
14. 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.
15. Um ein Feld zu entfernen, klicken Sie auf das Minuszeichen ( – ) rechts neben dem Feld.
16. Klicken Sie auf Weiter.
17. Eine Vorschau wird angezeigt, die Ihnen ein Beispiel dafür zeigt, was für jedes ausgewählte Feld importiert wird.
18. 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:

1. 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.
2. Ihre Unternehmensnummer wird über den Anmeldefeldern angezeigt.
   Beispiel: Eine beispielhafte Unternehmens-ID ist BenefitsSB.
3. 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.

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.

Häufig gestellte Fragen