Modules/GraphHelpers/PlannerTaskObject.psm1
|
class PlannerTaskObject { [string]$PlanId [string]$TaskId [string]$Title [string]$Notes [string]$BucketId [string]$ETag [string[]]$Assignments [System.Collections.Hashtable[]]$Attachments [System.Collections.Hashtable[]]$Checklist [string]$StartDateTime [string]$DueDateTime [string[]]$Categories [string]$CompletedDateTime [int]$PercentComplete [int]$Priority [string]$ConversationThreadId [string]$OrderHint [string]GetTaskCategoryNameByColor([string]$ColorName) { switch ($ColorName) { 'Pink' { return 'category1' } 'Red' { return 'category2' } 'Yellow' { return 'category3' } 'Green' { return 'category4' } 'Blue' { return 'category5' } 'Purple' { return 'category6' } } return $null } [string]GetTaskColorNameByCategory([string]$CategoryName) { switch ($CategoryName) { 'category1' { return 'Pink' } 'category2' { return 'Red' } 'category3' { return 'Yellow' } 'category4' { return 'Green' } 'category5' { return 'Blue' } 'category6' { return 'Purple' } } return $null } [void]PopulateById([System.Management.Automation.PSCredential]$Credential, [string]$TaskId) { $uri = "https://graph.microsoft.com/beta/planner/tasks/$TaskId" $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method Get $taskDetailsResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri ($uri + '/details') ` -Method Get #region Assignments $assignmentsValue = @() if ($null -ne $taskResponse.assignments) { $allAssignments = $taskResponse.assignments | Get-Member | Where-Object -FilterScript { $_.MemberType -eq 'NoteProperty' } foreach ($assignment in $allAssignments) { $assignmentsValue += $assignment.Name } } #endregion #region Attachments $attachmentsValue = @() if ($null -ne $taskDetailsResponse.references) { $allAttachments = $taskDetailsResponse.references | Get-Member | Where-Object -FilterScript { $_.MemberType -eq 'NoteProperty' } foreach ($attachment in $allAttachments) { $hashEntry = @{ Uri = $attachment.Name Alias = $taskDetailsResponse.references.($attachment.Name).alias Type = $taskDetailsResponse.references.($attachment.Name).type } $attachmentsValue += $hashEntry } } #endregion #region Categories $categoriesValue = @() if ($null -ne $taskResponse.appliedCategories) { $allCategories = $taskResponse.appliedCategories | Get-Member | Where-Object -FilterScript { $_.MemberType -eq 'NoteProperty' } foreach ($category in $allCategories) { $categoriesValue += $this.GetTaskColorNameByCategory($category.Name) } } #endregion #region Checklist $checklistValue = @() if ($null -ne $taskDetailsResponse.checklist) { $allCheckListItems = $taskDetailsResponse.checklist | Get-Member | Where-Object -FilterScript { $_.MemberType -eq 'NoteProperty' } foreach ($checkListItem in $allCheckListItems) { $hashEntry = @{ Title = $taskDetailsResponse.checklist.($checkListItem.Name).title Completed = [bool]$taskDetailsResponse.checklist.($checkListItem.Name).isChecked } $checklistValue += $hashEntry } } #endregion $this.Etag = $taskResponse.'@odata.etag' $this.Title = $taskResponse.title $this.StartDateTime = $taskResponse.startDateTime $this.ConversationThreadId = $taskResponse.conversationThreadId $this.DueDateTime = $taskResponse.dueDateTime $this.CompletedDateTime = $taskResponse.completedDateTime $this.PlanId = $taskResponse.planId $this.TaskId = $taskResponse.id $this.BucketId = $taskResponse.bucketId $this.Priority = $taskResponse.priority $this.Notes = $taskDetailsResponse.description $this.Assignments = $assignmentsValue $this.Attachments = $attachmentsValue $this.Categories = $categoriesValue $this.Checklist = $checklistValue } [string]ConvertToJSONTask() { $sb = [System.Text.StringBuilder]::New() $sb.Append('{') | Out-Null $sb.Append("`"planId`":`"$($this.PlanId)`"") | Out-Null $sb.Append(",`"title`":`"$($this.Title)`"") | Out-Null if (-not [System.String]::IsNullOrEmpty($this.BucketId)) { $sb.Append(",`"bucketId`":`"$($this.BucketId)`"") | Out-Null } if (-not [System.String]::IsNullOrEmpty($this.Priority)) { $sb.Append(",`"priority`": $($this.Priority.ToString())") | Out-Null } if (-not [System.String]::IsNullOrEmpty($this.StartDateTime)) { $sb.Append(",`"startDateTime`":`"$($this.StartDateTime)`"") | Out-Null } if (-not [System.String]::IsNullOrEmpty($this.DueDateTime)) { $sb.Append(",`"dueDateTime`":`"$($this.DueDateTime)`"") | Out-Null } if (-not [System.String]::IsNullOrEmpty($this.ConversationThreadId)) { $sb.Append(",`"conversationThreadId`":`"$($this.ConversationThreadId)`"") | Out-Null } if ($this.Assignments.Length -gt 0) { $sb.Append(",`"assignments`": {") | Out-Null $id = 1 foreach ($assignment in $this.Assignments) { if ($id -gt 1) { $sb.Append(',') | Out-Null } $sb.Append("`"$assignment`":{") | Out-Null $sb.Append("`"@odata.type`":`"#microsoft.graph.plannerAssignment`"") | Out-Null if ([System.String]::IsNullOrEmpty($this.OrderHint)) { $sb.Append(",`"orderHint`": `" !`"") } $sb.Append('}') | Out-Null $id++ } $sb.Append('}') | Out-Null } if ($this.Categories.Length -gt 0) { $sb.Append(",`"appliedCategories`": {") | Out-Null $id = 1 foreach ($category in $this.Categories) { if ($id -gt 1) { $sb.Append(',') | Out-Null } $categoryName = $this.GetTaskCategoryNameByColor($category) $sb.Append("`"$categoryName`":true") | Out-Null $id++ } $sb.Append('}') | Out-Null } $sb.Append('}') | Out-Null return $sb.ToString() } [string]ConvertToJSONTaskDetails() { $sb = [System.Text.StringBuilder]::New() $sb.Append('{') | Out-Null $sb.Append("`"description`":`"$($this.Notes)`"") | Out-Null if ($this.Attachments.Length -gt 0) { $sb.Append(",`"references`": {") | Out-Null $i = 1 foreach ($attachment in $this.Attachments) { if ($i -gt 1) { $sb.Append(',') | Out-Null } $sb.Append("`"$($attachment.Uri)`": {") | Out-Null $sb.Append("`"@odata.type`": `"#microsoft.graph.plannerExternalReference`",") | Out-Null $sb.Append("`"alias`":`"$($attachment.Alias)`",") | Out-Null $sb.Append("`"type`":`"$($attachment.Type)`"") | Out-Null $sb.Append('}') | Out-Null $i++ } $sb.Append('}') | Out-Null } if ($this.Checklist.Length -gt 0) { $sb.Append(",`"checklist`": {") | Out-Null $i = 1 foreach ($checkListItem in $this.Checklist) { if ($i -gt 1) { $sb.Append(',') | Out-Null } $sb.Append("`"$((New-Guid).ToString())`": {") | Out-Null $sb.Append("`"@odata.type`": `"#microsoft.graph.plannerChecklistItem`",") | Out-Null $sb.Append("`"title`":`"$($checkListItem.Title)`",") | Out-Null $sb.Append("`"isChecked`": $($checkListItem.Completed.ToString().Replace('`$', '').ToLower())") | Out-Null $sb.Append('}') | Out-Null $i++ } $sb.Append('}') | Out-Null } $sb.Append('}') | Out-Null return $sb.ToString() } [void]Create([System.Management.Automation.PSCredential]$Credential) { $uri = 'https://graph.microsoft.com/v1.0/planner/tasks' $body = $this.ConvertToJSONTask() $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method 'POST' ` -Body $body $this.TaskId = $taskResponse.id Write-Verbose -Message "New Planner Task created with Id {$($taskResponse.id)}" $this.UpdateDetails($Credential) } [void]Update([System.Management.Automation.PSCredential]$Credential) { $uri = "https://graph.microsoft.com/v1.0/planner/tasks/$($this.TaskId)" $body = $this.ConvertToJSONTask() $Headers = @{} $Headers.Add('If-Match', $this.ETag) $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method 'PATCH' ` -Body $body ` -Headers $Headers } [void]UpdateDetails([System.Management.Automation.PSCredential]$Credential) { $uri = "https://graph.microsoft.com/v1.0/planner/tasks/$($this.TaskId)/details" $body = $this.ConvertToJSONTaskDetails() # Get ETag for the details $currentTaskDetails = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method 'GET' $Headers = @{} $Headers.Add('If-Match', $currentTaskDetails.'@odata.etag') $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method 'PATCH' ` -Body $body ` -Headers $Headers } [void]Delete([System.Management.Automation.PSCredential]$Credential, [string]$TaskId) { $VerbosePreference = 'Continue' Write-Verbose -Message "Initiating the Deletion of Task {$TaskId}" $uri = "https://graph.microsoft.com/v1.0/planner/tasks/$TaskId" # Get ETag for the details $currentTaskDetails = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method 'GET' $Headers = @{} $Headers.Add('If-Match', $currentTaskDetails.'@odata.etag') Write-Verbose -Message "Retrieved Task's ETag {$($currentTaskDetails.'@odata.etag')}" $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -Credential $Credential ` -Uri $uri ` -Method 'DELETE' ` -Headers $Headers } } |