Private/Association/Format-JCAssociation.ps1
|
Function Format-JCAssociation { Param ( [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true, Position = 0)][ValidateNotNullOrEmpty()][string]$Command , [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true, Position = 2)][ValidateNotNullOrEmpty()][object]$Source , [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, Position = 3)][ValidateNotNullOrEmpty()][string]$TargetId , [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, Position = 4)][ValidateNotNullOrEmpty()][bool]$IncludeInfo = $false , [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, Position = 5)][ValidateNotNullOrEmpty()][bool]$IncludeNames = $false , [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, Position = 6)][ValidateNotNullOrEmpty()][bool]$IncludeVisualPath = $false , [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, Position = 7)][ValidateNotNullOrEmpty()][bool]$Raw = $false ) Write-Debug ('[CommandTemplate]:' + $Command) $AssociationsOut = @() $Associations = Invoke-Expression -Command:($Command) If ($TargetId) { $Associations = $Associations | Where-Object { $_.id -eq $TargetId } } If (-not [System.String]::IsNullOrEmpty($Associations)) { $Associations | ForEach-Object { #Region Determine if association is 'direct', 'indirect', or "direct`/indirect" and apply label $_.paths | ForEach-Object { $PathCount = ($_.ToId | Measure-Object).Count $associationType = If ($PathCount -eq 0 -or $PathCount -eq 1) { 'direct' } ElseIf ($PathCount -gt 1) { 'indirect' } Else { 'associationType unknown;The count of paths is:' + [string]$PathCount } Add-Member -InputObject:($_) -MemberType:('NoteProperty') -Name:('associationType') -Value:($associationType) } $associationType = ($_.paths.associationType | Sort-Object | Select-Object -Unique) -join '/' #EndRegion Determine if association is 'direct', 'indirect', or "direct`/indirect" and apply label #Region Build record for each association If ($Raw) { # Raw switch allows for the user to return an unformatted version of what the api endpoint returns Add-Member -InputObject:($_) -NotePropertyName:('associationType') -NotePropertyValue:($associationType); $_.paths | ForEach-Object { $_.PSObject.Properties.Remove('associationType') } $AssociationsOut += $_ } Else { $AssociationHash = [ordered]@{ 'associationType' = $associationType; 'id' = $Source.($Source.ById); 'type' = $Source.TypeName.TypeNameSingular; 'name' = $null; 'info' = $null; 'targetId' = $null; 'targetType' = $null; 'targetName' = $null; 'targetInfo' = $null; 'visualPathById' = $null; 'visualPathByName' = $null; 'visualPathByType' = $null; }; # Dynamically get the rest of the properties and add them to the hash $AssociationProperties = $_ | ForEach-Object { $_.PSObject.Properties.name } | Select-Object -Unique If ($AssociationProperties) { ForEach ($AssociationProperty In $AssociationProperties | Where-Object { $_ -notin ('id', 'type') }) { $AssociationHash.Add($AssociationProperty, $_.($AssociationProperty)) | Out-Null } } Else { Write-Error ('No object properties found for association record.') } # If any "Include*" switch is provided get the target object If ($IncludeInfo -or $IncludeNames -or $IncludeVisualPath) { $Target = Get-JCObject -Type:($_.type) -Id:($_.id) } # If target is populated If ($Target) { $AssociationHash.targetId = $Target.($Target.ById) $AssociationHash.targetType = $Target.TypeName.TypeNameSingular } Else { $AssociationHash.targetId = $_.id $AssociationHash.targetType = $_.type } # Show source and target info If ($IncludeInfo) { $AssociationHash.info = $Source $AssociationHash.targetInfo = $Target } # Show names of source and target If ($IncludeNames) { $AssociationHash.name = $Source.($Source.ByName) $AssociationHash.targetName = $Target.($Target.ByName) } # Map out the associations path and show If ($IncludeVisualPath) { class AssociationMap { [string]$Id; [string]$Name; [string]$Type; AssociationMap([string]$i, [string]$n, [string]$t) { $this.Id = $i; $this.Name = $n; $this.Type = $t; } } $AssociationVisualPath = @() [AssociationMap]$AssociationVisualPathRecord = [AssociationMap]::new($Source.($Source.ById), $Source.($Source.ByName), $Source.TypeName.TypeNameSingular) $AssociationVisualPath += $AssociationVisualPathRecord $_.paths | ForEach-Object { $_ | ForEach-Object { If (-not [System.String]::IsNullOrEmpty($_)) { $AssociationPathToItemInfo = Get-JCObject -Type:($_.ToType) -Id:($_.ToId) $AssociationVisualPath += [AssociationMap]::new($_.ToId, $AssociationPathToItemInfo.($AssociationPathToItemInfo.ByName), $_.ToType) } } } ($AssociationVisualPath | ForEach-Object { $_.PSObject.Properties.name } | Select-Object -Unique) | ForEach-Object { $KeyName_visualPath = 'visualPathBy' + $_ $AssociationHash.($KeyName_visualPath) = ('"' + ($AssociationVisualPath.($_) -join '" -> "') + '"') } } # Convert the hashtable to an object where the Value has been populated $AssociationsUpdated = [PSCustomObject]@{} $AssociationHash.GetEnumerator() | ForEach-Object { If ($_.Value -or $_.key -in ($AssociationProperties) -or $_.key -in ('targetId', 'targetType')) { Add-Member -InputObject:($AssociationsUpdated) -NotePropertyName:($_.Key) -NotePropertyValue:($_.Value) } } $AssociationsOut += $AssociationsUpdated } } #EndRegion Build record for each association Return $AssociationsOut } } |