Add /V1.0/InvoicePDF to Swagger update Get-AutotaskAPIResource to allow PDF invoice downloading

.gitignore

@@ -0,0 +1,2 @@
+
+PSGetModuleInfo.xml

AutoTaskAPI.psd1

@@ -12,7 +12,7 @@
     RootModule        = '.\AutoTaskAPI.psm1'
 
     # Version number of this module.
-    ModuleVersion     = '1.2.2'
+    ModuleVersion     = '1.2.3'
 
     # Supported PSEditions
     # CompatiblePSEditions = @()

Public/Get-AutotaskAPIResource.ps1

@@ -46,6 +46,8 @@ function Get-AutotaskAPIResource {
         $Script:Index = $Script:Queries | Group-Object Index -AsHashTable -AsString
         $ResourceURL = @(($Script:Index[$resource] | Where-Object { $_.Get -eq $resource }))[0]
         $ResourceURL.name = $ResourceURL.name.replace("/query", "/{PARENTID}") 
+        # Fix path to InvoicePDF URL, must be unique vs. /Invoices in Swagger file
+        $ResourceURL.name = $ResourceURL.name.replace("V1.0/InvoicePDF", "V1.0/Invoices/{id}/InvoicePDF")
         if ($SimpleSearch) {
             $SearchOps = $SimpleSearch -split ' '
             $SearchQuery = ConvertTo-Json @{
@@ -73,12 +75,21 @@ function Get-AutotaskAPIResource {
         if ($SearchQuery) { 
             $ResourceURL = ("$($ResourceURL.name)/query?search=$SearchQuery" -replace '{PARENTID}', '')
         }
-        $SetURI = "$($Script:AutotaskBaseURI)/$($ResourceURL)"
+        # Write-Host "ResourceURL BEFORE IF:" $ResourceURL
+        if ($resource -eq "InvoicePDF" -and $ID) { 
+            $ResourceURL = ("$($ResourceURL)" -replace '{id}', "$($ID)") 
+        }
+        $SetURI = "$($Script:AutotaskBaseURI)$($ResourceURL)" # Removed separating / as it was doubling in output (but worked)
+        # Write-Host "Final SetURI:" $SetURI
         try {
             do {
                 $items = Invoke-RestMethod -Uri $SetURI -Headers $Headers -Method Get
                 $SetURI = $items.PageDetails.NextPageUrl
                 #[System.TimeZoneInfo]::ConvertTimeBySystemTimeZoneId([datetime]::UtcNow, (get-timezone).id)
+                # Returns blank unless $items itself is returned for InvoicePDF function
+                if($resource -eq "InvoicePDF") {
+                    return $items
+                }
 
                 if ($items.items) { 
                     foreach ($item in $items.items) {

Public/Set-AutotaskAPIResource.ps1

@@ -60,7 +60,7 @@ function Set-AutotaskAPIResource {
         if ($ID) {
             $MyBody | Add-Member -NotePropertyMembers @{id=$ID}
         }
-        $PSBoundParameters.body.PSObject.properties | Where-Object {$null -ne $_.Value} | ForEach-Object {Add-Member -InputObject $MyBody -NotePropertyMembers @{$_.Name=$_.Value}}
+        $PSBoundParameters.body.PSObject.properties | Where-Object {$null -ne $_.Value} | ForEach-Object {Add-Member -Force -InputObject $MyBody -NotePropertyMembers @{$_.Name=$_.Value}}
 
         try {
             # Iterating through the property names above produces an array of n MyBody objects, all the same,

v1.json

@@ -65879,6 +65879,72 @@
         }
       }
     },
+    "/V1.0/InvoicePDF": {
+      "get": {
+        "tags": [
+          "InvoicePDF"
+        ],
+        "operationId": "InvoicePDF_QueryItem",
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json",
+          "text/json"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "type": "integer",
+            "format": "int64"
+          },
+          {
+            "name": "ApiIntegrationCode",
+            "in": "header",
+            "description": "API Integration Code",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "UserName",
+            "in": "header",
+            "description": "User Name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "Secret",
+            "in": "header",
+            "description": "Secret",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "ImpersonationResourceId",
+            "in": "header",
+            "description": "Impersonation Resource Key",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/InvoicePDFModel"
+            }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        }
+      }
+    },
     "/V1.0/Invoices/query/count": {
       "get": {
         "tags": [
@@ -144133,6 +144199,29 @@
         }
       }
     },
+    "InvoicePDFModel": {
+      "type": "object",
+      "properties": {
+        "Id": {
+          "format": "int64",
+          "type": "integer"
+        },
+        "contentType": {
+          "type": "string"
+        },
+        "fileName": {
+          "type": "string"
+        },
+        "fileSize": {
+          "format": "int64",
+          "type": "integer"
+        },
+        "data": {
+          "format": "byte",
+          "type": "string"
+        }
+      }
+    },
     "OpportunityModel": {
       "type": "object",
       "properties": {