Improve transpose #316

Author: PrzemyslawKlys

CHANGELOG.MD

@@ -4,9 +4,60 @@
 Unfortunetly some code is very old, some code doesn't serve it's purpose anymore, and requires heavy changes that may have an impact on already deployed code.
 Please make sure to read changes before updating, as we're undergoing some breaking changes.
 
+## 1.21.0 - 2024.06.29
+- Changed behavior of `Transpose` in `New-HTMLTable` / `Out-HtmlView`
+- Added `TransposeLegacy` to `New-HTMLTable` / `Out-HtmlView` to keep old behavior
+- Added `TransposeName` to `New-HTMLTable` / `Out-HtmlView` to allow for custom name (default is `Object 0`, `Object 1`, `Object 2`)
+- Added `TransposeProperty` to `New-HTMLTable` / `Out-HtmlView` to allow for transposing on unique value from specific property (ex. ServerName)
+- Added `Out-HtmlView` additional options `PrettifyObject, PrettifyObjectSeparator, PrettifyObjectDateTimeFormat`
+
+Those changes resolve: [#316](https://github.com/EvotecIT/PSWriteHTML/issues/316)
+
+```powershell
+$Object = @(
+    [PSCustomObject] @{
+        Test  = 5
+        Ello  = 'Motto'
+        Hello = 'Totto'
+    }
+    [PSCustomObject] @{
+        Test  = 5
+        Ello  = 'Motto'
+        Hello = 'Totto'
+    }
+    [PSCustomObject] @{
+        Test  = 5
+        Ello  = 'Motto'
+        Hello = 'Totto'
+    }
+    [PSCustomObject] @{
+        Test  = 5
+        Ello  = 'Motto'
+        Hello = 'Totto'
+    }
+    [PSCustomObject] @{
+        Test  = 5
+        Ello  = 'Motto'
+        Hello = 'Totto'
+    }
+    [PSCustomObject] @{
+        Test  = 3
+        Ello  = 'Lotto'
+        Hello = 'Totto'
+    }
+)
+
+
+$Object | Out-HtmlView -Transpose -TransposeName 'Test ' -Filtering
+
+New-HTML -TitleText $Title -Online -FilePath $PSScriptRoot\Example-TableTranspose01.html {
+    New-HTMLTable -DataTable $Object -Filtering -Transpose
+} -ShowHTML
+```
+
 ## 1.20.0 - 2024.06.27
-- Added to `EmailTable` / `New-HTMLTable` additional properties `PrettifyObject, PrettifyObjectSeparator, PrettifyObjectDateTimeFormat`
-- Added to `New-HTMLTableOption` additional properties `PrettifyObject, PrettifyObjectSeparator, PrettifyObjectDateTimeFormat`
+- Added to `EmailTable` / `New-HTMLTable` additional options `PrettifyObject, PrettifyObjectSeparator, PrettifyObjectDateTimeFormat`
+- Added to `New-HTMLTableOption` additional options `PrettifyObject, PrettifyObjectSeparator, PrettifyObjectDateTimeFormat`
 
 Those options above allow object to be translated to more readable format when using properties that are arrays or when wanting different datetime format
 It basically does to HTML version what normally is doable in JavaScript DataStore.

Public/New-HTMLTable.ps1

@@ -223,7 +223,16 @@ function New-HTMLTable {
     Parameter description
 
     .PARAMETER Transpose
-    Parameter description
+    Transpose table. This is useful when you have objects and you want to transpose them.
+
+    .PARAMETER TransposeProperty
+    Transpose table based on property. By default it's "Object X". This makes sense if you have unique value per object that you want to transpose table based on.
+
+    .PARAMETER TransposeName
+    Name of the column that will be used per object to transpose table. By default it's "Object X", "Object Y", "Object Z" etc.
+
+    .PARAMETER TransposeLegacy
+    Use old method of transposing table. This is useful when you have objects and you want to transpose them, using legacy method.
 
     .PARAMETER OverwriteDOM
     Parameter description
@@ -339,6 +348,9 @@ function New-HTMLTable {
         [alias('DataTableName')][string] $DataTableID,
         [string] $DataStoreID,
         [switch] $Transpose,
+        [string] $TransposeProperty,
+        [string] $TransposeName,
+        [switch] $TransposeLegacy,
         [string] $OverwriteDOM,
         [switch] $SearchHighlight,
         [switch] $AlphabetSearch,
@@ -424,7 +436,19 @@ function New-HTMLTable {
 
     if ($Transpose) {
         # Allows easy conversion from PSCustomObject to Hashtable and vice versa
-        $DataTable = Format-TransposeTable -Object $DataTable
+        $formatTransposeTableSplat = @{
+            AllObjects = $DataTable
+        }
+        if ($TransposeProperty) {
+            $formatTransposeTableSplat['Property'] = $TransposeProperty
+        }
+        if ($TransposeName) {
+            $formatTransposeTableSplat['Name'] = $TransposeName
+        }
+        if ($TransposeLegacy) {
+            $formatTransposeTableSplat['Legacy'] = $true
+        }
+        $DataTable = Format-TransposeTable @formatTransposeTableSplat
     }
     if ($FlattenObject) {
         if ($FlattenDepth) {

Public/Out-HTMLView.ps1

@@ -100,14 +100,20 @@ function Out-HtmlView {
         [ValidateSet('top', 'bottom')][string] $SearchBuilderLocation = 'top',
         [ValidateSet('HTML', 'JavaScript', 'AjaxJSON')][string] $DataStore,
         [switch] $Transpose,
+        [string] $TransposeProperty,
+        [string] $TransposeName,
+        [switch] $TransposeLegacy,
         [switch] $PreventShowHTML,
         [switch] $Online,
         [string] $OverwriteDOM,
         [switch] $SearchHighlight,
         [switch] $AlphabetSearch,
         [switch] $FuzzySearch,
         [switch] $FuzzySearchSmartToggle,
-        [switch] $FlattenObject
+        [switch] $FlattenObject,
+        [switch] $PrettifyObject,
+        [string] $PrettifyObjectSeparator = ", ",
+        [string] $PrettifyObjectDateTimeFormat
     )
     Begin {
         $DataTable = [System.Collections.Generic.List[Object]]::new()
@@ -177,7 +183,6 @@ function Out-HtmlView {
                     Simplify                     = $Simplify
                     HideShowButton               = $HideShowButton
                     CompareReplace               = $CompareReplace
-                    Transpose                    = $Transpose
                     SearchRegularExpression      = $SearchRegularExpression
                     WordBreak                    = $WordBreak
                     AutoSize                     = $AutoSize
@@ -205,6 +210,27 @@ function Out-HtmlView {
                     FlattenObject                = $FlattenObject
                     CompareNames                 = $CompareNames
                 }
+                if ($Transpose) {
+                    $newHTMLTableSplat['Transpose'] = $Transpose.IsPresent
+                    if ($TransposeProperty) {
+                        $newHTMLTableSplat['TransposeProperty'] = $TransposeProperty
+                    }
+                    if ($TransposeName) {
+                        $newHTMLTableSplat['TransposeName'] = $TransposeName
+                    }
+                    if ($TransposeLegacy) {
+                        $newHTMLTableSplat['TransposeLegacy'] = $TransposeLegacy
+                    }
+                }
+                if ($PrettifyObject) {
+                    $newHTMLTableSplat['PrettifyObject'] = $PrettifyObject.IsPresent
+                    if ($PrettifyObjectSeparator) {
+                        $newHTMLTableSplat['PrettifyObjectSeparator'] = $PrettifyObjectSeparator
+                    }
+                    if ($PrettifyObjectDateTimeFormat) {
+                        $newHTMLTableSplat['PrettifyObjectDateTimeFormat'] = $PrettifyObjectDateTimeFormat
+                    }
+                }
                 Remove-EmptyValue -Hashtable $newHTMLTableSplat
                 New-HTMLTable @newHTMLTableSplat