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.
Réponse directe
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.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.
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. |
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.
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.
- Ouvrez la liste à personnaliser.
- Accédez à la configuration des colonnes ou de l’écran.
- Ouvrez l’onglet Styles conditionnels.
- Cliquez sur Configuration des styles.
- Sélectionnez un numéro de style libre.
- Choisissez la couleur de fond.
- Choisissez la couleur du texte.
- Choisissez la police, son style et sa taille si ces zones sont proposées.
- Donnez une apparence suffisamment lisible.
- Enregistrez les styles avant de fermer l’éditeur.
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.
- Ouvrez l’onglet des colonnes.
- Recherchez le champ
USER_STYLE. - Ajoutez-le à la liste.
- Cochez l’option Invisible si vous ne souhaitez pas l’afficher.
- Enregistrez la configuration.
USER_STYLE, les expressions peuvent être correctement saisies
sans produire aucun changement visuel.
8. Définir les conditions
Dans l’onglet Styles/Conditions ou Styles conditionnels, la documentation décrit cinq lignes de condition.
- Cliquez sur le bouton de la première ligne.
- Utilisez l’assistant de filtre ou d’expression.
- Choisissez le champ à tester.
- Choisissez l’opérateur.
- Saisissez ou choisissez la valeur.
- Validez l’expression.
- Associez le numéro du style à cette condition.
- 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. |
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
- Condition générale : tous les documents non soldés.
- 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é
- Documents non soldés et en retard — style rouge.
- Documents non soldés mais non échus — style orange.
- Documents soldés — aucun style ou style neutre.
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. |
- Créez les styles 1 et 2 dans l’éditeur.
- 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. - Créez la condition
NET_A_PAYER <> 0sur la première ligne. - Associez le style 1.
- Créez la condition
TOTAL_TTC < 0sur la deuxième ligne. - Enregistrez et rouvrez la liste.
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. |
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.
- Créez ou modifiez les styles.
- Définissez les conditions.
- Cliquez sur Appliquer.
- Contrôlez les couleurs, polices et priorités.
- Corrigez les règles si le résultat est trop large.
- Enregistrez la configuration lorsque la licence le permet.
13. Enregistrer et valider
- Enregistrez les styles dans WKW_STYLE_EDITEUR.
- Enregistrez les conditions de la liste.
- Vérifiez la présence de
USER_STYLE. - Fermez complètement la liste.
- Rouvrez-la depuis son menu d’origine.
- Testez une ligne correspondant à chaque condition.
- Testez une ligne correspondant à plusieurs conditions.
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.
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.
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.
17. Sauvegarde et déploiement
Avant de déployer une configuration sur plusieurs utilisateurs :
- notez la liste et le dossier concernés ;
- notez le numéro et la signification de chaque style ;
- conservez les expressions dans une fiche de paramétrage ;
- effectuez une sauvegarde de la configuration des listes et du dossier ;
- testez sur un poste pilote ;
- vérifiez la disponibilité du même éditeur et de la même version sur les autres postes ;
- contrôlez le résultat dans chaque session TSE ou numéro de poste concerné.
18. Diagnostic rapide
Aucun style ne s’applique
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
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
Le mauvais style est appliqué
Une condition paraît toujours fausse
La police ou la couleur ne change pas
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
Les styles fonctionnent sur un poste mais pas en TSE
-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
La liste devient difficile à lire
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_STYLEest 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
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.