SystemAdmins.M365Assessment

1.0.12

private/helper/html/Set-HtmlReview.ps1

function Set-HtmlReview
{
    <#
    .SYNOPSIS
        Replace markdown content with view data.
    .DESCRIPTION
        Returns HTML (fragment) code.
    .EXAMPLE
        Set-HtmlReview -Path 'C:\path\to\report.md' -Review $review;
    #>
    [cmdletbinding()]
    param
    (
        [Parameter(Mandatory = $true)]
        [string]$Path,

        [Parameter(Mandatory = $true)]
        [Review]$Review
    )

    BEGIN
    {
        # If the file does not exist, throw an error.
        if (-not (Test-Path -Path $Path -PathType Leaf))
        {
            # Throw exception.
            throw ("Markdown file '{0}' does not exist" -f $Path);
        }
    }
    PROCESS
    {
        # Convert from Markdown to HTML.
        $htmlContent = (ConvertFrom-Markdown -Path $Path).Html;

        # Write to log.
        Write-CustomLog -Category 'Report' -Subcategory 'HTML' -Message ("Replacing ID with '{0}'" -f $Review.Id) -Level Verbose;
        Write-CustomLog -Category 'Report' -Subcategory 'HTML' -Message ("Replacing CATEGORY with '{0}'" -f $Review.Category) -Level Verbose;
        Write-CustomLog -Category 'Report' -Subcategory 'HTML' -Message ("Replacing SUBCATEGORY with '{0}'" -f $Review.Subcategory) -Level Verbose;
        Write-CustomLog -Category 'Report' -Subcategory 'HTML' -Message ("Replacing TITLE with '{0}'" -f $Review.Title) -Level Verbose;
        Write-CustomLog -Category 'Report' -Subcategory 'HTML' -Message ("Replacing REVIEW with '{0}'" -f $Review.Review) -Level Verbose;
        Write-CustomLog -Category 'Report' -Subcategory 'HTML' -Message ("Replacing DATE with '{0}'" -f (Get-Date).ToString('yyyy-MM-dd', [CultureInfo]::InvariantCulture)) -Level Verbose;

        # Update the content of the file.
        $htmlContent = $htmlContent.Replace('{{ID}}', $Review.Id);
        $htmlContent = $htmlContent.Replace('{{CATEGORY}}', $Review.Category);
        $htmlContent = $htmlContent.Replace('{{SUBCATEGORY}}', $Review.Subcategory);
        $htmlContent = $htmlContent.Replace('{{TITLE}}', $Review.Title);
        $htmlContent = $htmlContent.Replace('{{REVIEW}}', $Review.Review);
        $htmlContent = $htmlContent.Replace('{{DATE}}', (Get-Date).ToString('yyyy-MM-dd', [CultureInfo]::InvariantCulture));

        # Convert review data to HTML.
        $reviewData = $Review.Data | ConvertTo-Html -Fragment;

        # Add to content.
        $htmlContent += $reviewData;

        # Add div.
        $htmlContent = '<div id="review-{0}" class="review">{1}</div>' -f $Review.Id, $htmlContent;
    }
    END
    {
        # Return HTML.
        return $htmlContent;
    }
}