LLI Wiki — My Digital Knowledge Base

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

  1. Un seul statut par mail (ERREUR, ACTION, AVERTISSEMENT, OK, INFO), dérivé des données, visible dès le premier écran.
  2. 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.
  3. Le téléphone d'abord : pas de défilement horizontal, texte de 12 px minimum, boutons de 44 px.
  4. Les données sont affichées telles quelles, mais toujours encodées HTML : un message d'erreur contenant < ne doit jamais devenir du balisage.
  5. 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 à :

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

Mastodon LLIMastodon SocialFosstodon