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]$GlobalAdminAccount, [String]$ApplicationId, [string]$TaskId)
    {
        $uri = "https://graph.microsoft.com/beta/planner/tasks/$TaskId"
        $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -Uri $uri `
            -Method Get
        $taskDetailsResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -Uri ($uri + "/details") `
            -Method Get

        #region Assignments
        $assignmentsValue = @()
        if ($null -ne $taskResponse.assignments)
        {
            $allAssignments = $taskResponse.assignments | gm | 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 | gm | 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 | gm | 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 | gm | 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]$GlobalAdminAccount, [String]$ApplicationId)
    {
        $uri = "https://graph.microsoft.com/v1.0/planner/tasks"
        $body = $this.ConvertToJSONTask()
        $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -Uri $uri `
            -Method "POST" `
            -Body $body
        $this.TaskId = $taskResponse.id
        Write-Verbose -Message "New Planner Task created with Id {$($taskResponse.id)}"
        $this.UpdateDetails($GlobalAdminAccount)
    }

    [void]Update([System.Management.Automation.PSCredential]$GlobalAdminAccount, [String]$ApplicationId)
    {
        $uri = "https://graph.microsoft.com/beta/planner/tasks/$($this.TaskId)"
        $body = $this.ConvertToJSONTask()
        $Headers = @{}
        $Headers.Add("If-Match", $this.ETag)
        $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -Uri $uri `
            -Method "PATCH" `
            -Body $body `
            -Headers $Headers
    }

    [void]UpdateDetails([System.Management.Automation.PSCredential]$GlobalAdminAccount, [String]$ApplicationId)
    {
        $uri = "https://graph.microsoft.com/v1.0/planner/tasks/$($this.TaskId)/details"
        $body = $this.ConvertToJSONTaskDetails()

        # Get ETag for the details
        $currentTaskDetails = Invoke-MSCloudLoginMicrosoftGraphAPI -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -Uri $uri `
            -Method "GET"
        $Headers = @{}
        $Headers.Add("If-Match", $currentTaskDetails.'@odata.etag')
        $taskResponse = Invoke-MSCloudLoginMicrosoftGraphAPI -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -Uri $uri `
            -Method "PATCH" `
            -Body $body `
            -Headers $Headers
    }

    [void]Delete([System.Management.Automation.PSCredential]$GlobalAdminAccount, [string]$ApplicationId, [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 -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -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 -CloudCredential $GlobalAdminAccount `
            -ApplicationId $ApplicationId `
            -Uri $uri `
            -Method "DELETE" `
            -Headers $Headers
    }
}