Integrar SAP SuccessFactors

Integre con SAP SuccessFactors para acceder desde cualquier lugar a la información sobre empleados, competencias y cursos.

Nota:

Ofrecemos dos plantillas para la integración de SuccessFactors. Recomendamos utilizar la integración HTTP de SuccessFactors EC más reciente para los casos de uso de SAP SuccessFactors Employee Central. La integración HTTP ofrece mayor capacidad para configurar la estructura de datos en caché.

Para obtener una lista completa de las microaplicaciones de SuccessFactors de uso inmediato, consulte Usar microaplicaciones de SuccessFactors.

Revisar requisitos previos

Después de configurar esta integración en SAP SuccessFactors, necesitará estos artefactos para agregar la integración a las microaplicaciones de Citrix Workspace según el tipo de integración que necesite habilitar. Después de completar este proceso, el nivel existente de registros de auditoría persiste, incluidas las acciones llevadas a cabo por el uso de microaplicaciones de Citrix.

• La información de configuración necesaria para conectarse con SAP SuccessFactors depende de si se utiliza el módulo Learning.
• Cree un usuario administrador en la instancia de Provisioning. Normalmente, un consultor certificado de SuccessFactors realiza todas las actividades en Provisioning. Asigne al usuario un nombre distinguible.
• Configure Citrix Gateway para que admita Single Sign-On para SuccessFactors, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Para obtener más información acerca de la configuración de SSO, consulte Citrix Gateway Service.

Nota:

Hay aplicables límites de tráfico para las integraciones de SuccessFactors en términos de número de solicitudes por minuto. Esto puede afectar a las instancias de prueba. Para evitar problemas, establezca los límites de tráfico en 8 llamadas por segundo. Para obtener más información, consulte a su asesor de SuccessFactors para averiguar el valor máximo de solicitudes.

Para la integración de SuccessFactors EC:

• URL base: La URL base sigue este modelo: https://{tenant}.successfactors.{region}/odata/v2
• Nombre de usuario: Su ID único de usuario.
• ID de cliente: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Consulte la sección Obtenga su ID de empresa y su ID de cliente.
• ID de empresa: El ID de empresa es una cadena de caracteres breve que identifica cada sistema de SAP SuccessFactors, como un nombre de usuario de su organización. Consulte la sección Obtenga su ID de empresa y su ID de cliente.
• Clave privada: Esta es la clave de API del registro del cliente de OAuth2. Consulte Registrar el cliente de OAuth2.
• URL de OAuth: Esta es la URL de aplicación generada en la plantilla, que sigue este modelo: https://{tenant}.successfactors.{region}/oauth. Necesitará esto para Registrar el cliente de OAuth2.

Para la integración de SuccessFactors HCM:

• URL de API
• ID de empresa
• ID de usuario (nombre de usuario)
• ID de cliente (clave de API)
• Clave privada del cliente (clave privada cifrada)

Para la integración de SuccessFactors Learning:

• URL de Learning
• ID de empresa de Learning
• ID de usuario de Learning
• ID de cliente de Learning
• Secreto del cliente de Learning

Configurar la integración de SuccessFactors HCM

Siga este proceso si necesita configurar la integración básica de SuccessFactors HCM o la integración básica con el módulo Learning. Con el usuario administrador, cree un rol de permisos, cree un grupo de permisos y asigne el grupo de permisos al rol de permisos.

Crear un rol de permisos

Para crear un rol de permisos, siga estos pasos:

1. Inicie sesión en el centro de administración de SAP SuccessFactors con su usuario Admin.
2. Busque y seleccione Manage Permission Roles y seleccione Create New.
3. Introduzca un nombre de rol relevante y seleccione Permission….
4. Desplácese hasta Manage Integration Tools, haga clic en Select All y seleccione Done.
5. Seleccione Guardar cambios.

Crear un grupo de permisos

Para crear un grupo de permisos, siga estos pasos:

1. En el centro de administración de SAP SuccessFactors, busque y seleccione Manage Permission Groups y, a continuación, Create New.
2. Introduzca un nombre de grupo relevante.
3. En Choose Group Members: People Pool, seleccione la categoría Username.
4. Escriba el nombre de usuario del usuario dedicado, marque la casilla de verificación situada junto al nombre y seleccione Done.
5. Vuelva a seleccionar Done.

Asignar el nuevo grupo de permisos al rol de permisos

Para asignar el nuevo grupo de permisos al rol de permisos, siga estos pasos:

1. En el centro de administración de SAP SuccessFactors, busque y seleccione Manage Permission Roles y, a continuación, el rol de permisos creado anteriormente.
2. Desplácese hacia abajo hasta Grant this role to… y seleccione Add…
3. En Grant this role to: Permission Group…, haga clic en Select….
4. Busque el grupo creado anteriormente, marque la casilla de verificación situada junto al nombre y seleccione Done.

5. Seleccione Done de nuevo y, a continuación, Save Changes.

   Ahora habrá asignado el grupo de permisos de usuario al rol de permisos.

Registrar el cliente de OAuth2

Para registrar el cliente de OAuth2, siga estos pasos:

1. En el centro de administración de SAP SuccessFactors, busque y seleccione Manage OAuth2 Client Applications y, a continuación, Register Client Application.

2. Introduzca los siguientes detalles:

   Nombre de la aplicación

   URL de la aplicación

3. Seleccione Generate X.509 Certificate.
4. Introduzca un nombre común (CN) y seleccione Generate.
5. Seleccione Download para descargar una copia del certificado X.509. La clave privada del cliente se encuentra dentro del archivo de certificado como clave privada cifrada. Copie y guarde esta clave. Estos datos se utilizan al configurar la integración.

6. Seleccione Register.

   La nueva aplicación aparece en la página de administración de aplicaciones cliente de Oauth2.

7. En Acciones, seleccione Ver.
8. Copie la clave de API y guárdela para uso posterior.

Configurar la integración de SuccessFactors Learning

Siga este proceso si necesita configurar la integración básica de SuccessFactors con el módulo Learning o simplemente el módulo Learning. Con el usuario administrador, obtenga el ID de empresa y el ID de cliente, y genere un nuevo secreto del cliente.

Obtenga su ID de empresa y su ID de cliente

Para obtener el ID de empresa y el ID de cliente, siga estos pasos:

1. Inicie sesión en el entorno de administración SAP SuccessFactors Learning para su arrendatario.
2. Vaya a System Admin > Configuration > OAuth Token Server.
3. En la pantalla Application Administration, copie el ID de empresa y el ID de cliente y guárdelos para su uso posterior.

Generar un nuevo secreto de cliente

Para generar un nuevo secreto de cliente, siga estos pasos:

1. En la pantalla Application Administration, seleccione Generate a new Client Secret y confirme seleccionando OK.

   El secreto de cliente recién generado se rellena bajo el ID de cliente.

2. Copie el secreto del cliente y guárdelo para su uso posterior.

   El secreto no se almacena. Cuando sale de la página del servidor de tokens de OAuth, el secreto desaparece.

Agregar direcciones URL de respuesta

Agregue una URL personalizada a la configuración de la instancia para dar acceso a datos privados y habilitar acciones de usuarios autenticados por OAuth. La primera respuesta que aparece en la lista no cambia. La segunda respuesta depende de la aplicación de destino, y se puede encontrar en la barra de direcciones URL al crear la integración. La sección {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Inicie sesión en SuccessFactors como administrador y agregue las siguientes URL de redirección autorizadas para esta integración:

• https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.successfactors.SuccessFactorsService/auth/serverContext
• https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Agregar la integración de SuccessFactors EC

Siga estos pasos para configurar la integración de SuccessFactors EC. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Se recomienda usar esta integración HTTP más reciente para la mayoría de los casos de uso. La integración HTTP ofrece mayor capacidad para configurar la estructura de datos en caché.

Siga estos pasos:

1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
2. Seleccione el mosaico de SuccessFactors EC en Integraciones.
3. En el campo Nombre de la integración, introduzca un nombre para la misma.
4. Introduzca los parámetros del conector.
   • Introduzca la URL base de la instancia: https://{tenant}.successfactors.{region}/odata/v2
   • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.

5. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

   1. En el menú Flujo de tipo de concesión, seleccione SAML 2.0 SuccessFactors.
   2. Deje el Ámbito en blanco.
   3. Introduzca su Nombre de usuario.
   4. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Consulte la sección Obtenga su ID de empresa y su ID de cliente.
   5. Introduzca su ID de empresa. El ID de empresa es una cadena de caracteres breve que identifica cada sistema de SAP SuccessFactors, como un nombre de usuario de su organización. Consulte la sección Obtenga su ID de empresa y su ID de cliente.
   6. Introduzca su Clave privada. Esta es la clave de API del registro del cliente de OAuth2. Consulte Registrar el cliente de OAuth2.
   7. La URL de OAuth se genera automáticamente. Esta es la URL de aplicación generada en la plantilla y sigue este modelo: https://{tenant}.successfactors.{region}/oauth. Necesitará esto para Registrar el cliente de OAuth2.
6. Deje Autenticación de acciones de servicio inhabilitada.
7. La opción Habilitar la limitación del índice de solicitudes está habilitada. Deje 1 como Cantidad de solicitudes y 1 segundo como Intervalo de tiempo. 1.. El valor de Tiempo de espera de solicitud se establece en 120 de forma predeterminada.
8. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
9. Seleccione Guardar para continuar.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Usar microaplicaciones de SuccessFactors EC

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias. Nuestra integración de SuccessFactors EC incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:

Directorio: Sirve para buscar empleados y previsualizar sus detalles, incluido el conjunto de competencias.

Notificación o página	Flujos de trabajo por caso de uso
Página Usuario	Proporciona una lista de usuarios en la que se puede buscar.
Página Competencias de los usuarios	Proporciona una vista de los detalles de usuario y el conjunto de competencias.

Skills: Permite buscar competencias y obtener una vista previa de los empleados con sus competencias correspondientes.

Notificación o página	Flujos de trabajo por caso de uso
Notificación Evaluación de competencia cambiada	Cuando un jefe cambia la calificación de las competencias de un empleado, el empleado recibe una notificación.
Página Skills	Proporciona una lista de competencias en la que se puede buscar para conectar a los usuarios.
Página Competencias evaluadas por los usuarios	Proporciona una vista detallada de las competencias evaluadas. Las competencias evaluadas son competencias que los empleados y sus jefes califican en el portlet Perfil de competencias.
Página Competencias autodeclaradas por los usuarios	Proporciona una vista detallada de las competencias autodeclaradas. Las competencias autodeclaradas se agregan manualmente en el portlet Perfil de competencias.
Página Usuarios	Proporciona una vista del conjunto de competencias de un usuario.

Agregar la integración de SuccessFactors a las microaplicaciones de Citrix Workspace

Agregue la integración de SuccessFactors a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Utilice el siguiente proceso para habilitar la integración de SuccessFactors. Compruebe que cumple los requisitos previos y decida qué integración necesita configurar:

• la integración básica de SuccessFactors HCM,
• la integración básica con el módulo Learning,
• solo el módulo Learning.

Siga estos pasos:

1. En la página de descripción general, seleccione Introducción.

   Se abrirá la página Administrar integraciones.

2. Seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
3. Seleccione el mosaico de SuccessFactors.

4. Introduzca un nombre para la integración.

   

5. Introduzca los parámetros del conector que recopiló como requisitos previos.
   • Seleccione Yes/No en Are you using the Employee central module?
     • Introduzca la URL de API. Por ejemplo, https://api12preview.sapsf.eu/odata/v2v.
     • Introduzca el ID de empresa.
     • Introduzca el ID de usuario.
     • Introduzca el ID de cliente.
     • Introduzca la clave privada del cliente.
   • Seleccione Yes/No en Are you using the Learning module?
     • Introduzca la URL de Learning.
     • Introduzca el ID de empresa de Learning.
     • Introduzca el ID de usuario de Learning.
     • Introduzca el ID de cliente de Learning.
     • Introduzca el secreto de cliente de Learning.
6. Seleccione Agregar.

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización. Para obtener más información, consulte Verificar las entidades necesarias. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de SuccessFactors.

Usar microaplicaciones de SuccessFactors

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Nuestra integración de SuccessFactors incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:

Directorio: Permite buscar, consultar y modificar empleados con los detalles correspondientes.

Notificación o página	Flujos de trabajo por caso de uso
Notificación Nuevo compañero de equipo	Cuando se une un nuevo compañero de equipo, todos los suscriptores reciben una notificación, en la que se destacan el nuevo compañero de equipo y su puesto.
Notificación Puesto cambiado	Cuando cambia el título de un empleado, todos los suscriptores reciben una notificación, en la que se destacan el compañero de equipo y su nuevo puesto.
Página Mis detalles	Proporciona un formulario para ver detalles personales, así como un enlace a los subdetalles del jefe.
Página Mi equipo	Proporciona una vista de tabla de los compañeros de equipo de un empleado y enlaces a los detalles de usuario.
Página Detalles del usuario	Proporciona un formulario para ver los detalles de un usuario y proporciona un enlace a los subdetalles de su jefe y de cualquier subordinado directo.
Página Subdetalles de usuario	Proporciona un formulario para ver los subdetalles de un usuario, así como un enlace a sus detalles.
Página Usuarios	Proporciona una vista de tabla de usuarios, con funcionalidad de búsqueda y un enlace a los detalles de usuario.

Aprendizaje: Permite buscar, consultar, compartir y registrar los cursos de aprendizaje disponibles.

Notificación o página	Flujos de trabajo por caso de uso
Notificación Curso popular	Cuando un curso de aprendizaje se define como popular, todos los suscriptores reciben una notificación.
Página Cursos	Proporciona una lista de cursos disponibles con un enlace a los detalles del artículo de aprendizaje.
Página Detalles del artículo de aprendizaje	Proporciona una vista de tabla de artículos de aprendizaje con un enlace a los detalles de la oferta programada y una opción para compartirlos por correo electrónico.
Página Detalles de la oferta programada	Proporciona una vista detallada de una oferta programada con una lista de instructores y una opción para registrarse en la oferta.