Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
1. Registrieren einer neuen App im Microsoft Entra Admin Center
Gilt für: Microsoft 365 Global Administrator
Hinweis
Weitere Informationen zum Registrieren einer App im Microsoft Entra Admin Center finden Sie unter Schnellstart: Registrieren einer Anwendung bei der Microsoft Identity Platform.
Wählen Sie auf der linken Seite des Microsoft Admin Centers die Option Alle Admin Center aus. Diese Option wird als letzte Option in der Liste angezeigt.
Wählen Sie Microsoft Entra aus.
Wählen Sie links unter Enttra-ID die Option Übersicht.
Erstellen Sie eine neue App-Registrierung:
Wählen Sie in der oberen Symbolleiste "App-Registrierunghinzufügen>" aus.
Auf dem daraufhin angezeigten Bildschirm:
Geben Sie Ihrer App einen Namen.
Lassen Sie unter "Unterstützte Kontotypen" die erste Option, Nur Konten in diesem Organisationsverzeichnis ([Nur Ihr organization – einzelner Mandant)), ausgewählt.
Wählen Sie unten auf dem Bildschirm "Registrieren" aus.
Wenn Sie zurück auf der Übersichtsseite sind, kopieren Sie die Anwendungs-ID (Client-ID) und die Verzeichnis-ID (Mandanten-ID). Halten Sie diese IDs bereit. Sie müssen sie später bereitstellen.
Entfernen Sie vorhandene API-Berechtigungen:
Wählen Sie links API-Berechtigungen aus.
Wählen Sie für jeden aufgelisteten API -/Berechtigungsnamen die Auslassungspunkte (...) rechts neben der API aus, z. B. Microsoft Graph.
Wählen Sie Berechtigung entfernen.
Bestätigen Sie das Entfernen. Wenn Sie Berechtigungen für diese Elemente entfernen, stellen Sie sicher, dass die App nur über Berechtigungen für das verfügt, was sie benötigt.
(Optional) Wenn Sie die erforderliche API-Berechtigung manuell hinzufügen möchten, anstatt dies automatisch in Schritt 4 oben zu tun:
Suchen Sie nach "Organisationsdaten in Microsoft 365", und wählen Sie die Option aus.
Wählen Sie Delegierte Berechtigungen aus.
Wählen Sie unter Berechtigungenden Zugriff als Benutzer aus.
Wählen Sie Berechtigungen hinzufügen aus.
Wählen Sie unter "Konfigurierte Berechtigungen" die Option "Administratoreinwilligung erteilen" aus.
Geben Sie dem Datenquellenadministrator die App-ID und die Mandanten-ID.
2. (Optional) Erforderliche Benutzerberechtigung manuell hinzufügen
Gilt für: Microsoft 365 Global Administrator
Wenn Sie die erforderliche Benutzerberechtigung manuell hinzufügen möchten, anstatt dies in Schritt 4 automatisch zu tun, führen Sie die folgenden Schritte aus.
Wählen Sie im Microsoft Entra Admin Center auf der linken Seite Unternehmens-Apps aus.
Entfernen Sie den Suchfilter "Anwendungstyp".
Suchen Sie nach "Organisationsdaten in Microsoft 365", und wählen Sie die Option aus.
Wählen Sie unter Verwalten auf der linken Seite Benutzer und Gruppen aus.
Wählen Sie Benutzer/Gruppe hinzufügen aus.
Wählen Sie unter Benutzer und Gruppendie Option Keine ausgewählt.
Suchen Sie die Benutzer- oder E-Mail-Adresse, die Sie zum Abrufen von OAuth-Token aus dem Tokenskript verwenden möchten, und wählen Sie diese aus.
Wählen Sie "Auswählen" und dann unten "Zuweisen" aus.
3. Einen geheimen Clientschlüssel erstellen
Gilt für: Microsoft 365 Global Administrator
Navigieren Sie zunächst zurück zu Ihrer App-Registrierung im Microsoft Entra Admin Center. Ihre App-Registrierungen finden Sie unter Entra-ID auf der linken Seite.
Wählen Sie in der App-Registrierung im Microsoft Entra Admin Center links unter Verwalten Zertifikate & Geheimnisse aus.
Wählen Sie "Geheime Clientschlüssel" und dann "Neues geheime Clientschlüssel" aus.
Geben Sie eine Beschreibung für das Geheimnis ein, und legen Sie ein Ablaufdatum fest. Wählen Sie dann Hinzufügen aus.
Wählen Sie auf der Seite "Zertifikate & Geheimnisse" das Kopiersymbol aus, um das Geheimnis in die Zwischenablage zu kopieren. Speichern Sie sie sicher für die spätere Verwendung beim Einrichten des Imports.
4. Einrichten des Imports im Microsoft 365 Admin Center
Gilt für: Microsoft 365 globaler Administrator oder Administrator für organisatorische Datenquellen
Starten Sie den Import von der Seite "Datenverbindungen" auf der Seite "Microsoft 365 Organisationsdatendienst" (Start>: Einrichtung>, Migration und Importe>:Datenverbindungen desMicrosoft 365-Organisationsdatendiensts>).
Klicken Sie auf Erste Schritte (wenn Sie zum ersten Mal Daten importieren) oder Neu importieren (wenn Sie bereits Daten importiert haben).
Wählen Sie auf der Seite Verbindungstyp auswählen die Option API-basierte Einrichtung starten aus.
Wählen Sie die Apps und Dienste aus, für die Sie Daten freigeben möchten. Standardmäßig werden alle öffentlichen reservierten Attribute für Microsoft 365- und Viva-Apps und -Dienste freigegeben. Verwenden Sie diese Seite, um Apps auszuwählen, mit denen anwendungsspezifische und benutzerdefinierte Daten freigegeben werden sollen. Sie können Ihre Auswahl jederzeit in den Einstellungen ändern. Weitere Informationen.
Im Vorbereitungs- und Einrichtungsbereich werden die restlichen Schritte zum Abschließen der Verbindung beschrieben. Einige dieser Schritte, wie z.B. das Erstellen der App-Registrierung, wurden bereits mit dem oben beschriebenen Prozess abgeschlossen. Sie müssen eine Kopfzeile .csv Datei vorbereiten, um Ihre importierten Attribute den Apps zuzuordnen, mit denen Sie Daten freigeben. Wenn Sie noch keine Vorlage für diese Datei haben, wählen Sie Vorlage herunterladen aus, um zu beginnen.
Wählen Sie auf der Seite API-basierte Verbindung einrichtendie Option Benutzer-ID aus. Geben Sie unter Benutzer-ID den Benutzerprinzipalnamen (User Principal Name, UPN) oder die Objekt-ID des Benutzers ein, den Sie zum Abrufen von OAuth-Token aus dem PowerShell-Skript verwenden möchten. Der UPN ist normalerweise mit der E-Mail-Adresse des Benutzers identisch. Geben Sie unter App-ID die App-ID aus der App-Registrierung ein. Wenn der Connector zum ersten Mal bereitgestellt wird, muss ein globaler Administrator diesen Schritt ausführen. Nach der Bereitstellung wird die API-Connector-Datenschreiberrolle automatisch zugewiesen, und Sie können sie im Microsoft Entra Admin Center sehen.
- Wenn Sie die Details zur Qualität der erfassten Daten überprüfen möchten, bevor Sie sie Downstream-Apps zur Verfügung stellen, wählen Sie Datenstaging aktivieren aus. Anleitung.
Laden Sie auf der Seite Kopfzeilen für Attributzuordnung importieren die .csv Datei hoch, die Sie im vorherigen Schritt für die Attributzuordnung erstellt haben.
- Stellen Sie sicher, dass die Header in der .csv Headerdatei mit Ihrer .csv Datendatei übereinstimmen. Wenn die .csv Headerdatei mehr Felder enthält als die .csv Datendatei oder umgekehrt, schlägt die Verarbeitung für den Import fehl.
Ordnen Sie Ihren importierten Daten Ihre reservierten Attribute zu. Dies bedeutet, dass Sie Attribute aus Ihrer .csv Datei mit den entsprechenden Attributen für die Apps abgleichen, für die Sie Daten freigeben. Alle importierten Attribute, die Sie nicht mit reservierten Attributen abgleichen, werden als benutzerdefinierte Attribute verwendet und können nicht umbenannt werden. Weitere Informationen. Um Spalten automatisch zuzuordnen und die manuelle Zuordnung zu überspringen, verwenden Sie reservierte Attributnamen mit dem Präfix "Microsoft_", z. B. Microsoft_PersonEmail, in Ihren .csv Spaltenüberschriften. Die vollständige Liste der reservierten Attributnamen wird angezeigt.
Anzeigen der globalen Attribute, die für alle Microsoft 365-Apps und -Dienste verwendet werden. Dies sind Attribute, die aus Ihren importierten Daten abgerufen werden und automatisch von allen berechtigten Apps verwendet werden. Wählen Sie unten auf der Seite "Weiter" aus.
Überprüfen Sie auf der letzten Seite alle Details, Apps und Attributzuordnungen für Ihre Verbindung. Wenn alles richtig aussieht, wählen Sie Verbinden aus.
Hinweis
Wenn Sie regelmäßige Exporte aus Ihrem Quellsystem einrichten, werden Ihre Daten für Viva- und Microsoft 365-Dienstanforderungen überprüft. Wenn Sie keine regelmäßigen Exporte konfiguriert haben, wird der Connector zwar eingerichtet, aber die Daten werden nicht zur Überprüfung in das System übertragen. Stattdessen wird im Microsoft 365 Admin Center auf der Registerkarte "Datenverbindungen" der Status "Wartet auf Verbindung" angezeigt. Wenn Sie diese Verbindung auswählen, zeigt dies, dass der Datenquellenadministrator die regelmäßigen Exporte nicht konfiguriert hat. Sie werden aufgefordert, sich mit ihm in Verbindung zu setzen, um diesen Prozess in Gang zu setzen.
Ihre Organisationsdaten werden anhand der Anforderungen für die Verwendung mit Viva- und Microsoft 365-Diensten überprüft. Die Überprüfung dauert einige Stunden; Es kann jedoch bis zu drei Tage dauern, bis Ihr vollständiger Datenupload im Profilspeicher verfügbar ist. Sie können die Validierungs status auf der Seite Organisationsdaten im Admin Center überprüfen. Wenn die Überprüfung abgeschlossen ist, wird eine Meldung angezeigt, dass Ihre Daten von Viva und Microsoft 365 verwendet und verwaltet werden. Nach Abschluss der Überprüfung werden die Organisationsdaten den von Ihnen ausgewählten Apps und Diensten zur Verfügung gestellt.
5. Ausführen der PowerShell-Lösung zum Abrufen von Token
Gilt für: Administrator für Organisationsdatenquellen
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. Sehen Sie sich die Lösung auf GitHub an.
Laden Sie dieses PowerShell-Skript herunter.
Öffnen Sie Windows PowerShell 5.1 oder PowerShell 7, um das Skript auszuführen:
Navigieren Sie zum Speicherort des Skripts:
cd path/to/folderIn Windows PowerShell 5.1:
powershell -File .\OrganizationalDataTokens.ps1In PowerShell 7:
pwsh -File .\OrganizationalDataTokens.ps1
Geben Sie die folgenden Konsolenwerte ein:
App-ID (Client): Diese ID finden Sie in den registrierten App-Informationen im Microsoft Entra Admin Center unter Anwendungs-ID (Client-ID).
Geheimer Clientschlüssel: Dies ist eine geheime Zeichenfolge, die die Anwendung verwendet, um ihre Identität beim Anfordern eines Tokens nachzuweisen. Es wird auch als Anwendungskennwort bezeichnet. Dieser geheime Schlüssel wird nur zum ersten Mal angezeigt, wenn der geheime Clientschlüssel erstellt wird. Gehen Sie folgendermaßen vor, um einen neuen geheimen Clientschlüssel zu erstellen.
Microsoft Entra Mandanten-ID: Suchen Sie diese ID in den registrierten App-Informationen im Microsoft Entra Admin Center unter Directory (Mandanten)-ID.
Connector-ID: Dies ist die Zeichenfolge am Ende der URL, die angezeigt wird, wenn Sie Ihren API-basierten Connector im Microsoft 365 Admin Center auswählen, z. B
https://admin.cloud.microsoft/?#/featureexplorer/migration/M365OrganizationalDataService/connection-details/[Connector ID here]. . .
Das Skript wird ausgeführt und öffnet ein neues Browserfenster. Melden Sie sich mit demselben Benutzer an, den Sie beim Einrichten des Imports im Microsoft 365 Admin Center unter Benutzer-ID (UPN oder Objekt-ID) eingegeben haben.
Kopieren Sie auf der Seite zur Konfiguration der HRIS-Integration die folgenden Werte, die Sie zum Erstellen der Integration verwenden, sicher in Ihre externe Quelle wie Workday Enterprise Interface Builder (EIB):
- HTTP-Adresse
- Zugriffstoken
- Token aktualisieren
- Token-URL aktualisieren
Hinweis
Zugriffstoken laufen in der Regel nach 1 Stunde ab. Ihre Integration sollte automatisch das Aktualisierungstoken verwenden, um ein neues Zugriffstoken abzurufen.
Problembehandlung
Fehler: "Administratorgenehmigung erforderlich" oder "Ungültige Ressource"
Ein globaler Administrator muss Schritt 4.6 oben befolgen, um die erforderliche API-Berechtigung automatisch bereitzustellen, oder Schritt 1.6 oben, um die Berechtigung manuell hinzuzufügen und die Administratorzustimmung zu erteilen.
Fehler: "Umleitungs-URI stimmt nicht überein"
Ein globaler Administrator muss einen Webumleitungs-URI auf der Authentifizierungsseite der App-Registrierung hinzufügenhttp://localhost:5173/callback:
Fehler: "Nicht autorisiert" / HTTP 403 in Ihrer HRIS-Integration
Stellen Sie sicher, dass die Token nicht abgelaufen sind.
Überprüfen Sie, ob die URL des Aktualisierungstokens Ihre spezifische Mandanten-ID verwendet (nicht "/common/").
Stellen Sie sicher, dass die im API-basierten Connector konfigurierte Benutzer-ID mit dem Benutzer übereinstimmt, mit dem Sie sich anmelden, wenn Sie das Skript zum Abrufen von Token ausführen.
Stellen Sie sicher, dass die im API-basierten Connector konfigurierte App-ID mit der App-ID übereinstimmt, die beim Ausführen des Skripts zum Abrufen von Token verwendet wird.
Zusätzliche Authentifizierungs- und Autorisierungsressourcen:
6. Erstellen eines benutzerdefinierten Berichts in Workday
Gilt für: Microsoft 365 globaler Administrator oder Administrator für organisatorische Datenquellen
Öffnen Sie Workday, suchen Sie nach "Benutzerdefinierten Bericht erstellen" und wählen Sie den Bericht aus.
Geben Sie einen Namen für den Bericht ein.
Wählen Sie neben Berichtstypdie Option Erweitert aus.
Wählen Sie neben "Datenquelle" die Option "Arbeitskräfte für HCM-Berichterstellung" aus.
Lassen Sie "Optimiert für Leistung " deaktiviert, um Mitarbeiter herauszufiltern, die keine E-Mail-Adresse haben. Microsoft identifiziert Arbeiter anhand der E-Mail-Adresse, daher ist dies ein Pflichtfeld.
Wählen Sie unten auf der Seite "OK" aus.
So fügen Sie E-Mail-Felder für Vorgesetzte hinzu:
Wählen Sie das Drei-Punkte-Menü rechts neben dem Namen Ihres Berichts aus.
Ausgewähltes berechnetes Feld für Bericht>erstellen Berechnetes Feld auswählen.
Geben Sie einen Namen für das neue Feld ein, z. B. "Manager-E-Mail".
Geben Sie neben Business Object "Worker" ein.
Geben Sie neben Funktion "Nachschlagebezogener Wert" ein.
Wählen Sie OK aus.
Geben Sie auf dem nächsten Bildschirm neben Nachschlagefeld "Manager – Ebene 01" ein.
Geben Sie neben Rückgabewert das gewünschte E-Mail-Feld ein, z. B. öffentliche primäre E-Mail-Adresse des Arbeitsplatzes.
Wählen Sie unten auf der Seite "OK" aus.
Fügen Sie Felder hinzu, und passen Sie den Bericht entsprechend den Anforderungen Ihrer Organization an:
Wählen Sie das Drei-Punkte-Menü rechts neben dem Namen Ihres Berichts aus.
Wählen Sie "Benutzerdefinierter Bericht>bearbeiten" aus.
Geben Sie neben "Datenquellenfilter" "Alle aktiven Arbeitskräfte (alle Typen)" ein.
Wählen Sie auf der Registerkarte "Spalten" das Symbol "+" oben links aus, um Felder hinzuzufügen.
Beispiel für Zuordnungen für die meisten reservierten Felder, die hier aufgeführt sind
Das Feld Manager-E-Mail verweist auf das berechnete Feld, das Sie oben eingerichtet haben.
Dies ist eine beste Schätzung für die Zuordnung jedes Feldes; Möglicherweise gibt es speziell für Ihren Mandanten geeignetere Zuordnungen.
Jedes der oben verlinkten reservierten Felder kann hier hinzugefügt werden, sofern dies noch nicht geschehen ist. Sie können auch beliebige benutzerdefinierte Felder mit einem beliebigen Namen hinzufügen, und diese können in alle Apps importiert werden, die benutzerdefinierte Felder verwenden.
| Business Object | Feld | Außerkraftsetzung von Spaltenüberschriften | Spaltenüberschrift überschreiben XML-Alias |
|---|---|---|---|
| Worker | Employee ID | Microsoft_EmployeeID | Legen Sie fest, dass diese Spalte denselben Wert wie die Außerkraftsetzung von Spaltenüberschriften hat |
| Worker | Öffentliche primäre Arbeit E-Mail-Adresse | Microsoft_PersonEmail | |
| Worker | Manager-E-Mail | Microsoft_ManagerEmail | |
| Worker | Aufsichtsorganisation | Microsoft_Organization | |
| Worker | Verwaltungsebene | Microsoft_LevelDesignation | |
| Worker | Single Job Familie | Microsoft_JobDiscipline | |
| Worker | Titel des Unternehmens | Microsoft_JobTitle | |
| Worker | Standort – Name | Microsoft_CompanyOfficeLocation | |
| Worker | Einstellungsdatum | Microsoft_HireDate | |
| Worker | Vorname | Microsoft_FirstName | |
| Worker | Nachname | Microsoft_LastName | |
| Worker | Rechtlicher Name im Anzeigeformat für Berichte | Microsoft_DisplayName | |
| Worker | Unternehmen - Name | Microsoft_Company | |
| Worker | Arbeitsadresse – formatierte Zeile 1 | Microsoft_CompanyOfficeStreet | |
| Worker | Arbeitsadresse – Stadt | Microsoft_CompanyOfficeCity | |
| Worker | Arbeitsadresse – Bundesland/Kanton | Microsoft_CompanyOfficeState | |
| Worker | Arbeitsadresse – Postleitzahl | Microsoft_CompanyOfficePostalCode | |
| Worker | Arbeitsadresse – Land/Region | Microsoft_CompanyOfficeCountryOrRegion | |
| Worker | Workertyp – Text | Microsoft_EmploymentType | |
| Worker | Aktive Skills | Microsoft_UserSkillNames | |
| Worker | Öffentliche primäre geschäftliche Telefonnummer | Microsoft_Phone | |
| Worker | Kostenstelle – ID | Microsoft_CostCenter | |
| Worker | Division | Microsoft_Division |
Filtern Sie Arbeitskräfte heraus, die keine E-Mail-Adresse haben, indem Sie der Registerkarte "Filter" etwas hinzufügen, z. B.:
Nachdem Sie den Bericht angepasst haben, wählen Sie "Erweitert" aus. Wählen Sie dann unter Webdienstoptionen die Option Als Webdienst aktivieren aus.
7. Erstellen Sie die Integration in Ihrer externen Quelle
Führen Sie diese Schritte aus, um die API-Integration in Workday zu erstellen. Die Dokumentation für den Arbeitstag finden Sie hier.
Suchen Sie oben auf dem Bildschirm in Workday nach "EIB erstellen" und wählen Sie es aus.
Auf der Seite EIB erstellen :
- Geben Sie einen Namen für die Integration ein.
- Wählen Sie Ausgehend aus.
- Wählen Sie OK aus.
Überprüfen und bestätigen Sie die Details auf der Seite "Allgemeine Einstellungen ". Wenn alles gut aussieht, wählen Sie Weiter aus.
Auf der Seite " Daten abrufen ":
Wählen Sie neben "Datenquellentyp" die Option "Benutzerdefinierter Bericht" aus.
Wählen Sie neben Benutzerdefinierter Bericht den Bericht aus, den Sie in Ihren API-basierten Connector integrieren möchten.
Wählen Sie unter "Details" neben "Alternatives Ausgabeformat"die Option "CSV" aus.
Wählen Sie unten auf der Seite "Weiter" aus.
Auf der Seite "Transformieren " müssen Sie keine Änderungen vornehmen. Wählen Sie Weiter aus.
Auf der Seite "Liefern" :
- Wählen Sie neben "Delivery Method" die Option "HTTP/SSL" aus.
- Geben Sie neben HTTP-Adresse die Adresse ein, die aus den obigen Schritten generiert wurde.
- Wählen Sie neben Webdienstaufruftypdie Option OAuth 2.0 aus.
- Geben Sie neben Zugriffstoken das aus den obigen Schritten generierte Zugriffstoken ein.
- Geben Sie neben "Token aktualisieren" das aus den obigen Schritten generierte Aktualisierungstoken ein.
- Geben Sie neben " Token-URL aktualisieren" die URL des Aktualisierungstokens ein, die aus den obigen Schritten generiert wurde.
- Geben Sie neben Client-ID die AppID/ClientID ein.
- Geben Sie neben " Geheimer Clientschlüssel" den geheimen Clientschlüssel ein.
- Geben Sie neben "Dateiname" den gewünschten Dateinamen ein. Er muss .csv werden.
- Wählen Sie unten auf der Seite "Bereitstellen"die Option "Weiter" aus.
Überprüfen Sie die Details auf der Seite Überprüfen und absenden . Wenn alles gut aussieht, wählen Sie "OK" aus.
Wählen Sie neben dem Namen Ihrer Integration Aktionen aus.
Bewegen Sie den Mauszeiger über Integration, und wählen Sie dann Integration starten/planen aus.
Auf der Seite Integration starten/planen :
- Wählen Sie neben Integration den Namen der Integration aus, die Sie erstellt haben.
- Wählen Sie neben Ausführungsfrequenz die gewünschte Frequenz aus.
- Wählen Sie OK aus.