mirror of
https://github.com/Micke-K/IntuneManagement.git
synced 2026-09-28 19:05:38 +02:00
496 lines
31 KiB
PowerShell
496 lines
31 KiB
PowerShell
# Bulk Documentation form + per-view Show-IntuneManagerDocumentForm caller.
|
|
# Split out of IntuneManagerUIWPF.ps1 on 2026-06-03 to match the Avalonia tree's
|
|
# per-feature layout (architecture rule R9 — keep the WPF shell from growing further).
|
|
|
|
function Set-WpfDocumentationCombo {
|
|
param($Form, [string]$Name, $Items, $SelectedValue)
|
|
$control = $Form.FindName($Name)
|
|
if (-not $control) { return }
|
|
$control.ItemsSource = Get-UIItemsArray $Items
|
|
if ($null -ne $SelectedValue) { $control.SelectedValue = $SelectedValue }
|
|
if ($control.SelectedIndex -lt 0 -and $control.Items.Count -gt 0) { $control.SelectedIndex = 0 }
|
|
}
|
|
|
|
# Show/hide $TargetNames whenever $TriggerName's SelectedValue matches
|
|
# $VisibleWhen. Mirrors the OLD project's per-output-form selectionChanged
|
|
# wiring (DocumentationWord.psm1 ~L126, Documentation.psm1 ~L5029) so the
|
|
# Custom Properties row only appears for Output Properties = "custom" and
|
|
# the limit-length grid only appears for Output Level = "limited".
|
|
function Set-WpfDocumentationConditionalVisibility {
|
|
param(
|
|
$Form,
|
|
[string]$TriggerName,
|
|
[string]$VisibleWhen,
|
|
[string[]]$TargetNames
|
|
)
|
|
$trigger = $Form.FindName($TriggerName)
|
|
if (-not $trigger) { return }
|
|
$targets = @($TargetNames | ForEach-Object { $Form.FindName($_) } | Where-Object { $_ })
|
|
if ($targets.Count -eq 0) { return }
|
|
|
|
$apply = {
|
|
param($selectedValue)
|
|
$vis = if ([string]$selectedValue -eq $VisibleWhen) { 'Visible' } else { 'Collapsed' }
|
|
foreach ($t in $targets) { $t.Visibility = $vis }
|
|
}.GetNewClosure()
|
|
|
|
& $apply $trigger.SelectedValue
|
|
$trigger.Add_SelectionChanged({
|
|
param($s, $e)
|
|
& $apply $s.SelectedValue
|
|
}.GetNewClosure())
|
|
}
|
|
|
|
function Initialize-WpfDocumentationOptions {
|
|
param($Form)
|
|
|
|
Set-WpfDocumentationCombo $Form 'cbDocumentationLanguage' (Get-DocumentationLanguages | Sort-Object EnglishName) (Get-DocumentationSetting 'Language' 'en')
|
|
Set-WpfDocumentationCombo $Form 'cbDocumentationPropertySeparator' @(',',';','-','|') (Get-DocumentationSetting 'PropertySeparator' ';')
|
|
Set-WpfDocumentationCombo $Form 'cbDocumentationObjectSeparator' @(
|
|
[PSCustomObject]@{ Name='New line'; Value=[Environment]::NewLine },
|
|
[PSCustomObject]@{ Name=';'; Value=';' },
|
|
[PSCustomObject]@{ Name='|'; Value='|' }
|
|
) (Get-DocumentationSetting 'ObjectSeparator' ([Environment]::NewLine))
|
|
Set-WpfDocumentationCombo $Form 'cbNotConfiguredText' @(
|
|
[PSCustomObject]@{Name='Not configured (localized)';Value='notConfigured'},
|
|
[PSCustomObject]@{Name='Empty';Value='empty'},
|
|
[PSCustomObject]@{Name="Don't change";Value='asis'}
|
|
) (Get-DocumentationSetting 'NotConfiguredText' 'notConfigured')
|
|
Set-WpfDocumentationCombo $Form 'cbValueOutputProperty' @(
|
|
[PSCustomObject]@{Name='Value';Value='value'},
|
|
[PSCustomObject]@{Name='Value with label';Value='valueWithLabel'}
|
|
) (Get-DocumentationSetting 'ValueOutputProperty' 'value')
|
|
$propertyModes = @([PSCustomObject]@{Name='Simple';Value='simple'},[PSCustomObject]@{Name='Extended';Value='extended'},[PSCustomObject]@{Name='Custom';Value='custom'})
|
|
$fileModes = @([PSCustomObject]@{Name='Single file';Value='Full'},[PSCustomObject]@{Name='One file per object';Value='Object'})
|
|
Set-WpfDocumentationCombo $Form 'cbCSVDocumentationProperties' $propertyModes (Get-DocumentationSetting 'CSVExportProperties' 'simple')
|
|
Set-WpfDocumentationCombo $Form 'cbCSVDelimiter' @('',',',';','-','|') (Get-DocumentationSetting 'CSVDelimiter' '')
|
|
Set-WpfDocumentationCombo $Form 'cbJsonOutputFileType' @([PSCustomObject]@{Name='Single file';Value='Full'},[PSCustomObject]@{Name='One file per object type';Value='ObjectType'}) (Get-DocumentationSetting 'JSONOutputFileType' 'Full')
|
|
Set-WpfDocumentationCombo $Form 'cbHTMLDocumentFileType' $fileModes (Get-DocumentationSetting 'HTMLDocumentFileType' 'Full')
|
|
Set-WpfDocumentationCombo $Form 'cbAtlassianDocumentFileType' $fileModes (Get-DocumentationSetting 'AtlassianDocumentFileType' 'Full')
|
|
Set-WpfDocumentationCombo $Form 'cbMDDocumentFileType' $fileModes (Get-DocumentationSetting 'MDDocumentFileType' 'Full')
|
|
Set-WpfDocumentationCombo $Form 'cbWordExportProperties' $propertyModes (Get-DocumentationSetting 'WordExportProperties' 'simple')
|
|
Set-WpfDocumentationCombo $Form 'cbWordDocumentFormat' @([PSCustomObject]@{Name='DOCX';Value='wdFormatDocumentDefault'},[PSCustomObject]@{Name='Strict Open XML';Value='wdFormatStrictOpenXMLDocument'},[PSCustomObject]@{Name='PDF';Value='wdFormatPDF'}) (Get-DocumentationSetting 'WordDocumentFormat' 'wdFormatDocumentDefault')
|
|
Set-WpfDocumentationCombo $Form 'cbWordDocumentationLevel' @([PSCustomObject]@{Name='Full';Value='full'},[PSCustomObject]@{Name='Limited';Value='limited'},[PSCustomObject]@{Name='Basic';Value='basic'}) (Get-DocumentationSetting 'WordDocumentationLevel' 'full')
|
|
Set-WpfDocumentationCombo $Form 'cbWordTableCaptionPosition' @([PSCustomObject]@{Name='Below table';Value='below'},[PSCustomObject]@{Name='Above table';Value='above'}) (Get-DocumentationSetting 'WordTableCaptionPosition' 'below')
|
|
|
|
$defaults = @{
|
|
txtCSVDocumentationPath='CSVDocumentationPath'; txtCSVCustomProperties='CSVCustomDisplayProperties'; txtJsonDocumentName='JSONDocumentName'
|
|
txtHTMLDocumentName='HTMLDocumentName'; txtHTMLCSSFile='HTMLCSSFile'; txtHTMLTitleProperty='HTMLTitleProperty'
|
|
txtAtlassianDocumentName='AtlassianDocumentName'; txtAtlassianTitleProperty='AtlassianTitleProperty'
|
|
txtMDDocumentName='MDDocumentName'; txtMDCSSFile='MDCSSFile'; txtMDTitleProperty='MDTitleProperty'
|
|
txtWordDocumentName='WordDocumentName'; txtWordDocumentTemplate='WordDocumentTemplate'; txtWordCustomDisplayProperties='WordCustomDisplayProperties'
|
|
txtWordDocumentationLimitMaxLength='WordDocumentationLimitMaxLength'; txtWordDocumentationLimitTruncateLength='WordDocumentationLimitTruncateLength'
|
|
txtWordTitleProperty='WordTitleProperty'; txtWordSubjectProperty='WordSubjectProperty'; txtWordContentControls='WordContentControls'
|
|
txtWordCoverPage='WordCoverPage'; txtWordHeader1Style='WordHeader1Style'; txtWordHeader2Style='WordHeader2Style'; txtWordHeader3Style='WordHeader3Style'
|
|
txtWordTableStyle='WordTableStyle'; txtWordTableHeaderStyle='WordTableHeaderStyle'; txtWordCategoryHeaderStyle='WordCategoryHeaderStyle'
|
|
txtWordSubCategoryHeaderStyle='WordSubCategoryHeaderStyle'; txtWordTableTextStyle='WordTableTextStyle'
|
|
txtWordScriptTableStyle='WordScriptTableStyle'; txtWordScriptStyle='WordScriptStyle'
|
|
}
|
|
foreach($name in $defaults.Keys) {
|
|
$c = $Form.FindName($name)
|
|
# Some output XAML files don't carry every control yet (e.g. the
|
|
# WPF MD form omits TitleProperty); skip silently rather than
|
|
# NullReferenceException-on-property-set.
|
|
if ($c) { $c.Text = [string](Get-DocumentationSetting $defaults[$name] '') }
|
|
}
|
|
foreach($pair in @(
|
|
@('chkSkipNotConfigured','SkipNotConfigured',$false),@('chkSkipDefaultValues','SkipDefaultValues',$false),@('chkSkipDisabled','SkipDisabled',$true),
|
|
@('chkSetUnconfiguredValue','SetUnconfiguredValue',$true),@('chkSetDefaultValue','SetDefaultValue',$false),@('chkIncludeScripts','IncludeScripts',$true),
|
|
@('chkExcludeScriptSignature','ExcludeScriptSignature',$false),@('chkExcludeAssignments','ExcludeAssignments',$false),@('chkIncludePolicyId','IncludePolicyId',$false),@('chkSkipDocumentInfo','SkipDocumentInfo',$false),@('chkFallbackDocumentation','FallbackDocumentation',$true),
|
|
@('chkCSVAddObjectType','CSVAddObjectType',$true),@('chkCSVAddCompanyName','CSVAddCompanyName',$false),@('chkJsonOpenFile','JSONOpenFile',$true),
|
|
@('chkHTMLOpenFile','HTMLOpenFile',$true),@('chkAtlassianOpenFile','AtlassianOpenFile',$true),
|
|
@('chkMDIncludeCSS','MDIncludeCSS',$true),@('chkMDOpenFile','MDOpenFile',$true),@('chkMDDocumentSkipDate','MDDocumentSkipDate',$false),
|
|
@('chkWordDocumentationLimitAttach','WordDocumentationLimitAttach',$false),@('chkWordAddCategories','WordAddCategories',$true),@('chkWordAddSubCategories','WordAddSubCategories',$true),
|
|
@('chkWordOpenDocument','WordOpenDocument',$true),@('chkWordAttachJsonFile','WordAttachJsonFile',$false)
|
|
)) {
|
|
$c = $Form.FindName($pair[0])
|
|
if ($c) { $c.IsChecked = (Get-DocumentationSetting $pair[1] $pair[2]) -eq $true }
|
|
}
|
|
|
|
# Conditional-visibility wiring: matches the OLD project's per-output-form
|
|
# selectionChanged handlers. The Custom Properties row only appears for
|
|
# Output Properties = "custom"; the limit-length grid only appears for
|
|
# Output Level = "limited".
|
|
Set-WpfDocumentationConditionalVisibility -Form $Form -TriggerName 'cbWordExportProperties' -VisibleWhen 'custom' `
|
|
-TargetNames @('spWordCustomProperties','txtWordCustomDisplayProperties')
|
|
Set-WpfDocumentationConditionalVisibility -Form $Form -TriggerName 'cbWordDocumentationLevel' -VisibleWhen 'limited' `
|
|
-TargetNames @('gdWordDocumentationLimitOptions')
|
|
Set-WpfDocumentationConditionalVisibility -Form $Form -TriggerName 'cbCSVDocumentationProperties' -VisibleWhen 'custom' `
|
|
-TargetNames @('spCSVCustomProperties','txtCSVCustomProperties')
|
|
}
|
|
|
|
function Get-WpfDocumentationOptions {
|
|
param($Form)
|
|
# Missing-control safety: if a XAML file doesn't carry a referenced
|
|
# control (e.g. legacy form without the new field), return $null/empty
|
|
# rather than tripping NullReferenceException. Save-DocumentationOptionsDefaults
|
|
# later filters $null so we don't overwrite the user's persisted setting
|
|
# with garbage on click-Export.
|
|
function Txt($n) { $c = $Form.FindName($n); if ($c) { [string]$c.Text } else { $null } }
|
|
function Sel($n) { $c = $Form.FindName($n); if ($c) { $c.SelectedValue } else { $null } }
|
|
function Chk($n) { $c = $Form.FindName($n); if ($c) { [bool]$c.IsChecked } else { $null } }
|
|
@{
|
|
Language=Sel 'cbDocumentationLanguage'; PropertySeparator=Sel 'cbDocumentationPropertySeparator'; ObjectSeparator=Sel 'cbDocumentationObjectSeparator'; NameFilter=Txt 'txtDocumentFilter'; SourceFolder=Txt 'txtDocumentFromFolder'
|
|
SkipNotConfigured=Chk 'chkSkipNotConfigured'; SkipDefaultValues=Chk 'chkSkipDefaultValues'; SkipDisabled=Chk 'chkSkipDisabled'
|
|
SetUnconfiguredValue=Chk 'chkSetUnconfiguredValue'; SetDefaultValue=Chk 'chkSetDefaultValue'; IncludeScripts=Chk 'chkIncludeScripts'
|
|
ExcludeScriptSignature=Chk 'chkExcludeScriptSignature'; ExcludeAssignments=Chk 'chkExcludeAssignments'; IncludePolicyId=Chk 'chkIncludePolicyId'
|
|
SkipDocumentInfo=Chk 'chkSkipDocumentInfo'; FallbackDocumentation=Chk 'chkFallbackDocumentation'
|
|
NotConfiguredText=Sel 'cbNotConfiguredText'; ValueOutputProperty=Sel 'cbValueOutputProperty'
|
|
Outputs=@{
|
|
csv=@{CSVDocumentationPath=Txt 'txtCSVDocumentationPath';CSVExportProperties=Sel 'cbCSVDocumentationProperties';CSVCustomDisplayProperties=Txt 'txtCSVCustomProperties';CSVDelimiter=Sel 'cbCSVDelimiter';CSVAddObjectType=Chk 'chkCSVAddObjectType';CSVAddCompanyName=Chk 'chkCSVAddCompanyName'}
|
|
json=@{JSONDocumentName=Txt 'txtJsonDocumentName';JSONOpenFile=Chk 'chkJsonOpenFile';JSONOutputFileType=Sel 'cbJsonOutputFileType'}
|
|
html=@{HTMLDocumentName=Txt 'txtHTMLDocumentName';HTMLCSSFile=Txt 'txtHTMLCSSFile';HTMLTitleProperty=Txt 'txtHTMLTitleProperty';HTMLOpenFile=Chk 'chkHTMLOpenFile';HTMLDocumentFileType=Sel 'cbHTMLDocumentFileType'}
|
|
atlassian=@{AtlassianDocumentName=Txt 'txtAtlassianDocumentName';AtlassianTitleProperty=Txt 'txtAtlassianTitleProperty';AtlassianOpenFile=Chk 'chkAtlassianOpenFile';AtlassianDocumentFileType=Sel 'cbAtlassianDocumentFileType'}
|
|
md=@{MDDocumentName=Txt 'txtMDDocumentName';MDCSSFile=Txt 'txtMDCSSFile';MDTitleProperty=Txt 'txtMDTitleProperty';MDIncludeCSS=Chk 'chkMDIncludeCSS';MDOpenFile=Chk 'chkMDOpenFile';MDDocumentSkipDate=Chk 'chkMDDocumentSkipDate';MDDocumentFileType=Sel 'cbMDDocumentFileType'}
|
|
word=@{WordDocumentName=Txt 'txtWordDocumentName';WordDocumentTemplate=Txt 'txtWordDocumentTemplate';WordExportProperties=Sel 'cbWordExportProperties';WordCustomDisplayProperties=Txt 'txtWordCustomDisplayProperties';WordDocumentFormat=Sel 'cbWordDocumentFormat';WordDocumentationLevel=Sel 'cbWordDocumentationLevel';WordDocumentationLimitMaxLength=Txt 'txtWordDocumentationLimitMaxLength';WordDocumentationLimitTruncateLength=Txt 'txtWordDocumentationLimitTruncateLength';WordDocumentationLimitAttach=Chk 'chkWordDocumentationLimitAttach';WordAddCategories=Chk 'chkWordAddCategories';WordAddSubCategories=Chk 'chkWordAddSubCategories';WordOpenDocument=Chk 'chkWordOpenDocument';WordAttachJsonFile=Chk 'chkWordAttachJsonFile';WordTitleProperty=Txt 'txtWordTitleProperty';WordSubjectProperty=Txt 'txtWordSubjectProperty';WordContentControls=Txt 'txtWordContentControls';WordCoverPage=Txt 'txtWordCoverPage';WordHeader1Style=Txt 'txtWordHeader1Style';WordHeader2Style=Txt 'txtWordHeader2Style';WordHeader3Style=Txt 'txtWordHeader3Style';WordTableStyle=Txt 'txtWordTableStyle';WordTableHeaderStyle=Txt 'txtWordTableHeaderStyle';WordCategoryHeaderStyle=Txt 'txtWordCategoryHeaderStyle';WordSubCategoryHeaderStyle=Txt 'txtWordSubCategoryHeaderStyle';WordTableTextStyle=Txt 'txtWordTableTextStyle';WordTableCaptionPosition=Sel 'cbWordTableCaptionPosition';WordScriptTableStyle=Txt 'txtWordScriptTableStyle';WordScriptStyle=Txt 'txtWordScriptStyle'}
|
|
}
|
|
}
|
|
}
|
|
|
|
function Add-WpfDocumentationFileBrowse {
|
|
param($Form, [string]$ButtonName, [string]$TextName, [switch]$Save, [string]$Filter = 'All files (*.*)|*.*')
|
|
$script:UIProvider.AddXamlEvent($Form, $ButtonName, 'add_click', {
|
|
$dialog = if($Save) { [System.Windows.Forms.SaveFileDialog]::new() } else { [System.Windows.Forms.OpenFileDialog]::new() }
|
|
$dialog.Filter = $Filter
|
|
$current = [string]$Form.FindName($TextName).Text
|
|
if($current) { $dialog.FileName = $current }
|
|
if($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
|
|
$Form.FindName($TextName).Text = $dialog.FileName
|
|
}
|
|
}.GetNewClosure())
|
|
}
|
|
|
|
function Set-WpfDocumentationOutputPanel {
|
|
param($Form, [string]$OutputValue)
|
|
foreach($output in [DocumentationRegistry]::Outputs) {
|
|
$panel = $Form.FindName("pnlDocumentationOutput$($output.Name)")
|
|
if($panel) { $panel.Visibility = if($output.Value -eq $OutputValue) { 'Visible' } else { 'Collapsed' } }
|
|
}
|
|
}
|
|
|
|
function Show-GraphBulkDocumentationForm
|
|
{
|
|
param([object[]]$PolicyObject)
|
|
|
|
$script:bulkDocForm = $script:UIProvider.GetXamlObject(($script:AppUIRootFolder + "\Xaml\BulkDocumentationForm.xaml"), $true)
|
|
if(-not $script:bulkDocForm) { return }
|
|
|
|
$script:dgObjectsToDocument = $script:bulkDocForm.FindName("dgObjectsToDocument")
|
|
|
|
# ---- Output-format combo populated from the registry ----
|
|
$cbType = $script:bulkDocForm.FindName("cbDocumentationType")
|
|
if($cbType) {
|
|
$outputs = @([DocumentationRegistry]::Outputs |
|
|
Sort-Object Name |
|
|
ForEach-Object { [PSCustomObject]@{ Name = $_.Name; Value = $_.Value } })
|
|
$cbType.ItemsSource = $outputs
|
|
if($outputs.Count -gt 0) {
|
|
$last = Get-SettingStoreValue "Documentation" "OutputType" "json"
|
|
$match = $outputs | Where-Object Value -eq $last | Select-Object -First 1
|
|
if($match) { $cbType.SelectedValue = $match.Value }
|
|
else { $cbType.SelectedIndex = 0 }
|
|
}
|
|
Set-WpfDocumentationOutputPanel $script:bulkDocForm ([string]$cbType.SelectedValue)
|
|
$cbType.Add_SelectionChanged({
|
|
param($source, $e)
|
|
Set-WpfDocumentationOutputPanel $script:bulkDocForm ([string]$source.SelectedValue)
|
|
})
|
|
}
|
|
|
|
# ---- Restore persisted form values ----
|
|
$script:UIProvider.SetXamlProperty($script:bulkDocForm, "txtDocumentationOutputFolder", "Text", [string](Get-SettingStoreValue "Documentation" "OutputFolder" ""))
|
|
$script:UIProvider.SetXamlProperty($script:bulkDocForm, "txtDocumentFromFolder", "Text", [string](Get-DocumentationSetting 'SourceFolder' ''))
|
|
$script:UIProvider.SetXamlProperty($script:bulkDocForm, "txtDocumentFilter", "Text", [string](Get-DocumentationSetting 'NameFilter' ''))
|
|
Initialize-WpfDocumentationOptions $script:bulkDocForm
|
|
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "browseDocumentationOutputFolder", "add_click", {
|
|
$current = $script:UIProvider.GetXamlProperty($script:bulkDocForm, "txtDocumentationOutputFolder", "Text")
|
|
$folder = Get-Folder $current "Select root folder for documentation"
|
|
if($folder) {
|
|
$script:UIProvider.SetXamlProperty($script:bulkDocForm, "txtDocumentationOutputFolder", "Text", $folder)
|
|
}
|
|
})
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "browseDocumentFromFolder", "add_click", {
|
|
$current = $script:UIProvider.GetXamlProperty($script:bulkDocForm, "txtDocumentFromFolder", "Text")
|
|
$folder = Get-Folder $current "Select exported source folder"
|
|
if($folder) {
|
|
$script:UIProvider.SetXamlProperty($script:bulkDocForm, "txtDocumentFromFolder", "Text", $folder)
|
|
}
|
|
})
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "browseCSVDocumentationPath", "add_click", {
|
|
$current = $script:UIProvider.GetXamlProperty($script:bulkDocForm, "txtCSVDocumentationPath", "Text")
|
|
$folder = Get-Folder $current "Select CSV documentation folder"
|
|
if($folder) { $script:UIProvider.SetXamlProperty($script:bulkDocForm, "txtCSVDocumentationPath", "Text", $folder) }
|
|
})
|
|
# Registry-driven browse-button wiring. Each output provider that has
|
|
# file-picker inputs on the bulk-doc form attaches a FileBrowseControls
|
|
# array to its [DocumentationRegistry] entry from a matching WPF
|
|
# ClassExtensions file (UI/WPF/ClassExtensions/DocumentationOutput<X>UIExtension.ps1).
|
|
# Adding a new provider with browse buttons requires no edit here — just
|
|
# drop a ClassExtensions file that Add-Member's onto the provider.
|
|
foreach($output in [DocumentationRegistry]::Outputs) {
|
|
if(-not $output.PSObject.Properties['FileBrowseControls']) { continue }
|
|
foreach($fb in @($output.FileBrowseControls)) {
|
|
$params = @{ Form = $script:bulkDocForm; ButtonName = $fb.Button; TextName = $fb.TextBox }
|
|
if($fb.Save) { $params['Save'] = $true }
|
|
if($fb.Filter) { $params['Filter'] = $fb.Filter }
|
|
Add-WpfDocumentationFileBrowse @params
|
|
}
|
|
}
|
|
|
|
# ---- Object list (same filter as Bulk Export) ----
|
|
$script:bulkDocDocumentableGroups = @($script:IntuneGroups | Where-Object {
|
|
$_.Title -and (-not ($_.ShowButtons -is [Object[]]) -or $_.ShowButtons -contains "Document")
|
|
})
|
|
$script:bulkDocPolicyObjects = Get-UIItemsArray $PolicyObject
|
|
|
|
# Selected column with header-checkbox toggle-all
|
|
$column = Get-GridCheckboxColumn "Selected"
|
|
$script:dgObjectsToDocument.Columns.Add($column)
|
|
$column.Header.IsChecked = $true
|
|
$column.Header.add_Click({
|
|
foreach($item in $script:dgObjectsToDocument.ItemsSource) {
|
|
$item.Selected = $this.IsChecked
|
|
}
|
|
$script:dgObjectsToDocument.Items.Refresh()
|
|
})
|
|
|
|
# Title column
|
|
$binding = [System.Windows.Data.Binding]::new("Title")
|
|
$titleCol = [System.Windows.Controls.DataGridTextColumn]::new()
|
|
$titleCol.Header = if($script:bulkDocPolicyObjects.Count -gt 0) { "Title" } else { "Object type" }
|
|
$titleCol.IsReadOnly = $true
|
|
$titleCol.Binding = $binding
|
|
$script:dgObjectsToDocument.Columns.Add($titleCol)
|
|
|
|
$script:bulkDocMode = if($script:bulkDocPolicyObjects.Count -gt 0) { "Object" } else { "Group" }
|
|
$listBy = $script:bulkDocForm.FindName("pnlDocumentationListBy")
|
|
if($listBy) { $listBy.Visibility = if($script:bulkDocMode -eq "Object") { "Collapsed" } else { "Visible" } }
|
|
foreach($bulkOnlyControlName in @("lblDocumentFilter","txtDocumentFilter","lblDocumentFromFolder","pnlDocumentFromFolder")) {
|
|
$bulkOnlyControl = $script:bulkDocForm.FindName($bulkOnlyControlName)
|
|
if($bulkOnlyControl) { $bulkOnlyControl.Visibility = if($script:bulkDocMode -eq "Object") { "Collapsed" } else { "Visible" } }
|
|
}
|
|
Update-BulkDocumentationObjectList
|
|
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "rbBulkDocViewGroup", "add_Checked", {
|
|
$script:bulkDocMode = "Group"
|
|
Update-BulkDocumentationObjectList
|
|
})
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "rbBulkDocViewType", "add_Checked", {
|
|
$script:bulkDocMode = "Type"
|
|
Update-BulkDocumentationObjectList
|
|
})
|
|
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "btnClose", "add_click", {
|
|
$script:bulkDocForm = $null
|
|
$script:bulkDocPolicyObjects = $null
|
|
Show-ModalObject
|
|
})
|
|
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "btnDocument", "add_click", {
|
|
try {
|
|
Write-Status "Initializing documentation"
|
|
$selection = if($script:bulkDocMode -eq "Object") { Get-BulkDocumentationSelectedObjects } else { Get-BulkDocumentationSelectedIds }
|
|
$unit = if($script:bulkDocMode -eq "Object") { "policy" } elseif($script:bulkDocMode -eq "Type") { "policy type" } else { "object group" }
|
|
if($selection.Count -eq 0) {
|
|
$script:UIProvider.ShowMessageBox("Select at least one $unit to document.", "Bulk Documentation", "OK", "Warning") | Out-Null
|
|
return
|
|
}
|
|
|
|
$cb = $script:bulkDocForm.FindName("cbDocumentationType")
|
|
$outputValue = if($cb) { [string]$cb.SelectedValue } else { $null }
|
|
if(-not $outputValue) {
|
|
$script:UIProvider.ShowMessageBox("Select an output format.", "Bulk Documentation", "OK", "Warning") | Out-Null
|
|
return
|
|
}
|
|
|
|
$rawFolder = $script:UIProvider.GetXamlProperty($script:bulkDocForm, "txtDocumentationOutputFolder", "Text")
|
|
if($rawFolder) { $rawFolder = ([string]$rawFolder).Trim().Trim('"').Trim("'") }
|
|
$options = Get-WpfDocumentationOptions $script:bulkDocForm
|
|
if(-not $rawFolder) {
|
|
# Registry-driven fallback: consult the provider's declared
|
|
# PrimaryPathOption to find its persisted path, and PathIsFolder to
|
|
# decide whether the persisted value is already a folder (CSV) or a
|
|
# file whose parent we need to take. Adding a provider requires no
|
|
# change here — it just declares the two fields on registration.
|
|
$provider = [DocumentationRegistry]::FindOutput($outputValue)
|
|
$selectedPath = if($provider -and $provider.PSObject.Properties['PrimaryPathOption'] -and $provider.PrimaryPathOption) {
|
|
$providerOpts = $options.Outputs[$outputValue]
|
|
if($providerOpts) { $providerOpts[$provider.PrimaryPathOption] }
|
|
}
|
|
if($selectedPath) {
|
|
$rawFolder = if($provider -and $provider.PSObject.Properties['PathIsFolder'] -and $provider.PathIsFolder) { $selectedPath }
|
|
else { Split-Path -Parent $selectedPath }
|
|
}
|
|
if(-not $rawFolder) { $rawFolder = [Environment]::GetFolderPath('MyDocuments') }
|
|
}
|
|
try { $resolvedFolder = [IO.Path]::GetFullPath($rawFolder) }
|
|
catch {
|
|
$script:UIProvider.ShowMessageBox("Invalid output folder path: $($_.Exception.Message)", "Bulk Documentation", "OK", "Error") | Out-Null
|
|
return
|
|
}
|
|
|
|
$language = [string]$options.Language
|
|
if(-not $language) { $language = 'en' }
|
|
$defaultName = "%Organization%-%Date%"
|
|
if(-not $options.Outputs.csv.CSVDocumentationPath) { $options.Outputs.csv.CSVDocumentationPath = $resolvedFolder }
|
|
if(-not $options.Outputs.json.JSONDocumentName) { $options.Outputs.json.JSONDocumentName = Join-Path $resolvedFolder "$defaultName.json" }
|
|
if(-not $options.Outputs.html.HTMLDocumentName) { $options.Outputs.html.HTMLDocumentName = Join-Path $resolvedFolder "$defaultName.html" }
|
|
# Confluence storage format is XHTML, so .html keeps it openable in a browser.
|
|
if(-not $options.Outputs.atlassian.AtlassianDocumentName) { $options.Outputs.atlassian.AtlassianDocumentName = Join-Path $resolvedFolder "$defaultName.html" }
|
|
if(-not $options.Outputs.md.MDDocumentName) { $options.Outputs.md.MDDocumentName = Join-Path $resolvedFolder "$defaultName.md" }
|
|
if(-not $options.Outputs.word.WordDocumentName) { $options.Outputs.word.WordDocumentName = Join-Path $resolvedFolder "$defaultName.docx" }
|
|
|
|
# Persist form state for next time
|
|
Save-SettingStoreValue "Documentation" "OutputType" $outputValue
|
|
Save-SettingStoreValue "Documentation" "OutputFolder" $resolvedFolder
|
|
Save-DocumentationOptionsDefaults $options
|
|
$startParams = @{
|
|
OutputFormat = $outputValue
|
|
Language = $language
|
|
Options = $options
|
|
}
|
|
if($script:bulkDocMode -ne "Object" -and $options.SourceFolder) { $startParams.SourceFolder = $options.SourceFolder }
|
|
if($script:bulkDocMode -eq "Type") {
|
|
$startParams.PolicyType = $selection
|
|
}
|
|
elseif($script:bulkDocMode -eq "Group") {
|
|
$startParams.PolicyGroup = $selection
|
|
}
|
|
|
|
Write-Log "Documentation starting. Mode=$script:bulkDocMode Format=$outputValue Folder=$resolvedFolder Selection=$($selection -join ',')"
|
|
try {
|
|
if($script:bulkDocMode -eq "Object") {
|
|
[void]($selection | Start-GraphBulkDocumentation @startParams)
|
|
}
|
|
else {
|
|
[void](Start-GraphBulkDocumentation @startParams)
|
|
}
|
|
Write-Status $null
|
|
$script:UIProvider.ShowMessageBox(("Documentation finished. Output folder:`n{0}" -f $resolvedFolder), "Bulk Documentation", "OK", "Information") | Out-Null
|
|
}
|
|
catch {
|
|
Write-LogError "Bulk documentation failed" $_.Exception
|
|
$script:UIProvider.ShowMessageBox("Bulk documentation failed: $($_.Exception.Message)", "Bulk Documentation", "OK", "Error") | Out-Null
|
|
}
|
|
}
|
|
finally {
|
|
Write-Status $null
|
|
}
|
|
})
|
|
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "btnPreviewDocumentation", "add_click", {
|
|
$selection = if($script:bulkDocMode -eq "Object") { Get-BulkDocumentationSelectedObjects } else { Get-BulkDocumentationSelectedIds }
|
|
if($selection.Count -eq 0) { return }
|
|
$options = Get-WpfDocumentationOptions $script:bulkDocForm
|
|
$params = if($script:bulkDocMode -eq 'Type') { @{PolicyType=$selection} } elseif($script:bulkDocMode -eq 'Group') { @{PolicyGroup=$selection} } else { @{} }
|
|
if($script:bulkDocMode -eq 'Object') {
|
|
$policies = $selection
|
|
}
|
|
elseif($options.SourceFolder) {
|
|
$options.SourceTenantUnavailable = $true
|
|
Initialize-DocumentationSourceTenantContext -SourceFolder $options.SourceFolder
|
|
$policies = Get-DocumentationPoliciesFromSourceFolder -SourceFolder $options.SourceFolder @params
|
|
} else {
|
|
$policies = Get-GraphPolicies @params
|
|
}
|
|
$script:bulkDocPreview = @($policies | Select-Object -First 5 | Get-GraphDocumentation -Language $options.Language -Options $options)
|
|
$script:bulkDocForm.FindName('txtDocumentationRawData').Text = ($script:bulkDocPreview | ConvertTo-Json -Depth 10)
|
|
})
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "btnCopyBasicDocumentation", "add_click", {
|
|
@($script:bulkDocPreview | ForEach-Object BasicInfo) | Select-Object Name,Value | ConvertTo-Csv -NoTypeInformation | Set-Clipboard
|
|
})
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "btnCopySettingsDocumentation", "add_click", {
|
|
@($script:bulkDocPreview | ForEach-Object FilteredSettings) | ConvertTo-Csv -NoTypeInformation | Set-Clipboard
|
|
})
|
|
$script:UIProvider.AddXamlEvent($script:bulkDocForm, "btnCopyRawDocumentation", "add_click", {
|
|
$script:bulkDocForm.FindName('txtDocumentationRawData').Text | Set-Clipboard
|
|
})
|
|
|
|
$title = if($script:bulkDocMode -eq 'Object') { 'Document' } else { 'Bulk Documentation' }
|
|
$script:UIProvider.ShowModalForm($title, $script:bulkDocForm, $true)
|
|
}
|
|
|
|
function Update-BulkDocumentationObjectList
|
|
{
|
|
if(-not $script:dgObjectsToDocument) { return }
|
|
|
|
$script:documentObjects = @()
|
|
|
|
if($script:bulkDocMode -eq "Object") {
|
|
foreach($policy in ($script:bulkDocPolicyObjects | Sort-Object Name)) {
|
|
$script:documentObjects += New-Object PSObject -Property @{
|
|
Title = $policy.Name
|
|
Selected = $true
|
|
ObjectGroup = $null
|
|
ObjectType = $policy.PolicyType
|
|
PolicyObject = $policy
|
|
}
|
|
}
|
|
}
|
|
elseif($script:bulkDocMode -eq "Type") {
|
|
$documentableGroupIds = @($script:bulkDocDocumentableGroups | ForEach-Object { $_.Id })
|
|
$sortedTypes = $script:IntuneTypes |
|
|
Where-Object { $_.PolicyGroup -and ($documentableGroupIds -contains $_.PolicyGroup.Id) } |
|
|
Sort-Object Title
|
|
foreach($intuneType in $sortedTypes) {
|
|
$script:documentObjects += New-Object PSObject -Property @{
|
|
Title = $intuneType.Title
|
|
Selected = $true
|
|
ObjectGroup = $null
|
|
ObjectType = $intuneType
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
$sortedGroups = $script:bulkDocDocumentableGroups | Sort-Object Title
|
|
foreach($intuneGroup in $sortedGroups) {
|
|
$script:documentObjects += New-Object PSObject -Property @{
|
|
Title = $intuneGroup.Title
|
|
Selected = $true
|
|
ObjectGroup = $intuneGroup
|
|
ObjectType = $null
|
|
}
|
|
}
|
|
}
|
|
|
|
$script:dgObjectsToDocument.ItemsSource = $script:documentObjects
|
|
}
|
|
|
|
function Get-BulkDocumentationSelectedIds
|
|
{
|
|
if($script:bulkDocMode -eq "Type") {
|
|
return @($script:documentObjects |
|
|
Where-Object { $_.Selected -eq $true -and $_.ObjectType -and $_.ObjectType.Id } |
|
|
ForEach-Object { $_.ObjectType.Id })
|
|
}
|
|
return @($script:documentObjects |
|
|
Where-Object { $_.Selected -eq $true -and $_.ObjectGroup -and $_.ObjectGroup.Id } |
|
|
ForEach-Object { $_.ObjectGroup.Id })
|
|
}
|
|
|
|
function Get-BulkDocumentationSelectedObjects
|
|
{
|
|
return @($script:documentObjects |
|
|
Where-Object { $_.Selected -eq $true -and $_.PolicyObject } |
|
|
ForEach-Object { $_.PolicyObject })
|
|
}
|
|
|
|
# Compatibility wrapper for the main-view Document button. The shared form
|
|
# switches to Object mode and displays the selected policies.
|
|
function Show-IntuneManagerDocumentForm
|
|
{
|
|
param([object[]]$PolicyObject)
|
|
|
|
if (-not $PolicyObject -or $PolicyObject.Count -eq 0) {
|
|
$script:UIProvider.ShowMessageBox("No items to document.", "Document", "OK", "Warning") | Out-Null
|
|
return
|
|
}
|
|
|
|
Show-GraphBulkDocumentationForm -PolicyObject $PolicyObject
|
|
}
|
|
|
|
#endregion
|
|
|
|
#endregion
|