Usare PowerShell per connettere Turni a UKG Pro Workforce Management

Articolo
08/29/2024
Si applica a:

Microsoft Teams, Microsoft 365 for frontline workers

Panoramica

Usare il connettore Turni di Microsoft Teams per UKG Pro Workforce Management per integrare l'app Turni in Microsoft Teams con UKG Pro Workforce Management (UKG Pro WFM). I dipendenti in prima linea possono visualizzare e gestire facilmente le pianificazioni in UKG Pro WFM dall'interno di Turni.

In questo articolo viene illustrato come usare PowerShell per configurare e configurare il connettore per integrare Turni con UKG Pro WFM.

Per configurare la connessione, eseguire uno script di PowerShell. Lo script configura il connettore, applica le impostazioni di sincronizzazione, crea la connessione e esegue il mapping delle istanze WFM di UKG Pro (chiamate anche istanze WFM) ai team di Teams. Le impostazioni di sincronizzazione determinano le funzionalità abilitate in Turni e le informazioni sulla pianificazione sincronizzate tra UKG Pro WFM e Turni. I mapping definiscono la relazione di sincronizzazione tra le istanze di WFM e i team in Teams. È possibile eseguire il mapping a team esistenti e nuovi team.

Vengono forniti due script. È possibile usare uno script, a seconda che si voglia eseguire il mapping ai team esistenti o creare nuovi team di cui eseguire il mapping.

È possibile configurare più connessioni, ognuna con impostazioni di sincronizzazione diverse. Ad esempio, se l'organizzazione ha più posizioni con requisiti di pianificazione diversi, creare una connessione con impostazioni di sincronizzazione univoche per ogni posizione. Tenere presente che un'istanza di WFM può essere mappata a un solo team alla volta. Se un'istanza è già mappata a un team, non può essere mappata a un altro team.

Con UKG Pro 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 UKG Pro WFM per configurare le pianificazioni.

Nota

È anche possibile usare la procedura guidata del connettore Turni nell'interfaccia di amministrazione di Microsoft 365 per connettere Turni a UKG Pro WFM.

Prima di iniziare

Prerequisiti

Esaminare le informazioni e completare tutte le attività di configurazione e prerequisiti in Prerequisiti e requisiti per il connettore Teams Turni per UKG Pro Workforce Management.

Assicurarsi di completare tutte le attività prima di seguire i passaggi descritti in questo articolo.

Ruolo di amministratore per gestire il connettore tramite PowerShell

Per completare la procedura descritta in questo articolo, è necessario essere un amministratore globale di Microsoft 365 o un amministratore del connettore Turni.

Il ruolo di amministratore del connettore Turni è un ruolo personalizzato creato in Microsoft Entra ID e assegnato a un utente. Il nome del ruolo deve essere "Amministratore connettore turni". Il ruolo non deve avere autorizzazioni specifiche, anche se è necessario impostare almeno un'autorizzazione al momento della creazione. Il servizio si basa sulla presenza del ruolo sull'utente e non sulle relative autorizzazioni.

Per altre informazioni, vedere Creare e assegnare un ruolo personalizzato in Microsoft Entra ID e Assegnare ruoli di Microsoft Entra agli utenti. Tenere presente che la creazione e l'applicazione del ruolo a un utente possono richiedere fino a 24 ore.

Importante

Microsoft consiglia di usare i ruoli con il minor numero di autorizzazioni. Ciò consente di migliorare la sicurezza per l'organizzazione. Amministratore globale è un ruolo con privilegi elevati che deve essere limitato agli scenari di emergenza quando non è possibile usare un ruolo con privilegi inferiori.

Configurare l'ambiente

Installare PowerShell versione 7 o successiva. Per istruzioni dettagliate, vedere Installazione di PowerShell in Windows.
Esegui Powershell in modalità Amministratore.

Installare il modulo Microsoft Graph PowerShell.

Install-Module Microsoft.Graph
Import-Module Microsoft.Graph

Verificare che sia la versione 1.6.1 o successiva.

Get-InstalledModule Microsoft.Graph

Installare il modulo PowerShell di anteprima di Teams.

Install-Module -Name MicrosoftTeams -AllowPrerelease -Force
Import-Module MicrosoftTeams

Verificare che sia almeno la versione 4.7.0 e che contenga i cmdlet del connettore Turni.

Get-Command -Module MicrosoftTeams -Name *teamsshiftsconnection*

Impostare PowerShell in modo che venga chiuso se si verifica un errore durante l'esecuzione dello script.
```
$ErrorActionPreference = "Stop" 
```
Abilitare l'esecuzione degli script in Windows.
```
Set-ExecutionPolicy bypass 
```

Connettiti a Teams

Eseguire quanto segue per connettersi a Microsoft Teams.

Connect-MicrosoftTeams

Quando viene richiesto, accedere usando le credenziali di amministratore. È ora possibile configurare l'esecuzione degli script in questo articolo e nei cmdlet del connettore Turni.

Identificare i team di cui si vuole eseguire il mapping

Nota

Completare questo passaggio se si esegue il mapping delle istanze di WFM ai team esistenti. Se si creano nuovi team a cui eseguire il mapping, è possibile ignorare questo passaggio.

Nel portale di Azure passare alla pagina Tutti i gruppi per ottenere un elenco dei TeamId dei team nell'organizzazione.

Prendere nota dei TeamId dei team di cui si vuole eseguire il mapping. Lo script richiederà di immettere queste informazioni.

Nota

Se uno o più team hanno una pianificazione esistente, lo script rimuoverà le pianificazioni da tali team. In caso contrario, verranno visualizzati turni duplicati.

Eseguire lo script

Eseguire uno degli script seguenti, a seconda che si stia creando un nuovo team o eseguendo il mapping a un team esistente:

Per configurare una connessione, creare un nuovo team in Teams e eseguire il mapping di un'istanza di WFM al nuovo team, eseguire il nuovo script di teams.
Per configurare una connessione e eseguire il mapping delle istanze di WFM ai team esistenti in Teams, eseguire lo script di teams esistente.

Seguire le istruzioni visualizzate quando si esegue lo script. Lo script completa le azioni seguenti:

Testare e verificare la connessione a UKG Pro WFM usando le credenziali dell'account del servizio UKG Pro WFM e gli URL del servizio immessi.
Applicare le impostazioni di sincronizzazione. Queste impostazioni includono la frequenza di sincronizzazione (in minuti) e i dati di pianificazione sincronizzati tra UKG Pro WFM e Turni. È possibile abilitare i dati di pianificazione definiti da questi scenari: Shift, SwapRequest, OfferShiftRequest, UserShiftPreferences, OpenShift, OpenShiftRequest, TimeOff, . TimeOffRequest

Per altre informazioni, vedere New-CsTeamsShiftsConnectionInstance. Per visualizzare l'elenco delle opzioni di sincronizzazione supportate per ogni parametro, eseguire Get-CsTeamsShiftsConnectionConnector.

Nota

Lo script abilita la sincronizzazione per ogni opzione di sincronizzazione supportata. Se si desidera modificare le impostazioni di sincronizzazione, è possibile farlo dopo la configurazione della connessione. Per altre informazioni, vedere Usare PowerShell per gestire la connessione Turni a UKG Pro Workforce Management.
Eseguire il mapping delle istanze di WFM ai team in Teams.
- Se si sceglie di eseguire il nuovo script di teams per creare nuovi team, i mapping si basano sui nuovi team creati.
- Se si è scelto di eseguire lo script di teams esistente per eseguire il mapping dei team esistenti, i mapping sono basati sugli ID istanza WFM e i TeamId immessi. Se un team ha una pianificazione esistente, lo script rimuove tutti i dati di pianificazione.

Dopo aver eseguito lo script, un messaggio Di successo conferma se la connessione è stata configurata correttamente.

Gestire la 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

La pagina Gestione connettori elenca ogni connessione configurata, insieme a informazioni quali lo stato di integrità e i dettagli dell'intervallo di sincronizzazione. È anche possibile accedere alla procedura guidata per apportare modifiche a qualsiasi connessione. 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 UKG Pro 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 indicazioni dettagliate, vedere Usare PowerShell per gestire la connessione Turni a UKG Pro Workforce Management.

Script

Configurare una connessione e creare un nuovo team

#Map WFM instances to teams script
Write-Output "Map WFM sites to teams"
Start-Sleep 1

#Ensure Teams module is at least version x
Write-Output "Checking Teams module version"
try {
    Get-InstalledModule -Name "MicrosoftTeams" -MinimumVersion 5.2.0
} catch {
    throw
}

#Connect to MS Graph
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"

#List connector types available
Write-Output "Listing connector types available"
$UkgId = "95BF2848-2DDA-4425-B0EE-D62AEED4C0A0"
$connectors = Get-CsTeamsShiftsConnectionConnector
Write-Output $connectors
$Ukg = $connectors | Where-Object {$_.Id -match $UkgId}
if ($NULL -eq $Ukg) {
    throw "UKG Dimensions not currently supported"
}

#Prompt for entering of WFM username and password
$WfmUserName = Read-Host -Prompt 'Input your UKG account username'
$WfmPwd = Read-Host -Prompt 'Input your UKG account password' -AsSecureString
$plainPwd =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($WfmPwd))

#Test connection settings
Write-Output "Testing connection settings"
$ConnectionName = Read-Host -Prompt 'Input connection name'
$apiUrl = Read-Host -Prompt 'Input connector api url'
$ssoUrl = Read-Host -Prompt 'Input connector sso url'
$clientId = Read-Host -Prompt 'Input connector client id'
$AppKey = Read-Host -Prompt 'Input your app key' -AsSecureString
$plainKey =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($AppKey))
$ClientSecret = Read-Host -Prompt 'Input your client secret' -AsSecureString
$plainSecret =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($ClientSecret))

$testResult = Test-CsTeamsShiftsConnectionValidate `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })
if ($NULL -ne $testResult.Code) {
    Write-Output $testResult
    throw "Validation failed, conflict found"
}
Write-Output "Test complete, no conflicts found"

#Create a connection
Write-Output "Creating a connection"
$ConnectionResponse = New-CsTeamsShiftsConnection `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })

$ConnectionId = $ConnectionResponse.Id
if ($null -ne $ConnectionId){
    Write-Output "Successfully created connection"
} else {
    throw "Connection creation failed"
}

#Create a connection instance
Write-Output "Creating a connection instance"
$designatedActorName = Read-Host -Prompt "Input Microsoft 365 System Account (person@contoso.com)"
$designator = Get-MgUser -UserId $designatedActorName
$teamsUserId = $designator.Id
$syncFreq = Read-Host -Prompt "Input sync frequency in minutes"
$InstanceName = Read-Host -Prompt "Input connection instance name"

#Read sync scenarios for connection instance
function GetSyncScenarioSetting {
    param (
        $SettingName
    )
    $TwoWay = New-Object System.Management.Automation.Host.ChoiceDescription '&TwoWay', 'TwoWay'
    $Disabled = New-Object System.Management.Automation.Host.ChoiceDescription '&Disabled', 'Disabled'
    $FromWfmToShifts = New-Object System.Management.Automation.Host.ChoiceDescription '&FromWfmToShifts', 'FromWfmToShifts'
    $options = [System.Management.Automation.Host.ChoiceDescription[]]($TwoWay, $Disabled, $FromWfmToShifts)
    $result = $host.ui.PromptForChoice("Set sync scenario for $SettingName", "", $options, 0)

    switch ($result)
    {
        0 { return "TwoWay" }
        1 { return "Disabled" }
        2 { return "FromWfmToShifts" }
    }
}
$SyncScenarioOfferShiftRequest = GetSyncScenarioSetting "Offer Shift Request"
$SyncScenarioOpenShift = GetSyncScenarioSetting "Open Shift"
$SyncScenarioOpenShiftRequest = GetSyncScenarioSetting "Open Shift Request"
$SyncScenarioShift = GetSyncScenarioSetting "Shift"
$SyncScenarioSwapRequest = GetSyncScenarioSetting "Swap Request"
$SyncScenarioTimeCard = GetSyncScenarioSetting "Time Card"
$SyncScenarioTimeOff = GetSyncScenarioSetting "Time Off"
$SyncScenarioTimeOffRequest = GetSyncScenarioSetting "Time Off Request"
$SyncScenarioUserShiftPreference = GetSyncScenarioSetting "User Shift Preferences"

#Read admin email list
[psobject[]]$AdminEmailList = @()
while ($true){
    $AdminEmail = Read-Host -Prompt "Enter admin's email to receive error report"
    $AdminEmailList += $AdminEmail
    $title    = 'Adding another email'
    $question = 'Would you like to add another admin email?'
    $choices  = '&Yes', '&No'
    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$InstanceResponse = New-CsTeamsShiftsConnectionInstance `
    -ConnectionId $ConnectionId `
    -ConnectorAdminEmail $AdminEmailList `
    -DesignatedActorId $teamsUserId `
    -Name $InstanceName `
    -SyncFrequencyInMin $syncFreq `
    -SyncScenarioOfferShiftRequest $SyncScenarioOfferShiftRequest `
    -SyncScenarioOpenShift $SyncScenarioOpenShift `
    -SyncScenarioOpenShiftRequest $SyncScenarioOpenShiftRequest `
    -SyncScenarioShift $SyncScenarioShift `
    -SyncScenarioSwapRequest $SyncScenarioSwapRequest `
    -SyncScenarioTimeCard $SyncScenarioTimeCard `
    -SyncScenarioTimeOff $SyncScenarioTimeOff `
    -SyncScenarioTimeOffRequest $SyncScenarioTimeOffRequest `
    -SyncScenarioUserShiftPreference $SyncScenarioUserShiftPreference

$InstanceId = $InstanceResponse.id
if ($null -ne $InstanceId){
    Write-Output "Success"
} else {
    throw "Connector instance creation failed"
}

#Keep mapping teams until user stops it
$mappings=@()
while ($true)
{
    #Create a new Teams team with owner set to system account and name set to the site name
    Write-Output "Creating a Teams team"
    $teamsTeamName = Read-Host -Prompt "Input the Teams team name"
    $Team = New-Team -DisplayName $teamsTeamName -Visibility "Public" -Owner $teamsUserId
    Write-Output "Successfully created a team"
    $TeamsTeamId=$Team.GroupId

    #Retrieve the list of wfm locations
    Write-Output "Listing the WFM team sites"
    $WfmTeamIds = Get-CsTeamsShiftsConnectionWfmTeam -ConnectorInstanceId $InstanceId
    Write-Output $WfmTeamIds
    if (($NULL -ne $WfmTeamIds) -and ($WfmTeamIds.Count -gt 0)){
        [System.String]$WfmTeamId = Read-Host -Prompt "Input the ID of WFM team you want to map"
    }
    else {
        throw "The WfmTeamId list is null or empty"
    }

    #Retrieve the list of WFM users and their roles
    Write-Output "Listing WFM users and roles"
    $WFMUsers = Get-CsTeamsShiftsConnectionWfmUser -ConnectorInstanceId $InstanceId -WfmTeamId $WfmTeamId
    Write-Output $WFMUsers

    #Add users to the Team for Shifts
    Write-Output "Adding users to Teams team"
    $currentUser = Read-Host -Prompt "Input the current user's user name or AAD ID"
    Add-TeamUser -GroupId $TeamsTeamId -User $currentUser -Role Owner
    $failedWfmUsers=@()
    foreach ($user in $WFMUsers) {
        try {
        $userEmail = $user.Name + "@" +$domain
        Add-TeamUser -GroupId $TeamsTeamId -User $userEmail
        } catch {
            $failedWfmUsers+=$user
        }
    }
    if($failedWfmUsers.Count -gt 0){
        Write-Output "There are WFM users not existed in Teams tenant:"
        Write-Output $failedWfmUsers
    }

    #Enable scheduling in the group
    $RequestBody = @{
        Enabled = $true
        TimeZone = "America/Los_Angeles"
    }
    $teamUpdateUrl="https://graph.microsoft.com/v1.0/teams/"+$TeamsTeamId+"/schedule"
    Invoke-MgGraphRequest -Uri $teamUpdateUrl -Method PUT -Body $RequestBody

    #Create a mapping of the new team to the instance
    Write-Output "Create a mapping of the new team to the site"
    $TimeZone = Read-Host -Prompt "Input the time zone of team mapping"
    $mapping = @{
        teamId = $TeamsTeamId
        wfmTeamId = $WfmTeamId
        timeZone = $TimeZone
        }
    $mappings += , $mapping

    $title    = 'Connecting another team'
    $question = 'Would you like to connect another team?'
    $choices  = '&Yes', '&No'

    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$batchMappingResponse = New-CsTeamsShiftsConnectionBatchTeamMap -ConnectorInstanceId $InstanceId -TeamMapping @($mappings)
if ($null -ne $batchMappingResponse.OperationId){
    "The mapping has begun asynchronously. To query mapping results run Get-CsTeamsShiftsConnectionOperation with the operation Id."
}
else {
    throw "The mapping has failed due to validation errors."
}
Write-Output $batchMappingResponse

Remove-TeamUser -GroupId $TeamsTeamId -User $currentUser -Role Owner
Disconnect-MgGraph

Configurare una connessione e eseguire il mapping di un team esistente

#Map WFM instances to existing teams script
Write-Host "Map WFM sites to existing teams"
Start-Sleep 1

#Ensure Teams module is at least version x
Write-Host "Checking Teams module version"
try {
    Get-InstalledModule -Name "MicrosoftTeams" -MinimumVersion 5.2.0
} catch {
    throw
}

#Connect to MS Graph
Connect-MgGraph -Scopes "User.Read.All","Group.ReadWrite.All"

#List connector types available
Write-Output "Listing connector types available"
$UkgId = "95BF2848-2DDA-4425-B0EE-D62AEED4C0A0"
$connectors = Get-CsTeamsShiftsConnectionConnector
Write-Output $connectors
$Ukg = $connectors | Where-Object {$_.Id -match $UkgId}
if ($NULL -eq $Ukg) {
    throw "UKG Dimensions not currently supported"
}

#Prompt for entering of WFM username and password
$WfmUserName = Read-Host -Prompt 'Input your UKG account username'
$WfmPwd = Read-Host -Prompt 'Input your UKG account password' -AsSecureString
$plainPwd =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($WfmPwd))

#Test connection settings
Write-Output "Testing connection settings"
$ConnectionName = Read-Host -Prompt 'Input connection name'
$apiUrl = Read-Host -Prompt 'Input connector api url'
$ssoUrl = Read-Host -Prompt 'Input connector sso url'
$clientId = Read-Host -Prompt 'Input connector client id'
$AppKey = Read-Host -Prompt 'Input your app key' -AsSecureString
$plainKey =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($AppKey))
$ClientSecret = Read-Host -Prompt 'Input your client secret' -AsSecureString
$plainSecret =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($ClientSecret))

$testResult = Test-CsTeamsShiftsConnectionValidate `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })
if ($NULL -ne $testResult.Code) {
    Write-Output $testResult
    throw "Validation failed, conflict found"
}
Write-Output "Test complete, no conflicts found"

#Create a connection
Write-Output "Creating a connection"
$ConnectionResponse = New-CsTeamsShiftsConnection `
    -Name $ConnectionName `
    -ConnectorId $UkgId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificUkgDimensionsSettingsRequest `
        -Property @{
            apiUrl = $apiUrl
            ssoUrl = $ssoUrl
            appKey = $plainKey
            clientId = $clientId
            clientSecret = $plainSecret
            LoginUserName = $WfmUserName
            LoginPwd = $plainPwd
        })

$ConnectionId = $ConnectionResponse.Id
if ($null -ne $ConnectionId){
    Write-Output "Successfully created connection"
} else {
    throw "Connection creation failed"
}

#Create a connection instance
Write-Output "Creating a connection instance"
$designatedActorName = Read-Host -Prompt "Input Microsoft 365 System Account (person@contoso.com)"
$designator = Get-MgUser -UserId $designatedActorName
$teamsUserId = $designator.Id
$syncFreq = Read-Host -Prompt "Input sync frequency in minutes"
$InstanceName = Read-Host -Prompt "Input connection instance name"

#Read sync scenarios for connection instance
function GetSyncScenarioSetting {
    param (
        $SettingName
    )
    $TwoWay = New-Object System.Management.Automation.Host.ChoiceDescription '&TwoWay', 'TwoWay'
    $Disabled = New-Object System.Management.Automation.Host.ChoiceDescription '&Disabled', 'Disabled'
    $FromWfmToShifts = New-Object System.Management.Automation.Host.ChoiceDescription '&FromWfmToShifts', 'FromWfmToShifts'
    $options = [System.Management.Automation.Host.ChoiceDescription[]]($TwoWay, $Disabled, $FromWfmToShifts)
    $result = $host.ui.PromptForChoice("Set sync scenario for $SettingName", "", $options, 0)

    switch ($result)
    {
        0 { return "TwoWay" }
        1 { return "Disabled" }
        2 { return "FromWfmToShifts" }
    }
}
$SyncScenarioOfferShiftRequest = GetSyncScenarioSetting "Offer Shift Request"
$SyncScenarioOpenShift = GetSyncScenarioSetting "Open Shift"
$SyncScenarioOpenShiftRequest = GetSyncScenarioSetting "Open Shift Request"
$SyncScenarioShift = GetSyncScenarioSetting "Shift"
$SyncScenarioSwapRequest = GetSyncScenarioSetting "Swap Request"
$SyncScenarioTimeCard = GetSyncScenarioSetting "Time Card"
$SyncScenarioTimeOff = GetSyncScenarioSetting "Time Off"
$SyncScenarioTimeOffRequest = GetSyncScenarioSetting "Time Off Request"
$SyncScenarioUserShiftPreference = GetSyncScenarioSetting "User Shift Preferences"

#Read admin email list
[psobject[]]$AdminEmailList = @()
while ($true){
    $AdminEmail = Read-Host -Prompt "Enter admin's email to receive error report"
    $AdminEmailList += $AdminEmail
    $title    = 'Adding another email'
    $question = 'Would you like to add another admin email?'
    $choices  = '&Yes', '&No'
    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$InstanceResponse = New-CsTeamsShiftsConnectionInstance `
    -ConnectionId $ConnectionId `
    -ConnectorAdminEmail $AdminEmailList `
    -DesignatedActorId $teamsUserId `
    -Name $InstanceName `
    -SyncFrequencyInMin $syncFreq `
    -SyncScenarioOfferShiftRequest $SyncScenarioOfferShiftRequest `
    -SyncScenarioOpenShift $SyncScenarioOpenShift `
    -SyncScenarioOpenShiftRequest $SyncScenarioOpenShiftRequest `
    -SyncScenarioShift $SyncScenarioShift `
    -SyncScenarioSwapRequest $SyncScenarioSwapRequest `
    -SyncScenarioTimeCard $SyncScenarioTimeCard `
    -SyncScenarioTimeOff $SyncScenarioTimeOff `
    -SyncScenarioTimeOffRequest $SyncScenarioTimeOffRequest `
    -SyncScenarioUserShiftPreference $SyncScenarioUserShiftPreference

$InstanceId = $InstanceResponse.id
if ($null -ne $InstanceId){
    Write-Output "Success"
} else {
    throw "Connector instance creation failed"
}

#Keep mapping teams until user stops it
$mappings=@()
while ($true)
{
    $TeamsTeamId = Read-Host -Prompt "Input the ID of the Teams team to be mapped"
    #Clear schedule of the Teams team
    Write-Host "Clear schedule of the existing team"

    $entityTypeString = Read-Host -Prompt 'Input the entity types of clear schedule'
    $Delimiters = ",", ".", ":", ";", " ", "`t"
    $entityType = $entityTypeString -Split {$Delimiters -contains $_}
    $entityType = $entityType.Trim()
    $entityType = $entityType.Split('',[System.StringSplitOptions]::RemoveEmptyEntries)
    Remove-CsTeamsShiftsScheduleRecord -TeamId $TeamsTeamId -ClearSchedulingGroup:$True -EntityType $entityType

    #Retrieve the list of wfm locations
    Write-Output "Listing the WFM team sites"
    $WfmTeamIds = Get-CsTeamsShiftsConnectionWfmTeam -ConnectorInstanceId $InstanceId
    Write-Output $WfmTeamIds
    if (($NULL -ne $WfmTeamIds) -and ($WfmTeamIds.Count -gt 0)){
        [System.String]$WfmTeamId = Read-Host -Prompt "Input the ID of WFM team you want to map"
    }
    else {
        throw "The WfmTeamId list is null or empty"
    }

    #Retrieve the list of WFM users and their roles
    Write-Output "Listing WFM users and roles"
    $WFMUsers = Get-CsTeamsShiftsConnectionWfmUser -ConnectorInstanceId $InstanceId -WfmTeamId $WfmTeamId
    Write-Output $WFMUsers

    #Create a mapping of the existing team to the instance
    Write-Host "Create a mapping of the existing team to the site"
    $TimeZone = Read-Host -Prompt "Input the time zone of team mapping"
    $mapping = @{
        teamId = $TeamsTeamId
        wfmTeamId = $WfmTeamId
        timeZone = $TimeZone
        }
    $mappings += , $mapping

    $title    = 'Connecting another team'
    $question = 'Would you like to connect another team?'
    $choices  = '&Yes', '&No'

    $decision = $Host.UI.PromptForChoice($title, $question, $choices, 1)
    if ($decision -eq 1) {
        break
    }
}
$batchMappingResponse = New-CsTeamsShiftsConnectionBatchTeamMap -ConnectorInstanceId $InstanceId -TeamMapping @($mappings)
if ($null -ne $batchMappingResponse.OperationId){
    "The mapping has begun asynchronously. To query mapping results run Get-CsTeamsShiftsConnectionOperation with the operation Id."
}
else {
    throw "The mapping has failed due to validation errors."
}
Write-Output $batchMappingResponse

Disconnect-MgGraph

Cmdlet del connettore Turni

Per informazioni sui cmdlet del connettore Turni, inclusi i cmdlet usati negli script, cercare CsTeamsShiftsConnection nelle informazioni di riferimento sui cmdlet di Teams PowerShell. Ecco i collegamenti ad alcuni cmdlet di uso comune, raggruppati per categoria:

Connections

Credenziali dei sistemi WFM

Test-CsTeamsShiftsConnectionValidate

Opzioni di sincronizzazione per gli scenari supportati

Get-CsTeamsShiftsConnectionConnector

Rimuovere i dati di pianificazione

Remove-CsTeamsShiftsScheduleRecord

Istanze di connessione

Mapping utente e sincronizzazione riuscita

Mapping del team

ID operazione

Get-CsTeamsShiftsConnectionOperation

Segnalazioni di errori

Get-CsTeamsShiftsConnectionErrorReport

Condividi tramite

Usare PowerShell per connettere Turni a UKG Pro Workforce Management

Panoramica

Prima di iniziare

Prerequisiti

Ruolo di amministratore per gestire il connettore tramite PowerShell

Configurare l'ambiente

Connettiti a Teams

Identificare i team di cui si vuole eseguire il mapping

Eseguire lo script

Gestire la connessione

Usare l'interfaccia di amministrazione di Microsoft 365

Usare PowerShell.

Script

Configurare una connessione e creare un nuovo team

Configurare una connessione e eseguire il mapping di un team esistente

Cmdlet del connettore Turni

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

Usare PowerShell per connettere Turni a UKG Pro Workforce Management

Panoramica

Prima di iniziare

Prerequisiti

Ruolo di amministratore per gestire il connettore tramite PowerShell

Configurare l'ambiente

Connettiti a Teams

Identificare i team di cui si vuole eseguire il mapping

Eseguire lo script

Gestire la connessione

Usare l'interfaccia di amministrazione di Microsoft 365

Usare PowerShell.

Script

Configurare una connessione e creare un nuovo team

Configurare una connessione e eseguire il mapping di un team esistente

Cmdlet del connettore Turni

Articoli correlati

Commenti e suggerimenti

Risorse aggiuntive