Realizando operación de escritura de EC OData

Configuración de operaciones de escritura en EC OData

Objective

After completing this lesson, you will be able to consultar datos de SAP SuccessFactors Employee Central mediante API de OData desde un cliente de prueba.

Introducción

La siguiente serie de contenidos cubrirá el conocimiento básico de cómo escribir datos en SuccessFactors.

Operaciones de escritura de datos

Existen cuatro formas de escribir datos:

POST: odata/v2/cust_MyBuilding

PUT: odata/v2/cust_MyBuilding( efftiveStartDate=datetime → CREATE (IU incl. RBP)

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

POST: ¿odata/v2/upsert?purgeType=incremental → ACTUALIZAR O CREAR integración - sin autorización basada en función

POST: ¿odata/v2/upsert?purgeType=full → BORRAR O CREAR integración - sin autorización basada en función

A veces necesitamos escribir datos en el sistema EC, para una pequeña cantidad de datos podemos conseguirlos en SAP SuccessFactors Employee Central, pero si se requiere una gran cantidad de datos, es mejor escribir datos de otras maneras. Hay 4 formas de escribir datos que se muestran en la página.

Escribiendo payload de datos

Código de snippet de payload de datos de escritura.

De consulta a escritura

  1. Crear una consulta y ejecutarla en Advanced Rest Client
  2. Copie la respuesta de la consulta en el portapapeles (asegúrese de que cada token tenga " y después de cada token hay una coma) y cópiela en el payload
  3. Cambiar de GET a put o post (un en caso de upsert sustituir nombre de entidad por upsert)
  4. añada el tipo de contenido a la cabecera http de URL para indicar el formato que se utiliza para el payload
  5. Ejecutar API de escritura

Utilice el enlace Copiar en el portapapeles en el cliente rest avanzado en lugar de CTRL-C en el navegador.

Utilice http://www.epochconverter.com/ para convertir fechas en cronomarcador EPOC y viceversa

  • p. ej., 631152000000 es igual a 1990-01-01T00:00:00 que se traduce en Lun, 01 Ene 1990 00:00:00 GMT

No todas las entidades admiten todas las operaciones de escritura:

  • Objetos MDF y objetos de plataforma, p. ej. Entidad de soporte de usuario, posición, tiempo de empleado, etc. con POST y PUT, así como upsert.
  • Las entidades de EC como EmpJob y PerPersonal solo admiten upsert.
  • Entidades EC2MDF como FODepartment y FOCostCenter admiten upsert, pero POST y PUT con algunas limitaciones.

Otras funciones

Solicitud POST de SAP oData para el recurso Cust_MyBuilding, envío de payload JSON, estado de respuesta 201 Creado, tipo de contenido application/json.
  • CREAR
  • Crea un nuevo Edificio 3 y enlaza con la Sala 1 y 2
  • Formato de payload

Combinar Crear/Enlazar

POST: odata/v2/cust_MyBuidling

Payload:

{ "efftiveStartDate" : "\/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"

}}

]

}

Ejecutar consultas de datos de empleado mediante cliente REST con API de OData

Resumen del proceso

Esta simulación muestra los pasos de configuración básicos necesarios para configurar manualmente la configuración para SAP SuccessFactors Employee Central. Obtendrá los conocimientos básicos de la llamada y las herramientas de la API de OData. Cómo supervisar las API para diferentes socios.

Prerrequisitos

La siguiente configuración y personalización deben haberse completado antes de implementar la configuración básica en SAP SuccessFactors.

  • Acceso a SFAPI de OData
  • Acceso al log de audio
  • Acceso a herramientas de API

Resultado

Como parte de esta demostración, cubriremos la sección de configuración en EC, que es: EC OData Basics - Operaciones de consulta.