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

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 nell'interfaccia di amministrazione di Microsoft 365 per connettere Turni a Blue Yonder WFM.

La procedura guidata crea una connessione al sistema WFM Blue Yonder e 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 WFM di Blue Yonder 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 di 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

Prerequisiti

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

• Si è 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 conoscono il nome dell'account del servizio WFM Blue Yonder, 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 disporre dell'accesso API, dell'amministratore client, del gestore dello Store e del 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 nell'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 blu yonder WFM. Se un team ha una pianificazione esistente, seguire i passaggi descritti 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

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 a sinistra dell'interfaccia di amministrazione di Microsoft 365 scegliere Configura e quindi in Raccolte in primo piano selezionare Ruoli di lavoro in primo piano.

2. Selezionare Console di gestione connettori.

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 WFM blue yonder.

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.

7. Al termine, selezionare Salva 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.

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.

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.

3. In Destinatari delle notifiche tramite posta elettronica scegliere chi riceve le 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.

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

   • Gli utenti dei turni non visualizzeranno i dati del provider: i dati non verranno sincronizzati tra Blue Yonder WFM e Turni.
   • I turni degli utenti possono visualizzare i dati del provider: la sincronizzazione dei dati è unidirezionale da WFM di Blue Yonder a turni.
   • Turni che gli utenti possono visualizzare e modificare i dati del provider: la sincronizzazione dei dati è bidirezionale tra 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 .

5. Scegliere la frequenza di sincronizzazione.

6. 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 delle istanze di WFM ai team

Scegliere le istanze di WFM da 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
• Usare un file CSV per eseguire il mapping di istanze WFM

Eseguire manualmente il mapping delle istanze di WFM ai team

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 delle 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 WFM e dei relativi ID. Le righe principali del modello avranno un aspetto simile al seguente:

   ID istanza WFM di Blue Yonder	Blue Yonder WFM Instance Name	ID team	Nome team	Fuso orario
   Precompilato automaticamente	Precompilato automaticamente	Zero	Zero	Default*

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

   ID istanza WFM di Blue Yonder	Blue Yonder WFM Instance Name	ID team	Nome team	Fuso orario
   Zero	Zero	Precompilato automaticamente	Precompilato automaticamente	Default*

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 di Blue Yonder	Blue Yonder WFM Instance Name	ID inferiore del team	Nome team	Fuso orario
   Precompilato automaticamente	Precompilato automaticamente	ID team spostato	Nome del team spostato	Default*

   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.

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

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 nell'interfaccia di amministrazione di Microsoft 365 o usando PowerShell.

Usare l'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 l'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.

Articoli correlati

• Connettori turni
• Gestire l'app Turni per in Teams