Überblick über die API-Technologie
EC-API-Konfiguration einrichten
Verwenden von OData-API-Aufrufen und -Tools
EC-OData-API-Funktionen optimieren
EC-OData-Schreiboperation durchführen
Integrations-Center verwalten
Externe Ereignisbenachrichtigung konfigurieren
Monitoring-APIs
Anhang wird analysiert

Schreibvorgänge in EC OData konfigurieren

Objective

After completing this lesson, you will be able to abfragen von SAP-SuccessFactors-Employee-Central-Daten mithilfe von OData-APIs aus einem Testmandanten abfragen.

Einführung

Die nächste Inhaltsreihe deckt die grundlegenden Kenntnisse zum Schreiben von Daten in SuccessFactors ab.

Schreiben von Datenoperationen

Es gibt vier Möglichkeiten, Daten zu schreiben:

POST: odata/v2/cust_MyBuilding

PUT: odata/v2/cust_MyBuilding( valideStartDate=datetime → CREATE (UI incl. RBB)

'1990-01-01T00:00:00', externalCode='GRTTESTKM3') → UPDATE (UI incl. RBB)

POST: odata/v2/upsert?purgeType=incremental → UPDATE OR CREATE Integration - no RBP

POST: odata/v2/upsert?purgeType=full → DELETE OR CREATE Integration - no RBP

Manchmal müssen wir Daten in das EC-System schreiben. Für eine kleine Datenmenge können wir sie in SAP SuccessFactors Employee Central erreichen. Wenn jedoch eine große Datenmenge erforderlich ist, ist es besser, Daten auf andere Weise zu schreiben. Es gibt 4 Möglichkeiten, Daten zu schreiben, die auf der Seite angezeigt werden.

Daten-Payload schreiben

Snippet-Code des Schreibens der Daten-Payload.

Von Query zu Schreiben

  1. Eine Abfrage erstellen und im erweiterten REST-Client ausführen
  2. Kopieren Sie die Antwort der Abfrage in die Zwischenablage (achten Sie darauf, dass jedes Token " und nach jedem Token ein Komma aufweist), und kopieren Sie es in die Payload.
  3. Änderung von GET in Put oder Post (bei Upsert Entitätsname durch Upsert ersetzen)
  4. Content-Typ zum URL-HTTP-Header hinzufügen, um das für die Payload verwendete Format anzugeben
  5. Schreib-API ausführen

Verwenden Sie den Link "In Zwischenablage kopieren" im erweiterten REST-Client statt STRG+C im Browser.

Verwenden Sie http://www.epochconverter.com/, um Datumsangaben in EPOC-Zeitstempel zu konvertieren und umgekehrt.

  • Beispiel: 631152000000 ist gleich 1990-01-01T00:00:00, was bedeutet Mo, 01 Jan 1990 00:00:00 GMT

Nicht alle Entitäten unterstützen alle Schreibvorgänge:

  • MDF-Objekte und Plattformobjekte, z. B. Benutzer, Planstelle, EmployeeTime usw. unterstützen Entitäten mit POST und PUT sowie Upsert.
  • EC-Entitäten wie EmpJob und PerPersonal unterstützen nur Upsert.
  • EC2MDF-Entitäten wie FODepartment und FOCostCenter unterstützen Upsert, aber POST und PUT mit einigen Einschränkungen.

Weitere Funktionen

SAP-OData-POST-Request für Ressource Cust_MyBuilding, JSON-Payload senden, Antwortstatus 201 angelegt, Inhaltstyp application/json
  • ANLEGEN
  • Legt ein neues Gebäude 3 an und verweist auf Raum 1 und 2
  • Format der Payload

Anlegen/Verknüpfen kombinieren

POST: odata/v2/cust_MyBuidling

Payload:

{ "valideStartDate" : "\/Date(1437436800000)\/",

"externalCode" : "GRTBLD3",

"externalName" : "Gerald Building 3",

"cust_rooms" : [

{

"__metadata" : {

"uri" : "https://salesdemo4.successfactors.com:443/odata/v2/cust_MyRoom(effectiveStartDate=datetime'2015-07-21T00:00:00',externalCode='GRTROOM1')", "type" : "SFOData.cust_MyRoom"

}},

{"__metadata" : {

"uri" : "https://salesdemo4.successfactors.com:443/odata/v2/cust_MyRoom(effectiveStartDate=datetime'2015-07-21T00:00:00',externalCode='GRTROOM2')", "type" : "SFOData.cust_MyRoom"

}}

]

}

Mitarbeiterdatenabfragen über REST-Client mit OData-API ausführen

Prozessübersicht

Diese Simulation zeigt die grundlegenden Konfigurationsschritte, die erforderlich sind, um die Konfiguration für SAP SuccessFactors Employee Central manuell einzurichten. Sie erhalten die Grundkenntnisse des OData-API-Aufrufs und der Werkzeuge. Überwachen der APIs für verschiedene Partner.

Voraussetzungen

Die folgende Konfiguration und Anpassung müssen abgeschlossen sein, bevor die Grundeinstellungen in SAP SuccessFactors implementiert werden können.

  • Zugriff auf OData SFAPI
  • Zugriff auf Audioprotokoll
  • Zugriff auf API-Tools

Ergebnis

Im Rahmen dieser Demonstration wird der Konfigurationsabschnitt in EC behandelt: EC OData Basics - Query Operations.