El siguiente contenido cubre un resumen básico de la tecnología API de EC.
Exploración de tecnología API
Objective
After completing this lesson, you will be able to recuperar cuándo utilizar qué API admitida por SAP SuccessFactors.
Introducción
Webinar grabado: Introducción a Employee Central y API de OData
Resumen de tecnología API
Estrategia API-First
El marco de la empresa inteligente
OData ofrece a los socios y a los clientes una experiencia de API consistente para la empresa inteligente.
- Integre tecnologías inteligentes en extensiones con técnicas consistentes.
- Se aplican las mismas herramientas y conjuntos de habilidades en todos los productos.
- Aproveche los activos existentes para ejecutar rápidamente la visión de la suite inteligente.
- OData es el estándar arquitectónico de SAP.
Visión arquitectónica API-First
Aplicación externa a/desde el sistema SAP SucccessFactors - Replicación de datos
- El sistema de terceros replica datos desde o hacia un sistema SAP SucccessFactors
- Por lo general, el middleware involucrado
- Usuarios técnicos utilizados para la replicación
Aplicación externa al sistema SAP SucccessFactors en tiempo real - Integración de IU
- Datos de acceso a la aplicación en tiempo real desde un sistema SAP SucccessFactors
- Por lo general, las plataformas de aplicación involucradas
- Acceso de usuario con nombre
Beneficios de un enfoque API-First
Mayor calidad
- Las API son más fáciles y costosas de probar con el framework de automatización (AAF v2) y las pruebas basadas en metadatos
- El uso generalizado de servicios compartidos minimiza la posibilidad de escapes de prueba
- Los servicios de configuración y datos de API son más fáciles de simular para el desarrollo impulsado por pruebas (TDD)
- Las pruebas de UX solo necesitan probar la lógica del controlador, ya que los servicios subyacentes ya están probados
Tiempo de llegada al mercado/Coste de propiedad
- Mejora el tiempo de comercialización general para aplicaciones móviles, de escritorio, de partners y personalizadas
- RGPD, CypherCloud, cifrado y otras características más fáciles de implementar con un conjunto central de servicios en un marco común
- Sin mantenimiento dual: solo se actualiza un único conjunto de lógica empresarial.
- Las mejoras funcionales benefician a todas las aplicaciones
Escalabilidad/Estabilidad
- Mediar, monitorear, analizar y limitar la API a través de SAP API Management en nuestros centros de datos
- Las mejoras de rendimiento de API benefician a todas las aplicaciones
- Las API son esenciales para cualquier arquitectura de microservicios
Tecnologías de integración/API disponibles para EC
Integración/Evolución de API
Importación/Exportación: Fichero CSV (automatización posible vía FTP)
API SOAP
- Empleado compuesto: servicio SOAP especializado para la replicación de datos (solo lectura)
API de OData
- API de lectura de EC OData para consumo y replicación de IU
- API upsert EC OData para replicación de datos
- API de lectura/escritura de OData de MDF para consumo y replicación de IU
Basado en empleado: API de empleado compuesto
Basado en empleado - API de empleado compuesto - I
Empleado compuesto
De nuevo al diagrama de relación de entidades, muestra la API de empleado compuesto incluye un conjunto de entidades rodeadas de una línea naranja. La API de empleado compuesto es un tipo de tecnología de API de EC SOAP que se centra en la replicación de datos maestros de empleado de Employee Central.
Basado en empleado - API de empleado compuesto - II
Solicitud:
Respuesta:
Si consultamos Empleado compuesto, la cláusula de consulta ya no son campos, sino el nombre de la entidad (person, personal_information) que se compara con la API directa de SAP SuccessFactors.
Basado en empleado: API EC OData - I
API de EC OData que utilizan navegaciones, incl. MDF
Las API OData admiten la navegación para entidades asociadas; crea automáticamente navegaciones desde la entidad de origen a las entidades de destino en función de la relación definida. Las navegaciones en una entidad representan asociaciones entre entidades. Cada entidad puede tener las siguientes propiedades.
- Fechas efectivas
- Claves empresariales
- Atributo obligatorio/anulable
- Parámetros de procesamiento para upsert
Basado en empleado: API EC OData - II
Observe esta solicitud y respuesta de API. Podemos ampliar fácilmente las entidades de Employee Central (EC) existentes (personalInfoNav) utilizando la funcionalidad de ampliación y creando ampliaciones de cliente de EC para socios y clientes. MDF le permite personalizar los objetos del cliente y la lógica de aplicación relacionada según sea necesario para satisfacer las necesidades de su cliente.
Solicitud:
https://salesdemo4.successfactors.com:443/odata/v2/PerPerson?$format=json &$select=personIdExternal,dateOfBirth, personalInfoNav/startDate, personalInfoNav/firstName, personalInfoNav/lastName, personalInfoNav/customString1&$expand=personalInfoNav &$filter=personIdExternal%20eq%20'greinhard3‘‘
Respuesta:
Sus opciones y motivos para elegir cuál
Cuándo utilizar importaciones/exportaciones...
- Para la carga de datos inicial o si no puede consumir API (SOAP u OData).
Cuándo utilizar OData y cuándo SOAP...
- Si desea utilizar la autorización basada en función y el acceso de usuario simultáneo para crear sus propias IU sobre EC utilizando una plataforma de ampliación, OData es la tecnología que desee.
- Si desea acceder a OData de datos MDF es la única tecnología de su elección.
- Para la replicación de datos mediante un usuario técnico (lectura o escritura) se pueden utilizar tanto SOAP como OData, pero recomendamos utilizar OData, ya que OData tiene una mejor cobertura de entidades.
Cuándo utilizar la API compuesta SOAP...
- Si necesita para la replicación de empleado nivel de campo delta, instantánea o leer solo empleados modificados.
- Si solo necesita leer datos maestros de empleado (CE no admite escritura).
Documentación de ayuda de SAP
Aspectos destacados de la solución
OData:
- API estandarizada que sigue la especificación de OData V2
- Los objetos configurables personalizados vienen con API OData CRUD
- Las API OData reaccionan a las modificaciones del modelo de datos
- Las API de OData permiten la navegación por el modelo de datos mediante $expand
- Tecnología de destino para casos de uso tanto de integración como de IU
- Soporte de autorización basado en usuario
- OAuth y autenticación básica posibles
API SOAP:
- Employee Central ofrece para la replicación de datos de empleado una potente interfaz SOAP (solo lectura)
- Varios modos disponibles, como transmisión completa, delta, delta de período e instantánea
- Optimizado para cargas de datos altas
Más información:
Tecnología obsoleta
Interfaz SOAP
- Todos los informes adhoc
- Depósito directo per.
- Empleado compuesto - Todas las SFAPI directas de agosto de 2018
Importaciones basadas en archivos
- Depósito directo per.