Use o assistente do conector do Turnos para conectar o Turnos ao Workforce Management da Blue Yonder

  • Artigo
  • Aplica-se a:
    Microsoft Teams, Microsoft 365 for frontline workers

Visão Geral

O Conector de Turnos do Microsoft Teams para Blue Yonder permite integrar o aplicativo Turnos no Microsoft Teams ao Gerenciamento de Força de Trabalho Blue Yonder (Blue Yonder WFM). Os trabalhadores da linha de frente podem exibir e gerenciar perfeitamente seus agendamentos no Blue Yonder WFM de dentro do Shifts.

Neste artigo, explicamos como executar o assistente do conector Shifts no Centro de administração do Microsoft 365 para conectar Shifts ao Blue Yonder WFM.

Observação

Se preferir, você pode usar o PowerShell para integrar o Shifts ao Blue Yonder WFM. Para saber mais, confira Usar o PowerShell para conectar o Turnos ao Workforce Management da Blue Yonder.

O assistente cria uma conexão com o sistema de WFM do Blue Yonder e uma instância de conexão. Uma instância de conexão aplica as configurações de sincronização e mapeamentos de equipe escolhidos.

  • As configurações de sincronização determinam as informações de agendamento e quais entidades sincronizam entre o Blue Yonder WFM e Shifts.
  • Os mapeamentos de equipe definem a relação de sincronização entre suas instâncias de WFM e equipes do Blue Yonder no Teams.

Você pode criar uma ou mais instâncias de conexão, cada uma com configurações de sincronização diferentes. Por exemplo, se sua organização tiver vários locais com requisitos de agendamento diferentes, crie uma instância de conexão com configurações de sincronização exclusivas para cada local. Uma instância do Blue Yonder WFM só deve ser mapeada uma vez para uma equipe no Teams a qualquer momento. No entanto, é possível no assistente ter instâncias de conexão diferentes com os mesmos mapeamentos. Isso significa que você pode criar instâncias de conexão com mapeamentos duplicados.

Com o Blue Yonder WFM como seu sistema de registro, os trabalhadores da linha de frente podem gerenciar com eficiência seus agendamentos e disponibilidade em Turnos em seus dispositivos. Os gerentes de linha de frente podem continuar a usar o WFM do Blue Yonder para configurar agendas.

Termos usados neste artigo

Termo Definição
Connection Uma conexão permite o acesso a todas as instâncias de WFM criadas no sistema de WFM do Blue Yonder. Para criar uma conexão, você fornece seus detalhes de WFM do Blue Yonder, que incluem o nome da conta de serviço, a senha e as URLs de serviço.
Instância de conexão Para criar uma instância de conexão, configure as seguintes configurações:
  • Configurações de sincronização que determinam como e quais informações de agenda são sincronizadas entre o Blue Yonder WFM e Shifts
  • Mapeamentos de equipe para definir a relação entre suas instâncias WFM e equipes no Teams.
WFM instância Este termo refere-se a um site no sistema de WFM do Blue Yonder.

Pré-requisitos

Antes de começar, certifique-se de atender a todos os pré-requisitos a seguir.

  • Você é um administrador global do Microsoft 365.

  • Você tem o Blue Yonder WFM versão 2020.3, 2021.1 ou 2021.2.

    Observação

    Se você tiver o Workforce Management da Blue Yonder 2020.3 ou 2021.1, aplique o patch 2020.3.0.4 ou 2021.1.0.3. Esse patch corrige um problema em que os usuários recebem uma mensagem de erro persistente no Turnos. Ele também corrige um problema que impede que os usuários atualizem sua disponibilidade no Turnos.

  • Você sabe que o Blue Yonder WFM nome da conta de serviço, senha e URLs de serviço:

    • URL de autenticação federada
    • URL de autenticação de cookies
    • URL de autoatendimento para funcionários
    • URL da API Web de varejo
    • URL da API do gerenciador de sites
    • URL da API de administração

    Se você não tiver todas essas informações, entre em contato com o suporte do Blue Yonder. Uma conta do Blue Yonder é criada no nível da empresa raiz por um administrador da empresa Blue Yonder. Ele deve ter acesso à API, Administração do cliente, Gerenciador de Lojas e Acesso ao Trabalho. A conta e a senha são necessárias para criar uma conexão.

  • A autenticação SSO federada está habilitada no seu ambiente Workforce Management da Blue Yonder. Entre em contato com o suporte da Blue Yonder para garantir que a SSO federado esteja habilitado. Eles precisarão das seguintes informações:

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

  • Você tem pelo menos uma equipe configurada no Teams.

  • Você adicionou uma conta geral, o que chamamos de conta do sistema microsoft 365, como proprietário da equipe para todas as equipes que você deseja mapear.

    Crie essa conta no Centro de administração do Microsoft 365 e atribua uma licença do Microsoft 365. Em seguida, adicione a conta como um proprietário de equipe a todas as equipes que você deseja mapear. O conector do Turnos usa essa conta ao sincronizar as alterações do Turnos do Workforce Management do Blue Yonder. Recomendamos que você crie uma conta especificamente para essa finalidade e não use sua conta de usuário pessoal.

  • Verifique se as equipes que você deseja mapear não têm agendamentos em Turnos ou WFM do Blue Yonder. Se uma equipe tiver uma agenda existente, siga as etapas na próxima seção para remover entidades de agendamento da equipe antes de mapear uma instância WFM para ela. Caso contrário, você verá turnos duplicados.

Remover entidades de agenda de equipes que você deseja mapear

Observação

Conclua esta etapa se você estiver mapeando WFM instâncias para equipes existentes que têm entidades de agendamento. Se você estiver mapeando para equipes que não têm agendamentos ou se estiver criando novas equipes para mapear, poderá ignorar essa etapa.

Use o PowerShell para remover entidades de agendamento das equipes.

  1. Primeiro, você precisará instalar os módulos do PowerShell e configurá-lo. Siga as etapas para configurar seu ambiente.

  2. Execute o seguinte comando:

    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 obter uma lista de cenários do parâmetro EntityType, execute Get-CsTeamsShiftsConnectionConnector. Os dados do agendamento serão removidos para o intervalo de data e hora que você especificar.

Para saber mais, confira Remove-CsTeamsShiftsScheduleRecord.

Executar o assistente do conector Shifts

Criar uma conexão

  1. Na navegação à esquerda do Centro de administração do Microsoft 365, escolha Instalação e, em coleções em destaque, selecione Trabalhos de linha de frente.

  2. Selecione Console de Gerenciamento do Conector. Captura de tela da página de detalhes do assistente do conector do Turnos no Centro de administração do Microsoft 365.

  3. Para criar uma nova conexão, escolha Adicionar conexão.

  4. No painel Escolher seu conector, escolha Blue Yonder Workforce Management e, em seguida, selecione Avançar para criar uma conexão WFM Blue Yonder.

  5. No painel Configurações de conexão, dê a sua conexão um nome exclusivo. Não pode ter mais de 100 caracteres ou ter caracteres especiais.

  6. Insira o nome da conta de serviço do Blue Yonder WFM e as URLs de serviço e senha. Se você não souber um ou mais detalhes da conexão, entre em contato com o suporte do Blue Yonder. Captura de tela da página Detalhes da conexão do assistente, mostrando as configurações de conexão.

  7. Quando terminar, selecione Salvar conexão.

Observação

Se você precisar criar outra conexão, acesse a página Console de Gerenciamento do Conector e selecione Adicionar conexão.

Criar uma instância de conexão

Depois de criar uma conexão, você pode configurar uma ou mais instâncias de conexão nessa conexão.

As conexões que você criou estão listadas na página Console de Gerenciamento do Conector. Na conexão em que você deseja criar uma nova instância, selecione Criar instância. Captura de tela do Console de Gerenciamento do Conector, mostrando o botão para criar uma nova instância.

Escolher configurações

Na página Configurações da Instância, você escolhe as informações a serem sincronizadas do Blue Yonder WFM para Shifts, a frequência de sincronização e se os usuários do Shifts podem fazer alterações nos dados. Captura de tela da página Configurações de sincronização do assistente, mostrando as configurações de sincronização.

  1. Insira um nome para sua instância de conexão. Não pode ter mais de 100 caracteres ou ter caracteres especiais.

  2. Insira sua conta do sistema Microsoft 365. Essa é a conta que você criou como um pré-requisito que é um proprietário de equipe de todas as equipes que você deseja mapear.

  1. Em Email destinatários de notificação, escolha quem recebe notificações por email sobre essa instância de conexão. Você pode adicionar grupos e usuários individuais. Os notificações por email contêm informações sobre a configuração status e quaisquer problemas ou erros que possam ocorrer após a configuração da instância de conexão.

  2. Escolha suas configurações de sincronização.
    Para cada uma dessas configurações, você tem as seguintes opções para escolher:

    • Os usuários de turnos não verão dados do provedor: os dados não serão sincronizados entre o Blue Yonder WFM e o Shifts.
    • Os usuários de turnos podem ver dados do provedor: a sincronização de dados é unidirecional do Blue Yonder WFM para Shifts.
    • Os usuários de turnos podem ver e alterar dados do provedor: a sincronização de dados é bidirecional entre o Blue Yonder WFM e o Shifts.

    Importante

    Antes de desabilitar um recurso selecionando a opção Desativar os usuários do Shifts não verá a opção de dados do provedor, esteja ciente de que:

    • Se a configuração Agendas, grupos, turnos e atividades estiver desabilitada , todas as outras configurações, como Tempo limite e disponibilidade do funcionário e muito mais, também serão desabilitadas.
    • Se a configuração Abrir turno estiver desabilitada, a solicitação abrir turno também será desabilitada.
    • Se a configuração de tempo limite estiver desabilitada, a solicitação de tempo limite também será desabilitada.

  3. Escolha sua frequência de sincronização.

  4. Quando terminar de escolher suas configurações, selecione Avançar.

    Importante

    Se você escolher qualquer uma das opções a seguir para desabilitar turnos abertos, solicitações de turno aberto, solicitações de troca ou solicitações de folga, há outra etapa que você precisa executar para ocultar a funcionalidade em Turnos.

    • Abrir turnos: os usuários de turnos não verão dados do provedor
    • Solicitações de troca: usuários de turnos não verão dados do provedor
    • Solicitações de tempo limite: os usuários de turnos não verão dados do provedor

    Depois de executar o assistente, certifique-se de seguir as etapas na seção Desabilitar turnos abertos, solicitações de turnos abertos, solicitações de troca e solicitações de folga mais adiante neste artigo.

Mapear instâncias de WFM para equipes

Escolha as instâncias WFM que você deseja conectar ao Shifts e, em seguida, mapeie cada instância para uma equipe no Teams. Você pode mapear até 400 instâncias.

Para concluir esta etapa, você pode:

Mapear manualmente WFM instâncias para equipes

Captura de tela do assistente, mostrando a lista de instâncias de WFM do Blue Yonder.

  1. Na página Mapeamento, comece escolhendo as instâncias WFM que você deseja mapear para equipes no Teams.

  2. Selecione a caixa de seleção de cada instância WFM que você deseja mapear. Uma instância só será mapeada se a caixa de seleção for selecionada.

  3. Em seguida, pesquise e escolha a equipe correta no Teams. Lembre-se de que as equipes que já estão mapeadas para uma instância de WFM nesta instância de conexão não estão disponíveis para mapear novamente.

  4. Escolha o fuso horário. A cidade mais próxima é preenchida automaticamente, mas você pode alterá-la.

  5. Quando terminar de mapear todas as equipes, selecione Avançar.

Usar um arquivo CSV para mapear WFM instâncias para equipes

  1. Na página Mapeamento, escolha ferramenta de carregamento CSV.

  2. Selecione Baixar modelo para obter o arquivo de mapeamento CSV. O modelo inclui uma lista de todas as suas instâncias de WFM e suas IDs. As linhas superiores do modelo serão semelhantes a esta:

    ID da instância de WFM do Blue Yonder Nome da instância de WFM do Blue Yonder ID da equipe Nome da Equipe Fuso Horário
    Pré-preenchido automaticamente Pré-preenchido automaticamente Em branco Em branco Padrão*

    E as linhas inferiores do modelo serão assim:

    ID da instância de WFM do Blue Yonder Nome da instância de WFM do Blue Yonder ID da equipe Nome da Equipe Fuso Horário
    Em branco Em branco Pré-preenchido automaticamente Pré-preenchido automaticamente Padrão*

  3. Escolha uma equipe que você deseja mapear para uma instância de WFM. Corte e cole a ID da Equipe e o Nome da Equipe da metade inferior do modelo para estar em linha com a instância WFM desejada. Uma linha concluída do modelo deve ser semelhante a esta:

    ID da instância de WFM do Blue Yonder Nome da instância de WFM do Blue Yonder BottomID da equipe Nome da Equipe Fuso Horário
    Pré-preenchido automaticamente Pré-preenchido automaticamente ID da equipe que você moveu Nome da equipe que você moveu Padrão*

    Repita esta etapa para todos os mapeamentos.

  4. Insira o local correto na coluna Fuso Horário, se necessário.

    Observação

    O assistente dá suporte a aproximadamente 460 locais. O fuso horário deve estar no formato tz. Se o local específico escolhido não tiver suporte, você verá um erro no assistente. Tente usar a cidade mais próxima ou a cidade principal no mesmo fuso horário.

  5. Na página Mapeamento, selecione Procurar para localizar e carregar seu arquivo CSV concluído.

  6. Escolha Concluído se o arquivo for carregado corretamente. Caso contrário, examine o relatório de erro e carregue um arquivo corrigido.

  7. Seus novos mapeamentos estão listados na página Mapeamentos.

  8. Escolha Avançar.

Analisar e concluir

Antes de concluir, examine o resumo do processo de criação da instância de conexão. Se você precisar fazer alterações durante o processo de criação da instância de conexão, escolha Voltar. Quando estiver pronto, selecione Concluir.

Captura de tela da página Revisão do assistente, mostrando os mapeamentos.

O assistente inicia o processo para configurar a instância de conexão, o que pode levar algum tempo para ser concluído. Se você tentar editar a instância de conexão antes da instalação ser concluída, provavelmente não poderá exibir os mapeamentos criados anteriormente.

Os destinatários de notificação por email escolhidos receberão notificações por email sobre a instalação status caso haja erros.

Selecione Concluído para sair do assistente.

Desabilitar vagas abertas de turnos, solicitações de vagas abertas de turnos, pedidos de troca de turno e pedidos de folga

Importante

Siga estas etapas somente se você escolher qualquer uma das opções a seguir para desabilitar turnos abertos, solicitações de turnos abertos, solicitações de troca ou solicitações de folga no assistente. A conclusão dessa etapa oculta a funcionalidade no Turnos.

  • Turnos abertos: os usuários do Turnos não verão dados do Blue Yonder WFM
  • Solicitações de troca: o recurso estará desabilitado para todos os usuários
  • Solicitações de folga: o recurso estará desabilitado para todos os usuários

Sem essa segunda etapa, os usuários ainda verão a funcionalidade no Turnos e receberão uma mensagem de erro "operação sem suporte" se tentarem usá-la.

Para ocultar vagas abertas de turnos, pedidos de troca de turno e pedidos de folga no Turnos, use o tipo de recurso de cronograma da API do Graph para definir os seguintes parâmetros para false cada equipe mapeada para uma instância do Blue Yonder WFM:

  • Vagas abertas de turnos: openShiftsEnabled
  • Solicitações de troca: swapShiftsRequestsEnabled
  • Pedidos de folga: timeOffRequestsEnabled

Para ocultar solicitações de vagas abertas de turnos no Turnos, vá para as Configurações em Turnos e desabilite a configuração Vagas abertas de Turnos.

Gerenciar sua instância de conexão e conexão

Depois que uma conexão é configurada, você pode gerenciar e fazer alterações nela no Centro de administração do Microsoft 365 ou usando o PowerShell.

Use o Centro de administração do Microsoft 365

A página Console de Gerenciamento do Conector lista cada instância de conexão e conexão que você configurou, juntamente com informações como status de integridade e detalhes do intervalo de sincronização. Você também pode acessar o assistente para criar novas conexões e instâncias de conexão e fazer alterações em qualquer uma das suas existentes. Por exemplo, você pode atualizar configurações de sincronização e mapeamentos de equipe.

Para saber mais, confira Usar o Centro de administração do Microsoft 365 para gerenciar sua conexão shifts com o Blue Yonder Workforce Management.

Usar o Windows PowerShell!

Você pode usar o PowerShell para exibir um relatório de erro, alterar as configurações de conexão, desabilitar a sincronização e muito mais. Para obter diretrizes passo a passo, confira Usar o PowerShell para gerenciar sua conexão do Turnos com o Workforce Management da Blue Yonder.