שימוש ב- PowerShell לחיבור Shifts ל- Blue Yonder Workforce Management

• חל על:

  Microsoft Teams, Microsoft 365 for frontline workers

סקירה כללית

השתמש במחבר Microsoft Teams Shifts עבור Blue Yonder כדי לשלב את האפליקציה Shifts ב- Microsoft Teams עם לוח Workforce Management כחול (כחול WFM). העובדים בחזית יכולים להציג ולנהל בצורה חלקה את לוחות הזמנים שלהם ב- Blue Yonder WFM מתוך Shifts.

במאמר זה, נדריך אותך כיצד להשתמש ב- PowerShell כדי להגדיר ולהגדיר את המחבר כך שישלב את Shifts עם Blue Yonder WFM.

כדי להגדיר את החיבור, הפעל קובץ Script של PowerShell. קובץ ה- Script קובע את תצורת המחבר, מחיל הגדרות סינכרון, יוצר את החיבור וממפה את WFM הכחולים על צוותים. הגדרות הסינכרון קובעות את התכונות הזמינות ב- Shifts ואת פרטי לוח הזמנים שסונכרנו בין Blue Yonder WFM Shifts. מיפויים מגדירים את קשר הסינכרון בין מופעי blue Yonder WFM שלך לבין צוותים ב- Teams. באפשרותך למפות לצוותים קיימים ולקבוצות חדשות.

אנו מספקים שני תסריטים. באפשרותך להשתמש בכל קובץ Script, בהתאם לשאלה אם ברצונך למפות לצוותים קיימים או ליצור צוותים חדשים שאליהם ברצונך למפות.

באפשרותך להגדיר חיבורים מרובים, שכל אחד מהם כולל הגדרות סינכרון שונות. לדוגמה, אם לארגון שלך יש מיקומים מרובים עם דרישות לוח זמנים שונות, צור חיבור עם הגדרות סינכרון ייחודיות עבור כל מיקום. זכור שניתן למפות מופע WFM כחול של לוח זמנים לצוות אחד בלבד בכל זמן נתון. אם מופע כבר ממופה לצוות, לא ניתן למפות אותו לצוות אחר.

כאשר Blue Yonder WFM למערכת הרשומה, העובדים בחזית העסק יכולים לנהל ביעילות את לוחות הזמנים והזמינות שלהם ב- Shifts במכשירים שלהם. מנהלי קווי החזית יכולים להמשיך להשתמש ב- Blue Yonder WFM להגדיר לוחות זמנים.

הערה

באפשרותך גם להשתמש באשף מחבר Shifts בחלונית מרכז הניהול של Microsoft 365 כדי לחבר את Shifts ל-Blue Yonder WFM.

לפני שתתחיל

דרישות מוקדמות

לפני שתתחיל, הקפד לעמוד בכל הדרישות המוקדמות הבאות:

• יש לך את Blue Yonder WFM גירסה 2020.3, 2021.1 או 2021.2.

  הערה

  אם יש לך Blue Yonder WFM 2020.3 או 2021.1, החל את התיקון 2020.3.0.4 או 2021.1.0.3. תיקון זה מתקן בעיה שבה משתמשים מקבלים הודעת שגיאה מתמידה ב- Shifts. הוא גם פותר בעיה שמונעת ממשתמשים לעדכן את הזמינות שלהם ב- Shifts.

• אתה יודע ש- Blue Yonder WFM שם חשבון השירות, הסיסמה וכתובות ה- URL של השירות:

  • כתובת URL של אימות מאוחד
  • כתובת URL לאימות קבצי Cookie
  • כתובת URL של שירות עצמי לעובדים
  • כתובת URL של API של אתר קמעונאי
  • כתובת URL של API של מנהל אתר
  • כתובת URL של API של ניהול

  אם אין לך את כל המידע הזה, פנה לתמיכה של Blue Yonder. חשבון Blue Yonder נוצר ברמת הארגון המוגדרת כבסיס על-ידי מנהל ארגון Blue Yonder. דרושה לו גישת API, גישת מרכז הניהול לקוח, מנהל חנות וגישה לעובד. החשבון והסיסמה נדרשים כדי ליצור חיבור.

• אימות SSO מאוחד זמין בסביבה הכחולה WFM שלך. פנה לתמיכה של Blue Yonder כדי לוודא ש- SSO מאוחד מופעל. הם יצטרכו את המידע הבא:

  • federatedSSOValidationService: https://wfmconnector.teams.microsoft.com/api/v1/fedauth/{tenantId}/6A51B888-FF44-4FEA-82E1-839401E9CD74/authorize היכן {tenantId} נמצא ה- tenantId שלך
  • ProxyHeader: X-MS-AuthToken

• הגדרת צוות אחד לפחות ב- Teams.

• הוספת חשבון כללי, חשבון מערכת Microsoft 365, כבעלים של כל הצוותים שברצונך למפות.

  צור חשבון זה בדף מרכז הניהול של Microsoft 365 והקצה לו רשיון של Microsoft 365. לאחר מכן, הוסף את החשבון כבעלים של צוות לכל הצוותים שברצונך למפות. המחבר Shifts משתמש בחשבון זה בעת סינכרון שינויים ב- Shifts מ- Blue Yonder WFM. אנו ממליצים ליצור חשבון במיוחד למטרה זו ולא להשתמש בחשבון המשתמש האישי שלך.

מרכז הניהול תפקיד בניהול המחבר באמצעות PowerShell

עליך להיות מנהל מערכת כללי של Microsoft 365 או מנהל מחבר של Shifts כדי להשלים את השלבים המפורטים במאמר זה.

תפקיד הניהול של מחבר Shifts הוא תפקיד מותאם אישית שאתה יוצר Microsoft Entra זהה ומקצה למשתמש. שם התפקיד חייב להיות "מנהל מחבר Shifts". התפקיד אינו חייב להיות בעל הרשאות ספציפיות, למרות שיש להגדיר לפחות הרשאה אחת בעת יצירתו. השירות מסתמך על הנוכחות של התפקיד על המשתמש, ולא על ההרשאות שלו.

לקבלת מידע נוסף, ראה יצירה והקצאה של תפקיד מותאם אישית במזהה Microsoft Entraוהקצאת תפקידי Microsoft Entra למשתמשים. זכור כי ייתכן שידרשו עד 24 שעות עד שהתפקיד ייווצר ויחול על משתמש.

הגדרת הסביבה שלך

1. התקן את PowerShell גירסה 7 ואילך. לקבלת הדרכה שלב אחר שלב, ראה התקנת PowerShell ב- Windows.

2. הפעל את PowerShell במצב מנהל מערכת.

3. התקן את המודול Microsoft Graph PowerShell.

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

   ודא שגירסה זו היא גירסה 1.6.1 ואילך.

   Get-InstalledModule Microsoft.Graph 
   

4. התקן את מודול PowerShell של תצוגה מקדימה של Teams.

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

   ודא שגירסה 4.7.0 לפחות מכילה את רכיבי ה- cmdlet של מחבר Shifts.

   Get-Command -Module MicrosoftTeams -Name *teamsshiftsconnection* 
   

5. הגדר את PowerShell ליציאה אם מתרחשת שגיאה בעת הפעלת קובץ ה- Script.

   $ErrorActionPreference = "Stop" 
   

6. אפשר הפעלה של קבצי Script ב- Windows.

   Set-ExecutionPolicy bypass 
   

התחבר ל- Teams

הפעל את הפעולות הבאות כדי להתחבר ל- Teams.

Connect-MicrosoftTeams

כשתתבקש, היכנס באמצעות אישורי מנהל המערכת שלך. כעת אתה מוגדר להפעיל את קבצי ה- Script במאמר זה ואת רכיבי ה- cmdlet של מחבר Shifts.

זהה את הצוותים שברצונך למפות

הערה

בצע שלב זה אם אתה ממפה את Blue Yonder WFM מופעים של צוותים קיימים. אם אתה יוצר צוותים חדשים למיפוי, באפשרותך לדלג על שלב זה.

בפורטל Azure, עבור אל הדף 'כל הקבוצות ' כדי לקבל רשימה של TeamIds של צוותים בארגון שלך.

רשום לעצמך את מזהה הצוות של הצוותים שברצונך למפות. קובץ ה- Script יבקש ממך להזין מידע זה.

הערה

אם לצוות אחד או יותר יש לוח זמנים קיים, קובץ ה- Script יסיר את לוחות הזמנים מקבוצות אלה. אחרת, תראה משמרות כפולות.

הפעל את קובץ ה- Script

הפעל אחד מתרחישי ה- Script הבאים, בהתאם לשאלה אם אתה יוצר צוות חדש או ממפה לצוות קיים:

• כדי להגדיר חיבור, צור צוות חדש ב- Teams ומפה מופע WFM כחול לצוות החדש, הפעל את קובץ ה- Script החדש של Teams.
• כדי להגדיר חיבור ומפה את Blue Yonder WFM של צוותים קיימים ב- Teams, הפעל את קובץ ה- Script הקיים של Teams.

בצע את ההוראות המוצגות על המסך בעת הפעלת קובץ ה- Script. קובץ ה- Script משלים את הפעולות הבאות:

1. בדוק ואמת את החיבור ל- Blue Yonder WFM באמצעות ה- Blue Yonder WFM אישורי חשבון השירות וכתובות ה- URL של השירות שאתה מזין.

2. החל הגדרות סינכרון. הגדרות אלה כוללות את תדירות הסינכרון (בדקות) ואת נתוני לוח הזמנים המסונכרנים בין Blue Yonder ל- Shifts WFM כחול. באפשרותך להפוך את נתוני לוח הזמנים המוגדרים לפי תרחישים אלה לזמינים: Shift, SwapRequest, UserShiftPreferences, OpenShiftOpenShiftRequest, TimeOff. TimeOffRequest

   לקבלת מידע נוסף, ראה New-CsTeamsShiftsConnectionInstance. כדי לראות את רשימת אפשרויות הסינכרון הנתמכות עבור כל פרמטר, הפעל את Get-CsTeamsShiftsConnectionConnector.

   הערה

   קובץ ה- Script מאפשר סינכרון עבור כל אפשרות סינכרון נתמכת. אם ברצונך לשנות את הגדרות הסינכרון, תוכל לעשות זאת לאחר הגדרת החיבור. לקבלת מידע נוסף, ראה שימוש ב- PowerShell לניהול חיבור Shifts ל- Blue Yonder Workforce Management.

3. מפה את blue Yonder WFM שלך לצוותים שלך ב- Teams.

   • אם בחרת להפעיל את קובץ ה - Script החדש של Teams כדי ליצור צוותים חדשים, המיפויים מבוססים על הצוותים החדשים שאתה יוצר.
   • אם בחרת להפעיל את קובץ ה- Script הקיים של Teams כדי למפות צוותים קיימים, המיפויים מבוססים על מזהה מופע Blue Yonder ועל מזהה צוות שאתה מזין. אם לצוות יש לוח זמנים קיים, קובץ ה- Script מסיר את כל נתוני לוח הזמנים.

לאחר הפעלת קובץ ה- Script, הודעת הצלחה מאשרת אם החיבור הוגדר בהצלחה.

נהל את החיבור שלך

לאחר הגדרת חיבור, באפשרותך לנהל אותו ולבצע בו שינויים ב- מרכז הניהול של Microsoft 365 או באמצעות PowerShell.

השתמש מרכז הניהול של Microsoft 365

הדף 'ניהול מחברים' מפרט כל חיבור שאתה מגדיר, יחד עם מידע כגון מצב תקינות ופרטי מרווחי סינכרון. באפשרותך גם לגשת לאשף כדי לבצע שינויים בכל אחד מהחיבורים שלך. לדוגמה, באפשרותך לעדכן הגדרות סינכרון ומיפויי צוות.

לקבלת מידע נוסף, ראה שימוש מרכז הניהול של Microsoft 365 כדי לנהל את חיבור Shifts שלך ל- Blue Yonder Workforce Management.

שימוש ב- PowerShell

באפשרותך להשתמש ב- PowerShell כדי להציג דוח שגיאות, לשנות הגדרות חיבור, להפוך סינכרון ללא זמין ועוד. לקבלת הדרכה שלב אחר שלב, ראה שימוש ב- PowerShell לניהול חיבור Shifts ל- Blue Yonder Workforce Management.

סקריפטים

הגדרת חיבור וייצור צוות חדש

#Map WFM sites 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 (comment out if not implemented for preview)
Write-Output "Listing connector types available"
$BlueYonderId = "6A51B888-FF44-4FEA-82E1-839401E9CD74"
$connectors = Get-CsTeamsShiftsConnectionConnector
Write-Output $connectors

#Prompt for entering of WFM username and password
$WfmUserName = Read-Host -Prompt 'Input your Blue Yonder account username'
$WfmPwd = Read-Host -Prompt 'Input your Blue Yonder 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'
$adminApiUrl = Read-Host -Prompt 'Input admin api url'
$cookieAuthUrl = Read-Host -Prompt 'Input cookie authorization url'
$essApiUrl = Read-Host -Prompt 'Input ess api url'
$federatedAuthUrl = Read-Host -Prompt 'Input federated authorization url'
$retailWebApiUrl = Read-Host -Prompt 'Input retail web api url'
$siteManagerUrl = Read-Host -Prompt 'Input site manager url'

$testResult = Test-CsTeamsShiftsConnectionValidate `
	-Name $ConnectionName `
	-ConnectorId $BlueYonderId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificBlueYonderSettingsRequest `
        -Property @{
            AdminApiUrl = $adminApiUrl
            SiteManagerUrl = $siteManagerUrl
            EssApiUrl = $essApiUrl
            RetailWebApiUrl = $retailWebApiUrl
            CookieAuthUrl = $cookieAuthUrl
            FederatedAuthUrl = $federatedAuthUrl
            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 $BlueYonderId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificBlueYonderSettingsRequest `
		-Property @{
			AdminApiUrl = $adminApiUrl
			SiteManagerUrl = $siteManagerUrl
			EssApiUrl = $essApiUrl
			RetailWebApiUrl = $retailWebApiUrl
			CookieAuthUrl = $cookieAuthUrl
			FederatedAuthUrl = $federatedAuthUrl
			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" }
	}
}
$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 `
	-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

הגדרת חיבור ומפה צוות קיים

#Map WFM sites to existing teams script
Write-Output "Map WFM sites to existing 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 (comment out if not implemented for preview)
Write-Output "Listing connector types available"
$BlueYonderId = "6A51B888-FF44-4FEA-82E1-839401E9CD74"
$connectors = Get-CsTeamsShiftsConnectionConnector
Write-Output $connectors

#Prompt for entering of WFM username and password
$WfmUserName = Read-Host -Prompt 'Input your Blue Yonder account username'
$WfmPwd = Read-Host -Prompt 'Input your Blue Yonder 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'
$adminApiUrl = Read-Host -Prompt 'Input admin api url'
$cookieAuthUrl = Read-Host -Prompt 'Input cookie authorization url'
$essApiUrl = Read-Host -Prompt 'Input ess api url'
$federatedAuthUrl = Read-Host -Prompt 'Input federated authorization url'
$retailWebApiUrl = Read-Host -Prompt 'Input retail web api url'
$siteManagerUrl = Read-Host -Prompt 'Input site manager url'

$testResult = Test-CsTeamsShiftsConnectionValidate `
	-Name $ConnectionName `
	-ConnectorId $BlueYonderId `
	-ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificBlueYonderSettingsRequest `
		-Property @{
			AdminApiUrl = $adminApiUrl
			SiteManagerUrl = $siteManagerUrl
			EssApiUrl = $essApiUrl
			RetailWebApiUrl = $retailWebApiUrl
			CookieAuthUrl = $cookieAuthUrl
			FederatedAuthUrl = $federatedAuthUrl
			LoginUserName = $WfmUserName
			LoginPwd = $plainPwd
		})
		
if ($NULL -ne $testResult.Code) {
	Write-Output $testResult
	throw "Validation failed, conflict found"
}
Write-Host "Test complete, no conflicts found"

#Create a connection
Write-Output "Creating a connection"
$ConnectionResponse = New-CsTeamsShiftsConnection `
    -Name $ConnectionName `
    -ConnectorId $BlueYonderId `
    -ConnectorSpecificSettings (New-Object Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.ConnectorSpecificBlueYonderSettingsRequest `
		-Property @{
			AdminApiUrl = $adminApiUrl
			SiteManagerUrl = $siteManagerUrl
			EssApiUrl = $essApiUrl
			RetailWebApiUrl = $retailWebApiUrl
			CookieAuthUrl = $cookieAuthUrl
			FederatedAuthUrl = $federatedAuthUrl
			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" }
	}
}
$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 `
	-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 של מחבר Shifts

לקבלת עזרה עבור רכיבי cmdlet של מחבר Shifts, כולל רכיבי ה- cmdlet המשמשים בקבצי ה- Script, חפש את CsTeamsShiftsConnection בהפניית ה- cmdlet של Teams PowerShell. להלן קישורים לרכיבי cmdlet נפוצים, מקובצים לפי קטגוריה:

חיבורי

• New-CsTeamsShiftsConnection
• Get-CsTeamsShiftsConnection
• Update-CsTeamsShiftsConnection

WFM אישורי מערכות

• Test-CsTeamsShiftsConnectionValidate

אפשרויות סינכרון עבור תרחישים נתמכים

• Get-CsTeamsShiftsConnectionConnector

הסרת נתוני לוח זמנים

• Remove-CsTeamsShiftsScheduleRecord

מופעי חיבור

• New-CsTeamsShiftsConnectionInstance
• Get-CsTeamsShiftsConnectionInstance
• Set-CsTeamsShiftsConnectionInstance
• Update-CsTeamsShiftsConnectionInstance
• Remove-CsTeamsShiftsConnectionInstance

מיפוי משתמש וסינכרון מוצלח

• Get-CsTeamsShiftsConnectionSyncResult
• Get-CsTeamsShiftsConnectionWfmUser

מיפוי צוות

• Get-CsTeamsShiftsConnectionTeamMap
• Remove-CsTeamsShiftsConnectionTeamMap

מזהה פעולה

• Get-CsTeamsShiftsConnectionOperation

דוחות שגיאה

• Get-CsTeamsShiftsConnectionErrorReport

מאמרים קשורים

• מחברי Shifts
• השתמש ב- PowerShell כדי לנהל את חיבור Shifts שלך ל- Blue Yonder Workforce Management
• השתמש מרכז הניהול של Microsoft 365 כדי לנהל את חיבור Shifts שלך ל- Blue Yonder Workforce Management
• נהל את האפליקציה 'משמרות'
• מבט כולל על Teams PowerShell
• חומר עזר ל- cmdlet של Teams PowerShell