Ansicht
Dokumentation

ECPAO_EMPL_EXTRACTION - Mitarbeiterdatenextraktion

PERFORM Short Reference   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Verwendung

Dieses Programm extrahiert Mitarbeiterdaten aus dem ERP-System und repliziert diese nach SAP SuccessFactors Employee Central (EC).

Wenn Sie das Programm erstmals ausführen, extrahiert es alle Mitarbeiterdaten für die ausgewählten Mitarbeiter, die Sie unter Verwendung der auf dem Selektionsbild des Programms angegebenen Transformationsvorlagengruppe definiert haben. Wenn Personalsachbearbeiter Mitarbeiterdaten in der Personaladministration im ERP-System ändern, werden Änderungszeiger erzeugt. Das Programm IDocs aus den Änderungszeigern erzeugen (RBDMIDOC) (oder Transaktion BD21) liest die Änderungszeiger mit dem Nachrichtentyp ECPAO, repliziert die geänderten Daten und kennzeichnet die Änderungszeiger als verarbeitet. Beachten Sie, dass Sie nur Transformationsvorlagengruppen mit dem Kommunikationskanal "Webservice-Übertragung" verwenden können, um geänderte Daten zu replizieren.

Integration

Sie können dieses Programm mit dem Transaktionscode ECPAO_EE_EXTR aufrufen.

Dieses Programm schreibt Meldungen in das Anwendungsprotokoll. Es gibt ein allgemeines Protokoll mit Statistiken für jeden Lauf des Programms, das anzeigt, wie viele Mitarbeiter erfolgreich und wie viele mit Fehlern verarbeitet wurden. Wenn Sie sich für ein detailliertes Protokoll entschieden haben, werden für jeden Mitarbeiter zusätzliche Erfolgs- und Fehlermeldungen angezeigt. Die Fehlermeldungen geben an, warum bei der Extraktion oder Replikation ein Fehler aufgetreten ist.

Beispiel

Wenn das Employee-Central-Feld Vorname im Customizing auf Erforderlich gesetzt wurde und die extrahierten Daten keinen Wert für dieses Feld enthalten, wird eine entsprechende Fehlermeldung für das betreffende Objekt angezeigt.

Das Anwendungsprotokoll zeigt außerdem Employee-Central-Meldungen an, die für eine Transformationsvorlage bei der Replikation der Mitarbeiterdaten aus dem ERP-System in Employee Central mittels Webservice-Übertragung ausgegeben wurden.

Dieses Programm aktualisiert außerdem die folgenden Tabellen mit dem Replikationsstatus und gegebenenfalls mit der zugehörigen Fehlermeldung:

• Inventar von Daten, die für Mitarbeiter und Organisationsobjekte repliziert wurden (ECPAO_EE_INVT)

• Inventar von Daten repliziert für Mitarbeiter zentrale Vorlagen (ECPAO_INVT)

• Inventar der replizierten Daten: Fehlermeldungen (ECPAO_INVT_MSG)

Voraussetzungen

Sie haben die Metadaten (z.B. Feldnamen) aus Employee Central in das ERP-System für die Employee-Central-Instanz importiert, in die Sie die Mitarbeiterdaten replizieren möchten. Wählen Sie hierfür eines der folgenden Programme aus:

• Import von Metadaten aus Employee Central mit XML-Datei (ECPAO_ECTMPL_METADATA_WRITER)

Weitere Informationen finden Sie unter Metadaten für webservicebasierte Datenübertragung aus Employee Central importieren.

• Import von Metadaten aus Employee Central (ECPAO_ECFLD_METADATA_WRITER)

Weitere Informationen finden Sie unter Metadaten für dateibasierte Datenübertragung aus Employee Central importieren.

Sie haben im Viewcluster VC_ECPAO_MAP definiert, aus welchen Feldern im ERP-System Daten extrahiert und in welche Employee-Central-Felder die Daten übertragen werden sollen. Weitere Informationen finden Sie unter Feldzuordnung für Mitarbeiterdaten definieren.

Sie haben das Programm IDocs aus den Änderungszeigern erzeugen (RBDMIDOC) so eingeplant, dass es in regelmäßigen Abständen im Hintergrund ausgeführt wird, um sicherzustellen, dass geänderte Stammdaten in Employee Central repliziert werden.

Funktionsumfang

Selektion

Selektionskriterien

Geben Sie an, für welche Mitarbeiter die Daten extrahiert werden sollen. Geben Sie dazu entweder die Personalnummern der Mitarbeiter an, oder verwenden Sie Organisationszuordnungskriterien, um eine Gruppe an Mitarbeitern auszuwählen.

Extraktionsvorlage

1. Geben Sie die Transformationsvorlagengruppe an, auf deren Basis das Programm die Mitarbeiterdaten extrahieren soll. Transformationsvorlagengruppen werden im Viewcluster VC_ECPAO_MAP definiert (siehe Abschnitt Voraussetzungen oben).
2. Sie können auch die Varianten-ID eingeben. Wählen Sie die Varianten-ID aus, die Sie für die Transformationsvorlagengruppe in der Sicht V_ECPAO_VARIANT definiert haben. Sie müssen die Varianten-ID auswählen, wenn Sie den Extraktionsreport nur für die unter der ausgewählten Varianten-ID definierten Transformationsvorlagen ausführen möchten.

Hinweis: EC-Entitäten, die in der Sicht V_ECPAO_ECTM_FIL gepflegt werden, werden während des Extraktionsprozesses gefiltert.

Kommunikationskanäle

Hier geben Sie an, ob das Programm einen Testlauf ausführen soll und wie die Daten übertragen werden sollen:

• mittels Webservice-Übertragung unter Verwendung von Middleware, die zur Replikation von Daten aus dem ERP-System in Employee Central verfügbar ist

Diese Option können Sie nur verwenden, wenn die angegebene Transformationsvorlagengruppe den Kommunikationskanal Webservice-Übertragung verwendet.

• mittels einer trennzeichengetrennten Datei (CSV-Datei)

Die CSV-Optionen können Sie nur verwenden, wenn die angegebene Transformationsvorlagengruppe den Kommunikationskanal CSV-dateibasierte Übertragung verwendet.

Wenn Sie eine der Dateioptionen wählen, können Sie einen Zusatz für den Dateinamen angeben, um zu verhindern, dass die vorhandenen Dateien durch die neuen Dateien überschrieben werden. Wenn Sie keine Datei-ID eingeben, wird für jeden Download der gleiche Dateiname verwendet, sodass die vorhandenen Dateien überschrieben werden.

Geben Sie außerdem an, wo die CSV-Datei gespeichert werden soll. Sie können die CSV-Datei auf dem Anwendungsserver oder auf Ihrem lokalen Laufwerk speichern. Wir empfehlen Ihnen, die Datei auf dem Anwendungsserver zu speichern.

Wenn Sie mehrere CSV-Dateien speichern, können Sie diese auch in einer ZIP-Datei zusammenfassen. Beachten Sie, dass CSV-Dateien, die Sie für generische Objekte anlegen, nicht komprimiert werden können. Diese werden separat gespeichert, auch wenn Sie die Option In ZIP-Datei kombinieren wählen.

Meldungsprotokoll

Sie geben an, ob Sie ein detailliertes Protokoll mit individueller Auflistung der Erfolgs- und Fehlermeldungen oder nur eine Statistik abrufen möchten.

Weitere Selektionskriterien

Sie geben an, ob Sie die Replikation nur für Mitarbeiter mit dem Replikationsstatus "Fehlgeschlagen" erneut ausführen möchten.

Hinweis

Der Dateiübertragungsmodus wird für diese Auswahl nicht unterstützt.

Standardvarianten

Ausgabe

Wenn Sie die Webservice-Übertragung gewählt haben, überträgt das Programm mithilfe von Webservices die extrahierten Daten an die Middleware. Diese überträgt die Daten dann an Employee Central.

Wenn Sie die Übertragung der Daten mittels einer Datei gewählt haben, generiert das Programm eine CSV-Datei, die ohne Verschlüsselung unter dem angegebenen Pfad gespeichert wird.

Anhand eines Protokolls werden Sie darüber informiert, für wie viele Mitarbeiter die Daten erfolgreich extrahiert oder repliziert wurden und für wie viele Mitarbeiter die Extraktion oder Replikation fehlgeschlagen ist. Auch bei erfolgreicher Replikation der EC-Entität aus ERP könnten Warnmeldungen aus EC auftreten. Falls Sie den Abruf eines detaillierten Protokolls gewählt haben, werden die betreffenden Personalnummern und Transformationsvorlagen mit den relevanten Fehler- oder Warnmeldungen aus EC aufgelistet. Zudem werden alle Meldungen im Anwendungsprotokoll gespeichert.

Wenn Sie eine EC-Entität mithilfe der Customizing-Aktivität "EC-Entitäten für Migration von Mitarbeiterdaten nach EC basierend auf Land filtern" gefiltert haben, dann wird dies bei der Extraktion für eine PERNR, die zu diesem Land gehört, nicht berücksichtigt.

Aktivitäten

Um sicherzustellen, dass die Vorgesetztenzuordnungen der Mitarbeiter nach Employee Central übertragen werden, gehen Sie wie folgt vor:

1. Führen Sie einen Initialisierungslauf des Programms ECPAO_EMPL_EXTRACTION aus, um alle Mitarbeiter zu extrahieren, einschließlich der Manager, jedoch ohne eine Managerzuordnung. Das bedeutet, dass die Mitarbeiter nach Employee Central mit dem Eintrag NO_MANAGER im Feld übertragen werden, das den zugeordneten Vorgesetzten enthält.
2. Führen Sie das Programm Ermittlung von Vorgesetzten und Organisationsmanagementdaten (ECPAO_MNGR_TYPES_EXTRACTION) aus, um die Vorgesetzten der Mitarbeiter zu ermitteln und deren Personalnummern (oder Benutzer) in der Tabelle ECPAO_EE_MGNR zu speicher. Weitere Informationen finden Sie unter Ermittlung von Vorgesetzten und Organisationsmanagementdaten.
3. Führen Sie das Programm ECPAO_EMPL_EXTRACTION erneut aus, um die Vorgesetztenbeziehungen aus der Tabelle ECPAO_EE_MGNR abzurufen und nach Employee Central zu übertragen.
4. Planen Sie für das Programm ECPAO_MNGR_TYPES_EXTRACTION eine regelmäßige Ausführung im Hintergrund ein, um sicherzustellen, dass die nach Employee Central übertragenen Vorgesetztenbeziehungen auf dem aktuellsten Stand sind.

Rufen Sie nach jeder Ausführung des Programms ECPAO_EMPL_EXTRACTION die Transaktion Anwendungslog auswerten (SLG1) auf, und prüfen Sie die Protokolle. Geben Sie hierzu das Objekt und Unterobjekt ECPAO ein. Um nach einem bestimmten Mitarbeiter zu suchen, geben Sie die Personalnummer im Feld Externe ID ein. Sie können optional zusätzliche Selektionskriterien eingeben. Wählen Sie dann Ausführen. Um die von Employee Central für eine Transformationsvorlage ausgegebenen Meldungen anzuzeigen, wählen Sie für eine Fehlermeldung mit Bezug zu einer Transformationsvorlage (z.B. Fehler in der Transformationsvorlage ERP1 für Mitarbeiter 12345 während der Datenreplikation auf EC) die Option Details.

Sie können auch das Programm Inventar der replizierten Mitarbeiterdaten analysieren (ECPAO_OM_INVENTORY_ALV) verwenden, um den Replikationsstatus pro Mitarbeiter zu prüfen.

Beispiel

rdisp/max_wprun_time - Maximum work process run time   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 12892 Date: 20240520 Time: 105848     sap01-206 ( 204 ms )