Compartir vía

Use el asistente del conector Turnos para conectar Turnos a Blue Yonder Workforce Management

  • Artículo
  • Se aplica a:
    Microsoft Teams, Microsoft 365 for frontline workers

Información general

Use el conector Turnos de Microsoft Teams para Blue Yonder para integrar la aplicación Turnos en Microsoft Teams con Workforce Management de Blue Yonder (Blue Yonder WFM). Los trabajadores de primera línea pueden ver y administrar sin problemas sus programaciones en Blue Yonder WFM desde Shifts.

En este artículo, le guiaremos a través de cómo ejecutar el asistente del conector Shifts en el Centro de administración de Microsoft 365 para conectar Shifts a Blue Yonder WFM.

Nota:

Si lo prefiere, puede usar PowerShell para integrar Shifts con Blue Yonder WFM. Para obtener más información, consulte Usar PowerShell para administrar la conexión de Turnos a Workforce Management de Blue Yonder.

El asistente crea una conexión con el sistema WFM de Blue Yonder y una instancia de conexión. Una instancia de conexión aplica la configuración de sincronización y las asignaciones de equipo que elija.

  • La configuración de sincronización determina la información de programación y qué entidades se sincronizan entre WFM de Blue Yonder y Shifts.
  • Las asignaciones de equipos definen la relación de sincronización entre las instancias de WFM de Blue Yonder y los equipos de Teams.

Puede crear una o varias instancias de conexión, cada una con una configuración de sincronización diferente. Por ejemplo, si su organización tiene varias ubicaciones con requisitos de programación diferentes, cree una instancia de conexión con una configuración de sincronización única para cada ubicación. Una instancia de WFM de Blue Yonder solo debe asignarse una vez a un equipo de Teams en un momento dado. Sin embargo, en el asistente es posible tener diferentes instancias de conexión con las mismas asignaciones. Esto significa que puede crear instancias de conexión con asignaciones duplicadas.

Con Blue Yonder WFM como sistema de registro, los trabajadores de primera línea pueden administrar de forma eficaz sus programaciones y disponibilidad en turnos en sus dispositivos. Los jefes de primera línea pueden seguir usando Blue Yonder WFM para configurar programaciones.

Términos usados en este artículo

Término Definición
Connection Una conexión permite el acceso a todas las instancias de WFM creadas en el sistema WFM de Blue Yonder. Para crear una conexión, proporcione los detalles de WFM de Blue Yonder, que incluyen el nombre de la cuenta de servicio, la contraseña y las direcciones URL de servicio.
Instancia de conexión Para crear una instancia de conexión, configure los siguientes valores:
  • Configuración de sincronización que determina cómo y qué programa las sincronizaciones de información entre WFM de Blue Yonder y Shifts
  • Asignaciones de equipos para definir la relación entre las instancias de WFM y los equipos de Teams.
Instancia de WFM Este término hace referencia a un sitio en el sistema WFM de Blue Yonder.

Requisitos previos

Antes de empezar, asegúrese de cumplir todos los requisitos previos siguientes.

  • Es administrador global de Microsoft 365.

  • Tiene Blue Yonder WFM versión 2020.3, 2021.1 o 2021.2.

    Nota:

    Si tiene Blue Yonder WFM 2020.3 o 2021.1, aplique la revisión 2020.3.0.4 o 2021.1.0.3. Esta revisión corrige un problema por el que los usuarios reciben un mensaje de error persistente en Turnos. También corrige un problema que impide que los usuarios actualicen su disponibilidad en Turnos.

  • Conoce el nombre de la cuenta de servicio, la contraseña y las direcciones URL de servicio de Blue Yonder WFM:

    • URL de autenticación federada
    • URL de autenticación de cookie
    • URL de autoservicio para empleados
    • URL de la API del comercio minorista
    • URL de la API del administrador del sitio
    • URL de la API de administración

    Si no tiene toda esta información, póngase en contacto con el soporte técnico de Blue Yonder. Un administrador de empresa de Blue Yonder crea una cuenta de Blue Yonder en el nivel de empresa raíz. Debe tener acceso de API, administrador de cliente, administrador de tienda y acceso de trabajo. La cuenta y la contraseña son necesarias para crear una conexión.

  • La autenticación de SSO federado está habilitada en el entorno de WFM de Blue Yonder. Póngase en contacto con el soporte técnico de Blue Yonder para asegurarse de que el SSO federado está habilitado. Necesitarán la información siguiente:

    • federatedSSOValidationService: https://wfmconnector.teams.microsoft.com/api/v1/fedauth/{tenantId}/6A51B888-FF44-4FEA-82E1-839401E9CD74/authorize donde {tenantId} es su tenantId
    • proxyHeader: X-MS-AuthToken

  • Tiene al menos un equipo configurado en Teams.

  • Ha agregado una cuenta general, lo que llamamos la cuenta del sistema de Microsoft 365, como propietario del equipo a todos los equipos que desea asignar.

    Cree esta cuenta en el Centro de administración de Microsoft 365 y asígnele una licencia de Microsoft 365. Después, agregue la cuenta como propietario de un equipo a todos los equipos que quiera asignar. El conector de Turnos usa esta cuenta al sincronizar los cambios de Turnos de WFM de Blue Yonder. Se recomienda crear una cuenta específicamente para este propósito y no usar su cuenta de usuario personal.

  • Asegúrese de que los equipos que desea asignar no tengan ninguna programación en Shifts o Blue Yonder WFM. Si un equipo tiene una programación existente, siga los pasos de la sección siguiente para quitar las entidades de programación del equipo antes de asignarle una instancia de WFM. De lo contrario, verá turnos duplicados.

Eliminación de entidades de programación de los equipos que desea asignar

Nota:

Complete este paso si va a asignar instancias de WFM a equipos existentes que tienen entidades de programación. Si va a asignar a equipos que no tienen ninguna programación o si va a crear nuevos equipos a los que asignar, puede omitir este paso.

Use PowerShell para quitar las entidades de programación de los equipos.

  1. En primer lugar, tendrá que instalar los módulos de PowerShell y configurarse. Siga estos pasos para configurar su entorno:

  2. Ejecute el comando siguiente:

    Remove-CsTeamsShiftsScheduleRecord -TeamId <Teams team ID> -DateRangeStartDate <start time> -DateRangeEndDate <end time> -ClearSchedulingGroup:$false -EntityType <the scenario entities that you want to remove, the format is @(scenario1, scenario2, ...)> -DesignatedActorId <Teams team owner ID>

    Para obtener una lista de escenarios para el EntityType parámetro, ejecute Get-CsTeamsShiftsConnectionConnector. Los datos de programación se quitarán para el intervalo de fecha y hora que especifique.

Para más información, vea Remove-CsTeamsShiftsScheduleRecord.

Ejecución del Asistente para conectores shifts

Crear una conexión

  1. En el panel de navegación izquierdo del Centro de administración de Microsoft 365, elija Configuración y, en Colecciones destacadas, seleccione Trabajadores de primera línea.

  2. Seleccione Consola de administración del conector. Captura de pantalla de la página de detalles del Asistente para conectores Shifts en el Centro de administración de Microsoft 365.

  3. Para crear una nueva conexión, elija Agregar conexión.

  4. En el panel Elegir el conector, elija Blue Yonder Workforce Management y, a continuación, seleccione Siguiente para crear una conexión WFM de Blue Yonder.

  5. En el panel Configuración de conexión, asigne un nombre único a la conexión. No puede tener más de 100 caracteres ni tener caracteres especiales.

  6. El nombre de la cuenta de servicio de Blue Yonder WFM y las direcciones URL de servicio y contraseña: Si no conoce uno o más detalles de la conexión, póngase en contacto con el soporte técnico de Blue Yonder. Captura de pantalla de la página Detalles de conexión del asistente, en la que se muestra la configuración de conexión.

  7. Cuando haya terminado, seleccione Guardar conexión.

Nota:

Si necesita crear otra conexión, vaya a la página Consola de administración del conector y, a continuación, seleccione Agregar conexión.

Creación de una instancia de conexión

Después de crear una conexión, puede configurar una o varias instancias de conexión en esa conexión.

Las conexiones que ha creado se enumeran en la página Consola de administración de conectores. En la conexión donde desea crear una nueva instancia, seleccione Crear instancia. Captura de pantalla de la consola de administración del conector, en la que se muestra el botón para crear una nueva instancia.

Elija la configuración

En la página Configuración de instancia, elija la información que se va a sincronizar de Blue Yonder WFM a Shifts, la frecuencia de sincronización y si los usuarios de Shifts pueden realizar cambios en los datos. Captura de pantalla de la página Configuración de sincronización del asistente, en la que se muestra la configuración de sincronización.

  1. Escriba un nombre para la instancia de conexión. No puede tener más de 100 caracteres ni tener caracteres especiales.

  2. Escriba su cuenta del sistema de Microsoft 365. Esta es la cuenta que creó como requisito previo que es el propietario de todos los equipos que desea asignar.

  1. En Destinatarios de notificaciones por correo electrónico, elija quién recibe notificaciones por correo electrónico sobre esta instancia de conexión. Puede agregar tanto usuarios individuales como grupos de seguridad a estos grupos. Las notificaciones por correo electrónico contienen información sobre el estado de la instalación y cualquier problema o error que pueda producirse después de configurar la instancia de conexión.

  2. Elija la configuración de sincronización.
    Para cada una de estas opciones, tiene las siguientes opciones entre las que elegir:

    • Los usuarios de desplazamientos no verán los datos del proveedor: los datos no se sincronizarán entre WFM de Blue Yonder y Shifts.
    • Los usuarios de turnos pueden ver los datos del proveedor: la sincronización de datos es unidireccional de WfM de Yonder azul a turnos.
    • Desplazamientos que los usuarios pueden ver y cambiar los datos del proveedor: la sincronización de datos es bidireccional entre WFM de Blue Yonder y Shifts.

    Importante

    Antes de deshabilitar una característica seleccionando la opción Desplazamientos los usuarios no verán los datos del proveedor , tenga en cuenta que:

    • Si la configuración Programaciones, grupos, turnos y actividades está deshabilitada, todas las demás opciones, como Tiempo de espera y Disponibilidad del empleado, etc., también se deshabilitan.
    • Si la opción Abrir turno está deshabilitada, la solicitud abrir turnos también está deshabilitada.
    • Si la opción Tiempo de espera está deshabilitada, también se deshabilita la solicitud de tiempo de espera .

  3. Elija la frecuencia de sincronización.

  4. Cuando haya terminado de elegir la configuración, seleccione Siguiente.

    Importante

    Si eligió cualquiera de las siguientes opciones para deshabilitar los turnos abiertos, las solicitudes de turnos abiertos, las solicitudes de intercambio o las solicitudes de tiempo de expiración, hay otro paso que debe realizar para ocultar la funcionalidad en Turnos.

    • Abrir turnos: desplazamientos los usuarios no verán los datos del proveedor
    • Solicitudes de intercambio: desplazamientos los usuarios no verán los datos del proveedor
    • Solicitudes de tiempo de expiración: los usuarios de desplazamientos no verán los datos del proveedor

    Después de ejecutar el asistente, asegúrese de seguir los pasos de la sección Deshabilitar turnos abiertos, solicitudes de turnos abiertos, solicitudes de intercambio y solicitudes de tiempo de expiración más adelante en este artículo.

Asignación de instancias de WFM a equipos

Elija las instancias de WFM que desea conectar a Turnos y, a continuación, asigne cada instancia a un equipo de Teams. Puede asignar hasta 400 instancias.

Para completar este paso, puede:

Asignación manual de instancias de WFM a equipos

Captura de pantalla del asistente, en la que se muestra la lista de instancias de WFM de Blue Yonder.

  1. En la página Asignación, empiece por elegir las instancias de WFM que desea asignar a los equipos de Teams.

  2. Active la casilla para cada instancia de WFM que quiera asignar. Una instancia solo se asigna si la casilla está seleccionada.

  3. A continuación, busque y elija el equipo correcto en Teams. Tenga en cuenta que los equipos que ya están asignados a una instancia de WFM en esta instancia de conexión no están disponibles para volver a asignarse.

  4. Elija la zona horaria. La ciudad más cercana se rellena automáticamente, pero puede cambiarla.

  5. Cuando haya terminado de asignar todos los equipos, seleccione Siguiente.

Uso de un archivo CSV para asignar instancias de WFM a equipos

  1. En la página Asignación, elija Herramienta de carga CSV.

  2. Seleccione Descargar plantilla para obtener el archivo de asignación CSV. La plantilla incluye una lista de todas las instancias de WFM y sus identificadores. Las filas superiores de la plantilla tendrán un aspecto similar al siguiente:

    Identificador de instancia de WFM de Yonder azul Nombre de instancia de WFM de Yonder azul Id. de equipo Nombre del equipo Zona horaria
    Rellenado automáticamente Rellenado automáticamente En blanco En blanco Predeterminado*

    Y las filas inferiores de la plantilla tendrán este aspecto:

    Identificador de instancia de WFM de Yonder azul Nombre de instancia de WFM de Yonder azul Id. de equipo Nombre del equipo Zona horaria
    En blanco En blanco Rellenado automáticamente Rellenado automáticamente Predeterminado*

  3. Elija un equipo que quiera asignar a una instancia de WFM. Corte y pegue el identificador de equipo y el nombre del equipo de la mitad inferior de la plantilla para que estén en línea con la instancia de WFM que desee. Una fila completa de la plantilla debe tener este aspecto:

    Identificador de instancia de WFM de Yonder azul Nombre de instancia de WFM de Yonder azul Id. inferior del equipo Nombre del equipo Zona horaria
    Rellenado automáticamente Rellenado automáticamente Id. de equipo que ha movido Nombre del equipo que ha movido Predeterminado*

    Repita este paso para todas las asignaciones.

  4. Escriba la ubicación correcta en la columna Zona horaria si es necesario.

    Nota:

    El asistente admite aproximadamente 460 ubicaciones. La zona horaria debe estar en formato tz. Si no se admite la ubicación específica que eligió, verá un error en el asistente. Pruebe a usar la ciudad más cercana o la ciudad principal dentro de la misma zona horaria.

  5. En la página Asignación, seleccione Examinar para buscar y cargar el archivo CSV completado.

  6. Elija Listo si el archivo se cargó correctamente. De lo contrario, revise el informe de errores y cargue un archivo corregido.

  7. Las nuevas asignaciones se muestran en la página Asignaciones.

  8. Elija Siguiente.

Revisar y finalizar

Antes de finalizar, revise el resumen del proceso de creación de la instancia de conexión. Si necesita realizar cambios durante el proceso de creación de la instancia de conexión, elija Atrás. Cuando esté listo, seleccione Finalizar.

Captura de pantalla de la página Revisar del asistente, en la que se muestran las asignaciones.

El asistente inicia el proceso para configurar la instancia de conexión, lo que puede tardar algún tiempo en completarse. Si intenta editar la instancia de conexión antes de completar la instalación, lo más probable es que no pueda ver las asignaciones que creó anteriormente.

Los destinatarios de notificaciones por correo electrónico que elija recibirán notificaciones por correo electrónico sobre el estado de la instalación en caso de que se produzcan errores.

Seleccione Listo para salir del asistente.

Deshabilitar turnos abiertos, solicitudes de turnos abiertos, solicitudes de intercambio y solicitudes de tiempo de expiración

Importante

Siga estos pasos solo si elige cualquiera de las siguientes opciones para deshabilitar los turnos abiertos, las solicitudes de turnos abiertos, las solicitudes de intercambio o las solicitudes de tiempo de expiración en el asistente. Al completar este paso, se oculta la funcionalidad en Turnos.

  • Turnos abiertos: los usuarios de desplazamientos no verán los datos de Blue Yonder WFM
  • Solicitudes de intercambio: la característica está deshabilitada para todos los usuarios
  • Solicitudes de tiempo de espera: la característica está deshabilitada para todos los usuarios

Sin este segundo paso, los usuarios seguirán viendo la funcionalidad en Turnos y recibirán un mensaje de error de "operación no admitida" si intentan usarlo.

Para ocultar turnos abiertos, solicitudes de intercambio y solicitudes de tiempo de espera en Turnos, use el tipo de recurso de programación Graph API para establecer los parámetros false siguientes en para cada equipo que haya asignado a una instancia de Blue Yonder WFM:

  • Abrir turnos: openShiftsEnabled
  • Solicitudes de intercambio: swapShiftsRequestsEnabled
  • Solicitudes de tiempo de expiración: timeOffRequestsEnabled

Para ocultar las solicitudes de turnos abiertos en Turnos, vaya a Configuración en Turnos y, a continuación, desactive la opción Abrir turnos.

Administración de la conexión y la instancia de conexión

Una vez configurada una conexión, puede administrarla y realizar cambios en ella en el Centro de administración de Microsoft 365 o mediante PowerShell.

Uso del Centro de administración de Microsoft 365

La página Consola de administración de conectores muestra cada conexión e instancia de conexión que ha configurado, junto con información como el estado de mantenimiento y los detalles del intervalo de sincronización. También puede acceder al asistente para crear nuevas conexiones e instancias de conexión y realizar cambios en cualquiera de los existentes. Por ejemplo, puede actualizar la configuración de sincronización y las asignaciones de equipo.

Para más información, consulte Uso del Centro de administración de Microsoft 365 para administrar la conexión de Turnos a Blue Yonder Workforce Management.

Usar PowerShell

Puede usar PowerShell para ver un informe de errores, cambiar la configuración de conexión, deshabilitar la sincronización, etc. Para obtener información paso a paso, consulte Usar PowerShell para administrar la conexión de Turnos a Workforce Management de Blue Yonder.