New-OPTask.ps1

function New-OPTask {
    <#
    .SYNOPSIS
        Create a new task in OpenProject
    .DESCRIPTION
        This function allows command driven task creation.  Create tasks, choosing project, status, priority, team and description.
    .EXAMPLE
        PS C:\> <example usage>
        Explanation of what the example does
    .INPUTS
        Inputs (if any)
    .OUTPUTS
        Output (if any)
    .NOTES
        General notes
    #>
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true)]
        [String[]]$TaskName,
        [Parameter()]
        [ValidateSet("Backlog", "Parked", "RoadBlocked", "InProgress")]
        [String]$Status,
        [Parameter()]
        [ValidateSet("Immediate", "High", "Normal", "Low")]
        [String]$Priority,
        [Parameter()]
        [ValidateSet("Service Desk", "Infrastructure", "Network Operations", "Event Operations", "Security")]
        [String]$Department,
        [Parameter()]
        [String]$Description
    )

    begin {

        # OpenProject API Key stored in confid data file
        $Config = Import-PowerShellDataFile -Path Config.psd1

        # Create base64 encoded api authentication credentials
        $cred = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f 'apikey', $Config.ApiKey)))

        # Create the Invoke-RestMethod request Headers
        $Headers = @{"Authorization" = "Basic $cred";"Content-Type" = 'application/json'}

        # Param switches
        $StatusSwitch = 0
        switch ($PSBoundParameters.Status) {
            "Backlog" { $StatusSwitch = 1; Break }
            "Parked" { $StatusSwitch = 15; Break }
            "RoadBlocked" { $StatusSwitch = 16; Break }
            "InProgress" { $StatusSwitch = 7; Break }
            Default { $StatusSwitch = 1 }
        }

        if ($PSBoundParameters.Department) {
            $DepartmentValue = $PSBoundParameters.Department
            Break
        }
        elseif ($Config.department) {
            $DepartmentValue = $Config.Department   
        }
        $DepartmentSwitch = 0
        switch ($DepartmentValue) {
            "Service Desk" { $DepartmentSwitch = 1; Break }
            "Infrastructure" { $DepartmentSwitch = 2; Break }
            "Network Operations" { $DepartmentSwitch = 3; Break }
            "Security" { $DepartmentSwitch = 4; Break }
            Default {}
        }
        $PrioritySwitch = 0
        switch ($PSBoundParameters.Priority) {
            "Low" { $PrioritySwitch = 7; Break }
            "Normal" { $PrioritySwitch = 8; Break }
            "High" { $PrioritySwitch = 9; Break }
            "Immediate" { $PrioritySwitch = 10; Break }
            Default { $PrioritySwitch = 8 }
        }

    }
    process {

        $TaskName.foreach{
            # This is the request body to POST
            $body = @{
                subject     = $_.trim() # Clean up the task name
                description = @{
                    raw = $Description
                }
                _links      = @{
                    type         = @{href = "/api/v3/types/1" } # Match the task type (Task, Milestone, Bug, etc, with your own requirement)
                    status       = @{href = "/api/v3/statuses/$StatusSwitch" } # Match the status (Backlog, Roadblocked, InProgress, Stalled, etc with your own requirement)
                    priority     = @{href = "/api/v3/priorities/$PrioritySwitch" } # Match the priority (High, Medium, Low, etc, with your own requirement)
                    customField2 = @{href = "/api/v3/custom_options/$DepartmentSwitch" } # If you want to include custom fields, otherwise comment this line out.
                    customField9 = @{href = "/api/v3/custom_options/116" } # If you want to include custom fields, otherwise comment this line out.
                }
            } | ConvertTo-Json -Compress # The OpenProject API expects JSON, so convert the object to JSON

            # Test endpoint using httpbin.org container
            #$Uri = "http://localhost/anything"

            # The project specific Work_Packages endpoint.
            $Uri = -join ($Config.ProductionDomain, "/api/v3/projects/", $Config.ProjectID, "/work_packages/")
        
            # Splat the payload
            $payload = @{
                Uri     = $Uri
                Headers = $Headers
                Method  = "Post"
                Body    = $body
                Verbose = $false
            }
            try {
                Invoke-RestMethod @payload
                Write-Verbose "Added [$TaskName]"
            }
            catch {
                $_
            }
        }
    }
}