Freigeben über


Option 5: Führen Sie die Node-Lösung aus, um Token abzurufen, und erstellen Sie dann eine Integration in einer externen Quelle wie Workday für den API-basierten Import.

Nachdem Sie eine neue App im Microsoft 365 Admin Center registriert, einen geheimen Clientschlüssel generiert und den Import im Microsoft 365 Admin Center eingerichtet haben, können Sie unsere Node-Lösung ausführen, um Token in der Konsole abzurufen. Wenn Sie diese Lösung ausführen, werden die Token generiert, die Sie benötigen, um dann die API-Integration in Ihrer externen Quelle wie Workday zu erstellen. Weitere Informationen finden Sie auf GitHub.

1. Ausführen der Lösung

  1. Klonen Sie diese App auf Ihrem Computer, indem Sie den folgenden Befehl in der Befehlszeile ausführen:

    git clone https://github.com/microsoft/orgdata_apibasedimport.git

  2. Fügen Sie die folgenden Konsolenwerte ein:

  • AppID/ClientID
  • Geheimer Clientschlüssel
  • Microsoft Entra Mandanten-ID
  • Connector-ID
  • Skalierungseinheit
  1. Das Skript wird ausgeführt und öffnet ein neues Browserfenster. Melden Sie sich mit der gleichen E-Mail an, die Sie beim Einrichten des Imports im Microsoft 365 Admin Center unter App-ID oder UPN eingegeben haben.

  2. Kopieren Sie auf der Seite HRIS-Integrationskonfiguration die folgenden Werte sicher, die Sie verwenden, um die Integration in Ihrer externen Quelle wie Workday Report as a Service (RaaS) zu erstellen:

  • HTTP-Adresse
  • Zugriffstoken
  • Aktualisierungstoken
  • Aktualisierungstoken-URL

2. Erstellen eines benutzerdefinierten Berichts in Workday

Gilt für: Globaler Microsoft 365-Administrator oder Organisationsdatenquellenadministrator

  1. Öffnen Sie Workday, suchen Sie nach "Benutzerdefinierten Bericht erstellen", und wählen Sie ihn aus.

    Screenshot: Suchen nach einem benutzerdefinierten Bericht

  2. Geben Sie einen Namen für Den Bericht ein.

  3. Wählen Sie neben Berichtstypdie Option Erweitert aus.

  4. Wählen Sie neben Datenquelle die Option Worker für die HCM-Berichterstellung aus.

  5. Lassen Sie Optimiert für Leistung deaktiviert, um Worker ohne E-Mail-Adresse herauszufiltern. Microsoft identifiziert Worker anhand der E-Mail-Adresse, sodass es ein pflicht pflichtfeld ist.

    Screenshot der Seite mit den Berichtsdetails.

  6. Wählen Sie unten auf der Seite OK aus.

  7. So fügen Sie Vorgesetzte-E-Mail-Felder hinzu:

    1. Wählen Sie das Dreipunktmenü rechts neben dem Namen Ihres Berichts aus.

    2. Wählen Sie Berechnetes Feld für Bericht>erstellen berechnetes Feld aus.

      Screenshot: Erstellen eines berechneten Felds

    3. Geben Sie einen Namen für das neue Feld ein, z. B. "Manager Email".

    4. Geben Sie neben Business Object (Geschäftsobjekt) "Worker" ein.

    5. Geben Sie neben Function (Funktion) "Lookup Related Value" (Verwandter Nachschlagewert) ein.

      Screenshot: Details des berechneten Felds

    6. Wählen Sie OK aus.

    7. Geben Sie auf dem nächsten Bildschirm neben Nachschlagefeld "Manager – Ebene 01" ein.

    8. Geben Sie neben Rückgabewert das gewünschte E-Mail-Feld ein, z. B. Öffentliche primäre Arbeit Email Adresse.

      Screenshot: Nachschlagedetails für berechnete Felder.

    9. Wählen Sie unten auf der Seite OK aus.

  8. Fügen Sie Felder hinzu, und passen Sie den Bericht an die Anforderungen Ihrer organization an:

    1. Wählen Sie das Dreipunktmenü rechts neben dem Namen Ihres Berichts aus.

    2. Wählen Sie Benutzerdefinierte Berichtsbearbeitung>aus.

    3. Geben Sie neben Datenquellenfilter "Alle aktiven Worker (alle Typen)" ein.

    4. Wählen Sie auf der Registerkarte Spalten das Symbol "+" oben links aus, um Felder hinzuzufügen.

      Screenshot: Anpassen des Berichts

Beispiel für Zuordnungen für die meisten reservierten Felder, die hier aufgeführt sind

  • Das Feld Manager Email verweist auf das berechnete Feld, das Sie oben eingerichtet haben.

  • Dies ist eine beste Schätzung für die Zuordnung der einzelnen Felder. Es gibt möglicherweise geeignetere Zuordnungen speziell für Ihren Mandanten.

  • Alle oben verknüpften reservierten Felder können hier hinzugefügt werden, wenn sie noch nicht vorhanden sind. Sie können auch beliebige benutzerdefinierte Felder mit einem beliebigen Namen hinzufügen, die in alle Apps importiert werden können, die benutzerdefinierte Felder verwenden.

Geschäftsobjekt Feld Außerkraftsetzung von Spaltenüberschriften Überschreiben des XML-Alias für Spaltenüberschriften
Arbeitnehmer Mitarbeiter-ID Microsoft_EmployeeID Legen Sie fest, dass diese Spalte denselben Wert wie die Außerkraftsetzung von Spaltenüberschriften aufweist.
Arbeitnehmer Öffentliche primäre Arbeitsadresse Email Microsoft_PersonEmail
Arbeitnehmer manager Email Microsoft_ManagerEmail
Arbeitnehmer Aufsichtsorganisation Microsoft_Organization
Arbeitnehmer Verwaltungsebene Microsoft_LevelDesignation
Arbeitnehmer Single Job Family Microsoft_JobDiscipline
Arbeitnehmer Geschäftstitel Microsoft_JobTitle
Arbeitnehmer Standort – Name Microsoft_CompanyOfficeLocation
Arbeitnehmer Einstellungsdatum Microsoft_HireDate
Arbeitnehmer Vorname Microsoft_FirstName
Arbeitnehmer Nachname Microsoft_LastName
Arbeitnehmer Rechtlicher Name im Berichtsanzeigeformat Microsoft_DisplayName
Arbeitnehmer Unternehmen - Name Microsoft_Company
Arbeitnehmer Arbeitsadresse – Formatierte Zeile 1 Microsoft_CompanyOfficeStreet
Arbeitnehmer Arbeitsadresse – Ort Microsoft_CompanyOfficeCity
Arbeitnehmer Arbeitsadresse - Bundesland/Provinz Microsoft_CompanyOfficeState
Arbeitnehmer Geschäftsadresse – Postleitzahl Microsoft_CompanyOfficePostalCode
Arbeitnehmer Arbeitsadresse – Land/Region Microsoft_CompanyOfficeCountryOrRegion
Arbeitnehmer Workertyp – Text Microsoft_EmploymentType
Arbeitnehmer Aktive Qualifikationen Microsoft_UserSkillNames
Arbeitnehmer Telefonnummer für öffentliche primäre Arbeit Microsoft_Phone
Arbeitnehmer Kostenstelle – ID Microsoft_CostCenter
Arbeitnehmer Division Microsoft_Division

Filtern Sie Worker heraus, die keine E-Mail haben, indem Sie zur Registerkarte Filter hinzufügen, z. B.:

Screenshot: Herausfiltern von Mitarbeitern ohne E-Mail

Nachdem Sie den Bericht angepasst haben, wählen Sie Erweitert aus. Wählen Sie dann unter Webdienstoptionen die Option Als Webdienst aktivieren aus.

3. Erstellen der Integration in Ihrer externen Quelle

Führen Sie die folgenden Schritte aus, um die API-Integration in Workday zu erstellen.

  1. Suchen Sie oben auf dem Bildschirm in Workday nach "Eib erstellen", und wählen Sie sie aus.

  2. Auf der Seite EIB erstellen :

    1. Geben Sie einen Namen für die Integration ein.
    2. Wählen Sie Ausgehend aus.
    3. Wählen Sie OK aus.
  3. Überprüfen und bestätigen Sie die Details auf der Seite Allgemeine Einstellungen . Wenn alles gut aussieht, wählen Sie Weiter aus.

  4. Gehen Sie auf der Seite Daten abrufen wie

    1. Wählen Sie neben Datenquellentyp die Option Benutzerdefinierter Bericht aus.

    2. Wählen Sie neben Benutzerdefinierter Bericht den Bericht aus, den Sie in Ihren Azure Blob Storage-Connector integrieren möchten.

    3. Wählen Sie unter Details neben Alternatives Ausgabeformat die Option CSV aus.

      Screenshot: Eingeben von Details auf der Seite

    4. Wählen Sie unten auf der Seite Weiter aus.

  5. Auf der Seite Transformieren müssen Sie keine Änderungen vornehmen. Wählen Sie Weiter aus.

  6. Gehen Sie auf der Seite Übermitteln wie

    1. Wählen Sie neben Übermittlungsmethodedie Option HTTP/SSL aus.
    2. Geben Sie neben HTTP-Adresse die Adresse ein, die aus den obigen Schritten generiert wurde.
    3. Wählen Sie neben Webdienstaufruftypdie Option OAuth 2.0 aus.
    4. Geben Sie neben Zugriffstoken das Zugriffstoken ein, das aus den obigen Schritten generiert wurde.
    5. Geben Sie neben Aktualisierungstoken das Aktualisierungstoken ein, das aus den obigen Schritten generiert wurde.
    6. Geben Sie neben Aktualisierungstoken-URL die aktualisierungstoken-URL ein, die aus den obigen Schritten generiert wurde.
    7. Geben Sie neben Client-ID die AppID/ClientID ein.
    8. Geben Sie neben Geheimer Clientschlüssel den geheimen Clientschlüssel ein.
    9. Geben Sie neben Dateiname den gewünschten Dateinamen ein, der .csv werden muss.
    10. Wählen Sie unten auf der Seite Übermitteln die Option Weiter aus.
  7. Überprüfen Sie die Details auf der Seite Überprüfen und Übermitteln . Wenn alles gut aussieht, wählen Sie OK aus.

  8. Wählen Sie neben dem Namen Ihrer Integration Aktionen aus.

  9. Zeigen Sie auf Integration, und wählen Sie dann Integration starten/planen aus.

  10. Auf der Seite Integration starten/planen :

    1. Wählen Sie neben Integration den Namen der von Ihnen erstellten Integration aus.
    2. Wählen Sie neben Ausführungshäufigkeit die gewünschte Häufigkeit aus.
    3. Wählen Sie OK aus.

    Screenshot: Eingeben der Details der gestarteten Integration