functions/Update-JS7FromRepositoryItem.ps1
|
function Update-JS7FromRepositoryItem { <# .SYNOPSIS Updates the JS7 inventory from scheduling objects in a local Git repository .DESCRIPTION This cmdlet updates scheduling objects such as a workflows, schedules etc. in the JS7 inventory from a local Git repository. Existing scheduling objects in the JS7 inventory are created or are updated if they exist. The following REST Web Service API resources are used: * /inventory/repository/update .PARAMETER Path Specifies the folder and sub-folders of the repository from which objects are selected for update of the JS7 inventory. .PARAMETER Type Specifies the scheduling object type that is one of: * Deployable object types ** WORKFLOW ** FILEORDERSOURCE ** JOBRESOURCE ** NOTICEBOARD ** LOCK * Releasable object types ** INCLUDESCRIPT ** JOBTEMPLATE ** WORKINGDAYSCALENDAR ** NONWORKINGDAYSCALENDAR ** SCHEDULE ** REPORT If no object type is specified then any object types will be used. .PARAMETER Folder Alternatively to use of -Path the parameter specifies a JOC Cockpit inventory folder to be used to which objects from a local Git repository are updated. .PARAMETER Recursive Specifies that all sub-folders should be looked up if the -Folder parameter is used. By default no sub-folders will be looked up. .PARAMETER Change Specifies the identifier of an inventory change. Scheduling objects indicated with the change and dependencies will be updated from JOC Cockpit's Git repository. If in addition the -Folder parameter is used, then scheduling objects of the change will be limited to objects located in the specified folder. .PARAMETER Local Specifies that a repository holding local scheduling objects should be used. This corresponds to the LOCAL category. If this switch is not used then then ROLLOUT category is assumed for a repository that holds scheduling objects intended for rollout to later environments such as test, prod. .PARAMETER NoReferencing Specifies that no referencing objects from dependencies of objects subject to the indicated -Change should be included. .PARAMETER NoReferences Specifies that no references to objects from dependencies of objects subject to the indicated -Change should be included. .PARAMETER AuditComment Specifies a free text that indicates the reason for the current intervention, e.g. "business requirement", "maintenance window" etc. The Audit Comment is visible from the Audit Log view of the JOC Cockpit. This parameter is not mandatory. However, the JOC Cockpit can be configured to require Audit Log comments for all interventions. .PARAMETER AuditTimeSpent Specifies the duration in minutes that the current intervention required. This information is shown in the Audit Log view. It can be useful when integrated with a ticket system that logs the time spent on interventions with JS7. .PARAMETER AuditTicketLink Specifies a URL to a ticket system that keeps track of any interventions performed for JS7. This information is shown in the Audit Log view of JOC Cockpit. It can be useful when integrated with a ticket system that logs interventions with JS7. .INPUTS This cmdlet accepts pipelined objects as for example from the Get-JS7RepositoryItem cmdlet. .OUTPUTS This cmdlet returns no output. .EXAMPLE Update-JS7FromRepositoryItem -Folder /some_folder/samples Updates the JOC Cockpit inventory from the indicated folder in the local Git repository of category ROLLOUT. Depending on the JS7 Settings in use this can include workflows, resource locks etc. .EXAMPLE Update-JS7FromRepositoryItem -Folder /some_folder/samples -Local Updates the JOC Cockpit inventory from the indicated folder in the local Git repository of category LOCAL. Depending on the JS7 Settings in use this can include calendars, schedules etc. .EXAMPLE Update-JS7FromRepositoryItem -Path /some_folder/samples/sampleWorkflow -Type 'WORKFLOW' Updates the JOC Cockpit inventory from the indicated worfklow in the local Git repository. .LINK about_JS7 #> [cmdletbinding(SupportsShouldProcess)] param ( [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [string] $Path, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [ValidateSet('WORKFLOW','FILEORDERSOURCE','JOBRESOURCE','NOTICEBOARD','LOCK','INCLUDESCRIPT','JOBTEMPLATE','WORKINGDAYSCALENDAR','NONWORKINGDAYSCALENDAR','SCHEDULE','REPORT',IgnoreCase = $False)] [string] $Type, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [string] $Folder, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$False)] [switch] $Recursive, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [string[]] $Change, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [switch] $Local, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [switch] $NoReferencing, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [switch] $NoReferences, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [string] $AuditComment, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [int] $AuditTimeSpent, [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)] [Uri] $AuditTicketLink ) Begin { Approve-JS7Command $MyInvocation.MyCommand $stopWatch = Start-JS7StopWatch if ( !$AuditComment -and ( $AuditTimeSpent -or $AuditTicketLink ) ) { throw "$($MyInvocation.MyCommand.Name): Audit Log comment required, use parameter -AuditComment if one of the parameters -AuditTimeSpent or -AuditTicketLink is used" } $objectCount = 0 $changes = @() $updatableConfigurations = @() } Process { if ( $Path.endsWith('/') ) { throw "$($MyInvocation.MyCommand.Name): path has to include folder, sub-folder and object name" } if ( $Path.endsWith('/') ) { $Path = $Path.Substring( 0, $Path.Length-1 ) } if ( $Path -and !$Type ) { throw "$($MyInvocation.MyCommand.Name): path requires to specify the object type, use -Type parameter" } if ( $Path -and $Folder ) { throw "$($MyInvocation.MyCommand.Name): only one of the parameters -Path or -Folder can be used" } if ( !$Path -and !$Folder -and !$Change ) { throw "$($MyInvocation.MyCommand.Name): one of the parameters -Path, -Folder or -Change has to be used" } if ( $Change ) { $changes += $Change } elseif ( $Path ) { $updatableObj = New-Object PSObject Add-Member -Membertype NoteProperty -Name 'path' -value $Path -InputObject $updatableObj Add-Member -Membertype NoteProperty -Name 'objectType' -value $Type -InputObject $updatableObj } else { $updatableObj = New-Object PSObject Add-Member -Membertype NoteProperty -Name 'path' -value $Folder -InputObject $updatableObj Add-Member -Membertype NoteProperty -Name 'objectType' -value 'FOLDER' -InputObject $updatableObj Add-Member -Membertype NoteProperty -Name 'recursive' -value ($Recursive -eq $True) -InputObject $updatableObj } if ( !$Change ) { $updatableConfigurationObj = New-Object PSObject Add-Member -Membertype NoteProperty -Name 'configuration' -value $updatableObj -InputObject $updatableConfigurationObj $updatableConfigurations += $updatableConfigurationObj } } End { if ( $Local ) { $category = 'LOCAL' } else { $category = 'ROLLOUT' } $body = New-Object PSObject Add-Member -Membertype NoteProperty -Name 'category' -value $category -InputObject $body if ( $changes.count ) { $changeItems = Get-JS7InventoryChange -Name $changes -Detailed if ( !$changeItems ) { throw "$($MyInvocation.MyCommand.Name): no changes found" } $configurations = Get-JS7ConfigurationMerge -ChangeItems $changeItems -Dependencies (Get-JS7InventoryDependencies -OperationType DEPLOY -Folder $Folder -Configuration $changeItems.configurations -NoReferencing:$NoReferencing -NoReferences:$NoReferences) $objectCount = $configurations.configuration.count Add-Member -Membertype NoteProperty -Name 'configurations' -value $configurations -InputObject $body } else { $objectCount = $updatableConfigurations.configuration.count Add-Member -Membertype NoteProperty -Name 'configurations' -value $updatableConfigurations -InputObject $body } if ( $AuditComment -or $AuditTimeSpent -or $AuditTicketLink ) { $objAuditLog = New-Object PSObject Add-Member -Membertype NoteProperty -Name 'comment' -value $AuditComment -InputObject $objAuditLog if ( $AuditTimeSpent ) { Add-Member -Membertype NoteProperty -Name 'timeSpent' -value $AuditTimeSpent -InputObject $objAuditLog } if ( $AuditTicketLink ) { Add-Member -Membertype NoteProperty -Name 'ticketLink' -value $AuditTicketLink -InputObject $objAuditLog } Add-Member -Membertype NoteProperty -Name 'auditLog' -value $objAuditLog -InputObject $body } if ( $PSCmdlet.ShouldProcess( $Path, '/inventory/repository/update' ) ) { [string] $requestBody = $body | ConvertTo-Json -Depth 100 $response = Invoke-JS7WebRequest -Path '/inventory/repository/update' -Body $requestBody if ( $response.StatusCode -eq 200 ) { $requestResult = ( $response.Content | ConvertFrom-JSON ) if ( !$requestResult.ok ) { throw ( $response | Format-List -Force | Out-String ) } } else { throw ( $response | Format-List -Force | Out-String ) } if ( $objectCount -gt 0 ) { Write-Verbose ".. $($MyInvocation.MyCommand.Name): $($objectCount) objects updated: $Path" } else { Write-Verbose ".. $($MyInvocation.MyCommand.Name): no items updated" } } Trace-JS7StopWatch -CommandName $MyInvocation.MyCommand.Name -StopWatch $stopWatch Update-JS7Session } } |