Zum Hauptinhalt springen

SAP SuccessFactors HRIS-Integration

SAP SuccessFactors: Wie verknüpfe ich mein Konto?

Verfasst von David William

Voraussetzungen

Bitte lesen Sie sich das Folgende sorgfältig durch, um sicherzustellen, dass Sie die Einrichtung erfolgreich abschließen können:

  • Sie sind Admin Ihrer SAP SuccessFactors-Instanz. Wenn Sie kein Admin sind, können Sie die im Folgenden beschriebenen Konfigurationsseiten nicht einmal suchen oder aufrufen.

    • Alternativ: Bitte wenden Sie sich an Ihren SuccessFactors-Admin und lassen Sie ihn den Einrichtungsprozess der Integration übernehmen.

  • Die OData v2 API ist auf Ihrer SuccessFactors-Instanz verfügbar und aktiviert (das ist standardmäßig der Fall, daher müssen Sie sich in der Regel keine Sorgen machen).

Übersicht

Geschätzte Gesamtdauer der Einrichtung: 30 Minuten.

Im Grunde müssen Sie 3 Hauptschritte durchführen, um die Integration einzurichten:

1. Sie müssen einen neuen Benutzer und eine Berechtigungsgruppe für diesen Benutzer erstellen,

2. Sie müssen eine neue Berechtigungsrolle erstellen und diese der neu erstellten Berechtigungsgruppe zuweisen,

3. Sie müssen die API-Anmeldedaten für diese Berechtigungsrolle generieren.
​

Das war's! Der Rest dieses Dokuments ist eine Schritt-für-Schritt-Anleitung mit allem, was Sie wissen und tun müssen, um die Integration einzurichten.

Ihre API-Domain finden

Ihre API-Domain hängt davon ab, in welcher Region Sie ansässig sind. So finden Sie sie:

  1. Öffnen Sie die Liste der SuccessFactors-API-URLs.

  2. Filtern Sie nach Produktivumgebungen (es sei denn, Sie möchten eine Preview-Instanz verbinden)

    SuccessFactors

  3. Sobald der Filter angewendet ist, suchen Sie Ihren Standort und wählen Sie die API-Domain aus. Wenn Sie beispielsweise in Deutschland ansässig sind, würde Ihre Produktions-URL https://api012.successfactors.eu/ lauten

    SuccessFactors

Hinweis: Die resultierende „API Server"-URL sieht oft der SuccessFactors-Domain, mit der Sie sich einloggen, recht ähnlich (die API für pmsalesdemo8.successfactors.com befindet sich beispielsweise unter apisalesdemo8.successfactors.com)

Bitte beachten Sie, dass dies ein Workaround ist, da es keinen direkten Weg gibt, die API-Domain selbst über die SuccessFactors-Oberfläche zu ermitteln. SAP weist in seinem Help Center darauf hin, dass Sie sich an Ihren SAP-Berater wenden sollten, um die richtige API-Domain zu erhalten.

Ihr API-Endpunkt hängt davon ab, wo sich Ihre SAP-SuccessFactors-Instanz befindet. Sie kann sich in einem von mehreren Rechenzentren befinden. Bitte wenden Sie sich an Ihren SAP-SuccessFactors-Ansprechpartner, wenn Sie sich nicht sicher sind, welches Rechenzentrum zu verwenden ist. Die Endpunkte finden Sie im Abschnitt „Related Information".

Ihre Company ID finden

  1. Klicken Sie auf das Profilbild oben rechts und dann auf „Show version information":

    SuccessFactors

  2. Kopieren Sie den Wert direkt neben Company ID:

    SuccessFactors

Einen neuen Benutzer erstellen

  1. Gehen Sie im Admin Center zur Suchkonsole und geben Sie „Import Employee Data" ein. Klicken Sie auf die daraufhin angezeigte Aktion:

    SuccessFactors

  2. Klicken Sie auf „Import data" und wählen Sie dann „Download Template" aus:

    SuccessFactors

  3. Klicken Sie auf das Feld neben „Select an entity" und dann auf „Basic Import":

    SuccessFactors

  4. Klicken Sie auf die Schaltfläche „Generate Template"

    SuccessFactors

  5. Sie erhalten eine .csv-Datei zum Download. Sie enthält wahrscheinlich zwei Zeilen.

  6. Fügen Sie eine weitere Zeile hinzu und füllen Sie mindestens diese Felder aus
    - Status: active
    - User ID: SFAPI_INTEGRATION (Beispiel, jeder Wert ist möglich)
    - Username: SFAPI_INTEGRATION (Beispiel, jeder Wert ist möglich)
    - First name: API (Beispiel, jeder Wert ist möglich)
    - Last name: Integration (Beispiel, jeder Wert ist möglich)
    - Email: [email protected] (jeder Wert ist möglich – muss keine gültige E-Mail-Adresse sein)
    - Manager: NO_MANAGER
    - HR: NO_HR
    - Default locale: en_US
    ​
    Ihre CSV sollte nun ungefähr so aussehen wie diese Beispiel-CSV.
    ​


    ​Es ist wichtig, dass Sie Ihre eigene .csv-Vorlage generieren und dieses Beispiel nicht herunterladen, da Ihre SuccessFactors-Instanz anders konfiguriert ist
    ​

  7. Klicken Sie nun auf „Download Template" und dann auf „Import Data", um zurückzuwechseln

    SuccessFactors

  8. Klicken Sie auf das Feld neben „Select an entity" und dann auf „Basic Import"

    SuccessFactors

  9. Klicken Sie auf „Browse" und wählen Sie Ihre hochzuladende .csv-Datei aus

  10. Klicken Sie auf die Schaltfläche „Validate Import File Data"

    SuccessFactors

  11. Wenn der Dialog „Validation Successful" angezeigt wird, klicken Sie auf die Schaltfläche „Import"

    SuccessFactors

  12. Sie sollten nun diesen Erfolgsdialog sehen

    SuccessFactors

  13. Bitte lassen Sie die .csv-Datei im Hintergrund geöffnet, da Sie später darauf zurückgreifen müssen.
    ​

  14. Sie können sicherstellen, dass die Erstellung erfolgreich war, indem Sie nach dem Namen des Mitarbeiters (Vor- und Nachname) oder dem Benutzernamen suchen und ihn im Bereich „People" sehen. Lassen Sie sich nicht verunsichern, wenn der neue Benutzer nicht sofort erscheint – es kann manchmal einige Minuten dauern, bis der Benutzer in der Suche angezeigt wird!

    SuccessFactors

  15. Sobald der Benutzer wie in Schritt 12 beschrieben angezeigt wird, können Sie mit der Erstellung der Berechtigungsgruppe fortfahren.

Eine Berechtigungsgruppe erstellen

  1. Gehen Sie zu Ihrer Suchleiste und geben Sie „Manage Permission Groups" ein
    Klicken Sie auf die Aktion

    SuccessFactors

  2. Klicken Sie auf der neuen Seite auf die Schaltfläche „Create New"

    SuccessFactors

  3. Geben Sie der Gruppe einen „Namen" und klicken Sie auf „Pick a category"
    Wählen Sie die Kategorieoption „Username"

    SuccessFactors

  4. Suchen Sie nach Ihrem Benutzer (um zu erfahren, wie Sie einen neuen erstellen, klicken Sie hier), indem Sie dessen Benutzernamen eingeben, und aktivieren Sie das Kästchen daneben

  5. Klicken Sie auf „Done"

    SuccessFactors

  6. Sie sollten Ihren Benutzer nun im Personenpool sehen

  7. Klicken Sie auf „Done"

    SuccessFactors

  1. Gehen Sie zu Ihrer Suchleiste und geben Sie „Manage Permission Groups" ein
    Klicken Sie auf die Aktion

    SuccessFactors

  2. Klicken Sie auf der neuen Seite auf die Schaltfläche „Create New"

    SuccessFactors

  3. Geben Sie der Gruppe einen „Namen" und klicken Sie auf „Pick a category"
    Wählen Sie die Kategorieoption „Username"

    SuccessFactors

  4. Suchen Sie nach Ihrem Benutzer (um zu erfahren, wie Sie einen neuen erstellen, klicken Sie hier), indem Sie dessen Benutzernamen eingeben, und aktivieren Sie das Kästchen daneben

  5. Klicken Sie auf „Done"

    SuccessFactors

  6. Sie sollten Ihren Benutzer nun im Personenpool sehen

  7. Klicken Sie auf „Done"

    SuccessFactors

Eine Berechtigungsrolle erstellen

  1. Gehen Sie zur Suchleiste und geben Sie „Manage Permission Roles" ein
    Klicken Sie dann auf die gleichnamige Aktion

    SuccessFactors

  2. Klicken Sie auf der neuen Seite auf „Create New"

    SuccessFactors

  3. Geben Sie einen Namen für die Berechtigungsrolle ein

  4. Klicken Sie auf die Schaltfläche „Permission"

    SuccessFactors

  5. Jetzt müssen Sie der Berechtigungsgruppe die richtigen Berechtigungen zuweisen. Gehen Sie dazu wie folgt vor:

    1. Sehen Sie sich die benötigten Berechtigungen im Connection Flow an


      ​Dies ist nur ein Beispiel. Um die für Sie erforderlichen Scopes zu sehen, öffnen Sie den Connection Flow selbst.
      ​

    2. Stellen Sie sicher, dass auch die folgenden Berechtigungen ausgewählt sind:

      • Employee Central API

        • Employee Central HRIS OData API (read-only)

        • Employee Central Foundation OData API (read-only)

      • Manage User

        • User Account OData Entity (read-only)

    3. Suchen Sie für jeden Punkt die passende Berechtigungskategorie in der Seitenleiste. Suchen Sie z. B. für „Manage System Properties" die entsprechende Berechtigungsgruppe in der Seitenleiste der SF-Oberfläche
      Sie finden diese leichter, indem Sie STRG + F drücken und die Berechtigung dort einfügen
      ​

      SCR-20230719-nbml.png
      SCR-20230719-nczp.png

    4. Klicken Sie nun für jeden Unterpunkt auf die passende Berechtigung in der Kategorie

      SCR-20230719-nbpd.png
      SCR-20230719-ndhx.png

    5. Wenn Sie alle erforderlichen Berechtigungen angehakt haben, klicken Sie auf „Done"
      ​

      SuccessFactors

    6. Klicken Sie nun auf die Schaltfläche „Add" unter Abschnitt 3

      SuccessFactors

    7. Klicken Sie im neuen Fenster auf die Schaltfläche „Select"

      SuccessFactors

    8. Geben Sie den Namen Ihrer Berechtigungsgruppe ein (falls Sie noch keine erstellt haben, klicken Sie hier) und wählen Sie sie aus

    9. Klicken Sie auf „Done"

      SuccessFactors

    10. Sie sollten nun Ihre Berechtigungsgruppe sehen

    11. Klicken Sie erneut auf „Done"

      SuccessFactors

  6. Klicken Sie abschließend auf „Save Changes"

    SuccessFactors

    Neue OAuth2-Client-Anmeldedaten generieren

  1. Gehen Sie zu Ihrer Suchleiste und geben Sie „Manage OAuth2 Client Applications" ein
    Klicken Sie auf die Aktion

    SuccessFactors

  2. Klicken Sie im neuen Fenster auf „Register Client Application"

    SuccessFactors

  3. Geben Sie im neuen Fenster einen Namen und eine gültige URL für die Anwendung ein (dies kann buchstäblich jede beliebige URL sein – Sie können einen beliebigen Wert eingeben, er sollte lediglich mit „https://" beginnen). Aktivieren Sie dann das Kontrollkästchen „Bind to Users" und klicken Sie auf „OK"

  4. Geben Sie die USERID des Benutzers ein, den Sie zuvor erstellt haben

  5. Klicken Sie nicht auf „Generate X.509 Certificate", sondern kopieren Sie stattdessen das Zertifikat über „Copy" aus dem Connection Flow:


    ​

  6. Fügen Sie das Zertifikat ein und klicken Sie auf „Register"

  7. Klicken Sie nun in der obersten Zeile auf „View"

    SuccessFactors

  8. Rufen Sie den API-Schlüssel ab

    SuccessFactors

  9. Fügen Sie nun den API-Schlüssel und den Namen des API-Benutzers in den Connection Flow ein

  10. Klicken Sie auf „Set up integration"

    SuccessFactors

Nachdem Sie die oben genannten Schritte in Ihrem HRIS abgeschlossen haben, fahren Sie mit Schritt 2 in dieser Anleitung auf WorkFlex fort.

Verwandte Artikel
Hat dies deine Frage beantwortet?