Public/Template/Find-CardTemplateTag.ps1
|
<#
.SYNOPSIS Discovers all template tags within an Adaptive Card content structure. .DESCRIPTION The Find-CardTemplateTags function analyzes an Adaptive Card content hashtable and identifies all template tag placeholders (in the format "!{{TagName}}") that can be replaced with dynamic content. This is useful for understanding what replaceable elements exist in a template before using Build-CardFromTemplate to populate them with actual data. .PARAMETER Content A hashtable representing the Adaptive Card content structure to search for template tags. This is typically the output from card creation functions like New-CardContainer, New-CardTextBlock, etc. .OUTPUTS System.String[] Returns an array of unique template tag names found within the content structure. Returns an empty array if no template tags are found. .EXAMPLE $template = New-CardContainer -Content { New-CardTextBlock -Text (New-CardTemplateTag -TagName "UserName") New-CardTextBlock -Text (New-CardTemplateTag -TagName "Message") New-CardTextBlock -Text (New-CardTemplateTag -TagName "UserName") # Duplicate } Find-CardTemplateTags -Content $template # Returns: @("UserName", "Message") .EXAMPLE $complexTemplate = New-CardContainer -Content { New-CardTextBlock -Text "Welcome, !{{Name}}!" New-CardFactSet -Facts @{ "Department" = (New-CardTemplateTag -TagName "Dept") "Role" = (New-CardTemplateTag -TagName "Position") } } $tags = Find-CardTemplateTags -Content $complexTemplate # Returns: @("Name", "Dept", "Position") .EXAMPLE $noTagsTemplate = New-CardContainer -Content { New-CardTextBlock -Text "Static content only" } Find-CardTemplateTags -Content $noTagsTemplate # Returns: @() (empty array) .NOTES - The function performs a deep search through the entire content structure by converting to JSON - Template tags must be in the exact format "!{{TagName}}" to be detected - Duplicate tag names are automatically deduplicated in the results - The function is case-sensitive and will treat "!{{Name}}" and "!{{name}}" as different tags - This function is typically used for template validation and debugging purposes .LINK New-CardTemplateTag .LINK Build-CardFromTemplate #> function Find-CardTemplateTag { param ( [hashtable]$Content ) $TemplateAsJson = $Content | ConvertTo-Json -Depth 10 $TagPattern = '!{{(.*?)}}' $TagMatches = [regex]::Matches($TemplateAsJson, $TagPattern) if ($TagMatches.Count -eq 0) { return @() } return $TagMatches | ForEach-Object { $_.Groups[1].Value } | Select-Object -Unique } #Alias for function name for reverse compatibility Set-Alias -Name Find-CardTemplateTags -Value Find-CardTemplateTag -Force |