Documentation fonctionnelle KWISATZ

Les styles conditionnels

Les styles conditionnels permettent de modifier automatiquement l’apparence d’une ligne dans une liste selon son contenu. Une facture impayée peut apparaître en rouge, un retour en vert, une commande urgente en orange ou un stock faible avec une police renforcée.

Fiche : UI-STY-001 Module : Configuration des listes et écrans Public : utilisateur avancé ou technicien Risque : faible à modéré Catégorie : Paramétrage, modèles et personnalisationMise à jour : 6 août 2026

Réponse directe

Repère de diagnostic : WKW_STYLE_EDITEUR, USER_STYLE. Ce repère interne ne doit pas être modifié directement. Faites analyser et valider le réglage par un technicien KWISATZ après sauvegarde et relevé de la configuration.
L’ordre des règles est important : la première condition vraie est prioritaire. Placez les cas les plus urgents ou les plus précis avant les conditions générales.

Conseil technicien général

1. Repères de version

Les références de version ci-dessous sont conservées comme repères documentaires. Les menus, options et comportements doivent être contrôlés sur la version et la sérialisation réellement installées ; une évolution plus récente peut avoir modifié le fonctionnement.

2. Protection des données

3. Principe de fonctionnement

Élément Rôle
Style prédéfini Détermine le fond, la couleur du texte et la police à appliquer.
Expression ou condition Teste la valeur d’un ou plusieurs champs de la ligne.
Association condition/style Indique quel style utiliser lorsque l’expression est vraie.
USER_STYLE Champ technique qui active l’application du style dans la liste.
Ordre des conditions Définit la priorité lorsque plusieurs règles correspondent à la même ligne.

Exemples visuels :

  • À traiter facture avec un reste à payer ;
  • Retour document ou montant négatif ;
  • Urgent date ou délai proche ;
  • Information dossier ou statut particulier.
Le style ne modifie aucune donnée métier. Il change uniquement l’affichage de la ligne dans la liste configurée.

4. Licence et versions

Période ou version Évolution documentée
Décembre 2017 Introduction dans les listes MDI avec dix styles utilisateurs et cinq expressions par liste.
Mars 2019 Extension aux sélections rapides des clients, fournisseurs, produits, documents commerciaux et tickets de caisse.
Version 3.52R8 — mars 2024 L’éditeur permet jusqu’à vingt styles. Ajout des boutons Configuration des styles et Appliquer pour obtenir un aperçu immédiat.
Version 3.52R9 Extension aux listes des onglets clients et fournisseurs : devis, commandes, BL, factures, comptes et historiques.
L’application permanente des styles est historiquement associée au Pack caisse (fonctions avancées). Les versions récentes autorisent néanmoins l’ouverture de l’éditeur et l’aperçu sans ce pack, avec un avertissement indiquant que le résultat ne sera pas conservé.

5. Listes compatibles documentées

  • listes MDI principales : produits, clients, fournisseurs et documents ;
  • sélection rapide des clients et fournisseurs ;
  • sélection rapide des produits ;
  • sélection rapide des documents commerciaux ;
  • sélection rapide des tickets de caisse ;
  • onglets Devis, BCV, BLV et FAV des fiches clients ;
  • onglets BCA, BRA et FAA des fiches fournisseurs ;
  • compte client et compte fournisseur ;
  • historique des mouvements des fiches clients et fournisseurs.
La présence de l’onglet Styles conditionnels dans la configuration de la liste est le meilleur indicateur de compatibilité pour la version installée.

6. Créer les styles visuels

L’utilitaire WKW_STYLE_EDITEUR.EXE se trouve normalement dans le répertoire WKW de l’installation. Dans les versions récentes, il peut être appelé depuis le bouton Configuration des styles.

  1. Ouvrez la liste à personnaliser.
  2. Accédez à la configuration des colonnes ou de l’écran.
  3. Ouvrez l’onglet Styles conditionnels.
  4. Cliquez sur Configuration des styles.
  5. Sélectionnez un numéro de style libre.
  6. Choisissez la couleur de fond.
  7. Choisissez la couleur du texte.
  8. Choisissez la police, son style et sa taille si ces zones sont proposées.
  9. Donnez une apparence suffisamment lisible.
  10. Enregistrez les styles avant de fermer l’éditeur.
Les premières documentations mentionnent dix styles. Dans les versions documentées à partir de 3.52R8, l’éditeur documenté peut en gérer jusqu’à vingt.
Évitez un texte clair sur fond clair ou un texte foncé sur fond foncé. Testez aussi l’affichage avec le thème Windows, l’écran TSE et le zoom utilisés.

7. Ajouter le champ USER_STYLE

La colonne USER_STYLE doit être présente dans la liste pour que le moteur puisse appliquer les conditions et styles.

  1. Ouvrez l’onglet des colonnes.
  2. Recherchez le champ USER_STYLE.
  3. Ajoutez-le à la liste.
  4. Cochez l’option Invisible si vous ne souhaitez pas l’afficher.
  5. Enregistrez la configuration.
Sans USER_STYLE, les expressions peuvent être correctement saisies sans produire aucun changement visuel.
Le champ est technique. Il n’est pas nécessaire de l’afficher à l’utilisateur pour que les styles fonctionnent.

8. Définir les conditions

Dans l’onglet Styles/Conditions ou Styles conditionnels, la documentation décrit cinq lignes de condition.

  1. Cliquez sur le bouton de la première ligne.
  2. Utilisez l’assistant de filtre ou d’expression.
  3. Choisissez le champ à tester.
  4. Choisissez l’opérateur.
  5. Saisissez ou choisissez la valeur.
  6. Validez l’expression.
  7. Associez le numéro du style à cette condition.
  8. Répétez l’opération pour les autres règles.
Opérateur courant Utilisation Exemple
= Égal à une valeur. Statut égal à un code précis.
<> Différent de. NET_A_PAYER <> 0.
<, >, <=, >= Comparaison numérique ou chronologique. TOTAL_TTC < 0.
ET Toutes les conditions doivent être vraies. Reste à payer positif et échéance dépassée.
OU Une des conditions doit être vraie. Statut urgent ou date proche.
Utilisez l’assistant plutôt que de saisir une expression de mémoire. Le nom des champs et la syntaxe dépendent de la liste.

9. Gérer la priorité des règles

Lorsqu’une ligne répond à plusieurs conditions, la première condition vraie est appliquée. Les conditions suivantes ne remplacent pas son style.

Mauvais ordre

  1. Condition générale : tous les documents non soldés.
  2. Condition précise : documents non soldés et en retard.

La seconde règle ne sera jamais visible pour les documents déjà pris par la première condition.

Ordre conseillé

  1. Documents non soldés et en retard — style rouge.
  2. Documents non soldés mais non échus — style orange.
  3. Documents soldés — aucun style ou style neutre.
Placez les exceptions et les cas critiques en haut, puis terminez par les règles plus larges.

10. Exemple : liste des factures de vente

Exemple documenté :

Priorité Expression Style Résultat
1 NET_A_PAYER <> 0 Style 1 — fond rose ou rouge clair. Met en évidence les factures qui ne sont pas totalement soldées.
2 TOTAL_TTC < 0 Style 2 — fond vert. Met en évidence les avoirs ou documents négatifs qui ne sont pas déjà pris par la règle 1.
  1. Créez les styles 1 et 2 dans l’éditeur.
  2. Repère de diagnostic : USER_STYLE. Ce repère interne ne doit pas être modifié directement. Faites analyser et valider le réglage par un technicien KWISATZ après sauvegarde et relevé de la configuration.
  3. Créez la condition NET_A_PAYER <> 0 sur la première ligne.
  4. Associez le style 1.
  5. Créez la condition TOTAL_TTC < 0 sur la deuxième ligne.
  6. Enregistrez et rouvrez la liste.
Dans cet ordre, un avoir négatif ayant encore un net à payer utilisera le style 1, car la première condition est prioritaire.

11. Autres exemples d’usage

Liste Critère possible But visuel
Produits Stock inférieur au seuil ou produit en sommeil. Repérer les ruptures et produits inactifs.
Clients Solde débiteur, catégorie ou date de fin de contrat. Identifier les dossiers nécessitant un contrôle.
Fournisseurs Solde, catégorie ou information de suivi. Prioriser les règlements ou contrôles.
Commandes Date prévue dépassée ou reliquat non nul. Repérer les commandes en retard.
Tickets de caisse Total négatif, ticket de retour ou statut particulier. Distinguer les retours et opérations exceptionnelles.
Compte client Écriture non pointée ou échéance dépassée. Mettre en évidence les mouvements à traiter.
Historique Type de mouvement ou quantité négative. Distinguer ventes, retours et corrections.
Les noms exacts des champs diffèrent entre les listes. Vérifiez les colonnes disponibles et créez l’expression avec l’assistant de la liste concernée.

12. Utiliser l’aperçu immédiat

Dans les versions documentées à partir de 3.52R8, le bouton Appliquer applique temporairement les styles à la liste sous-jacente pour afficher immédiatement le résultat.

  1. Créez ou modifiez les styles.
  2. Définissez les conditions.
  3. Cliquez sur Appliquer.
  4. Contrôlez les couleurs, polices et priorités.
  5. Corrigez les règles si le résultat est trop large.
  6. Enregistrez la configuration lorsque la licence le permet.
Sans Pack caisse (fonctions avancées), l’aperçu permet de tester le résultat, mais un avertissement indique que les styles ne seront pas appliqués ensuite.

13. Enregistrer et valider

  1. Enregistrez les styles dans WKW_STYLE_EDITEUR.
  2. Enregistrez les conditions de la liste.
  3. Vérifiez la présence de USER_STYLE.
  4. Fermez complètement la liste.
  5. Rouvrez-la depuis son menu d’origine.
  6. Testez une ligne correspondant à chaque condition.
  7. Testez une ligne correspondant à plusieurs conditions.
La configuration est valide lorsque chaque cas utilise le style attendu, que les autres lignes restent lisibles et que le résultat persiste après fermeture puis réouverture de la liste.

14. Portée de la configuration

Une configuration de style est liée à la liste ou à l’écran configuré. Elle ne doit pas être supposée automatiquement identique dans :

  • la liste MDI principale ;
  • la sélection rapide équivalente ;
  • l’onglet d’une fiche client ou fournisseur ;
  • un autre poste ou une autre session TSE ;
  • un autre dossier KWISATZ.
Configurez et testez chaque vue concernée. Une liste rapide et une liste MDI peuvent utiliser des configurations distinctes même si elles montrent les mêmes données.

15. Bonnes pratiques visuelles

  • limiter le nombre de couleurs afin de conserver une signification claire ;
  • réserver le rouge aux alertes ou éléments bloquants ;
  • préférer des fonds clairs pour garder le texte lisible ;
  • ne pas utiliser uniquement la couleur pour transmettre une information essentielle ;
  • compléter si possible par une colonne de statut ou un libellé ;
  • tester avec les écrans, thèmes et résolutions réels ;
  • documenter la signification de chaque style ;
  • éviter des polices trop grandes qui augmentent fortement la hauteur des lignes ;
  • réserver un ou deux styles libres pour les besoins futurs.
Une légende interne simple, par exemple « rouge = impayé, orange = à échéance », facilite l’adoption par les utilisateurs.

16. Performance et qualité des conditions

Une condition est évaluée sur les lignes affichées. Pour garder une liste réactive :

  • utilisez les champs déjà présents dans la source de la liste ;
  • évitez des expressions inutilement complexes ;
  • limitez le nombre de règles aux besoins réels ;
  • filtrez la liste avant d’afficher des volumes très importants ;
  • testez en session TSE si les utilisateurs travaillent à distance ;
  • vérifiez la version en cas de ralentissement après ajout des styles.
Le style n’est pas un filtre. Il met une ligne en évidence, mais ne la retire pas de la liste et ne réduit pas le volume chargé.

17. Sauvegarde et déploiement

Avant de déployer une configuration sur plusieurs utilisateurs :

  1. notez la liste et le dossier concernés ;
  2. notez le numéro et la signification de chaque style ;
  3. conservez les expressions dans une fiche de paramétrage ;
  4. effectuez une sauvegarde de la configuration des listes et du dossier ;
  5. testez sur un poste pilote ;
  6. vérifiez la disponibilité du même éditeur et de la même version sur les autres postes ;
  7. contrôlez le résultat dans chaque session TSE ou numéro de poste concerné.
Ne copiez pas au hasard un fichier de configuration d’un autre dossier ou d’une autre version. Les champs et identifiants de listes peuvent différer.

18. Diagnostic rapide

Aucun style ne s’applique
Vérifiez que USER_STYLE est ajouté, que le style est enregistré, que la condition est valide et que la liste a été fermée puis rouverte. Vérifiez également la licence pour l’application permanente.
Le bouton Configuration des styles est absent
Vérifiez la version. Le bouton est documenté Dans les versions documentées à partir de 3.52R8. Sur une version plus ancienne, lancez l’utilitaire WKW_STYLE_EDITEUR.EXE depuis le répertoire WKW si celui-ci est disponible.
L’aperçu fonctionne mais disparaît après réouverture
Vérifiez le Pack caisse (fonctions avancées) et l’avertissement affiché. Les versions récentes autorisent un aperçu sans cette licence, mais ne conservent pas nécessairement l’application permanente.
Le mauvais style est appliqué
Une condition précédente est probablement vraie. Réorganisez les règles en plaçant le cas le plus précis avant les conditions générales.
Une condition paraît toujours fausse
Vérifiez le type du champ, la valeur vide, le format des dates et le séparateur décimal. Recréez l’expression avec l’assistant de filtre.
La police ou la couleur ne change pas
Repère de diagnostic : WKW_STYLE_EDITEUR. Ce repère interne ne doit pas être modifié directement. Faites analyser et valider le réglage par un technicien KWISATZ après sauvegarde et relevé de la configuration.
Les styles fonctionnent dans la liste principale mais pas dans une fiche client
Configurez séparément la liste de l’onglet concerné. La prise en charge des onglets clients et fournisseurs est documentée Dans les versions documentées à partir de 3.52R9.
Les styles fonctionnent sur un poste mais pas en TSE
Vérifiez le numéro de poste -Pxx, le dossier ouvert, les droits de la session et la configuration propre à la liste dans cette session. Contrôlez aussi la présence de l’utilitaire dans le répertoire accessible.
Une règle de date donne des résultats incohérents
Utilisez l’assistant de condition, vérifiez le format régional et distinguez la date vide, la date du jour et une date dépassée. Testez sur plusieurs lignes connues.
La liste devient difficile à lire
Réduisez le contraste, la taille de police ou le nombre de règles. Conservez la couleur la plus forte pour le cas prioritaire et ajoutez une colonne de statut explicite.

19. Liste de contrôle

  • La liste propose l’onglet Styles conditionnels.
  • Le Pack caisse (fonctions avancées) ou le mode aperçu est identifié.
  • Les styles sont enregistrés dans WKW_STYLE_EDITEUR.
  • Les couleurs et polices restent lisibles.
  • Le champ USER_STYLE est ajouté.
  • Les expressions utilisent les champs de la bonne liste.
  • Les règles les plus précises sont placées en premier.
  • L’aperçu est contrôlé.
  • La liste est fermée puis rouverte.
  • Chaque condition et chaque chevauchement sont testés.
  • La signification des couleurs est documentée.

20. Résultat attendu

Les lignes correspondant aux critères utilisent automatiquement la couleur et la police prévues, les priorités sont respectées et l’affichage reste stable après fermeture puis réouverture de la liste.

21. Sources documentaires

  • Tutoriel KWISATZ — Les styles conditionnels.
  • Suivi de développement KWISATZ — création des styles et conditions en décembre 2017.
  • Suivi de développement KWISATZ — extension aux sélections rapides en mars 2019.
  • Version 3.52R8 — éditeur de vingt styles et bouton Appliquer.
  • Version 3.52R9 — styles dans les onglets clients et fournisseurs.