Le patron commun à tous les écrans (journaux)

La grande majorité des écrans de SuperPharm — appelés journaux — sont bâtis sur le même modèle. Comprendre ce modèle une fois suffit pour se servir de tous les autres.

┌─ Titre de l'écran ─────────────────── [boutons secondaires] [BOUTON PRINCIPAL] ┐
│  ┌ Recherche avancée (bandeau bleu) ─────────────────────────────────────────┐ │
│  │  critère ▾ | opérateur ▾ | valeur | 🔍      … autres critères …  [Rechercher]│
│  └───────────────────────────────────────────────────────────────────────────┘ │
│  ┌ Grille ───────────────────────────────────────────────────────────────────┐ │
│  │ 🔍 Rechercher…   [Filtres] [Grouper ▾] [Densité] [Réinitialiser] [Exporter ▾]│
│  │ colonnes triables, lignes cliquables                                       │ │
│  └───────────────────────────────────────────────────────────────────────────┘ │
│                       « ‹ 1 2 3 › »                    TOTAL (résultat filtré) │
└────────────────────────────────────────────────────────────────────────────────┘

HT-COM-001 — Rechercher dans un journal (recherche avancée)

Écran : tout journal, bandeau bleu en haut Permission : Read sur l'écran

Étapes

1. Dans la première liste déroulante, choisir le critère (le champ sur lequel chercher : Désignation, Fournisseur, Date, Montant…).

2. Choisir l'opérateur :

   Symbole	Signification	S'applique à
   =	égal	tout
   ≠	différent	tout
   ⊃	contient	texte
   ˄	commence par	texte
   ↤	se termine par	texte
   > ≥ < ≤	comparaisons	nombres, dates
   ∅	vide / non renseigné	tout
   ¬∅	renseigné	tout

3. Saisir la valeur. L'éditeur s'adapte au type du champ : texte libre, nombre, calendrier pour une date, case à cocher pour oui/non, liste pour une énumération.

4. Cliquer la loupe du critère (« Rechercher avec ce critère ») pour ne filtrer que sur celui-ci, ou le bouton « Rechercher » (« Rechercher sur tous les critères ») pour combiner tous les critères renseignés.

Résultat attendu : la grille se recharge, la pagination et les totaux se recalculent.

À savoir

• Les critères laissés vides sont ignorés : ils ne restreignent pas le résultat.
• Les critères renseignés se combinent avec un ET.
• Le filtre reste actif tant qu'on ne le vide pas : un journal « vide » est souvent un journal filtré.

Action automatisable : app.journal.rechercher (risque lecture).

HT-COM-002 — Trier, filtrer, grouper et alléger la grille

Écran : barre d'outils de la grille

Un clic sur l'en-tête d'une colonne trie ; un second clic inverse le tri.

La recherche rapide de la grille agit sur les lignes déjà chargées ; la recherche avancée du bandeau bleu interroge la base entière. Pour chercher dans tout l'historique, utiliser le bandeau bleu.

HT-COM-003 — Exporter ou imprimer le contenu d'un écran

Écran : barre d'outils de la grille ▸ Exporter ▾ Permission : Export / Print sur l'écran quand elles sont gérées

Étapes

1. Filtrer d'abord la grille pour n'exporter que ce qui est utile.
2. Cliquer « Exporter ▾ » puis choisir :
   • CSV (.csv) — pour un tableur ou un import ;
   • Excel (.xlsx) — classeur formaté ;
   • PDF (.pdf) — rapport imprimable reprenant le titre de l'écran, les colonnes visibles, les groupes et les totaux.
3. Choisir l'emplacement d'enregistrement.

Résultat attendu : le fichier contient exactement les lignes visibles après filtrage, dans l'ordre affiché.

Toutes les grilles du poste savent produire ce rapport PDF ; c'est le moyen normal d'imprimer une liste (journal des ventes du jour, stock d'un fournisseur, créances échues…).

HT-COM-004 — Consulter la fiche détaillée d'une ligne

Étapes

1. Cliquer sur la ligne dans la grille.
2. Le panneau « Détails … » s'ouvre : informations complètes, lignes rattachées, historique, pièces jointes selon l'écran.
3. Fermer le panneau avec ✕ ou [Échap].

Presque toutes les fiches affichent les colonnes d'audit : « Créé par », « Date création », « Modifié par », « Date modification ». C'est la trace de qui a fait quoi.

HT-COM-005 — Créer un élément

Étapes

1. Cliquer le bouton principal en haut à droite de l'écran (bouton vert). Son libellé nomme l'élément : « Client », « Fournisseur », « Entrée », « Avoir », « Rôle », « Congé »…
2. Renseigner le formulaire. Les listes déroulantes (fournisseur, produit, dépôt…) se filtrent en tapant les premières lettres ; le bouton ⟳ à côté d'une liste la recharge si un élément vient d'être créé ailleurs.
3. Cliquer « Valider » (« Valider et enregistrer »).

Erreurs fréquentes

• « Valider » ne fait rien : un champ obligatoire est vide ; il est signalé en rouge.
• Le bouton principal est absent : l'employé n'a pas la permission Create sur cet écran.

HT-COM-006 — Modifier ou supprimer un élément

Étapes

1. Ouvrir la fiche de l'élément (HT-COM-004).
2. Modifier : bouton « Modifier » (ou l'icône crayon) — « Ouvre l'élément sélectionné pour le modifier ». Corriger, puis « Valider ». « Annuler » abandonne les modifications.
3. Supprimer : bouton « Supprimer », puis confirmer.

À savoir

• Une suppression est refusée quand l'élément est déjà engagé : vente encaissée, préparation vendue, échange transmis en ligne, commande reçue, lot déjà sorti. Le message d'erreur indique la raison.
• Supprimer un document de stock rend le stock correspondant : c'est un mouvement réel, pas un simple nettoyage de liste.

HT-COM-007 — Lire les totaux d'un journal

En bas à droite de la grille, le bandeau sombre « TOTAL (résultat filtré) » affiche les totaux calculés sur l'ensemble du résultat filtré, pas seulement sur la page affichée (montants nets, TTC, quantités… selon l'écran).

La pagination « ‹ 1 2 3 › » en bas de grille change de page sans modifier ces totaux.

HT-COM-008 — Quand un bouton est absent ou grisé

Deux causes possibles :

1. Droits : l'employé n'a pas la permission. Le bouton est alors masqué. La permission se nomme Ressource:Action (exemple Inventaires:Cloturer) et s'accorde dans Employés ▸ Gestion des rôles (HT-EMP-002).
2. État : l'écran est occupé par une saisie en cours, ou l'élément est dans un état qui interdit l'action (session fermée, document déjà validé). Le bouton est alors grisé.

Certaines actions demandent en plus un code PIN dans une fenêtre « Autorisation Requise ».

Colonnes et repères visuels récurrents