Zum Hauptinhalt gehen

Hallo, wie können wir Ihnen heute helfen?

Oder wählen Sie eine Kategorie unten aus
Erste Schritte
Videos

ADP Workforce Now

  1. Exclaimer Wissensdatenbank
  2. Benutzerhandbuch
  3. Konfiguration
  4. Benutzerdaten verwalten
Payal Arya
  • Aktualisiert

Beschreibung

HINWEIS: Diese Integration ist nur für Nutzer des Pro-Plans verfügbar. Weitere Informationen zu den Preismodellen finden Sie unter Exclaimer Preismodelle. 

Sie können ADP Workforce Now verwenden, um sich über Bindbee mit Exclaimer zu integrieren. Exclaimer verbindet sich mit ADP Workforce Now mithilfe einer Client-ID, eines Client-Geheimnisses und eines Zertifikats, die Sie in ADP API Central erstellen. Bindbee verwendet diese Zugangsdaten, um Mitarbeiterkontaktinformationen abzurufen und mit Exclaimer zu synchronisieren, damit sie in E-Mail-Signaturen verwendet werden können. Während der Einrichtung können Bindbee-URLs, Authentifizierungsaufforderungen oder Verbindungsfenster angezeigt werden.

Diese Integration ist für Exclaimer-Abonnements mit Microsoft 365 und Google Workspace verfügbar.

Einrichten von ADP Workforce Now für die Exclaimer-Integration (ADP Workforce Now)

Folgen Sie den untenstehenden Schritten, um die erforderlichen Details aus ADP Workforce Now zu sammeln, bevor Sie die Verbindung zu Exclaimer herstellen.

Voraussetzungen: 
• Administratorzugang zu ADP API Central, einschließlich der Berechtigung, Projekte zu erstellen und Zertifikate anzufordern. 
• Administratorzugang zu ADP Workforce Now, einschließlich der Berechtigung, Zugriffsberechtigungen und Profile zu verwalten. 
• Zugriff auf das Exclaimer-Abonnement (Pro-Plan).
 
Schritt 1: Erstellen Sie ein Projekt in API Central

So erstellen Sie ein Projekt in API Central:

  1. Navigieren Sie zu API Central unter https://api-central.adp.com/projects und melden Sie sich an.
     
  2. Wählen Sie Projekt erstellen.


    Beispielbild von API Central. Wählen Sie die Schaltfläche „Projekt erstellen“.
     

  3. Geben Sie einen passenden Namen und eine Beschreibung für das Projekt ein und wählen Sie dann Weiter.

    TIPP! Notieren Sie sich den Projektnamen. Sie benötigen ihn später, um das passende Profil in ADP Workforce Now's Zugriffsberechtigungen zu finden.



    Beispielbild für Neues Projekt erstellen. Geben Sie den Namen und die Beschreibung für das Projekt ein.
     

  4. Wählen Sie den Anwendungsfall aus, der Ihren Anforderungen entspricht.


    Beispielbild für Neues Projekt erstellen. Wählen Sie einen Anwendungsfall aus.
     
  5. Wählen Sie Projekt erstellen.
Schritt 2: Fügen Sie v2/workers zur API-Liste hinzu

So fügen Sie v2/workers zur API-Liste hinzu:

  1. Melden Sie sich bei API Central an.
     
  2. Wählen Sie Ansicht, um das entsprechende Projekt zu öffnen.
     
  3. Wählen Sie die Registerkarte APIs.
     
  4. Wählen Sie APIs hinzufügen oder Weitere APIs hinzufügen.


    Beispielbild von API Central. Wählen Sie die Registerkarte APIs und dann die Schaltfläche Weitere APIs hinzufügen.
     
  5. Geben Sie im Suchfeld v2/workers ein.


    Beispielbild von API Central. Geben Sie im Suchfeld v2/workers ein.
     
  6. Wählen Sie Hinzufügen neben den erforderlichen API-Bereichen.


    Beispielbild von API Central. Wählen Sie Hinzufügen neben den API-Bereichen.
     
  7. Wählen Sie Änderungen im Projekt übernehmen, um die Änderungen zu speichern.


    Beispielbild von API Central. Wählen Sie die Schaltfläche Änderungen im Projekt übernehmen.
     
  8. Versuchen Sie erneut, eine Verbindung herzustellen.
Schritt 3: Holen Sie sich Ihre Client-ID und Ihr Geheimnis

So erhalten Sie Ihre Client-ID und Ihr Secret:

  1. Sobald das Projekt erstellt ist, wählen Sie Projekt anzeigen.


    Beispielbild von API Central. Wählen Sie die Schaltfläche Projekt anzeigen.

    Die Projektdetails werden angezeigt. Standardmäßig ist der Reiter Anmeldeinformationen ausgewählt.
     

  2. Scrollen Sie nach unten und kopieren Sie die Client-ID.


    Beispielbild von API Central. Wählen Sie die Schaltfläche Client-ID kopieren.
     

    HINWEIS: Die Client-ID im Screenshot dient nur zu Beispielzwecken. Verwenden Sie Ihre eigene Client-ID.
  3. Aktivieren Sie Secret anzeigen, um das Client-Secret sichtbar zu machen.
     

  4. Wählen Sie Client-Secret kopieren. 


    Beispielbild von API Central. Wählen Sie die Schaltfläche Client-Secret kopieren.
     

    HINWEIS: Das Client-Secret im Screenshot dient nur zu Beispielzwecken. Verwenden Sie Ihr eigenes Client-Secret.
    TIPP! Notieren Sie die Client-ID und das Client-Secret sicher. Sie werden für die Integration benötigt.
Schritt 4: Beantragen Sie ein ADP-Zertifikat

Um ein ADP-Zertifikat anzufordern:

  1. Wählen Sie im Menü auf der linken Seite Zertifikat aus.
     
  2. Wählen Sie Zertifikat anfordern.


    Beispielbild von API Central. Wählen Sie die Schaltfläche Zertifikat anfordern.

    Das Fenster Neues Sicherheitzertifikat anfordern wird angezeigt.


    Beispielbild von API Central mit dem Fenster Neues Sicherheitzertifikat anfordern.
     
  3. Wählen Sie Weiter.
     
  4. Geben Sie die erforderlichen Details ein.
     
  5. Wählen Sie Weiter.
     

  6. Kopieren Sie den Privaten Schlüssel, einschließlich der Zeilen Begin Private Key und End Private Key.

    WARNUNG! Sie müssen die Zeilen -----BEGIN PRIVATE KEY----- und -----END PRIVATE KEY----- beim Kopieren des privaten Schlüssels einschließen. Das Weglassen dieser Zeilen verhindert die erfolgreiche Verbindung.



    Beispielbild von API Central. Wählen Sie die Schaltfläche Kopieren.

    HINWEIS: Der Private Key im Screenshot dient nur zu Demonstrationszwecken. Extrahieren Sie Ihren eigenen Privaten Schlüssel.

    TIPP! Kopieren Sie den Privaten Schlüssel sicher. Dieser wird für die Integration benötigt.

  7. Wählen Sie WEITER.

    Die Schaltfläche WEITER ist erst aktiviert, nachdem die Schaltfläche Kopieren ausgewählt wurde.
     


    Beispielbild von API Central, das Fenster Zertifikat generieren.

Schritt 5: Holen Sie Ihr Zertifikat ab

So rufen Sie Ihr Zertifikat ab:

  1. Sobald die Zertifikatserstellung beginnt, wählen Sie Fertig.


    Beispielbild von API Central, dem Fenster „Zertifikat erstellen“.

    Dies schließt den Anforderungsassistenten und bringt Sie zurück zur Zertifikate-Seite.


    Beispielbild von API Central. Fenster „Zertifikate“, wählen Sie die Schaltflächen „Anzeigen“ oder „Herunterladen“.
     

  2. Wählen Sie Anzeigen, um das Zertifikat einzusehen. Wählen Sie Kopieren, um das Zertifikat zu kopieren.
     

  3. Wählen Sie Herunterladen, um eine lokale Kopie für die zukünftige Verwendung zu speichern. 
     

    TIPP! Bewahren Sie die Details sicher auf. Diese werden für die Integration benötigt.

 

Zugriff auf die ADP Workforce Now-Integration in Exclaimer

So greifen Sie auf die ADP Workforce Now-Integration zu:

  1. Wählen Sie in der Kopfzeile das Zahnradsymbol und dann Absenderverwaltung.

    Das Beispielbild zeigt ein Microsoft 365-Abonnement und das Einstellungsmenü.
     

  2. Navigieren Sie zum Abschnitt HRIS-Zugriff aktivieren.
     
  3. Wählen Sie im Dropdown-Menü ADP Workforce Now aus.

Verbinden Sie Exclaimer mit ADP Workforce Now (Exclaimer)

Voraussetzungen: Bevor Sie Exclaimer mit ADP Workforce Now verbinden, stellen Sie sicher, dass Sie:
• Ein Exclaimer Pro-Abonnement verwenden. 
• Die erforderlichen Bindbee-Domains in Ihrem Netzwerk zulassen. Diese Domains müssen im Browser geladen werden, damit das Verbindungsfenster funktioniert: cdn.bindbee.dev und *.bindbee.dev, um zusätzliche Subdomains abzudecken, die während des Verbindungsablaufs verwendet werden (z. B. API-Callbacks und Authentifizierungsweiterleitungen). 

Halten Sie die folgenden ADP Workforce Now-Details bereit: 
• Client-ID
• Client-Geheimnis 
• Zertifikatsdetails und privaten Schlüssel (einschließlich Kopf-/Fußzeilen)
 
Schließen Sie die ADP Workforce Now-Verbindung in Exclaimer ab

Um eine Verbindung zu Ihrem HRIS herzustellen, damit Exclaimer Benutzerdaten synchronisieren kann:

  1. Wählen Sie aus der Dropdown-Liste ADP Workforce Now aus.
     
  2. Wählen Sie Verbinden.

    Ein Autorisierungsfenster wird angezeigt.


    Beispielbild in Exclaimer beim Versuch, eine Verbindung zum ADP Workforce Now System herzustellen.
     
  3. Wählen Sie Erlauben und Fortfahren.
     
  4. Geben Sie Ihre Client-ID und Ihr Client-Geheimnis ein.


    Beispielbild in Exclaimer beim Versuch, eine Verbindung zum ADP Workforce Now System herzustellen. Geben Sie Ihre Client-ID und Ihr Client-Geheimnis ein.
     
  5. Wählen Sie Fortfahren.
     

  6. Geben Sie die Zertifikatsdetails und den Privaten Schlüssel ein (einschließlich der Kopf- und Fußzeilen).

    WARNUNG! Sie müssen die Zeilen -----BEGIN PRIVATE KEY----- und -----END PRIVATE KEY----- beim Kopieren des privaten Schlüssels einschließen. Das Weglassen dieser Zeilen verhindert die Fertigstellung der Verbindung.



    Beispielbild in Exclaimer beim Versuch, eine Verbindung zum ADP Workforce Now System herzustellen. Geben Sie Ihre Zertifikatsdetails und den privaten Schlüssel ein.
     

  7. Wählen Sie Verbinden, um die Integration zwischen Exclaimer und ADP Workforce Now über Bindbee abzuschließen.
     

    WARNUNG! Lassen Sie das Fenster geöffnet, bis die Verbindung abgeschlossen ist. Wenn Sie es zu früh schließen, wird die Verbindung möglicherweise nicht vollständig eingerichtet und erscheint in Exclaimer nicht als verbunden.

     Wenn Sie versuchen, erneut eine Verbindung zu ADP Workforce Now herzustellen, kann eine Meldung erscheinen, dass der Connector bereits existiert. In diesem Fall eröffnen Sie bitte ein Support-Ticket, damit das Team Ihnen helfen kann.
     

  8. Sobald eine Verbindung hergestellt ist, wird der Status in Exclaimer als Verbunden angezeigt.


    Nachdem eine Verbindung mit dem ADP Workforce Now System hergestellt wurde, wird in Exclaimer der Text „Verbunden“ angezeigt.

 

Berechtigungen in ADP Workforce Now konfigurieren

Berechtigungen konfigurieren

So konfigurieren Sie Berechtigungen, damit Mitarbeiterdaten synchronisiert werden können:

Voraussetzungen: 
• Administratorzugang zu ADP Workforce Now. 
  1. Melden Sie sich bei ADP Workforce Now an.
     
  2. Wählen Sie das Menü Setup und dann unter Sicherheit die Option Zugriffsberechtigungen.
     
  3. Wählen Sie Profile verwalten. 


    Beispielbild des Bildschirms Zugriffsberechtigungen. Wählen Sie die Schaltfläche Profile verwalten. 
     
  4. Suchen Sie das für Ihr API Central-Projekt erstellte Profil. Sie können auch eine Suche durchführen. 
     
  5. Wählen Sie das Profil aus.
     
  6. Wählen Sie Menüs und Funktionen. Weisen Sie die entsprechenden Berechtigungen zu. Navigieren Sie durch die tabellarische Funktionsliste und deaktivieren Sie alle Felder, die nicht erforderlich sind.


    Beispielbild, das die Registerkarte Menüs und Funktionen zeigt.
     
  7. Speichern Sie diese Einstellungen. 

    Die Daten sollten in Kürze mit der Synchronisierung beginnen.

 

Verwalten Sie Ihre ADP Workforce Now-Verbindung (Exclaimer)

Folgen Sie den Optionen, um Ihre ADP Workforce Now-Verbindung zu verwalten:

Erneut mit ADP Workforce Now verbinden

So verbinden Sie sich erneut mit dem ADP Workforce Now-System:

  1. Wählen Sie Erneut verbinden.

    Es wird eine Meldung angezeigt, dass durch das erneute Verbinden Ihre bestehende Verbindung zu ADP Workforce Now entfernt wird, und alle Daten nicht mehr verfügbar sind. Ein neuer Verbindungsprozess wird automatisch gestartet.


    Wählen Sie OK, um die Verbindung zum ADP Workforce Now-System erneut herzustellen.
     

  2. Wählen Sie OK, um fortzufahren.
Verbindung zu ADP Workforce Now trennen

So trennen Sie die Verbindung zum ADP Workforce Now-System:

  1. Wählen Sie Trennen. Dadurch wird Ihre Verbindung und alle synchronisierten Daten entfernt.

    Es wird eine Meldung angezeigt, dass durch das Trennen Ihre Verbindung zu ADP Workforce Now vollständig entfernt wird und alle Daten aus dem System nicht mehr verfügbar sind.


    Wählen Sie OK, um die Verbindung zum ADP Workforce Now-System zu trennen.
     

  2. Wählen Sie OK, um fortzufahren.
Manuelle Synchronisierung durchführen

ADP Workforce Now Connector synchronisieren Daten automatisch nach einem vordefinierten Zeitplan.

Um eine manuelle Synchronisierung durchzuführen, um Mitarbeiterdaten sofort in Exclaimer zu aktualisieren:

  1. Wählen Sie Jetzt synchronisieren.


    Wählen Sie Jetzt synchronisieren, um eine manuelle Synchronisierung zu starten.
HINWEIS: Die Schaltfläche Jetzt synchronisieren ist nur aktiviert, wenn seit der letzten erfolgreichen Synchronisierung mindestens 6 Stunden vergangen sind. Das Datum und die Uhrzeit der nächsten Synchronisierung werden angezeigt.


Fehlerbehebung

Ungültige Anmeldedaten oder Berechtigungsfehler (403)

Wenn Sie folgenden Fehler erhalten:

403: Ungültige Anmeldedaten oder Berechtigung

Dies weist normalerweise darauf hin, dass der erforderliche API-Bereich/Zugriff für die Client-Anwendung nicht aktiviert wurde. Führen Sie Schritt 2: v2/workers zur API-Liste hinzufügen aus und versuchen Sie es erneut.

Das Verbindungsfenster von ADP Workforce Now wird nicht geladen

Wenn das Autorisierungsfenster in Exclaimer nicht erscheint:

  • Stellen Sie sicher, dass die folgenden Domains in Ihrem Netzwerk oder in den Sicherheitstools des Browsers auf der Positivliste stehen: cdn.bindbee.dev und *.bindbee.dev.
  • Überprüfen Sie, ob Browser-Erweiterungen oder Inhaltsblocker das Laden der Seite verhindern.
  • Aktualisieren Sie den Browser und versuchen Sie es erneut.
Meldung "Connector existiert bereits"

Wenn Sie versuchen, sich erneut mit ADP Workforce Now zu verbinden und eine Meldung erhalten, dass der Connector bereits existiert, erstellen Sie ein Support-Ticket, damit das Team Ihnen helfen kann.

Synchronisierung schlägt fehl oder wird nicht abgeschlossen

Wenn eine geplante oder manuelle Synchronisierung nicht erfolgreich abgeschlossen wird:

  • Bestätigen Sie, dass die Verbindung in Exclaimer weiterhin als Verbunden angezeigt wird.
  • Überprüfen Sie, ob die Client-ID, das Client-Geheimnis und das Zertifikat in API Central nicht abgelaufen oder widerrufen wurden.
Authentifizierungs- oder Verbindungsfehler

Wenn die Verbindung zu ADP Workforce Now während der Einrichtung fehlschlägt, überprüfen Sie, ob:

  • Die Client-ID und das Client-Geheimnis korrekt eingegeben wurden.
  • Das Zertifikat und der private Schlüssel in API Central nicht abgelaufen oder widerrufen wurden.
  • Der private Schlüssel die vollständigen Kopf- und Fußzeilen (-----BEGIN PRIVATE KEY----- und -----END PRIVATE KEY-----) enthält.
  • Der erforderliche v2/workers API-Bereich dem Projekt in API Central hinzugefügt wurde.
  • Der richtige Anwendungsfall bei der Erstellung des Projekts in API Central ausgewählt wurde.
Fehlende Kopf- und Fußzeilen im privaten Schlüssel

Wenn die Verbindung nach Eingabe Ihrer Zertifikatsdaten fehlschlägt, überprüfen Sie, ob der private Schlüssel vollständig kopiert wurde.

Beim Kopieren des privaten Schlüssels in API Central müssen Sie die untenstehenden Kopf- und Fußzeilenzeilen zusammen mit dem Schlüsselwert einschließen:

-----BEGIN PRIVATE KEY-----

-----END PRIVATE KEY-----

Wenn diese Zeilen fehlen, kehren Sie zu API Central zurück, kopieren Sie den privaten Schlüssel erneut vollständig und geben Sie ihn erneut in Exclaimer ein.