Incorporar SAP SuccessFactors como origen de contenido

En este artículo se muestra cómo configurar SAP SuccessFactors como un sistema de administración de aprendizaje de terceros para Microsoft Viva Learning. Esto implica la incorporación en la pestaña Administración en Viva Learning y, a continuación, en el Portal de SuccessFactors.

Nota:

En este artículo se describe la experiencia actualizada para los clientes que integran Viva Learning con SuccessFactors por primera vez. Si es un cliente que ya ha agregado SuccessFactors como origen de contenido, consulte nuestra documentación anterior.

El contenido accesible a través de Viva Learning está sujeto a términos distintos de los Términos del producto de Microsoft. El contenido de SAP SuccessFactors y los servicios asociados están sujetos a los términos de privacidad y servicio de SAP SuccessFactors.

Requisitos previos

Hay dos fases de integración principales para las que los administradores requieren permisos específicos.

1. interfaz de Viva Learning Administración:
   Obtener acceso a Viva Learning Administración acceso

   Los administradores pueden administrar su contenido Viva Learning desde la pestaña Administración de Viva Learning aplicación en Teams o mediante el explorador. Consulte Administrar contenido en la pestaña administrador para obtener más información.

2. SAP SuccessFactors Learning:

   Los usuarios necesitan acceso de administración de aprendizaje en el portal de SAP SuccessFactors. Los administradores de aprendizaje usan el módulo Administración del aprendizaje para administrar el sistema de administración de aprendizaje (LMS), incluidos los perfiles de aprendizaje, el contenido de aprendizaje y la administración de las necesidades de aprendizaje.

Incorporación

1. Abra la aplicación Viva Learning en Teams o en la web.

2. Vaya a la pestaña Administración de Viva Learning y seleccione Administrar proveedores.

3. Seleccione Agregar proveedor.

   

4. Seleccione SAP SuccessFactors en la lista Proveedor y seleccione Siguiente.

   

Configuración de la API SuccessFactors

Este paso es necesario para establecer la conexión base entre Viva Learning y el sistema SuccessFactors. Permite Viva Learning desencadenar el paquete de sincronización completo y la generación de paquetes delta de SuccessFactors para las sincronizaciones iniciales y las posteriores. El usuario debe proporcionar los detalles de configuración de la API SuccessFactors:

Nota:

Viva Learning solo tiene acceso a la API de configuración de extracción del asociado y a la API de generación de paquetes adhoc. Esta integración sin problemas con SuccessFactors está controlada por las API de SuccessFactors y requiere que los detalles del administrador de SuccessFactors tengan los siguientes permisos.

• Editar configuración del sistema
• Ver configuración del sistema

• Dirección URL de destino de aprendizaje de cliente: puede obtenerlo desde la dirección URL del módulo de dominio de aprendizaje. Por ejemplo, si la dirección URL del dominio de aprendizaje es organization.scdemo.successfactors.com/learning/... a continuación, se organization.scdemo.successfactors.com la dirección URL de destino de aprendizaje.

• Id. de cliente

• Id. de usuario de administrador del cliente

• Administración secreto de cliente

Consulte la sección Propiedades necesarias de SAP SuccessFactors para obtener más detalles sobre cómo obtener el identificador de cliente, el identificador de usuario de administrador del cliente & Administración las propiedades del secreto de cliente de SAP SuccessFactors.

Creación de claves PGP

SuccessFactors envía los datos a Viva Learning en paquetes de archivos. Los archivos se cifran mediante claves PGP para que solo puedan ser leídos por Viva Learning. Este paso genera el par de claves PGP único que usará SuccessFactors para cifrar el paquete de datos para Viva Learning.

Administración debe especificar los detalles siguientes para generar claves PGP:

• Nombre (nombre del propietario de la clave): lo ideal es que sea el nombre de la persona que escribe los detalles de esta página. SuccessFactors necesita estos datos.

• Email id . (id. de correo electrónico del propietario de la clave): idealmente es el identificador de correo electrónico de la persona que escribe los detalles de esta página. SuccessFactors necesita estos datos.

• Frase de contraseña (contraseña): escriba una contraseña con una longitud mínima de cinco caracteres. Esto se usa para cifrar y descifrar el paquete de datos junto con las claves PGP. Cambiar esto en el futuro conduce a cambiar las claves PGP. La frase de contraseña se puede cambiar en el futuro a través de la ruta de acceso EDITAR (consulte a continuación).

Nota:

Una vez creadas las claves PGP en el paso 2, los atributos se actualizan en la configuración de extracción de asociados de SuccessFactors. El estado del asociado se establece en deshabilitado hasta que el siguiente paso se complete correctamente.

• Id. de asociado : valor predeterminado como MVL

• Clave pública de PGP: generada anteriormente

• Propietario de la clave: nombre e identificador de correo electrónico compartidos anteriormente

Configuración de SuccessFactors

En este paso, los administradores deben especificar más configuraciones necesarias para establecer la conexión y el acceso al paquete de datos.

Configuración del dominio y el nombre para mostrar

• Nombre para mostrar: esta configuración permite que el Administración personalice el nombre para mostrar del carrusel de SAP SuccessFactors que aparece en Viva Learning. El valor predeterminado es "SAP SuccessFactors"

• Dirección URL del host del cliente: esta es la dirección URL del dominio BizX. Puede obtenerlo desde la dirección URL de inicio de sesión de BizX.
  Por ejemplo, si la dirección URL de inicio de sesión de BizX es organization.successfactors.com /sf/start/#/login, la dirección URL del host se organization.successfactors.com

• Dirección URL de destino de aprendizaje del cliente: Se rellena previamente con el valor que ha proporcionado en el PASO 1 anterior.

• Id. de empresa: este es el identificador de la empresa según SuccessFactors. Inicie sesión en el portal de SuccessFactors. Seleccione el icono de perfil y, a continuación, seleccione Mostrar configuración de versión. Puede ver el identificador de la empresa aquí.

Configuraciones de SFTP

• DIRECCIÓN URL del host SFTP: esta contraseña es necesaria para acceder al servidor SFTP. Vaya al portal de SAP SuccessFactors y seleccione LMS Administración Application>System Administration>System Configuration System ConfigurationCONNECTORS (CONECTORES deconfiguración del sistema de configuración del sistema de administración>> de aplicaciones). Obtenga el valor de la connector.ftp.server propiedad .

• Nombre de usuario: este es el nombre de usuario necesario para acceder al servidor SFTP. Este valor está rellenado previamente y no es necesario editarlo. Este campo se captura de SuccessFactors de la propiedad CONNECTORS connector.ftp.userID de lms Administración > configuración > del sistema de configuración >> del > sistema de aplicación.

• Contraseña: esta es la contraseña necesaria para acceder al servidor SFTP. Consulte con el propietario de la aplicación LMS para obtener ayuda con la recuperación de la contraseña. Escriba esa contraseña aquí.

• Ruta de acceso de la carpeta raíz: esta es la carpeta raíz del servidor SFTP donde SuccessFactors guarda el paquete de extracción de datos creado para esta integración. Este valor se rellena previamente.

  Este campo se captura de SuccessFactors de Laconfiguración> del sistema deadministración> delsistema de administración>> del aprendizajePARTNER_EXTRACT>propiedad defaultFtp.path.

  Compruebe si la carpeta raíz EXISTE en el servidor SFTF. La configuración puede producir un error si la carpeta no existe

• Ruta de acceso de la subcarpeta: esta es la subcarpeta de la carpeta raíz donde SuccessFactors guarda el paquete de extracción de datos creado para esta integración. El valor predeterminado es "MVL". Puede cambiar o quitar este valor. Si se quita todo este valor, el paquete de extracción de datos se guarda en la carpeta raíz configurada anteriormente.

  Compruebe si la carpeta raíz EXISTE en el servidor SFTF. La configuración puede producir un error si la carpeta no existe

Nota:

Solo se admite un nivel de ruta de acceso de carpeta para la ruta de acceso de la subcarpeta. La carpeta no debe superar los 256 caracteres

Configuración de API

Esta sección contiene los valores especificados en el primer paso descrito anteriormente. Todos los valores se rellenan previamente y no es necesario volver a escribir ni editar.

• Id. de cliente: se rellena previamente con el valor que ha proporcionado en el paso 1 anterior.

• Id. de usuario administrador del cliente: se rellena previamente con el valor que ha proporcionado en el paso 1 anterior.

• Administración secreto de cliente: se rellena previamente con el valor que ha proporcionado anteriormente.

Configuración de PGP

• Clave privada PGP: se rellena previamente con la clave privada PGP creada anteriormente

• Frase de contraseña de clave privada PGP:

Configuración completa

Después de completar los pasos anteriores, seleccione Guardar para completar la configuración de SuccessFactors en Microsoft Viva Learning para la sincronización de contenido.

Una vez guardada la configuración, el proveedor SuccessFactors aparece en la pantalla del panel Administrar proveedores del inquilino. SuccessFactors genera el paquete de extracción de datos completo en el servidor SFTP. Viva Learning procesa el paquete después de generar el paquete de extracción de datos completo. La sincronización se produce dos veces al día. Los registros de estado y error de sincronización se pueden revisar en el panel.

Nota:

Si sale de guardar la configuración de SuccessFactors del paso 2 o del paso 3, Viva Learning guarda los valores de configuración especificados hasta ese paso. Puede reanudar las configuraciones desde donde lo dejó. Por ejemplo, si pulsa cancelar en Paso 2: Crear claves PGP, Viva Learning conserva las configuraciones especificadas en el paso 1.

Si necesita eliminar la configuración de borrador, puede eliminar el proveedor SuccessFactors.

Clientes que ya han completado la integración de SuccessFactors

Si ha configurado la integración de SuccessFactors antes de esta actualización, se recomienda encarecidamente pasar a la nueva integración. Esto permite la integración sin problemas con SuccessFactors mediante la actualización automática de la configuración de extracción del asociado de SuccessFactors con el identificador de cliente, las claves PGP, el propietario de la clave y otras propiedades necesarias. Esto ayuda a la generación automática de paquetes de extracción de datos completos e integración sin problemas controlada por las API de SuccessFactors.

1. Vaya a la pestaña Administración de Viva Learning y seleccione Administrar proveedores. En el proveedor SuccessFactors configurado, verá "Configuración pendiente, a la espera de los detalles necesarios".

   El mensaje permanece hasta que se migra al nuevo proceso de integración. Si deja el proceso a mitad de camino, no se conservará la configuración.

2. Seleccione Actualizar

   Al seleccionar la actualización, se abre una pantalla única para proporcionar configuraciones de API de SuccessFactors que proporcionan una integración perfecta con SuccessFactors. Esta integración está controlada por las API de SuccessFactors, lo que requiere que los detalles del administrador de SuccessFactors tengan los permisos siguientes: Editar configuración del sistema y Ver configuración del sistema

   Viva Learning solo accede a la API de configuración de extracción del asociado y a la API de generación de paquetes ad hoc.

3. Proporcione los siguientes detalles de configuración de la API SuccessFactors:

   a. Id. de cliente

   b. Usuario administrador del cliente

   c. Administración secreto de cliente

   Consulte la sección "Propiedades requeridas de SAP SuccessFactors" para obtener más detalles para obtener las propiedades necesarias de SAP SuccessFactors.

4. Seleccione Siguiente y guarde las configuraciones de API.

Nota:

• También puede proporcionar detalles de configuración de API seleccionando Editar para el proveedor SuccessFactors.
• Al renovar las claves PGP y actualizar el valor de ruta de acceso de la subcarpeta, SuccessFactors genera un paquete de extracción de datos completo.

Propiedades necesarias de SAP SuccessFactors

Siga los pasos documentados en la tabla para obtener los valores de las tres propiedades necesarias de SAP SuccessFactors:

Propiedades	Descripción
Id. de usuario de Administración cliente	Este usuario administrador necesita un rol asignado a los permisos Biblioteca de búsqueda y Ver biblioteca para ejecutar la API del servicio de catálogo. No es necesario proporcionar ningún otro permiso para este usuario administrador en SuccessFactors.
Administración secreto de cliente	El secreto de cliente de administración es el secreto de cliente generado para el usuario administrador correspondiente. Vaya a Administrador de seguridad > de administración > del sistema y busque el administrador.
Id. de cliente	El identificador de cliente es necesario para ejecutar la API. Vaya a System Administration Configuration OAuth Token Server (Servidor de token de OAuth de configuración >> del sistema).

Permisos necesarios para el rol de administrador en SAP SuccessFactors

Siga estos pasos para asignar los permisos necesarios a un rol y asignar ese rol a un administrador en SAP SuccessFactors:

1. Cree un rol en compuesto por los permisos De la biblioteca de búsqueda y Ver biblioteca .

   1. Para crear un nuevo rol, vaya aAdministración de roles deseguridad> de administración> del > sistemaCreate a new role> enable Edit System Configuration and View System Configuration permissions for the role (Editar configuración del sistema y ver la configuración del sistema). O bien, use un rol existente que tenga los dos permisos ya asignados.

2. Asigne el nuevo rol a un usuario administrador.

   1. Para asignar un rol al usuario administrador, vaya aAdministrador> deseguridad> de administración> del sistema busque el resumen de edición de administrador> de un rolasignado por> el administrador > Agregue el rol creado.

Preguntas frecuentes

• ¿Cuánto tiempo tarda SAP SuccessFactors en generar el paquete completo para la sincronización una vez que se actualiza la configuración del asociado de SuccessFactors Portal?

  Una vez finalizada la configuración en el portal de SuccessFactors, SuccessFactors generará el paquete de sincronización inicial. Esto puede tardar hasta siete días laborables. Una vez que el paquete está disponible en la ruta de acceso de la carpeta SFTP, Viva Learning puede empezar a comunicarse con SuccessFactors. Si no encuentra el paquete, póngase en contacto con el soporte técnico de SAP SuccessFactors.

• ¿Por qué no puedo ver el paquete de sincronización completa ahora en SFTP 3 semanas después de haber completado la configuración del Portal de SuccessFactors?

  SAP SuccessFactors elimina el paquete de sincronización completa de la ubicación de SFTP automáticamente después de 14 días a partir de la fecha de generación. El paquete de sincronización completa tarda casi siete días en generarse a partir del día en que se envía la configuración en el Portal de SuccessFactors.

• ¿Por qué puedo ver el curso en Viva Learning aplicación al obtener un error de suscripción al reproducir el contenido?

  Los usuarios pueden detectar todos los cursos de nivel de inquilino en Viva Learning que tienen permiso para ver. Reciben un error de suscripción al reproducir cursos de terceros para los que no tienen una suscripción válida.

• ¿Cómo se puede editar Viva Learning configuración del proveedor SuccessFactors?

  Vaya a Administrar proveedores>SuccessFactors Provider.

• ¿Con qué frecuencia Viva Learning comprueba la disponibilidad de SuccessFactors?

  Viva Learning comprueba la disponibilidad del paquete SuccessFactors cada hora, a partir de cuando SuccessFactors se configura inicialmente en Viva Learning. La próxima ranura programada está disponible como estado en Administrar proveedores>SuccessFactors.

  SuccessFactors genera el paquete principal y el paquete de claves en diferentes momentos.

  Viva Learning inicia el procesamiento de estos paquetes una vez que SuccessFactors genera ambos archivos. Hemos observado un intervalo máximo de tres horas entre la generación de ambos paquetes.

  Si ambos paquetes se generan juntos, Viva Learning desencadena el procesamiento en un plazo de una hora. De lo contrario, Viva Learning desencadena el procesamiento dentro de una hora de la disponibilidad de ambos paquetes.

• ¿Por qué veo el error de configuración? ¿Se ha resuelto el error en la página Administrar proveedores del proveedor SuccessFactors?

  Verá este mensaje porque los valores de configuración de la API SuccessFactors ("Id. de cliente", "Id. de usuario administrador del cliente" y "Administración secreto de cliente") que proporcionó anteriormente ya no son válidos. Seleccione Resolver para proporcionar los valores correctos.

• ¿Cuál es el tamaño máximo de un paquete SuccessFactors que Viva Learning admite?

  Viva Learning admite la incorporación de paquetes SuccessFactors hasta un tamaño de 10 GB (archivo comprimido).

• Póngase en contacto con el soporte técnico de SAP SuccessFactors

  • Creación de un incidente de soporte técnico con soporte técnico de SAP SuccessFactors
  • Creación de incidentes
  • Escalación de incidentes

Mensajes de error

En la tabla siguiente se enumeran los códigos de error y los mensajes, cuando se muestran, y los pasos siguientes que puede seguir para resolverlos.

Código de error	Descripción	Pasos siguientes
USR_ERROR_SF_INITIAL_PACKAGE_NOT_FOUND	No se ha ingerido contenido nuevo, ya que el paquete necesario no se encontró en el servidor SFTP de SuccessFactors.	Asegúrese de que el paquete SuccessFactors está disponible. Puede tardar hasta siete días laborables en generar este paquete la primera vez que se sincronice. Si no encuentra el paquete, póngase en contacto con el equipo de soporte técnico de SuccessFactors.
USR_ERROR_SF_DELTA_PACKAGE_NOT_FOUND	No se ingerió ningún contenido nuevo, ya que no se encontró el paquete necesario en el servidor SFTP de SuccessFactors.	Asegúrese de que el paquete SF está disponible en la ruta de acceso de la carpeta configurada en el portal de SF. Si no encuentra el paquete, póngase en contacto con el equipo de soporte técnico de SuccessFactors.
USR_ERROR_SF_COMPRESSED_PACKAGE_SIZE_EXCEEDED	No se ingerió ningún contenido nuevo porque el tamaño del paquete comprimido superó los 2 GB.	Póngase en contacto con el servicio de soporte al cliente de Microsoft para obtener más información.
USR_ERROR_SF_UNCOMPRESSED_PACKAGE_SIZE_EXCEEDED	No se ingerió ningún contenido nuevo porque el tamaño del paquete sin comprimir superó los 25 GB.	Póngase en contacto con el servicio de soporte al cliente de Microsoft para obtener más información.
Error en la validación del par de claves de PGP	Posibles motivos de este error: valores incorrectos especificados para los campos: clave pública SF, clave privada SF, frase de paso de clave privada sf.	Vaya al proveedor SuccessFactors y seleccione Editar en ... y Renovar claves. Copie la configuración del asociado y péguela en el Portal de SuccessFactors. Guarde la configuración. Creación de una incidencia con el equipo de soporte técnico de SuccessFactors para generar un nuevo paquete
USR_ERROR_ACCESS_DENIED, PARTNER_ERROR_UPDATE_PARTNER_EXTRACT_CONFIGURATION_FAILED, PARTNER_ERROR_FETCH_PARTNER_EXTRACT_CONFIGURATION_FAILED, PARTNER_ERROR_UNKNOWN_ERROR, PARTNER_ERROR_GATEWAY_TIMEOUT, PARTNER_ERROR_WEB_SERVER_IS_DOWN, PARTNER_ERROR_UPDATE_PARTNER_EXTRACT_CONFIGURATION_FAILED, PARTNER_ERROR_FETCH_PARTNER_EXTRACT_CONFIGURATION_FAILED	No se pudieron guardar los cambios. Asegúrese de que los valores de las propiedades siguientes son correctos e inténtelo de nuevo. O bien, no se pudieron guardar los cambios. Asegúrese de que los valores del id. de usuario de Administración cliente, Administración secreto de cliente & id. de cliente son válidos e inténtelo de nuevo. O bien, no se pudieron guardar los cambios. Asegúrese de que los valores de la dirección URL de destino de Client's Learning, el id. de usuario Administración del cliente, Administración secreto de cliente & id. de cliente son válidos en el paso anterior e inténtelo de nuevo.	Asegúrese de proporcionar valores válidos para las configuraciones de API de SuccessFactors.
PARTNER_ERROR_INTERNAL_SERVER_ERROR, PARTNER_ERROR_SERVICE_UNAVAILABLE	Los cambios no se pudieron guardar debido a un error con la API SuccessFactors. Inténtelo de nuevo más tarde.	Póngase en contacto con el servicio de soporte al cliente de Microsoft para obtener más información.
SYS_ERROR_CLIENT_REQUESTS_LIMIT_EXCEEDED	Se ha alcanzado el límite de limitación de api de SuccessFactors. Inténtelo de nuevo más tarde.	Póngase en contacto con el servicio de soporte al cliente de Microsoft para obtener más información.
PARTNER_ERROR_PARTNER_EXTRACT_CONFIGURATION_PARTNER_LIMIT_EXCEEDED	No se pudieron guardar los cambios. Ya tiene tres asociados configurados en la configuración de extracción de asociados de SuccessFactors. Asegúrese de que tiene al menos una ranura de asociado disponible e inténtelo de nuevo.	Vaya a SuccessFactors Partner extract configurations (Learning Administration System Administration > System Configuration > System Configuration System Configuration PARTNER_EXTRACT) (Configuración > del sistema de administración del sistema de administración > de aprendizaje PARTNER_EXTRACT) y asegúrese de que tiene al menos un espacio de asociado disponible para Viva Learning integración e inténtelo de nuevo.
USR_ERROR_SF_LEARNING_DESTINATION_TENANT_URL_INVALID	No se pudieron guardar los cambios. Asegúrese de que los valores de la dirección URL de destino de Aprendizaje del cliente son válidos e inténtelo de nuevo.	Asegúrese de proporcionar un valor válido para la dirección URL de destino de Aprendizaje del cliente.
ND	No se pudieron guardar los cambios. Inténtelo de nuevo después de más tarde.	Póngase en contacto con el servicio de soporte al cliente de Microsoft para obtener más información.
VLS-SF-CONFIG-ERROR-00001	Error en la generación de claves PGP. Inténtelo de nuevo.	Póngase en contacto con el servicio de soporte al cliente de Microsoft para obtener más información.
USR_ERROR_PARTNER_EXTRACT_CONFIGURATION_API_SECRETS_TEST_CONNECTION_FAILED	No se pudieron guardar los cambios. Asegúrese de que los valores del identificador de usuario Administración del cliente, el secreto de cliente Administración y el identificador de cliente sean válidos e inténtelo de nuevo.	Asegúrese de proporcionar valores válidos para las configuraciones de API de SuccessFactors.