Voraussetzungen
*Wir möchten darauf hinweisen, dass sich die Abbildungen sich im Laufe der Zeit verändern können, hier ist der Stand zum Zeitpunkt der Erstellung des Artikels zu sehen*
Bitte lesen Sie die folgenden Hinweise sorgfältig durch, um sicherzustellen, dass Sie die Einrichtung abschließen können:
Sie sind Administrator Ihrer SAP SuccessFactors-Instanz. Wenn Sie kein Administrator sind, können Sie die später beschriebenen Konfigurationsseiten nicht suchen und darauf zugreifen.
Alternativ: Bitte wenden Sie sich an Ihren SuccessFactors-Administrator und lassen Sie ihn den Einrichtungsprozess der Integration übernehmen.
Die OData v2-API ist auf Ihrer SuccessFactors-Instanz verfügbar und aktiviert (dies ist standardmäßig der Fall, Sie müssen sich also normalerweise keine Sorgen machen).
Überblick
Geschätzte Gesamteinrichtungszeit: 30 Minuten.
Grundsätzlich müssen Sie zum Einrichten der Integration drei Hauptschritte ausführen:
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 dann der neu erstellten Berechtigungsgruppe zuweisen.
3. Sie müssen die API-Anmeldeinformationen für diese Berechtigungsrolle generieren.
Das war's! Der Rest dieses Dokuments enthält eine Schritt-für-Schritt-Anleitung für alles, was Sie zum Einrichten der Integration wissen und tun müssen.
Finden Sie Ihre API-Domäne
Ihre API-Domäne hängt von der Region ab, in der Sie ansässig sind. Um sie zu finden, müssen Sie:
1. Öffnen Sie die URL-Liste der SuccessFactors-API .
2. Filter für Produktionsumgebungen ( es sei denn, Sie versuchen, eine Vorschauinstanz zu verbinden )
3. Sobald der Filter angewendet wurde, suchen Sie Ihren Standort und wählen Sie die API-Domäne aus. Wenn Sie beispielsweise in Deutschland ansässig sind, lautet Ihre Produktions-URL: https://api012.successfactors.eu/.
Hinweis: Die resultierende „API-Server“-URL ähnelt häufig der SuccessFactors-Domäne, über die Sie sich anmelden (die API für pmsalesdemo8.successfactors.com befindet sich beispielsweise unter apisalesdemo8.successfactors.com ).
Bitte beachten Sie, dass dies eine Problemumgehung ist, da es keine direkte Möglichkeit gibt, die API-Domäne selbst über die SuccessFactors-Benutzeroberfläche abzurufen. SAP weist in seinem Hilfecenter darauf hin , dass Sie sich an Ihren SAP-Berater wenden sollten, um die richtige API-Domäne zu erhalten.
Ihr API-Endpunkt hängt vom Standort Ihrer SAP-SuccessFactors- Instanz ab. Er kann sich in einem von mehreren Rechenzentren befinden. Wenden Sie sich bitte an Ihren SAP-SuccessFactors -Ansprechpartner, wenn Sie sich nicht sicher sind, welches Rechenzentrum Sie verwenden sollen. Die Endpunkte finden Sie im Abschnitt „Weiterführende Informationen“.
Finden Sie Ihre Firmen-ID
1. Klicken Sie oben rechts auf das Profilbild und dann auf „ Versionsinformationen anzeigen“ :
2. Kopieren Sie den Wert direkt neben der Firmen-ID :
Einen neuen Benutzer erstellen
1. Gehen Sie im Admin Center zur Suchkonsole und geben Sie „ Mitarbeiterdaten importieren“
ein. Klicken Sie auf die gerade angezeigte Aktion:
2. Klicken Sie auf „ Daten importieren“ und wählen Sie dann „ Vorlage herunterladen“ :
3. Klicken Sie auf das Feld neben „Entität auswählen“ und dann auf „ Basisimport “:
4. Klicken Sie auf die Schaltfläche "Vorlage generieren"
5. Sie erhalten eine CSV-Datei zum Download. Diese enthält wahrscheinlich zwei Zeilen.
6. Fügen Sie eine zusätzliche Zeile hinzu und füllen Sie mindestens diese Felder aus
: - Status : aktiv
- Benutzer-ID : SFAPI_INTEGRATION (z. B. jeder mögliche Wert)
- Benutzername : SFAPI_INTEGRATION (z. B. jeder mögliche Wert)
- Vorname : API (z. B. jeder mögliche Wert)
- Nachname : Integration (z. B. jeder mögliche Wert)
- E-Mail : [email protected] (jeder mögliche Wert – muss keine gültige E-Mail-Adresse sein)
- Manager : KEIN_MANAGER
- HR : KEIN_HR
- Standardgebietsschema : en_US
Ihre CSV sollte jetzt in etwa wie diese Beispiel-CSV aussehen.
Es ist wichtig, dass Sie Ihre eigene CSV-Vorlage generieren und dieses Beispiel nicht herunterladen, da Ihre SuccessFactors-Instanz anders konfiguriert wird
7. Klicken Sie nun auf " Vorlage herunterladen " und dann auf "Daten importieren" , um zurück zu wechseln
8. Klicken Sie auf das Feld neben „ Entität auswählen “ und dann auf „ Basisimport “.
9. Klicken Sie auf „ Durchsuchen “ und wählen Sie Ihre CSV-Datei zum Hochladen aus
10. Klicken Sie auf die Schaltfläche „ Importdateidaten validieren“.
11. Wenn das Dialogfeld „Validierung erfolgreich“ angezeigt wird , klicken Sie auf die Schaltfläche „Importieren“.
12. Sie sollten jetzt diesen Erfolgsdialog sehen
13. Bitte lassen Sie die CSV-Datei im Hintergrund geöffnet, da Sie später darauf verweisen müssen.
14. Sie können die erfolgreiche Erstellung überprüfen, indem Sie nach dem Mitarbeiternamen (Vor- und Nachname) oder Benutzernamen suchen und ihn im Bereich „Personen“ anzeigen . Seien Sie nicht verwirrt, wenn der neue Benutzer nicht sofort angezeigt wird. Es kann manchmal einige Minuten dauern, bis er in der Suche angezeigt wird!
15. Sobald der Benutzer wie in Schritt 12 beschrieben angezeigt wird, können Sie mit der Erstellung der Berechtigungsgruppe fortfahren.
Erstellen einer Berechtigungsgruppe
1. Gehen Sie zu Ihrer Suchleiste und geben Sie " Berechtigungsgruppen verwalten " ein.
Klicken Sie auf die Aktion
2. Klicken Sie auf der neuen Seite auf die Schaltfläche "Neu erstellen"
3. Geben Sie der Gruppe einen „ Namen “ und klicken Sie auf „ Wählen Sie eine Kategorie “. Wählen Sie die Kategorieoption „ Benutzername“.
4. Suchen Sie nach Ihrem Benutzer (um zu erfahren, wie Sie einen neuen erstellen, klicken Sie hier ), indem Sie seinen Benutzernamen eingeben und das Kästchen daneben ankreuzen
5. Klicken Sie auf " Fertig "
6. Sie sollten Ihren Benutzer jetzt im Personenpool sehen
7. Klicken Sie auf " Fertig "
Erstellen einer Berechtigungsrolle
1. Gehen Sie zur Suchleiste und geben Sie " Berechtigungsrollen verwalten " ein. Klicken Sie dann auf die gleichnamige Aktion
2. Klicken Sie auf der neuen Seite auf „Neu erstellen“.
3. Geben Sie einen Namen für die Berechtigungsrolle ein
4. Klicken Sie auf die Schaltfläche "Berechtigung"
5. Nun müssen Sie der Berechtigungsgruppe die richtigen Berechtigungen zuweisen. Führen Sie dazu die folgenden Schritte durch:
1. Die erforderlichen Berechtigungen werden im Verbindungsfluss angezeigt.
Dies ist nur ein Beispiel. Um die für Sie erforderlichen Bereiche anzuzeigen, öffnen Sie den Verbindungsfluss selbst.
2. Suchen Sie für jeden Punkt die Berechtigungskategorie in der Seitenleiste. Suchen Sie beispielsweise für "Systemeigenschaften verwalten" die entsprechende Berechtigungsgruppe in der Seitenleiste der SF-Benutzeroberfläche.
Sie finden diese einfacher, indem Sie STRG + F drücken und die Berechtigung dort einfügen.
3. Klicken Sie nun für jeden Unterpunkt auf die richtige Berechtigung in der Kategorie
6. Wenn Sie alle erforderlichen Berechtigungen überprüft haben, klicken Sie auf " Fertig "
7. Klicken Sie nun unter Abschnitt 3 auf die Schaltfläche "Hinzufügen"
8. Klicken Sie im neuen Fenster auf die Schaltfläche "Auswählen"
9. Geben Sie den Namen Ihrer Berechtigungsgruppe ein (falls Sie noch keine erstellt haben, klicken Sie hier ) und wählen Sie sie aus
10. Klicken Sie auf „Fertig“.
11. Sie sollten jetzt Ihre Berechtigungsgruppe sehen
12. Klicken Sie erneut auf „Fertig“
13. Klicken Sie abschließend auf „Änderungen speichern“.
Generieren Sie neue OAuth2-Clientanmeldeinformationen
1. Gehen Sie zu Ihrer Suchleiste und geben Sie " OAuth2-Clientanwendungen verwalten " ein. Klicken Sie auf die Aktion
2. Klicken Sie im neuen Fenster auf „ Client-Anwendung registrieren “.
3. Geben Sie im neuen Fenster einen Namen und eine gültige URL (das kann buchstäblich jede beliebige URL sein , Sie können jeden beliebigen Wert eingeben – sie sollte mit beginnen) für die Anwendung ein, aktivieren Sie dann das Kontrollkästchen „ An Benutzer binden “ und klicken Sie auf „ OK “.
4. Geben Sie die USERID des Benutzers ein , den Sie zuvor erstellt haben
5. Klicken Sie nicht auf „X.509-Zertifikat generieren“ , sondern „ kopieren “ Sie stattdessen das Zertifikat aus dem Verbindungsablauf:
6. Fügen Sie das Zertifikat ein und klicken Sie auf „Registrieren“
7. Klicken Sie nun in der Zeile ganz oben auf „Ansicht“
8. Holen Sie sich den API-Schlüssel
9. Fügen Sie nun den API-Schlüssel und den Namen des API-Benutzers in den Verbindungsablauf ein
10. Klicken Sie auf „ Integration einrichten“