Rippling
Holen Sie Ihre Personaldaten aus Rippling in MuchSkills. Ihr Rippling-Administrator gibt MuchSkills einen reinen Lesezugriff, und wir übernehmen die Feldzuordnung und die Synchronisierung. Die Einrichtung gehört zu Ihrer MuchSkills-Implementierung.
- Wer
- Ihr Administrator für Rippling, gemeinsam mit unserem CTO
- So funktioniert die Anbindung
- Individuelle Einrichtung im Rahmen Ihrer Implementierung
- Synchronisierung
- Alle 5 Stunden oder bei Bedarf über Sync Now
- Zugriff
- Nur Lesezugriff
How to
So funktioniert es
MuchSkills ruft die Daten nach festem Zeitplan aus Rippling ab. Neueintritte, Austritte sowie Wechsel von Führungskraft oder Abteilung werden bei der nächsten Synchronisierung übernommen, ohne dass auf einer der beiden Seiten manueller Aufwand entsteht. In Rippling wird nichts zurückgeschrieben.
Bevor Sie beginnen
- Ein Rippling-Administrator in Ihrem Unternehmen oder Ihr Rippling-Implementierungspartner.
- Eine Liste der Personen, die in MuchSkills erscheinen sollen: alle oder eine Auswahl nach Land, Gesellschaft, Abteilung oder Beschäftigungsart.
- Ihre Feldnamen. Benutzerdefinierte Felder heißen in jeder Rippling-Installation anders. Halten Sie Ihre Feldliste deshalb für die technische Sitzung bereit.
Schritte
In Rippling
Ihr Rippling-Administrator erstellt in der Developer-App von Rippling ein API-Token. Das Token liest mit den Berechtigungen der Person, die es erstellt, daher kommt es darauf an, wem es gehört. Die Bezeichnungen stammen aus der Entwicklerdokumentation von Rippling. Rippling-Dokumentation
- Prüfen Sie, ob Ihr Rippling-Konto API-Zugriff hat. Sie benötigen die App Developer unter Tools und die Berechtigung Create and manage API Tokens. Laut Rippling erfordern Abwesenheitsdaten die Berechtigungsstufe API Tier 1. Fehlt die App oder die Berechtigungsstufe, wenden Sie sich an Ihren Account Manager bei Rippling.
- Legen Sie fest, wem das Token gehört. Das Token sieht nur, was das Berechtigungsprofil seines Inhabers zulässt, und Rippling widerruft es automatisch, wenn diese Person das Unternehmen verlässt. Wählen Sie einen langjährigen Administrator, dessen Berechtigungsprofil die Personen abdeckt, die in MuchSkills sein sollen, zum Beispiel The entire company oder eine kleinere Gruppe, mit grundlegenden statt sensiblen Beschäftigungsdaten. Ein Super Admin kann ein solches Profil unter Settings › Permissions › New Permission Profile einrichten.
- Erstellen Sie das Token. Gehen Sie zu Tools › Developer › API Tokens und wählen Sie Create API token. Nennen Sie es MuchSkills, vergeben Sie eine eindeutige Kennung und wählen Sie die neueste API version.
- Wählen Sie Scopes mit reinem Lesezugriff. Wählen Sie
workers.read,users.read,departments.read,work-locations.readundemployment-types.readsowieteams.read, falls Sie Teams nutzen. Fügen Sieleave-requests.readnur hinzu, wenn Sie Abwesenheiten teilen. Wählen Sie wedercompensations.readnoch einen Scope, der aufread-writeendet. - Kopieren Sie das Token. Klicken Sie auf Create und kopieren Sie das Token sofort: Rippling zeigt es nur einmal an. Anschließend informiert Rippling Ihre Admins per E-Mail, dass ein neues Token erstellt wurde. Das ist so vorgesehen.
- Notieren Sie Ihre Verbindungsdaten. Das API-Token, die Basis-URL
https://rest.ripplingapis.com, den Namen des Token-Inhabers und die gewählten Scopes.
Gemeinsam mit MuchSkills
- Senden Sie uns die Verbindungsdaten. Die Zugangs- und Verbindungsdaten aus den Schritten oben, Ihre Feldliste und Ihren Geltungsbereich, über einen sicheren Kanal, den wir gemeinsam festlegen.
- Nehmen Sie an der technischen Sitzung teil. Ihr Administrator für Rippling und unser CTO ordnen gemeinsam die Felder zu und testen die Verbindung.
- Prüfen Sie eine erste Synchronisierung. Wir synchronisieren eine Handvoll Personen oder eine Abteilung. Sie prüfen in MuchSkills deren Namen, Führungskräfte, Abteilungen und etwaige Tags.
- Erweitern Sie den Geltungsbereich. Wir schalten die Synchronisierung für alle Personen im Geltungsbereich ein. Ab dann läuft sie alle 5 Stunden.
Prüfen, ob es funktioniert hat
- Unter Team/Org › Members sind die Personen im Geltungsbereich aufgeführt.
- Die Personen im Geltungsbereich haben eine Einladung erhalten, ihr Profil in MuchSkills anzulegen.
- Führungskräfte sehen die Personen, die direkt an sie berichten, unter My Circle.
Benefits
Ihre Vorteile
- Rippling bleibt die maßgebliche Datenquelle. Personaldaten werden nur einmal erfasst, in Rippling, und MuchSkills übernimmt sie.
- Eine Kompetenzebene für Ihr HR-System. Kompetenzen, Zertifizierungen und Projekthistorie stehen direkt neben den Personaldatensätzen, denen Sie bereits vertrauen.
- Saubere Daten für die Planung. Berichtslinien, Abteilungen und Tags kommen direkt nutzbar an, für Filter, Skill-Gap-Analysen und Team Builder.
Important to know
Wichtig zu wissen
Was synchronisiert wird. Nur Name und E-Mail-Adresse sind Pflicht. Synchronisieren Sie so viele der übrigen Felder wie möglich, denn jedes davon macht MuchSkills nützlicher.
| Feld | Erforderlich | Verwendung |
|---|---|---|
| Vor- und Nachname | Pflicht | Profile, Suche, alle Ansichten |
| Pflicht | Abgleich und Anmeldung. Muss die Adresse sein, mit der sich die Personen anmelden | |
| Jobtitel | Empfohlen | Profile, Rollen, Discover |
| Führungskraft | Empfohlen | Berichtslinien, My Circle, Berichte. MuchSkills übernimmt dieses Feld automatisch aus Rippling |
| Abteilung | Empfohlen | Abteilungen und Filter |
| Beschäftigungsstatus | Empfohlen | Deaktivierung ausgeschiedener Mitarbeitender |
| Standort oder Land | Empfohlen | Filter und Eingrenzung des Geltungsbereichs |
| Profilfoto | Empfohlen | Profile und Organigramm |
| Beschäftigungsart | Empfohlen | Filter, zum Beispiel nach Angestellten oder externen Kräften |
| Abwesenheit | Empfohlen | Verfügbarkeit in Team Builder und My Circle. Nur Datumsangaben und Prozentsätze |
| Weitere Felder | Optional | Jedes Feld lässt sich als filterbares Tag nutzen, zum Beispiel Gesellschaft, Team oder Kostenstelle. Stimmen Sie diese Felder vorher mit uns ab |
Daten, die MuchSkills nicht annimmt. Diese Daten werden beim Eingang blockiert und nie gespeichert, selbst wenn die Quelle sie mitliefert: Alter oder Geburtsdatum, Gehalt oder andere Vergütungsdaten, Leistungsbeurteilungen sowie politische, religiöse oder Gesundheitsdaten.
Wer einbezogen wird. Bevorzugt wird, die Sichtbarkeit des Integrationsbenutzers in Rippling einzuschränken, sodass nichts außerhalb Ihres Geltungsbereichs Ihr System verlässt. Die Alternative ist ein Länderfilter in MuchSkills; Datensätze außerhalb davon werden ignoriert und nicht gespeichert. Ihr Sicherheits- oder Compliance-Team entscheidet, was zu Ihren Vorgaben passt.
Ausgeschiedene Personen werden deaktiviert, nicht gelöscht. Projekthistorie und Zertifikate bleiben erhalten.
Unsere IP-Adressen. MuchSkills verbindet sich immer von denselben zwei Adressen: 13.51.77.53 und 16.170.107.61. Wenn Rippling oder Ihr Netzwerk den Zugriff nach IP-Adresse beschränkt, nehmen Sie beide in die Allowlist auf.
Common errors
Fehlerbehebung
| Was Sie sehen | Ursache | Was zu tun ist |
|---|---|---|
| Einige Personen fehlen | Sie liegen außerhalb dessen, was der Integrationsbenutzer in Rippling sehen kann, oder außerhalb des Bereichsfilters | Prüfen Sie die Berechtigungen des Integrationsbenutzers und den Geltungsbereich |
| Führungskräfte fehlen oder sind falsch | Die Führungskraft liegt außerhalb des Geltungsbereichs, oder in Rippling ist keine Führungskraft hinterlegt | Prüfen Sie, ob alle Führungskräfte im Geltungsbereich liegen und die Berichtslinien in Rippling gepflegt sind |
| Eine Person erscheint doppelt | Ihre E-Mail-Adresse in Rippling weicht von der Adresse ab, mit der sie sich registriert hat | Gleichen Sie die E-Mail-Adresse in Rippling an und wenden Sie sich dann an den Support |
| Die Verbindung wird abgelehnt | Rippling oder Ihr Netzwerk beschränkt den Zugriff nach IP-Adresse | Nehmen Sie 13.51.77.53 und 16.170.107.61 in die Allowlist auf |
| Die Synchronisierung wurde gestoppt | Die Zugangsdaten sind abgelaufen, oder der Integrationsbenutzer wurde deaktiviert oder hat Berechtigungen verloren | Erneuern Sie den Zugriff in Rippling und senden Sie uns die neuen Daten auf sicherem Weg |
Häufig gestellte Fragen
Rippling ist in MuchSkills nicht aufgeführt oder wird als Contact us angezeigt. Können wir es trotzdem anbinden?
Ja. Rippling wird individuell eingerichtet statt über ein Formular, weil jede Installation anders konfiguriert ist. Schreiben Sie an support@muchskills.com oder nutzen Sie den Chat, und wir vereinbaren die technische Sitzung.
Brauchen wir Middleware oder eine Integrationsplattform?
Nein. MuchSkills greift per HTTPS direkt lesend auf Rippling zu. Ihr Team muss lediglich den hier beschriebenen Lesezugriff einrichten.
Können wir bestimmte Länder, Gesellschaften oder Gruppen ausschließen?
Ja. Am besten schränken Sie in Rippling ein, was der Integrationsbenutzer sehen kann, sodass nur Personen im Geltungsbereich Ihr System überhaupt verlassen. Ist das nicht möglich, kann MuchSkills beim Eingang der Datensätze nach Land filtern und den Rest ignorieren, ohne ihn zu speichern.
Können wir zuerst mit wenigen Personen testen?
Ja. Die erste Synchronisierung lässt sich auf eine Handvoll Personen oder eine Abteilung beschränken. Sie prüfen das Ergebnis, dann erweitern wir den Umfang. Separate Test-Tenants gibt es nicht.
Wie oft wird synchronisiert?
Alle 5 Stunden. Ein Owner oder Admin kann mit Sync Now außerdem jederzeit eine Synchronisierung starten.
Was passiert, wenn jemand ausscheidet?
Sie werden bei der nächsten Synchronisierung deaktiviert, nie gelöscht. Ihre Projekthistorie und Zertifikate bleiben erhalten, was für die Compliance wichtig ist.
Importieren Sie Abwesenheitsgründe?
Nein. Wenn Sie Abwesenheiten synchronisieren, übernimmt MuchSkills nur die Zeiträume und den prozentualen Anteil der Abwesenheit. Gründe wie Krankheit werden nie importiert.
Wie übermitteln wir die Zugangsdaten sicher?
Über einen sicheren Kanal, den wir vorab mit Ihnen vereinbaren, etwa eine Freigabe über einen Passwortmanager. Niemals per einfacher E-Mail.