Il fut un temps o\u00f9 me demandait r\u00e9guli\u00e8rement de g\u00e9n\u00e9rer des rapports de sant\u00e9 qu’il fallait envoyer quotidiennement par mail. Vous me direz : il est fou, pourquoi cr\u00e9er des script de reporting alors qu’il suffit de deux mot dans son moteur de recherche pr\u00e9f\u00e9r\u00e9 pour obtenir tout ce qu’il faut !<\/p>\n\n\n\n
A cela je r\u00e9pondrait :<\/p>\n\n\n\n
Comme vous l’avez vous dans mon article pr\u00e9c\u00e9dent<\/a>, il est tr\u00e8s facile de cr\u00e9er un module PowerShell. Alors pourquoi ne pas se faire un module custom pour g\u00e9n\u00e9rer de beaux rapports HTML ? C’est ce que j’ai fait avec le module wks_htmlReporting<\/a>.<\/p>\n\n\n\n PowerShell permet facilement de g\u00e9n\u00e9rer du code HTML simple et notamment de convenir des objets en table HTML : ConvertTo-HTML<\/a>. Par d\u00e9faut la cmd-let g\u00e9n\u00e8re le code complet d’une page HTML. Si on lui fournit un objet en entr\u00e9e, il va l’int\u00e9grer dans un tableau. Voici un exemple :<\/p>\n\n\n Mais pour le coup, c’est pas trop sexy \ud83d\ude41 Le plus simple est de demander de l’aide \ud83d\ude42 Je suis donc parti sur l’utilisation de Bootstrap <\/a>et Chart.js<\/a>. Je vous invite \u00e0 jeter un \u0153il sur leurs sites respectifs. Techniquement on proc\u00e9dera comme suit:<\/p>\n\n\n\n Le module se base sur une approche orient\u00e9e objet afin de fournir de la flexibilit\u00e9 dans son utilisation.<\/p>\n\n\n\n On dispose de 3 classes :<\/p>\n\n\n\n Rien de plus facile, il est publi\u00e9 dans la PowerShell Gallery<\/p>\n\n\n Voici un exemple avec la liste des services Windows du poste local.<\/p>\n\n\n On obtient alors un rapport avec un seul paragraphe et une table. N\u00e9anmoins, de base on a :<\/p>\n\n\n\n Pas mal pour un d\u00e9but ?<\/p>\n\n\n\n Faire un tableau c’est bien mais moi les rapports je pr\u00e9f\u00e8re les regarder, pas les lires \ud83d\ude41 Pour ajouter un graphique, on cr\u00e9\u00e9 un objet htmlItem suppl\u00e9mentaire de type Chart. La seule subtilit\u00e9 est que les donn\u00e9es qui servent au graphique doivent \u00eatre fournies sous forme de HashTable. C’est ce que je fais en cr\u00e9ant la variable $dataChart1. Alors, \u00e7a commence \u00e0 ressembler \u00e0 un vrai rapport, non ?<\/p>\n\n\n\n Maintenant qu’on a un graphique qui synth\u00e9tise des \u00e9l\u00e9ments du tableau juste en dessous, je me suis dit : on n’est pas trop mal, mais ce serait bien de pouvoir cliquer sur le graphique afin de filtrer automatiquement le tableau. N’est-ce pas ?<\/p>\n\n\n\n Et bien rien de plus simple, il suffit d’ajouter les param\u00e8tres \u00e0 l’item Chart afin de r\u00e9f\u00e9rencer l’item Table et le champ \u00e0 filtrer… Ah, je vous ait perdu. Regardez l’exemple, c’est hyper intuitif en fait \ud83d\ude09 Il suffit d’ajouter 3 param\u00e8tre quand on cr\u00e9\u00e9 le htlmItemChart :<\/p>\n\n\n Les points \u00e0 noter sont :<\/p>\n\n\n\n Bon c’est pas du grafana, c’est c’est cool non !<\/p>\n\n\n\n Voil\u00e0 pour le usages simple du module wks_htmlReporting. Il fut un temps o\u00f9 me demandait r\u00e9guli\u00e8rement de g\u00e9n\u00e9rer des rapports de sant\u00e9 qu’il fallait envoyer quotidiennement par mail. Vous me direz : il est fou, pourquoi cr\u00e9er des script de reporting alors qu’il suffit de deux mot dans son moteur de recherche pr\u00e9f\u00e9r\u00e9 pour obtenir tout ce qu’il faut ! A cela je […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[12,8,10],"class_list":["post-62","post","type-post","status-publish","format-standard","hentry","category-dev","tag-html","tag-powershell","tag-tips"],"_links":{"self":[{"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/posts\/62","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/comments?post=62"}],"version-history":[{"count":6,"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/posts\/62\/revisions"}],"predecessor-version":[{"id":76,"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/posts\/62\/revisions\/76"}],"wp:attachment":[{"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/media?parent=62"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/categories?post=62"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kev-it.fr\/index.php\/wp-json\/wp\/v2\/tags?post=62"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Comment faire du HTML en PowerShell ?<\/h2>\n\n\n\n
\nGet-Service | ConvertTo-Html\n<\/pre><\/div>\n\n\n
Heureusement, on peut faire beaucoup mieux :<\/p>\n\n\n\n\n
Comment faire des graphiques ?<\/h2>\n\n\n\n
Il faut que la page HTML soit autonome, donc un seul fichier et pas de traitement c\u00f4t\u00e9 serveurs. Ca limite les options. La conclusion logique est : Javascript !<\/p>\n\n\n\n\n
Comment utiliser la librairie de K\u00e9vin ?<\/h2>\n\n\n\n
Fonctionnement du module et architecture du rapport<\/h3>\n\n\n\n
\n
Installer le module PowerShell<\/h3>\n\n\n\n
\nInstall-module wks_htmlReporting\n<\/pre><\/div>\n\n\n
Cr\u00e9er un rapport simple<\/h3>\n\n\n\n
\n# Initialize script\n$filename = "$($env:temp)\\wks_htmlReporting.html"\n# Generate simple data\n$services = get-service |select status, name, DisplayName\n\n# Create a section\n$section1 = new-htmlSection "Services Windows" -foldable -folded\n# Adds a simple table to the section\n$section1 |add-htmlSectionItem -itemList (\n new-htmlItemTable -dataset $services\n)\n# Creates a Report\n$report = new-htmlReport -title "Rapport sur les services Windows" `\n -subtitle "Feature demonstration of the <b>wks_htmlReporting<\/b> module" `\n# Add section to report \n$report |add-htmlReportSection -sectionList ($section1)\n# Export report to HTML file\n$report.toFile($filename)\n<\/pre><\/div>\n\n\n
\n
Ajouter des graphiques<\/h3>\n\n\n\n
Je veux des graphiques ! Allez, qu’\u00e0 cela ne tienne, on va ajouter des Items dans la Section.
Je reprends le script pr\u00e9c\u00e9dent pour ajouter mes graphiques :<\/p>\n\n\n\n# Define output report file\n$filename = "$($env:temp)\\wks_htmlReporting.html"\n\n# Generate simple data\n$services = get-service -ea SilentlyContinue |select name, DisplayName, @{N="Status";E={$_.Status.toString()}}\n\n# Create a section\n$section1 = new-htmlSection "Services Windows" -foldable\n\n# create hashtable with data to display\n$dataChart1 = @{}; ($services |group status |select name, count) |% { $dataChart1[$_.name] = $_.count }\n# generate chart item\n$chart1 = new-htmlItemChart -title "R\u00e9partition des services par status" `\n -data $dataChart1 `\n -chartType 'doughnut'\n\n# create table\n$table = new-htmlItemTable -dataset $services\n\n# force item line break in report to have the table below the graphs ;)\nadd-htmlItemNewRowAfter -item $chart1\n\n# Generate section\n$section1 |add-htmlSectionItem -itemList ($chart1, $table)\n\n# Creates a Report\n$report = new-htmlReport -title "Rapport sur les services Windows" `\n -subtitle "Feature demonstration of the <b>wks_htmlReporting<\/b> module" `\n# Add section to report \n$report |add-htmlReportSection -sectionList ($section1)\n# Export report to HTML file\n$report.toFile($filename)\n#& $filename\n<\/pre><\/div>\n\n\n
Parmi les type de graphique support\u00e9s, il y a :<\/p>\n\n\n\n\n
Ajouter un filtrage automatique des donn\u00e9es<\/h3>\n\n\n\n
\n# Define output report file\n$filename = "$($env:temp)\\wks_htmlReporting.html"\n\n# Generate simple data\n$services = get-service -ea SilentlyContinue |select name, DisplayName, @{N="Status";E={$_.Status.toString()}}\n\n# Create a section\n$section1 = new-htmlSection "Services Windows" -foldable\n\n# create hashtable with data to display\n$dataChart1 = @{}; ($services |group status |select name, count) |% { $dataChart1[$_.name] = $_.count }\n# create table\n$table = new-htmlItemTable -dataset $services\n\n# generate chart item\n$chart1 = new-htmlItemChart -title "R\u00e9partition des services par status" `\n -data $dataChart1 `\n -chartType 'doughnut' `\n -linkedTableId $table.id `\n -linkedFieldName 'Status' `\n -linkedTableExactMatch\n\n# force item line break in report to have the table below the graphs ;)\nadd-htmlItemNewRowAfter -item $chart1\n\n# Generate section\n$section1 |add-htmlSectionItem -itemList ($chart1, $table)\n\n# Creates a Report\n$report = new-htmlReport -title "Rapport sur les services Windows" `\n -subtitle "Feature demonstration of the <b>wks_htmlReporting<\/b> module" `\n# Add section to report \n$report |add-htmlReportSection -sectionList ($section1)\n# Export report to HTML file\n$report.toFile($filename)\n#& $filename\n<\/pre><\/div>\n\n\n\n
Conclusion<\/h2>\n\n\n\n
Je vous donne rendez-vous dans mon prochain article pour les usages un peu plus exotiques \ud83d\ude09<\/p>\n","protected":false},"excerpt":{"rendered":"