Rapports e-mail HTML depuis PowerShell, lisibles sur mobile et bureau
Structure, CSS en ligne, couleurs de statut, tableaux et envoi d'un rapport HTML qui s'affiche bien sur téléphone comme sur ordinateur.
Un script qui envoie un rapport en texte brut, avec des colonnes alignées à coups d'espaces, ne se lit bien que dans une police à chasse fixe, sur un grand écran. Or les rapports d'exploitation sont souvent lus sur un téléphone. Voici comment je construis des e-mails HTML propres depuis PowerShell, qui tiennent sur 390 px comme sur 1024 px.
Les principes
- Un seul statut par mail (ERREUR, ACTION, AVERTISSEMENT, OK, INFO), dérivé des données, visible dès le premier écran.
- Le résumé dans le corps, le détail en pièce jointe : un tableau de 4 colonnes au maximum, le reste dans un CSV.
- Le téléphone d'abord : pas de défilement horizontal, texte de 12 px minimum, boutons de 44 px.
- Les données sont affichées telles quelles, mais toujours encodées HTML : un message d'erreur contenant
<ne doit jamais devenir du balisage. - Ne jamais perdre un mail : si la construction du HTML échoue, on envoie un corps texte court avec le même sujet.
Structure d'un mail
Les clients de messagerie (surtout Outlook classique, qui rend avec Word) ignorent beaucoup de CSS moderne. Je m'en tiens à :
- des tables pour la mise en page (
role="presentation"), jamaisflexnigrid; - du CSS en ligne sur chaque cellule ; un bloc
<style>ne sert qu'aux media queries et au mode sombre, le mail doit rester complet sans lui ; - une carte centrale de
max-width:720px, 100 % de large sur téléphone ; bgcoloren plus debackground-colorsur les cellules colorées (Outlook) ;- pas d'image, pas de police web, pas d'emoji : les icônes s'inversent mal en mode sombre, le mot de statut porte le sens.
Couleurs de statut
Je définis six tons, chacun avec un texte foncé sur un fond clair de la même teinte, ce qui reste lisible même quand le client force son propre mode sombre. J'évite qu'ACTION ressemble à AVERTISSEMENT en lui donnant une teinte différente (violet).
| Ton | Texte | Fond |
|---|---|---|
| erreur | #b42318 |
#fef3f2 |
| action | #5925dc |
#f4f3ff |
| avertissement | #b54708 |
#fffaeb |
| ok | #027a48 |
#ecfdf3 |
| info | #175cd3 |
#eff8ff |
Un exemple court
function ConvertTo-MailTable {
param([object[]]$Rows)
$tone = @{ FAILED = '#b42318;#fef3f2'; WARNING = '#b54708;#fffaeb'; OK = '#027a48;#ecfdf3' }
$cells = foreach ($r in $Rows) {
$fg, $bg = ($tone[$r.Status.ToUpper()] ?? '#475467;#f2f4f7') -split ';'
$name = [System.Net.WebUtility]::HtmlEncode($r.Name)
"<tr><td bgcolor='$bg' style='background-color:$bg;color:$fg;font:700 12px Segoe UI,Arial;padding:9px 12px'>$($r.Status.ToUpper())</td>" +
"<td style='font:14px/20px Segoe UI,Arial;color:#1d2939;padding:9px 10px;border-bottom:1px solid #eaecf0'>$name</td></tr>"
}
"<table role='presentation' width='100%' cellpadding='0' cellspacing='0'>$($cells -join '')</table>"
}
$rows = @(
[pscustomobject]@{ Name = 'nightly-export'; Status = 'ok' }
[pscustomobject]@{ Name = 'index-maintenance'; Status = 'failed' }
)
$worst = if ($rows.Status -contains 'failed') { 'ERROR' } else { 'OK' }
$html = @"
<!doctype html><html><head><meta charset='utf-8'>
<meta name='viewport' content='width=device-width,initial-scale=1'>
<title>[$worst] Jobs - daily</title></head>
<body style='margin:0;background:#f4f5f7'>
<table role='presentation' width='100%'><tr><td align='center' style='padding:16px'>
<table role='presentation' width='100%' style='max-width:720px;background:#ffffff'><tr><td style='padding:20px 24px'>
<h1 style='font:600 22px/28px Segoe UI,Arial;color:#101828;margin:0 0 12px'>Daily job report - $worst</h1>
$(ConvertTo-MailTable -Rows $rows)
</td></tr></table></td></tr></table></body></html>
"@
Le tableau n'a que deux colonnes : le statut en premier (cellule teintée), puis le nom. Un champ en plus devient une ligne grise sous le nom plutôt qu'une cinquième colonne.
L'envoi
Send-MailMessage est marqué obsolète par Microsoft. Je préfère un service qui accepte du HTML par API, par exemple Microsoft Graph :
Send-MgUserMail -UserId 'dba@contoso.com' -Body @{
Message = @{
Subject = "[$worst] Jobs - daily"
Body = @{ ContentType = 'HTML'; Content = $html }
ToRecipients = @(@{ EmailAddress = @{ Address = 'team@contoso.com' } })
}
}
Le sujet suit un schéma fixe, [STATUT] Application env - résumé, en ASCII : les règles de tri de la boîte de réception s'appuient dessus.
Retour d'expérience
- Tester à 390 px, pas seulement à 1024 px. Un navigateur sans interface ne descend pas sous environ 500 px : rendre le HTML dans une iframe de largeur exacte.
- Ne jamais tester en envoyant à la vraie liste de diffusion.
- Le préheader (le texte gris de la liste d'e-mails) est un texte caché au début du corps : y mettre le verdict et l'action à faire.
- Gmail coupe les mails au-delà de 100 Ko : limiter les lignes (25 dans une liste d'actions, 10 dans un tableau d'information) et renvoyer le reste vers un CSV joint (séparateur
;, UTF-8 avec BOM pour qu'Excel l'ouvre directement). - Un état « ne peut pas vérifier » est une erreur, jamais un OK silencieux.