Private/Initialize-AtwsRamCache.ps1
|
<# .COPYRIGHT Copyright (c) Hugo Klemmestad. All rights reserved. Licensed under the MIT license. See https://github.com/ecitsolutions/Autotask/blob/master/LICENSE.md for license information. #> Function Initialize-AtwsRamCache { <# .SYNOPSIS This function reads the cachefile into memory. .DESCRIPTION This function determines the correct path to a cache file and imports it. Then it creates a shadow cache for the current Autotask tenant. .INPUTS Nothing. .OUTPUTS Nothing, but the cache property of the SOAP Client object is filled. .EXAMPLE Initialize-AtwsRamCache Loads the cache from disk .NOTES NAME: Initialize-AtwsRamCache .LINK #> [CmdLetBinding()] Param() begin { Write-Verbose -Message ('{0}: trying to determine correct location for dynamic module cache.' -F $MyInvocation.MyCommand.Name) # Get the current module name $myModule = (Get-Command -Name $MyInvocation.MyCommand.Name).Module $cacheFile = 'AutotaskFieldInfoCache.xml' # Use join-path to be platform agnostic on slashes in paths $centralCache = Join-Path $(Join-Path $myModule.ModuleBase 'Private') $cacheFile Write-Verbose -Message ('{0}: Module cache location is {1}' -F $MyInvocation.MyCommand.Name, $centralCache) } process { # Keeping old cache code. Will use it to clean up from earlier module versions Write-Verbose -Message ('{0}: Initializing memory-only cache with data supplied with module ({1}).' -F $MyInvocation.MyCommand.Name, $centralCache) # Initialize memory only cache from module directory $Script:FieldInfoCache = Import-Clixml -Path $centralCache # Nested testing to make sure the structure is OK if ($Script:FieldInfoCache -is [Hashtable]) { if (-not ($Script:FieldInfoCache.Count -ge 156)) { Write-Warning ('{0}: RAM cache file is broken! Loading data from API!' -F $MyInvocation.MyCommand.Name) # Restart import Update-AtwsRamCache # Do not process rest of script return } } # We must be connected to know the customer identity number if ($Script:Atws.CI) { # If the API version has been changed at the Autotask end we unfortunately have to reload all # entities from scratch $currentApiVersion = $Script:Atws.GetWsdlVersion($Script:Atws.IntegrationsValue) if ($Script:FieldInfoCache.ApiVersion -ne $currentApiVersion) { # Call the import-everything function Update-AtwsRamCache } } } end { Write-Verbose ('{0}: End of function' -F $MyInvocation.MyCommand.Name) } } |