Guide Ultime
PulsiForms
Ultimate Guide
PulsiForms
Besoin de retrouver vite une signature ? L'📖 Référence des commandes présente les 28 verbes en fiches dépliables : signature, paramètres et exemple. Ce guide-ci explique quand et pourquoi les utiliser ; la référence sert d'aide-mémoire. Need to look up a signature fast? The 📖 Command reference lists all 28 verbs as collapsible cards: signature, parameters and example. This guide explains when and why to use them; the reference is the cheat sheet.
🔄 Comment PulsiForms génère le PS1How PulsiForms generates the PS1
PulsiForms n'est pas un éditeur de texte : c'est un compilateur visuel. Vos actions graphiques (drag & drop, propriétés, code d'événement) sont transformées en un script PowerShell autonome.
PulsiForms is not a text editor: it is a visual compiler. Your graphical actions (drag & drop, properties, event code) are turned into a self-contained PowerShell script.
À l'export, PulsiForms injecte automatiquement la bibliothèque PF-Script Stdlib en tête du script. Vous disposez ainsi de fonctions prêtes à l'emploi (Show-PF, Get-PF, Start-PF…) sans rien réécrire.
On export, PulsiForms automatically injects the PF-Script Stdlib at the top of the script. You get ready-to-use functions (Show-PF, Get-PF, Start-PF…) without rewriting anything.
{ ... } de l'événement. PulsiForms s'occupe de la création, du positionnement et du style.The code you write in the Code PS editor is placed inside the event's { ... } block. PulsiForms handles creation, positioning and styling.❌ « Variable non déclarée » — le piège n°1"Variable not declared" — pitfall #1
L'erreur la plus fréquente vient d'une incompréhension du scope PowerShell. Chaque événement Add_Click({ ... }) est un scriptblock avec son propre scope : une variable créée dans un événement n'existe pas dans un autre.
The most common error comes from misunderstanding PowerShell scope. Each Add_Click({ ... }) event is a scriptblock with its own scope: a variable created in one event does not exist in another.
# Les 3 scopes à connaîtreThe 3 scopes to know
$script:form et $script:_controls.$script:form and $script:_controls.{ } courant.{ } block.TextBox_3, écrivez $TextBox_3 — pas $TextBox3, pas $tb.The control's variable name in the Properties panel is exactly what to type. If the control is named TextBox_3, write $TextBox_3 — not $TextBox3, not $tb.# Référencer le formulaireReferencing the form
📐 Règles fondamentalesCore rules
| ❌ Ne pas écrireDon't write | ✅ Compatible PulsiFormsPulsiForms compatible |
|---|---|
| $form.Close() | $script:form.Close() |
| [Windows.Forms.MessageBox]::Show("x") | Alert-PF "x" / Show-PF "x" |
| $maVar = "v" (entre 2 events) | $global:maVar = "v" |
| Write-Host "debug" | Show-PF "debug" |
| Start-Sleep -Seconds 3 (gèle l'UI) | Sleep-PF -Ms 3000 / Wait-PF |
| $script:txt.Text depuis -Work | Write-PF $script:txt "v" (thread-safe) |
*-PF sont thread-safe (gestion automatique de InvokeRequired / .Invoke()) : vous pouvez les appeler depuis un callback async sans crash inter-thread.All *-PF functions are thread-safe (automatic InvokeRequired / .Invoke() handling): you can call them from an async callback without cross-thread crashes.⚡ Async — ne jamais geler l'interfaceAsync — never freeze the UI
Un traitement long (lecture de fichiers, requête réseau, boucle lourde) exécuté directement dans un Add_Click gèle l'interface : la fenêtre devient blanche, Windows affiche « Ne répond pas ». PulsiForms fournit trois outils pour l'éviter. Choisissez selon ce dont vous avez besoin.
A long task (file reading, network request, heavy loop) run directly inside an Add_Click freezes the UI: the window goes white and Windows shows "Not responding". PulsiForms provides three tools to avoid this. Choose based on what you need.
├─ NON · tâche de fond, je veux juste le résultat à la finbackground task, I just want the result at the end → Start-PF
├─ NON · + je veux un dialog « patientez » avec Annuler+ I want a "please wait" dialog with Cancel → Wait-PF
└─ OUI · boucle courte qui met à jour une ProgressBar en directshort loop updating a ProgressBar live → Sleep-PF
-Work de Start-PF et Wait-PF s'exécute dans un runspace isolé (autre thread). Il n'a aucun accès à $script: ni aux contrôles. Pour faire entrer des données → paramètre -With @{}. Pour récupérer le résultat → bloc -Then.
The runspace golden rule. The -Work block of Start-PF and Wait-PF runs in an isolated runspace (separate thread). It has no access to $script: or controls. To pass data in → -With @{}. To get the result out → the -Then block.
-Work ScriptBlock exécuté en arrière-plan (runspace isolé). Reçoit $_shared en argument — qui contient les clés passées via -With. · -Then callback UI au succès, reçoit le résultat de -Work. · -Catch callback UI en cas d'erreur, reçoit le message. · -With hashtable de données injectées dans le runspace.
-Work ScriptBlock run in the background (isolated runspace). Receives $_shared as argument — containing the keys passed via -With. · -Then UI callback on success, receives -Work's result. · -Catch UI callback on error, receives the message. · -With hashtable of data injected into the runspace.
Même moteur que Start-PF, mais affiche un dialog modal avec spinner animé. Le worker doit tester $_shared["_canceled"] pour s'arrêter proprement si l'utilisateur clique Annuler. Retourne le résultat de -Work, ou $null si annulé/erreur.
Same engine as Start-PF, but shows a modal dialog with an animated spinner. The worker must check $_shared["_canceled"] to stop cleanly if the user clicks Cancel. Returns -Work's result, or $null if cancelled/error.
Contrairement à Wait-PF, Sleep-PF reste sur le thread UI (boucle DoEvents) : $script: et les contrôles sont accessibles directement dans la boucle appelante. Idéal pour une boucle courte qui met une ProgressBar à jour. Retourne $true si Annuler cliqué. Toujours appeler Sleep-PF -End en fin de boucle (dans un finally).
Unlike Wait-PF, Sleep-PF stays on the UI thread (DoEvents loop): $script: and controls are directly accessible in the calling loop. Ideal for a short loop updating a ProgressBar. Returns $true if Cancel was clicked. Always call Sleep-PF -End at the end of the loop (in a finally).
-Work de Start-PF/Wait-PF (runspace séparé). Sleep-PF est réservé au thread UI.Never use Sleep-PF inside a Start-PF/Wait-PF -Work block (separate runspace). Sleep-PF is for the UI thread only.Même moteur que Start-PF (runspace + timer) : la commande tourne en arrière-plan et un timer UI vide la file dans le contrôle, ligne par ligne. Les erreurs sont colorées en rouge (sauf -NoColor) et le contrôle défile automatiquement (sauf -NoFollow). -Then s'exécute sur le thread UI à la fin.
Same engine as Start-PF (runspace + timer): the command runs in the background and a UI timer drains the queue into the control, line by line. Errors are coloured red (unless -NoColor) and the control auto-scrolls (unless -NoFollow). -Then runs on the UI thread at the end.
Set-PF, Fill-PF, $ctrl.Text). Utilisez -Then.The command block runs in an isolated runspace: no direct UI access inside. Use -Then.# Tableau comparatifComparison table
| Start-PF | Wait-PF | Sleep-PF | |
|---|---|---|---|
| ThreadThread | Runspace | Runspace | UI |
| Bloquant ?Blocking? | Non / No | ModalModal | Boucle UIUI loop |
| DialogDialog | — | ✅ spinner + Annuler | ✅ spinner + Annuler |
| Accès $script:$script: access | ❌ -With/-Then | ❌ -With/-Then | ✅ direct |
| UsageUse | tâche de fondbackground task | opération longue avec attentelong op with wait | boucle + ProgressBarloop + ProgressBar |
📚 Référence des commandes PF-ScriptPF-Script command reference
Toutes ces fonctions sont injectées automatiquement à l'export. Signatures vérifiées dans le moteur (Stdlib v2.0).
All these functions are auto-injected at export. Signatures verified against the engine (Stdlib v2.0).
# Notifications & dialogsNotifications & dialogs
Complément de Show-PF, pas un remplaçant. Show-PF = bulle dans la fenêtre (disparaît avec elle). Toast-PF = notification du système : visible fenêtre minimisée, conservée dans le centre de notifications, sonore et cliquable. Seul verbe de notification autorisé dans un bloc -Work (il ne touche aucun contrôle WinForms). -Duration : Windows n'a que 2 paliers, ≥ 15000 ms = long (~25 s), sinon court (~7 s).
Complements Show-PF, does not replace it. Show-PF = bubble inside the window. Toast-PF = system notification: visible when minimised, kept in the Action Center, audible and clickable. The only notification verb allowed inside a -Work block. -Duration: Windows only has 2 tiers, ≥ 15000 ms = long, else short.
.ps1/.msix exporté et saisissez .\logo.png. L'image n'est pas embarquée : distribuez-la avec l'application.Logo — set it once for the whole app: the $form button → Properties tab → Application section. Put the PNG next to the exported .ps1/.msix and enter .\logo.png. The image is not embedded: ship it with the app.$script:PFToastError.If Windows refuses the notification, Toast-PF falls back to the in-app toast — never a silent failure. Reason in $script:PFToastError.$null -ne $val : l'utilisateur peut cliquer Annuler.Always test $null -ne $val: the user can click Cancel.# Contrôles — lire, écrire, remplirControls — read, write, fill
Sans switch : TextBox→string · CheckBox→bool · DateTimePicker→DateTime · TrackBar/NumericUpDown→nombre · Rating→note (décimale si demi-étoiles) · Gauge→nombre · KenoBalls→boules choisies (nombres ou lettres) · Timeline→index de l’étape courante · PFTreeView→texte du nœud choisi (-Index : chemin a/b/c, -All / -Checked : nœuds) ·ComboBox→SelectedItem ou Text · ListBox→SelectedItem · DataGridView→ligne liée (DataBoundItem).
Without a switch: TextBox→string · CheckBox→bool · DateTimePicker→DateTime · TrackBar/NumericUpDown→number · Rating→score (decimal with half-stars) · Gauge→number · KenoBalls→selected balls (numbers or letters) · Timeline→current step index · PFTreeView→selected node text (-Index: a/b/c path, -All / -Checked: nodes) ·ComboBox→SelectedItem or Text · ListBox→SelectedItem · DataGridView→bound row (DataBoundItem).
Get-PF ctrl Text (nom du contrôle sans $, propriété en 2e argument) n'existe pas : elle renvoie du vide sans erreur. Écrivez Get-PF $ctrl, ou Get-PF $ctrl -Prop Text.The Get-PF ctrl Text form (bare control name + property argument) does not exist: it silently returns empty. Use Get-PF $ctrl or Get-PF $ctrl -Prop Text.-Then de Start-PF/Wait-PF. Gère InvokeRequired automatiquement.Required to update the UI from a Start-PF/Wait-PF -Then callback. Handles InvokeRequired automatically.Accepte un tableau de strings, de Hashtables ou de PSCustomObjects. Pour un DataGridView, les colonnes sont créées et redimensionnées automatiquement. $null vide le contrôle. -Where filtre les données à l'affichage (le bloc reçoit chaque élément dans $_) — pratique pour une barre de recherche, sans dupliquer la source.
Accepts an array of strings, Hashtables or PSCustomObjects. For a DataGridView, columns are auto-created and resized. $null clears the control. -Where filters the data at display time (the block receives each item as $_) — ideal for a search box, with no duplicated source.
Sur un arbre (PFTreeView) : des chemins "Lyon/Ventes/Julie" (les dossiers intermédiaires se créent seuls), des objets (chemin lu dans CanonicalName, DistinguishedName, FullName ou Path ; texte : -Display, sinon Name), ou les lignes Texte|icône|badge|options de la propriété Nœuds. Fill-PF remplace tout l’arbre : pour ajouter un nœud, $Arbre.FindNode("Lyon").Nodes.Add("Paul", "utilisateur").
On a tree (PFTreeView): paths "Lyon/Ventes/Julie" (intermediate folders are created for you), objects (path read from CanonicalName, DistinguishedName, FullName or Path; text: -Display, else Name), or the Texte|icône|badge|options lines of the Nodes property. Fill-PF replaces the whole tree: to add a node, $Arbre.FindNode("Lyon").Nodes.Add("Paul", "utilisateur").
Complément de Fill-PF, qui lui remplace tout. Sur une DataGridView liée (après Fill-PF), la ligne est ajoutée/retirée directement dans la source : plus besoin de variable miroir $script:.
Complements Fill-PF, which replaces everything. On a bound DataGridView the row is added/removed straight in the data source: no mirror $script: variable needed.
Colore la ligne entière selon la valeur d'une colonne. À appeler après Fill-PF. Couleurs = noms .NET (Green / Red / Orange / Gray…). S'abonne une fois au rendu : la couleur survit à un Fill-PF ultérieur. Ne jamais colorer via $dgv.Rows / .DefaultCellStyle — inopérant sur une grille liée (DataSource) et non certifié.
Colors the whole row by a column value. Call after Fill-PF. Colors = .NET names. Survives re-binding. Never use native $dgv.Rows / .DefaultCellStyle.
Sans -Prop, Set-PF écrit la valeur du contrôle : un nombre (ProgressBar, TrackBar, NumericUpDown, Rating, Gauge, DateTimePicker), l’étape d’une Timeline (numéro ou titre), le nœud d’un arbre PFTreeView (chemin ou texte : il est sélectionné et ses parents dépliés), l’élément d’une liste ComboBox ou ListBox (son texte ; un entier sans élément de ce texte est sa position). -Prop écrit n'importe quelle propriété .NET (Visible, Enabled, BackColor, Width…) de façon gardée et thread-safe. Pour l'apparence d'un bouton, préférez Style-PF.
Without -Prop, Set-PF writes the control's value: a number (ProgressBar, TrackBar, NumericUpDown, Rating, Gauge, DateTimePicker), a Timeline step (number or title), a PFTreeView tree node (path or text: it is selected and its parents expanded), the item of a ComboBox or ListBox list (its text; an integer with no item of that text is its position). -Prop writes any .NET property (Visible, Enabled, BackColor, Width…), guarded and thread-safe. For button looks, prefer Style-PF.
Sans argument : verrouille tout le formulaire + curseur sablier. Avec -Controls : seulement les contrôles fournis.
No argument: locks the whole form + wait cursor. With -Controls: only the given controls.
# Données & fichiersData & files
Connecte une application à une source de données externe en PowerShell pur — aucun module à installer. Read-PFData renvoie des objets prêts pour Fill-PF ; le binding, le filtrage (-Where) et la coloration (Format-PF) restent identiques. Encore plus simple : renseignez le fichier dans l'encadré Source de données des propriétés d'une DataGridView — elle se remplit seule à l'ouverture. Nouveau : Join-PFData associe deux sources par une clé commune — jointure relationnelle façon LookUp.
Connects an app to an external data source in pure PowerShell — no module to install. Read-PFData returns objects ready for Fill-PF; binding, filtering (-Where) and colouring (Format-PF) stay the same. Even simpler: set the file in the Data source box of a DataGridView's properties — it fills itself on open. New: Join-PFData links two sources on a shared key — a relational join, LookUp-style.
Une seule ligne, au chargement de la fenêtre : la grille se remplit depuis un fichier .xlsx ou .csv et devient modifiable (cellules, ligne vide pour ajouter, Suppr avec confirmation). Rien n'est écrit avant le clic sur Enregistrer ; « modifications non enregistrées » et une * au titre le rappellent, et la fenêtre demande avant de se fermer. Nombres, dates et oui / non retrouvent leur type ; une saisie invalide est refusée en nommant la ligne et la colonne. Le reste du classeur est conservé (autres feuilles, mise en forme, formules), avec une copie .bak. Fichier ouvert dans Excel ou modifié ailleurs : l'application le dit et ne remplace rien sans accord.
One line, when the window loads: the grid fills from an .xlsx or .csv file and becomes editable (cells, blank row to add, Del with confirmation). Nothing is written until Save is clicked; "unsaved changes" and a * in the title say so, and the window asks before closing. Numbers, dates and yes / no get their type back; an invalid entry is refused, naming the row and column. The rest of the workbook is kept (other sheets, formatting, formulas), with a .bak copy. File open in Excel or changed elsewhere: the app says so and replaces nothing without consent.
Écrit le contenu d'une DataGridView dans un fichier dont l'extension décide du format : .csv (séparateur ;, lisible par Excel en français), .xlsx (classeur Excel) ou .pdf (document). Seules les colonnes visibles sont exportées, dans l'ordre affiché — ce que l'utilisateur voit est exactement ce qu'il obtient. Sans -Path, la fenêtre « Enregistrer sous » s'ouvre. Renvoie $true si le fichier a été écrit, $false sinon (annulation, grille vide, fichier verrouillé).
Writes a DataGridView to a file whose extension picks the format: .csv (; separator, readable by French Excel), .xlsx (Excel workbook) or .pdf (document). Only visible columns are exported, in display order — what the user sees is exactly what they get. Without -Path, the “Save as” dialog opens. Returns $true if the file was written, $false otherwise (cancelled, empty grid, locked file).
PDF de document (devis, facture) : -Title remplace le titre de la fenêtre, -Header écrit un bloc sous le titre (client, adresse…), -Footer écrit les totaux en gras, alignés à droite, sur la dernière page, montants à 2 décimales. Utilisez [ordered]@{ } pour garder l'ordre des lignes. Alias : -Titre, -EnTete, -Pied / -Totaux. Un document titré n'a pas la ligne « Exporté le … », et les cellules gardent le format affiché par la grille (montants à 2 décimales).
Document PDF (quote, invoice): -Title replaces the window title, -Header writes a block under the title (customer, address…), -Footer writes the totals in bold, right-aligned, on the last page, amounts with 2 decimals. Use [ordered]@{ } to keep the lines in order. Aliases: -Titre, -EnTete, -Pied / -Totaux. A titled document has no “Exported on …” line, and cells keep the format shown by the grid (amounts with 2 decimals).
Câble en un seul appel (au chargement de la fenêtre) toute une gestion de liste : la sélection remplit les champs, Ajouter / Modifier / Supprimer, champs obligatoires, clé unique, confirmation avant suppression, grille rafraîchie, sauvegarde JSON et rechargement au démarrage (-File). -Source est le nom de la collection : elle reste à jour pour le reste de l'application. Les boutons n'ont pas de code à eux.
Wires a whole list screen in one call (when the window loads): selection fills the fields, Add / Update / Delete, required fields, unique key, confirmation before deleting, refreshed grid, JSON save and reload at startup (-File). -Source is the collection name: it stays up to date for the rest of the app. The buttons have no code of their own.
$null -ne $result — l'utilisateur peut annuler.Test $null -ne $result — the user can cancel.Par défaut (-As Auto) : collection d'objets → CSV (UTF8), sinon → TXT ; Load-PF renifle le délimiteur (; ou ,). Précisez -As dès que le contenu compte : Json = round-trip fiable de n'importe quelle valeur (hashtable, objet imbriqué), Text = jamais reniflé en CSV. C'est -As qui pilote le format, pas l'extension du fichier.
By default (-As Auto): object collection → CSV (UTF8), else → TXT; Load-PF sniffs the delimiter. Set -As whenever content matters: Json = reliable round-trip of any value (hashtable, nested object), Text = never sniffed as CSV. The format is driven by -As, not by the file extension.
Auto, un texte contenant , ou ; est relu à tort comme du CSV. Utilisez -As Text (ou -As Json) pour un round-trip garanti.In Auto, text containing , or ; is wrongly parsed as CSV. Use -As Text (or -As Json) for a guaranteed round-trip.# Style & navigationStyle & navigation
-Code attend un entier (notation 0xE74D acceptée), pas une chaîne hexadécimale.-Code expects an integer (0xE74D notation works), not a hex string.🎛️ Patterns de contrôles courantsCommon control patterns
# TextBox
# DataGridView
# ComboBox / CheckBox
💼 Cas d'usage completsComplete use cases
# Formulaire avec validationForm with validation
# Traitement long non-bloquantLong non-blocking task
🤖 IA dans PulsiForms — votre clé MistralAI in PulsiForms — your Mistral key
PulsiForms s'appuie sur un assistant en ligne, Mistral AI, complété par une IA locale hors-ligne. Vous fournissez votre propre clé API — c'est le modèle BYOK (Bring Your Own Key) : vos clés ne sont jamais stockées sur nos serveurs, et nous ne vous facturons aucun jeton.
PulsiForms relies on one online assistant, Mistral AI, complemented by an offline local AI. You provide your own API key — this is the BYOK (Bring Your Own Key) model: your keys are never stored on our servers, and we never bill you for tokens.
Ctrl+Shift+P). Génération d'une application entière à partir d'une description, code PowerShell par contrôle, et import d'un .ps1 existant vers un projet.Ctrl+Shift+P). Generate a whole application from a description, per-control PowerShell code, and import an existing .ps1 into a project.localStorage, les cookies, le DOM ou la console, et transite uniquement par en-tête (X-Mistral-Key) vers le proxy.
BYOK security. Your key is encrypted with AES-256-GCM (Web Crypto API) and stored either in an encrypted session or in pure memory (closure variable, wiped on close). It is never written to localStorage, cookies, the DOM or the console, and travels only via header (X-Mistral-Key) to the proxy.
# Créer votre clé MistralCreate your Mistral key
sk-…).Click Create new key and copy the key (format sk-…).Ctrl+Shift+P) ou cliquez l'icône 🔑 de la console Qualité en bas d'écran, collez votre clé et validez.In PulsiForms, open the Studio (Ctrl+Shift+P) or click the 🔑 icon in the Quality console at the bottom, paste your key and confirm.| Mistral AI | |
|---|---|
| Créer la cléCreate key | console.mistral.ai/api-keys |
| FormatFormat | sk-… |
| Modèle par défautDefault model | mistral-large-latest |
| Où dans PulsiFormsWhere in PulsiForms | Studio (Ctrl+Shift+P) · console Qualité 🔑Studio (Ctrl+Shift+P) · Quality console 🔑 |
# Dictée vocale et réponse parléeVoice dictation and spoken reply
Le Studio a un bouton « Dicter » : vous dites ce que vous voulez au lieu de le taper, et PulsiForms vous répond de vive voix. La dictée et la réponse utilisent votre clé Mistral, comme la génération.
The Studio has a "Dicter" (Dictate) button: you say what you want instead of typing it, and PulsiForms answers out loud. Dictation and the reply use your Mistral key, like generation does.
# L'IA locale (hors-ligne)The local AI (offline)
🛡️ PS.Guard v3 & Linter internePS.Guard v3 & internal linter
PulsiForms protège votre code à deux niveaux, synchronisés entre eux et avec la Stdlib.
PulsiForms protects your code at two levels, kept in sync with each other and with the Stdlib.
| SystèmeSystem | QuandWhen | SurveilleWatches |
|---|---|---|
| Linter PF_* | Temps réel, à l'écritureReal-time, while typing | Code de l'événement (alias, variables, propriétés)Event code (aliases, variables, properties) |
| PS.Guard PSG-* | Après export du .ps1After .ps1 export | Script complet (sécurité, qualité, perf)Whole script (security, quality, perf) |
# PS.Guard v3 — 33 règles, 3 catégoriesrules, 3 categories
Invoke-Expression, mots de passe en clair, ConvertTo-SecureString -AsPlainText, Net.WebClient, Set-ExecutionPolicy Bypass, processus cachés, Base64.Invoke-Expression, plaintext passwords, ConvertTo-SecureString -AsPlainText, Net.WebClient, Set-ExecutionPolicy Bypass, hidden processes, Base64.$Error[0] dans catch, if/elseif multiples, alias (60+), cmdlets dépréciées (Get-WmiObject→Get-CimInstance…).$Error[0] in catch, multiple if/elseif, aliases (60+), deprecated cmdlets (Get-WmiObject→Get-CimInstance…).New-Object Size, [CmdletBinding()], faux positifs perf neutralisés par PSGuard-disable/enable.New-Object Size, [CmdletBinding()], perf false-positives silenced via PSGuard-disable/enable.# Correction automatique « ⚡ Appliquer »Auto-fix "⚡ Apply"
Pour les règles auto-corrigeables, PS.Guard propose un bouton ⚡ Appliquer qui réécrit le code (alias → cmdlet complète, catch vide → Write-Error + throw, $Error[0] → $_…). Les règles de sécurité exigent une correction manuelle (jamais auto-corrigées, par prudence).
For auto-fixable rules, PS.Guard offers a ⚡ Apply button that rewrites the code (alias → full cmdlet, empty catch → Write-Error + throw, $Error[0] → $_…). Security rules require a manual fix (never auto-corrected, by design).
# PSGuard-disable PSG-P02 … # PSGuard-enable PSG-P02.False positive on a static block? Wrap it: # PSGuard-disable PSG-P02 … # PSGuard-enable PSG-P02.# Linter PF_* (temps réel)(real-time)
- PF_ALIAS — alias détecté (
ls,cat,rm…) → suggère la cmdlet complète. - PF_ALIAS — alias detected (
ls,cat,rm…) → suggests the full cmdlet. - PF_UNDECLARED — variable utilisée sans assignation visible. Solution :
$global:entre événements. - PF_UNDECLARED — variable used without a visible assignment. Fix:
$global:across events. - PF_INVALID_PROP — propriété inexistante sur un contrôle (
.Texte→.Text,.MaxChars→.MaxLength). - PF_INVALID_PROP — non-existent property on a control (
.Texte→.Text,.MaxChars→.MaxLength).
$global:).The linter analyses each event in isolation. Canvas controls and 50+ common variables are whitelisted — a variable shared between two events is still flagged (use $global:).⚠️ Top 10 des erreurs à éviterTop 10 mistakes to avoid
| # | ❌ ErreurMistake | ✅ SolutionFix |
|---|---|---|
| 1 | Variable partagée sans $global:Shared var without $global: | $global:maVar |
| 2 | $form.Close() | $script:form.Close() |
| 3 | Traitement long dans Add_ClickLong task in Add_Click | Start-PF / Wait-PF / Sleep-PF |
| 4 | Lire $script: dans -WorkReading $script: in -Work | -With @{} + -Then |
| 5 | Start-Sleep -Seconds 3 | Sleep-PF -Ms 3000 |
| 6 | Sleep-PF sans -EndSleep-PF without -End | try/finally + Sleep-PF -Endtry/finally + Sleep-PF -End |
| 7 | Pas de test $null après Pick-PF / Read-PFNo $null test after Pick-PF / Read-PF | if ($null -ne $r) { … } |
| 8 | MessageBox::Show("x") | Alert-PF "x" / Show-PF "x" |
| 9 | Catch videEmpty catch | catch { Write-Error $_; throw } |
| 10 | Mauvais nom de contrôle (casse)Wrong control name (case) | Copier le nom des PropriétésCopy the name from Properties |
$global: / $script:), passez par les fonctions *-PF (thread-safe), ne gelez jamais l'UI (async), et laissez PS.Guard + le linter valider le reste. En cas de doute, demandez à l'IA locale de l'application PulsiForms.
In short: respect scopes ($global: / $script:), go through the *-PF functions (thread-safe), never freeze the UI (async), and let PS.Guard + the linter validate the rest. When in doubt, ask the PulsiForms local AI.