Ansicht
Dokumentation

ECPAO_OM_OBJECT_EXTRACTION - Organisationsdatenextraktion

Vendor Master (General Section)   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Verwendung

Dieses Programm extrahiert Organisationsdaten (z.B. Daten, die sich auf Organisationseinheiten, Planstellen oder Stellen beziehen) aus dem ERP-System und repliziert sie in SAP SuccessFactors Employee Central (EC).

Wenn Sie das Programm erstmals ausführen, extrahiert es alle Daten für die von Ihnen ausgewählten Organisationsobjekte auf Basis der Transformationsvorlagengruppe, die Sie im Selektionsbild angegeben haben. Wenn Personalsachbearbeiter Organisationsdaten 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_OM, repliziert die geänderten Daten und kennzeichnet die Änderungszeiger als verarbeitet. Beachten Sie, dass Sie nur Vorlagengruppen mit dem Kommunikationskanal Webservice-Übertragung verwenden können, um geänderte Daten zu replizieren.

Integration

Sie können dieses Programm mit dem Transaktionscode ECPAO_OM_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 Organisationsobjekte erfolgreich und wie viele mit Fehlern verarbeitet wurden. Wenn Sie den Abruf eines detaillierten Protokolls gewählt haben, werden zusätzliche Erfolgs- und Fehlermeldungen für jedes Objekt auf Basis des Objekttyps und der Objekt-ID angezeigt. Die Fehlermeldungen geben an, warum die Extraktion oder Replikation fehlgeschlagen ist.

Beispiel

Wenn ein Feld im Customizing auf Ist 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 Organisationsdaten aus SAP in Employee Central mittels Webservice-Übertragung ausgegeben wurden.

Dieses Programm aktualisiert die Schlüsselzuordnungstabelle SFIOM_KMAP_OSI mit den zugeordneten IDs. Es 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, die für Employee-Central-Entitäten repliziert wurden (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 Organisationsdaten 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_OM 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 Organisationsdaten 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 Daten in Employee Central repliziert werden.

Funktionsumfang

Selektion

Objekte

Geben Sie an, für welche Organisationsobjekte die Daten extrahiert werden sollen. Für die von Ihnen ausgewählten Objekttypen sollte eine Feldzuordnung mit der ausgewählten Vorlagengruppe konfiguriert werden (siehe weiter unten Extraktionsvorlage). Die Transformationsvorlagengruppe kann Vorlagen für unterschiedliche Objekttypen wie Organisationseinheiten, Stellen oder Planstellen enthalten. Sie können die zu extrahierenden Objekte filtern, indem Sie die Option Strukturbedingungen setzen im Selektionsbild verwenden und ein Wurzelobjekt, einen Typ sowie einen Auswertungsweg angeben. Das Programm startet dann ausgehend von dem Wurzelobjekt und ermittelt anhand des Auswertungswegs alle Objekte mit dem angegebenen Objekttyp. Die Daten für die dem Auswertungsweg entsprechenden Objekte werden auf Basis der Einstellungen, die Sie für die ausgewählte Transformationsvorlagengruppe vorgenommen haben, extrahiert.

Beachten Sie, dass nur Ihre aktive Planversion und der aktive Objektstatus berücksichtigt werden.

Extraktionsvorlage

Geben Sie die Transformationsvorlagengruppe an, auf deren Basis das Programm die Organisationsdaten extrahieren soll. Transformationsvorlagengruppen werden im Viewcluster VC_ECPAO_MAP_OM definiert (siehe Abschnitt Voraussetzungen oben).

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.

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.

Meldungsprotokoll

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

Weitere Auswahlkriterien

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

Hinweis

"Nur fehlgeschlagene Objekte" wird nur für den Modus "Webservice-Übertragung" 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 Objekte die Daten erfolgreich extrahiert oder repliziert wurden und für wie viele Objekte die Extraktion oder Replikation fehlgeschlagen ist. Falls Sie den Abruf eines detaillierten Protokolls gewählt haben, werden die betreffenden Objekt-IDs und Transformationsvorlagen mit den relevanten Fehlermeldungen aufgelistet. Zudem werden alle Meldungen im Anwendungsprotokoll gespeichert.

Hinweis

Wenn die von Ihnen im Selektionsbild eingegebene Vorlagengruppe mehrere Transformationsvorlagen für Organisationseinheiten enthält, die Organisationseinheiten verschiedenen Objekttypen in Employee Central zuordnen, wird eine Fehlermeldung ausgegeben. Da alle Unternehmenseinheiten, Sparten und Abteilungen aus Employee Central Organisationseinheiten im ERP-System zugeordnet werden, müssen Sie sich für einen dieser Objekttypen entscheiden. Sie können z.B. angeben, dass Organisationseinheiten immer in Abteilungen repliziert werden. In diesem Fall fügen Sie nur eine Transformationsvorlage zu Ihrer Transformationsvorlagengruppe hinzu, der die Employee-Central-Vorlage Abteilung zugeordnet ist. Wenn Sie alle drei Vorlagen in Ihrer Transformationsvorlagengruppe verwenden möchten, implementieren Sie das Business Add-In (BAdI) Gültigkeitszeiträume für Datenreplikation nach EC (EX_ECPAO_EMP_VALIDITY_TAB). Mit diesem BAdI legen Sie für jede Organisationseinheit fest, zu welchem Employee-Central-Objekt sie zugeordnet wird. Weitere Informationen finden Sie unter BAdI: Gültigkeitszeiträume für Datenreplikation nach EC.

Aktivitäten

Rufen Sie nach jeder Ausführung dieses Programms die Transaktion Anwendungslog auswerten (SLG1) auf, und prüfen Sie die Protokolle. Geben Sie hierzu das Objekt ECPAO und das Unterobjekt ECPAO_OM ein. Um nach einer bestimmten Organisationseinheit zu suchen, geben Sie die Objekt-ID 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 ERP-Vorlage ERP1 für Objekt 1234567 während Datenreplikation nach EC) die Option Details.

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

Beispiel

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 12662 Date: 20240520 Time: 113711     sap01-206 ( 234 ms )