Usare la procedura guidata del connettore Turni per connettere Turni a Workforce Management di Blue Yonder

  • Articolo
  • Si applica a:
    Microsoft Teams, Microsoft 365 for frontline workers

Panoramica

Il connettore Turni di Microsoft Teams per Blue Yonder consente di integrare l'app Turni in Microsoft Teams con Blue Yonder Workforce Management (Blue Yonder WFM). I dipendenti in prima linea possono visualizzare e gestire facilmente le pianificazioni in Blue Yonder WFM dall'interno di Turni.

In questo articolo viene illustrato come eseguire la procedura guidata del connettore Turni nel interfaccia di amministrazione di Microsoft 365 per connettere Turni a Blue Yonder WFM.

Nota

Se si preferisce, è possibile usare PowerShell per integrare Turni con Blue Yonder WFM. Per altre informazioni, vedere Usare PowerShell per connettere Turni a Workforce Management di Blue Yonder.

La procedura guidata crea una connessione al sistema Blue Yonder WFM e a un'istanza di connessione. Un'istanza di connessione applica le impostazioni di sincronizzazione e i mapping del team scelti.

  • Le impostazioni di sincronizzazione determinano le informazioni sulla pianificazione e le entità sincronizzate tra Blue Yonder WFM e Turni.
  • I mapping dei team definiscono la relazione di sincronizzazione tra le istanze di Blue Yonder WFM e i team in Teams.

È possibile creare una o più istanze di connessione, ognuna con impostazioni di sincronizzazione diverse. Ad esempio, se l'organizzazione ha più posizioni con requisiti di pianificazione diversi, creare un'istanza di connessione con impostazioni di sincronizzazione univoche per ogni posizione. Un'istanza WFM Blue Yonder deve essere mappata una sola volta a un team in Teams in un determinato momento. Tuttavia, nella procedura guidata è possibile avere istanze di connessione diverse con gli stessi mapping. Ciò significa che è possibile creare istanze di connessione con mapping duplicati.

Con Blue Yonder WFM come sistema di registrazione, i dipendenti in prima linea possono gestire in modo efficiente le pianificazioni e la disponibilità in Turni nei propri dispositivi. I manager in prima linea possono continuare a usare Blue Yonder WFM per configurare le pianificazioni.

Termini usati in questo articolo

Termine Definizione
Connessione Una connessione consente l'accesso a tutte le istanze di WFM create nel sistema blue yonder WFM. Per creare una connessione, specificare i dettagli del WFM Blue Yonder, che includono il nome dell'account del servizio, la password e gli URL del servizio.
Istanza di connessione Per creare un'istanza di connessione, configurare le impostazioni seguenti:
  • Impostazioni di sincronizzazione che determinano come e quali informazioni di pianificazione vengono sincronizzate tra blue yonder WFM e turni
  • Mapping dei team per definire la relazione tra le istanze di WFM e i team in Teams.
istanza di WFM Questo termine si riferisce a un sito nel sistema di WFM Blue Yonder.

Prerequisiti

Prima di iniziare, assicurarsi di soddisfare tutti i prerequisiti seguenti.

  • L'utente è un amministratore globale di Microsoft 365.

  • È disponibile Blue Yonder WFM versione 2020.3, 2021.1 o 2021.2.

    Nota

    Se si dispone di Blue Yonder WFM 2020.3 o 2021.1, applicare la patch 2020.3.0.4 o 2021.1.0.3. Questa patch risolve un problema a causa del quale gli utenti ricevono un messaggio di errore permanente in Turni. Risolve anche un problema che impedisce agli utenti di aggiornare la loro disponibilità in Turni.

  • Si conosce il nome dell'account del servizio Blue Yonder WFM, la password e gli URL del servizio:

    • URL autenticazione federata
    • URL di autenticazione cookie
    • URL Employee Self-Service
    • URL API Web Retail
    • URL API Gestione siti
    • URL API di amministrazione

    Se non si dispone di tutte queste informazioni, contattare il supporto di Blue Yonder. Un account Blue Yonder viene creato a livello aziendale radice da un amministratore dell'organizzazione Blue Yonder. Deve avere accesso api, Amministrazione client, gestione dello Store e accesso al ruolo di lavoro. L'account e la password sono necessari per creare una connessione.

  • L'autenticazione SSO federata è abilitata nell'ambiente Blue Yonder WFM. Contattare il supporto di Blue Yonder per assicurarsi che l'accesso SSO federato sia abilitato. Necessitano delle seguenti informazioni:

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

  • È stato configurato almeno un team in Teams.

  • È stato aggiunto un account generale, denominato account di sistema microsoft 365, come proprietario del team a tutti i team di cui si vuole eseguire il mapping.

    Creare questo account nel interfaccia di amministrazione di Microsoft 365 e assegnargli una licenza di Microsoft 365. Aggiungere quindi l'account come proprietario del team a tutti i team di cui si vuole eseguire il mapping. Il connettore Turni usa questo account durante la sincronizzazione delle modifiche dei turni da Blue Yonder WFM. È consigliabile creare un account specifico per questo scopo e non usare l'account utente personale.

  • Assicurarsi che i team di cui si vuole eseguire il mapping non abbiano pianificazioni in Turni o in Blue Yonder WFM. Se un team ha una pianificazione esistente, seguire i passaggi nella sezione successiva per rimuovere le entità di pianificazione dal team prima di eseguire il mapping di un'istanza di WFM. In caso contrario, verranno visualizzati turni duplicati.

Rimuovere le entità di pianificazione dai team di cui si vuole eseguire il mapping

Nota

Completare questo passaggio se si esegue il mapping di istanze di WFM a team esistenti con entità di pianificazione. Se si sta eseguendo il mapping a team che non hanno pianificazioni o si stanno creando nuovi team a cui eseguire il mapping, è possibile ignorare questo passaggio.

Usare PowerShell per rimuovere le entità di pianificazione dai team.

  1. Prima di tutto, è necessario installare i moduli di PowerShell e configurare l'ambiente. Seguire la procedura per configurare l'ambiente.

  2. Eseguire il comando riportato di seguito:

    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>

    Per ottenere un elenco di scenari per il parametro EntityType, eseguire Get-CsTeamsShiftsConnectionConnector. I dati di pianificazione verranno rimossi per l'intervallo di data e ora specificato.

Per altre informazioni, vedere Remove-CsTeamsShiftsScheduleRecord.

Eseguire la procedura guidata del connettore Turni

Creazione di una connessione

  1. Nel riquadro di spostamento sinistro del interfaccia di amministrazione di Microsoft 365 scegliere Configura e quindi in Raccolte in primo piano selezionare Ruoli di lavoro front-line.

  2. Selezionare Console di gestione connettori. Screenshot della pagina dei dettagli per la procedura guidata del connettore Turni nell'interfaccia di amministrazione di Microsoft 365.

  3. Per creare una nuova connessione, scegliere Aggiungi connessione.

  4. Nel riquadro Scegliere il connettore scegliere Blue Yonder Workforce Management e quindi selezionare Avanti per creare una connessione Blue Yonder WFM.

  5. Nel riquadro Impostazioni connessione assegnare alla connessione un nome univoco. Non può essere più lungo di 100 caratteri o avere caratteri speciali.

  6. Immettere nome e password dell'account del servizio Blue Yonder WFM e URL del servizio. Se non si conoscono uno o più dettagli di connessione, contattare il supporto di Blue Yonder. Screenshot della pagina Dettagli connessione della procedura guidata, che mostra le impostazioni di connessione.

  7. Al termine, selezionare Salva connessione.

Nota

Se è necessario creare un'altra connessione, passare alla pagina Console di gestione connettori e quindi selezionare Aggiungi connessione.

Creare un'istanza di connessione

Dopo aver creato una connessione, è possibile configurare una o più istanze di connessione in tale connessione.

Le connessioni create sono elencate nella pagina Console di gestione connettori. Nella connessione in cui si vuole creare una nuova istanza selezionare Crea istanza. Screenshot della Console di gestione connettori che mostra il pulsante per creare una nuova istanza.

Scegliere le impostazioni

Nella pagina Impostazioni istanza scegliere le informazioni da sincronizzare da Blue Yonder WFM a Turni, la frequenza di sincronizzazione e se gli utenti di Turni possono apportare modifiche ai dati. Screenshot della pagina Impostazioni di sincronizzazione della procedura guidata, che mostra le impostazioni di sincronizzazione.

  1. Immettere un nome per l'istanza di connessione. Non può essere più lungo di 100 caratteri o avere caratteri speciali.

  2. Immettere l'account di sistema di Microsoft 365. Si tratta dell'account creato come prerequisito proprietario di tutti i team di cui si vuole eseguire il mapping.

  1. In Email destinatari delle notifiche scegliere chi riceve notifiche tramite posta elettronica su questa istanza di connessione. È possibile aggiungere singoli utenti e gruppi. Le notifiche di posta elettronica contengono informazioni sullo stato dell'installazione e su eventuali problemi o errori che possono verificarsi dopo la configurazione dell'istanza di connessione.

  2. Scegliere le impostazioni di sincronizzazione.
    Per ognuna di queste impostazioni, sono disponibili le opzioni seguenti tra cui scegliere:

    • I turni degli utenti non visualizzeranno i dati del provider: i dati non verranno sincronizzati tra Blue Yonder WFM e Turni.
    • Gli utenti dei turni possono visualizzare i dati del provider: la sincronizzazione dei dati è unidirezionale da Blue Yonder WFM a Turni.
    • I turni degli utenti possono visualizzare e modificare i dati del provider: la sincronizzazione dei dati è bidirezionale tra Blue Yonder WFM e Turni.

    Importante

    Prima di disabilitare una funzionalità selezionando l'opzione Turni gli utenti non visualizzeranno i dati del provider , tenere presente che:

    • Se l'impostazione Pianificazioni, gruppi, turni e attività è disabilitata, vengono disabilitate anche tutte le altre impostazioni, ad esempio Time off e Disponibilità dipendente e altro ancora.
    • Se l'impostazione Apri maiusc è disabilitata, viene disabilitata anche la richiesta Apri maiusc .
    • Se l'impostazione Time off è disabilitata, viene disabilitata anche la richiesta di time off .

  3. Scegliere la frequenza di sincronizzazione.

  4. Al termine della scelta delle impostazioni, selezionare Avanti.

    Importante

    Se si sceglie una delle opzioni seguenti per disabilitare i turni aperti, le richieste di turno aperto, le richieste di scambio o le richieste di permesso, è necessario eseguire un altro passaggio per nascondere la funzionalità in Turni.

    • Turni aperti: gli utenti dei turni non visualizzeranno i dati del provider
    • Richieste di scambio: i turni degli utenti non vedranno i dati del provider
    • Richieste di time off: i turni degli utenti non visualizzeranno i dati del provider

    Dopo aver eseguito la procedura guidata, assicurarsi di seguire i passaggi descritti nella sezione Disabilitare i turni aperti, le richieste di turni aperti, le richieste di scambio e le richieste di permesso più avanti in questo articolo.

Eseguire il mapping di istanze di WFM ai team

Scegliere le WFM istanze che si desidera connettere a Turni e quindi eseguire il mapping di ogni istanza a un team in Teams. È possibile eseguire il mapping fino a 400 istanze.

Per completare questo passaggio, è possibile:

Eseguire manualmente il mapping delle istanze di WFM ai team

Screenshot della procedura guidata che mostra l'elenco di istanze di Blue Yonder WFM.

  1. Nella pagina Mapping iniziare scegliendo le istanze di WFM di cui si vuole eseguire il mapping ai team in Teams.

  2. Selezionare la casella di controllo per ogni istanza di WFM di cui si vuole eseguire il mapping. Viene eseguito il mapping di un'istanza solo se la casella di controllo è selezionata.

  3. Successivamente, cercare e scegliere il team corretto in Teams. Tenere presente che i team già mappati a un'istanza di WFM in questa istanza di connessione non sono disponibili per il mapping.

  4. Scegliere il fuso orario. La città più vicina viene compilata automaticamente, ma è possibile modificarla.

  5. Al termine del mapping di tutti i team, selezionare Avanti.

Usare un file CSV per eseguire il mapping di istanze di WFM ai team

  1. Nella pagina Mapping scegliere Strumento di caricamento CSV.

  2. Selezionare Scarica modello per ottenere il file di mapping CSV. Il modello include un elenco di tutte le istanze di WFM e dei relativi ID. Le righe principali del modello avranno un aspetto simile al seguente:

    ID istanza WFM Blue Yonder Blue Yonder WFM Nome istanza ID team Nome team Fuso orario
    Precompilato automaticamente Precompilato automaticamente Zero Zero Predefinito*

    Le righe inferiori del modello avranno un aspetto simile al seguente:

    ID istanza WFM Blue Yonder Blue Yonder WFM Nome istanza ID team Nome team Fuso orario
    Zero Zero Precompilato automaticamente Precompilato automaticamente Predefinito*

  3. Scegliere un team di cui eseguire il mapping a un'istanza di WFM. Tagliare e incollare l'ID team e il nome del team dalla metà inferiore del modello per essere in linea con l'istanza di WFM desiderata. Una riga completa del modello dovrebbe essere simile alla seguente:

    ID istanza WFM Blue Yonder Blue Yonder WFM Nome istanza ID inferiore del team Nome team Fuso orario
    Precompilato automaticamente Precompilato automaticamente ID team spostato Nome del team spostato Predefinito*

    Ripetere questo passaggio per tutti i mapping.

  4. Se necessario, immettere la posizione corretta nella colonna Fuso orario.

    Nota

    La procedura guidata supporta circa 460 posizioni. Il fuso orario deve essere in formato tz. Se il percorso specifico scelto non è supportato, verrà visualizzato un errore nella procedura guidata. Provare a usare la città più vicina o la città principale all'interno dello stesso fuso orario.

  5. Nella pagina Mapping selezionare Sfoglia per trovare e caricare il file CSV completato.

  6. Scegliere Fine se il file è stato caricato correttamente. In caso contrario, esaminare il report degli errori e caricare un file corretto.

  7. I nuovi mapping sono elencati nella pagina Mapping.

  8. Scegliere Avanti.

Rivedere e completare

Prima di completare, esaminare il riepilogo del processo di creazione dell'istanza di connessione. Se è necessario apportare modifiche durante il processo di creazione dell'istanza di connessione, scegliere Indietro. Quando si è pronti, selezionare Fine.

Screenshot della pagina Rivedi della procedura guidata, che mostra i mapping.

La procedura guidata avvia il processo di configurazione dell'istanza di connessione, che potrebbe richiedere del tempo. Se si tenta di modificare l'istanza di connessione prima del completamento dell'installazione, è molto probabile che non sarà possibile visualizzare i mapping creati in precedenza.

I destinatari delle notifiche tramite posta elettronica scelti riceveranno notifiche tramite posta elettronica sullo stato di installazione in caso di errori.

Selezionare Fine per uscire dalla procedura guidata.

Disabilitare i turni aperti, le richieste di turni aperti, le richieste di scambio e le richieste di permesso

Importante

Seguire questi passaggi solo se nella procedura guidata è stata scelta una delle opzioni seguenti per disabilitare i turni aperti, le richieste di turni aperti, le richieste di scambio o le richieste di permesso. Il completamento di questo passaggio nasconde la funzionalità in Turni.

  • Turni aperti: gli utenti di Turni non visualizzeranno i dati di Blue Yonder WFM
  • Richieste di scambio: la funzionalità è disabilitata per tutti gli utenti
  • Richieste di permesso: la funzionalità è disabilitata per tutti gli utenti

Senza questo secondo passaggio, gli utenti vedranno ancora la funzionalità in Turni e riceveranno un messaggio di errore "operazione non supportata" se tentano di usarla.

Per nascondere i turni aperti, le richieste di scambio e le richieste di permesso in Turni, usare l'API Graph schedule resource type per impostare i parametri seguenti su false per ogni team mappato a un'istanza di Blue Yonder WFM:

  • Turni aperti: openShiftsEnabled
  • Richieste di scambio: swapShiftsRequestsEnabled
  • Richieste di permesso: timeOffRequestsEnabled

Per nascondere le richieste di turni aperti in Turni, passare a Impostazioni in Turni e quindi disattivare l'impostazione Turni aperti.

Gestire la connessione e l'istanza di connessione

Dopo aver configurato una connessione, è possibile gestirla e apportarvi modifiche nel interfaccia di amministrazione di Microsoft 365 o usando PowerShell.

Usare il interfaccia di amministrazione di Microsoft 365

Nella pagina Console di gestione connettori sono elencate tutte le istanze di connessione e connessione configurate, oltre a informazioni quali lo stato di integrità e i dettagli dell'intervallo di sincronizzazione. È anche possibile accedere alla procedura guidata per creare nuove connessioni e istanze di connessione e apportare modifiche a quelle esistenti. Ad esempio, è possibile aggiornare le impostazioni di sincronizzazione e i mapping del team.

Per altre informazioni, vedere Usare il interfaccia di amministrazione di Microsoft 365 per gestire la connessione turni a Blue Yonder Workforce Management.

Usare PowerShell.

È possibile usare PowerShell per visualizzare un report degli errori, modificare le impostazioni di connessione, disabilitare la sincronizzazione e altro ancora. Per istruzioni dettagliate, vedere Usare PowerShell per gestire la connessione di Turni a Workforce Management di Blue Yonder.