user_manual FR

Manuel Utilisateur

Guide de référence complet pour utiliser QElectroTech afin de créer des schémas électriques, des plans d'exécution et des dessins d'automatisation.

Table des Matières

1. Principes de Base
2. Aperçu de l'Interface
3. Projets et Folios
4. Travailler avec les Éléments
5. Dessiner les Fils et les Conducteurs
6. Texte, Étiquettes et Annotations
7. Édition et Formatage du Schéma
8. Rapports et Documentation
9. Exportation et Impression
10. Préférences et Paramètres
11. Sujets Avancés
12. Dépannage

---

Principes de Base

Lancer QElectroTech

Linux/macOS/Windows :

• Double-cliquez sur l'application QElectroTech
• Ou lancez depuis le terminal : qelectrotech

Spécifique à la Plateforme :

• Linux : Également disponible via gestionnaire de paquets (apt install qelectrotech)
• macOS : Faites glisser depuis Applications vers Dock pour un accès facile
• Windows : Épinglez au Menu Démarrer ou au Bureau pour un lancement rapide

Quitter l'Application

• Fichier → Quitter (ou Fichier → Fermer)
• Fermez la fenêtre principale
• Enregistrez vos projets avant de quitter

Obtenir de l'Aide dans QET

• Aide → Manuel — Ouvre le manuel PDF officiel
• Aide → À propos — Affiche la version et les crédits
• Clic droit sur les éléments pour l'aide contextuelle

---

Aperçu de l'Interface

Espace de Travail Principal

┌─────────────────────────────────────────────────────────┐
│ Barre de Menu (Fichier, Édition, Affichage, Insertion, Outils, Aide)      │
├─────────────────────────────────────────────────────────┤
│  Barre d'Outils (Sélection, Fil, Texte, Formes, etc.)           │
├─────────┬─────────────────────────────┬─────────────────┤
│ Projet  │                             │  Panneau        │
│ Panel   │   CANEVAS DE DIAGRAMME      │  Éléments       │
│         │   (Votre zone de dessin)    │  (Recherche &   │
│ (Folios)│                             │  Parcourir)     │
│         │                             │  Propriétés     │
│         │                             │  (Élément       │
│         │                             │   sélectionné)  │
├─────────┴─────────────────────────────┴─────────────────┤
│ Barre de Statut (Coordonnées, Zoom, Mode Actuel)          │
└─────────────────────────────────────────────────────────┘

Panneaux Clés

Panneau Éléments (Côté Droit)

• Boîte de recherche pour trouver des composants
• Catégories pour parcourir
• Faites glisser les éléments sur le canevas
• Affiche les informations sur les éléments « Master » et les connexions

Panneau Projet (Côté Gauche)

• Liste tous les folios (pages) dans votre projet
• Ajouter de nouveaux folios (diagrammes)
• Organiser et renommer les folios
• Clic droit pour les propriétés du folio

Barre d'Outils

• Outil Sélection — Sélectionner et déplacer les objets
• Outil Fil — Dessiner les connexions électriques
• Outil Texte — Ajouter des étiquettes et des annotations
• Outils de Formes — Ajouter des rectangles, cercles, polygones
• Contrôles de Zoom — Agrandir/réduire la vue

Panneau Préférences (Menu Fenêtres)

• Afficher/masquer les panneaux latéraux selon les besoins
• Personnaliser la disposition de l'espace de travail
• Enregistrer les espaces de travail personnalisés

Personnaliser Votre Espace de Travail

• Affichage → Panneaux — Afficher/masquer les panneaux latéraux
• Affichage → Barres d'Outils — Afficher/masquer les barres d'outils
• Faites glisser les panneaux pour les repositionner
• Double-cliquez sur les onglets du panneau pour flotter/ancrer

---

Projets et Folios

Créer un Nouveau Projet

Fichier → Nouveau projet crée un projet vierge immédiatement — il n'y a ni assistant ni dialogue de réglages à cette étape. Le nouveau projet démarre avec un folio vide, en reprenant les valeurs par défaut de bordure, de conducteur et de cartouche héritées (voir Propriétés du projet pour changer ensuite la taille de page, les marges et les autres réglages par défaut).

Comprendre les Folios

Un folio est une seule page/un seul diagramme dans votre projet. QET n'a pas de « type de folio » à choisir à la création : un folio est un folio, et ce qu'il finit par montrer (unifilaire, multifilaire, logique de commande…) tient uniquement à ce que vous y dessinez.

Pour créer un nouveau folio, clic droit dans le Panneau Projet → Ajouter un folio. Il est ajouté immédiatement, avec les réglages par défaut de bordure, de conducteur et de cartouche du projet — là encore, sans dialogue ni choix de type.

Organiser Votre Projet

• Renommer les folios : Clic droit sur folio → Renommer
• Réorganiser les folios : Faites glisser et déposez dans le Panneau Projet
• Supprimer les folios : Clic droit → Supprimer (confirmer)
• Propriétés du folio : Clic droit → Propriétés
  • Informations de cartouche — voir Modèles de cartouche
  • Auteur, date et autres champs de cartouche

Ouvrir et Enregistrer les Projets

Ouverture :

• Fichier → Récent — Accès rapide aux projets récents
• Fichier → Ouvrir — Parcourir les fichiers .qet
• Ctrl+O (ou Cmd+O) — Raccourci clavier

Enregistrement :

• Fichier → Enregistrer — Enregistrer le projet actuel (Ctrl+S)
• Fichier → Enregistrer Sous — Enregistrer avec un nouveau nom
• QET écrit périodiquement une sauvegarde de secours en arrière-plan (pas une « sauvegarde automatique » réglable — il n'y a aucun paramètre pour son intervalle). Si QET se ferme de façon inattendue, il propose de restaurer cette sauvegarde à la prochaine ouverture du projet.

Format de Fichier :

• Les projets QElectroTech sont enregistrés en tant que fichiers .qet
• Format basé sur XML, lisible par l'homme
• Peut être ouvert dans un éditeur de texte si nécessaire

---

Travailler avec les Éléments

Trouver des Éléments

Méthode de Recherche :

1. Tapez dans la boîte de recherche en haut du Panneau Éléments
2. Les résultats apparaissent instantanément au fur et à mesure que vous tapez
3. Cliquez sur l'élément pour le sélectionner pour le placement

Parcourir par Catégorie :

1. Développez les catégories dans le Panneau Éléments
2. Catégories organisées par type électrique (interrupteurs, relais, etc.)
3. Sous-catégories pour les familles de composants spécifiques

Les catégories de premier niveau de la collection livrée portent des noms inspirés de la numérotation IEC — 10_allpole, 20_logic, 30_hydraulic, 50_pneumatic, 60_energy — chacune avec plusieurs niveaux de sous-catégories. Il n'y a pas de courte liste fixe à retenir : parcourez l'arborescence ou utilisez la recherche.

Placer les Éléments

Glisser-Déposer :

1. Cliquez et maintenez un élément dans le Panneau Éléments
2. Faites-le glisser sur votre canevas
3. Relâchez pour placer
4. L'élément apparaît à la position du curseur

Placements Multiples :

• Ne relâchez pas dans le Panneau Éléments, cliquez simplement plusieurs fois sur le canevas
• Pratique pour ajouter de nombreux éléments identiques

Faire pivoter après placement :

• Sélectionnez l'élément et appuyez sur Espace pour pivoter de 90° à chaque fois

Sélectionner les Éléments

Sélection Unique :

• Cliquez sur l'élément avec l'outil Sélection

Multi-Sélection :

• Maintenez Ctrl (ou Cmd sur Mac) et cliquez sur les éléments
• Ou faites glisser une boîte de sélection autour de plusieurs éléments

Sélectionner Tout :

• Édition → Tout Sélectionner (Ctrl+A)
• Ou utilisez Ctrl+A

Déplacer et Positionner les Éléments

Déplacer :

1. Cliquez sur l'élément pour le sélectionner (les poignées apparaissent)
2. Faites-le glisser vers la nouvelle position
3. Maintenez Maj pour être limité à horizontal/vertical

Positionnement Précis :

• Utilisez les touches fléchées pour décaler les éléments sélectionnés
• Maintenez Maj pour des sauts plus importants

Accrochage à la Grille :

• Les éléments s'accrochent à la grille par défaut
• Basculer l'accrochage à la grille : Affichage → Accrochage à la Grille
• Ajuster la taille de la grille : Préférences → Grille

Dupliquer les Éléments

Copier et Coller :

1. Sélectionnez l'élément (les éléments)
2. Ctrl+C pour copier
3. Ctrl+V pour coller (apparaît décalé de l'original)
4. Faites-le glisser à la position finale

Duplication Rapide :

1. Sélectionnez l'élément
2. Édition → Dupliquer
3. La nouvelle copie apparaît à proximité

Rotation

Sélectionnez le ou les éléments et appuyez sur Espace pour pivoter de 90°, ou clic droit → Pivoter. Maj+Espace fait pivoter une sélection groupée en bloc plutôt qu'élément par élément ; Ctrl+Espace ne fait pivoter que les étiquettes/textes, pas le graphisme.

Il n'existe pas d'action de retournement/miroir pour les éléments placés sur un folio — retourner un symbole se fait une fois pour toutes, dans l'éditeur d'élément, en redessinant ou en retournant le symbole lui-même.

Supprimer les Éléments

• Sélectionnez l'élément (les éléments)
• Appuyez sur la touche Supprimer
• Ou clic droit → Supprimer
• Utilisez Ctrl+Z pour annuler la suppression

---

Dessiner les Fils et les Conducteurs

Comprendre les Conducteurs

Un conducteur est une connexion électrique entre les éléments (les fils/lignes).

Types :

• Unifilaire — Représentation simplifiée
• Multifilaire — Les lignes de conducteurs individuels sont affichées

Dessiner les Fils

Dessin Basique du Fil :

1. Cliquez sur l'Outil Fil (icône d'éclair)
2. Cliquez sur une borne (point de connexion sur l'élément)
3. Déplacez la souris vers la borne de destination
4. Cliquez pour compléter le fil
5. Le fil est tracé, automatiquement acheminé

Fils Multi-Segments :

1. Cliquez sur la première borne (point de départ)
2. Cliquez sur les points intermédiaires pour l'acheminement
3. Cliquez sur la borne finale (point de fin)
4. Appuyez sur Échap pour terminer

Acheminement du Fil :

• L'acheminement automatique crée généralement des chemins orthogonaux (angles droits)
• Cliquez sur les points de passage pour contrôler le chemin
• Appuyez sur Échap pour abandonner le fil

Éditer les Fils

Modifier le Chemin du Fil :

1. Sélectionnez le fil (cliquez dessus)
2. Faites glisser les points de passage pour ajuster l'acheminement
3. Clic droit sur le point de passage pour le supprimer

Supprimer le Fil :

• Sélectionnez le fil
• Appuyez sur Supprimer

Les fils ne se connectent qu'aux bornes — deux fils qui se croisent sur le canevas ne se rejoignent pas, sauf s'ils se rencontrent réellement à une borne.

Propriétés du Fil

Changer l'Apparence du Fil :

1. Clic droit sur le fil
2. Sélectionnez Propriétés
3. Modifiez :
   • Couleur (à partir de la palette de couleurs)
   • Style (solide, en tirets, pointillé)
   • Épaisseur (largeur de ligne)

Propriétés du Conducteur :

1. Clic droit sur le fil
2. Sélectionnez Propriétés du Conducteur
3. Définissez :
   • Type de conducteur (phase, neutre, terre, etc.)
   • Propriétés électriques
   • Schéma de numérotation

---

Texte, Étiquettes et Annotations

Ajouter des Étiquettes de Texte

Méthode de l'Outil Texte :

1. Cliquez sur l'Outil Texte (icône A) dans la barre d'outils
2. Cliquez sur le canevas où vous voulez du texte
3. Tapez votre texte
4. Cliquez ailleurs pour terminer

Étiquettes Rapides sur les Éléments/Fils :

1. Double-cliquez sur l'élément ou le fil
2. Tapez le texte (par exemple, "S1" pour commutateur 1)
3. Appuyez sur Entrée
4. L'étiquette apparaît sur l'objet

Étiquetage des Fils

Étiquettes de fil courantes :

• Noms de signal : "L1", "L2", "N", "PE" (terre)
• Tension : "24V AC", "12V DC"
• Fonction : "Activé", "Réinitialiser", "Alarme"

Pour ajouter une étiquette de fil :

1. Double-cliquez sur le fil
2. Tapez le texte d'étiquette
3. Appuyez sur Entrée

Étiquetage des Éléments

Étiquettes d'élément courantes :

• Désignateur de référence : "S1" (interrupteur 1), "R1" (relais 1), "M1" (moteur 1)
• Valeur du composant : "100kΩ", "10µF"
• Description : "Commutateur Alimentation", "Bouton Démarrage"

Pour ajouter une étiquette d'élément :

1. Double-cliquez sur l'élément
2. Tapez la référence (par exemple, "Q1")
3. Appuyez sur Entrée

Champs de Texte Dynamiques

Un champ de texte dynamique peut afficher une valeur vivante plutôt qu'un texte fixe — l'étiquette d'un élément, un numéro de folio, une référence fabricant, et bien plus. C'est tout un langage de variables à part entière, et les variables valides diffèrent selon l'endroit (une étiquette d'élément n'a pas le même jeu qu'un champ de folio). Voir Variables et formules pour la référence complète — mieux vaut la consulter avant de deviner un nom de variable, car une variable non reconnue reste silencieusement affichée comme texte littéral, sans erreur.

Formatage du Texte

Police et Style :

1. Sélectionnez l'élément de texte
2. Clic droit → Propriétés
3. Configurez :
   • Famille de police (Arial, Times, etc.)
   • Taille (points)
   • Couleur
   • Orientation (horizontal, vertical, 45°, etc.)

---

Édition et Formatage du Schéma

Sélection et Organisation

Sélectionner Tous les Objets :

• Édition → Tout Sélectionner (Ctrl+A)

Sélectionner par Type :

• Édition → Sélectionner (sous-menu pour sélectionner des types spécifiques)

Conseils Multi-Sélection :

• Maintenez Ctrl et cliquez pour ajouter à la sélection
• Maj+clic pour sélectionner la plage
• Faites glisser la boîte pour sélectionner tout dedans

Alignement et Distribution

Aligner les Objets :

1. Sélectionnez plusieurs objets
2. Clic droit → Aligner
3. Choisissez : Gauche, Droite, Haut, Bas, Centre

Distribuer l'Espacement :

1. Sélectionnez les objets (3 ou plus)
2. Clic droit → Distribuer
3. Espacer uniformément horizontalement ou verticalement

Fonctionnalités Grille et Accrochage

Paramètres de la Grille :

• Affichage → Accrochage à la Grille — Basculer l'accrochage on/off
• La taille de grille par défaut se règle dans la page de préférences Général — voir Référence des préférences
• Grille plus petite = positionnement plus fin ; plus grande = placement plus rapide

Conseils d'Alignement :

• Activez l'accrochage pour des diagrammes nets et alignés
• Désactivez pour un placement libre
• Basculer avec le raccourci clavier

Annuler et Refaire

Annuler :

• Ctrl+Z (ou Cmd+Z sur Mac)
• Édition → Annuler dans le menu
• Annuler plusieurs étapes répétées

Refaire :

• Ctrl+Y (ou Cmd+Maj+Z sur Mac)
• Édition → Refaire dans le menu
• Refaire plusieurs étapes répétées

Zoom et Panoramique

Méthodes de Zoom :

• Molette de Défilement : Vers le haut pour agrandir, vers le bas pour réduire
• Touches +/- : Agrandir ou réduire
• Ctrl+Scroll : Contrôle de zoom fin
• Affichage → Zoom → Ajuster à la Page : Diagramme d'ajustement automatique

Panoramique (Déplacer la Vue) :

• Bouton de souris central : Cliquez et faites glisser pour faire un panoramique
• Espace + Faites glisser : Maintenez l'espace et faites glisser pour faire un panoramique
• Touches fléchées : Décaler la vue (lorsque rien n'est sélectionné)

---

Rapports et Documentation

Générer des Rapports

Il n'y a pas de menu « Rapports » séparé : une nomenclature (liste des composants) ou une liste de câblage se produit via Fichier → Exporter, ou sans interface via la ligne de commande (--export-bom, --export-wiring, --export-nets, --export-links). Voir Automatiser QElectroTech pour la liste complète et La base de données du projet pour ce que chacun interroge réellement.

---

Exportation et Impression

Imprimer les Diagrammes

Fichier → Imprimer (Ctrl+P) ouvre d'abord le dialogue d'impression natif de votre système pour choisir une imprimante (taille de papier, recto-verso, couleur ou niveaux de gris — ce que propose votre pilote ; ce ne sont pas des réglages de QET). Valider là ouvre une fenêtre d'impression avec aperçu en direct — la même fenêtre que pour Fichier → Exporter en PDF, qui saute le dialogue du système et va directement ici. Cette fenêtre permet de choisir les folios à inclure, de conserver ou non les couleurs des conducteurs, et de régler la page via un bouton séparé Mise en page (désactivé sous Windows lors d'un export PDF). Il n'y a pas d'élément de menu « Aperçu avant impression » séparé, ni de réglage d'échelle manuel — un folio s'ajuste automatiquement à la page.

Les étiquettes de fil (conducteur) sont un contenu de folio ordinaire, pas une fonction d'impression séparée. Elles s'impriment ou s'exportent avec le folio comme tout autre élément — il n'y a pas de bascule pour les inclure ou les exclure spécifiquement (contrairement aux marqueurs de bornes, qui en ont une — voir Référence des préférences §3).

QET n'a aucune imprimante intégrée d'étiquettes physiques de repérage de fil/manchon. Pour cela, exportez la liste de câblage en CSV (menu Projet, ou --export-wiring) et introduisez-la dans le logiciel propre d'une imprimante d'étiquettes — voir Automatiser QElectroTech, qui couvre le flux réel utilisé (Brady, WAGO, Phoenix Contact) et une limite connue avec des lignes dupliquées sur de gros lots.

Exporter les Diagrammes

Formats d'Exportation :

• PDF — Documents professionnels, meilleur pour le partage
• PNG — Image raster, bonne pour le web
• SVG — Format vectoriel, éditable dans d'autres logiciels
• DXF — Format CAO pour la collaboration (contours et texte uniquement, voir les limites)

Processus d'Exportation :

1. Sélectionnez le ou les folios à exporter
2. Fichier → Exporter
3. Choisissez le format et l'emplacement
4. Configurer les options d'exportation
5. Cliquez sur Exporter

---

Préférences et Paramètres

Édition → Préférences ouvre cinq pages : Général, Nouveau projet, Export, Impression et Raccourcis. Il n'y a pas de catégorie distincte « Affichage » ou « Grille » — les deux vivent dans Général. Voir la référence des préférences pour ce que chaque page contrôle réellement.

---

Sujets Avancés

Créer des Éléments Personnalisés

Utiliser l'éditeur d'élément couvre le dessin d'un élément dans l'éditeur intégré de QET — outils, placement des bornes et vérifications à l'enregistrement. Lier des éléments couvre la manière d'en faire un maître, un esclave ou une borne. Elements XML documente directement le format de fichier résultant, pour qui génère des .elmt sans passer par l'éditeur.

Collections d'Éléments et Bibliothèques

Gérer les collections couvre l'organisation des dossiers, le déplacement et la suppression d'éléments, et laquelle des trois collections (commune/personnelle/entreprise) vous pouvez réellement modifier.

Workflows Multi-Utilisateurs

QET n'a aucune fonction de travail partagé ou d'édition multi-utilisateur intégrée — un fichier .qet est édité par une seule instance à la fois, comme n'importe quel autre document (voir La base de données du projet : même le cache de requêtes en mémoire est propre à chaque processus, pas partagé). Deux options pratiques si plusieurs personnes doivent travailler sur le même projet :

• Répartir par folio. Puisqu'un projet est un ensemble de folios dans un seul fichier, convenir de qui possède quel folio évite toute collision.
• Le contrôle de version (Git ou équivalent) sur le fichier .qet. Cela fonctionne pour travailler chacun son tour, mais un véritable conflit de fusion est un conflit dans du XML brut, pas une fusion structurée de schéma — le résoudre signifie éditer le XML à la main ou choisir un côté en bloc. Prévoyez « une personne à la fois », pas une édition simultanée.

Scripting et Automatisation

QET n'a aucun langage de script embarqué. L'automatisation se fait depuis l'extérieur :

• la ligne de commande sans interface — --export-pdf, --export-bom, --export-wiring et d'autres, avec de vrais codes de retour
• l'édition directe du XML — .qet et .elmt sont du XML ordinaire

Voir Automatiser QElectroTech et la Référence ligne de commande.

---

Dépannage

Problèmes Courants

"L'élément ne se connecte pas au fil"

• Cliquez directement sur la borne (petit point)
• Tous les points sur l'élément ne sont pas connectables
• Vérifiez les propriétés de l'élément pour les définitions de borne

"Les fils se croisent sans connexion"

• Les fils ne se connectent qu'aux bornes
• Les lignes de croisement ne se connectent pas automatiquement
• Utilisez une connexion explicite aux points de borne

"Le diagramme est lent/flou"

• Les grands projets avec de nombreux éléments ralentissent la réactivité
• Réduisez le niveau de zoom pour améliorer les performances
• Désactiver l'affichage de la grille si non nécessaire
• Fermer les panneaux inutiles

"Le fichier ne s'ouvre pas"

• Fichier corrompu ou problème de compatibilité
• Essayez d'ouvrir dans un éditeur de texte pour vérifier la validité du XML
• Restaurer à partir de la sauvegarde si disponible

---

Raccourcis Clavier

Action	Windows/Linux	macOS
Nouveau	Ctrl+N	Cmd+N
Ouvrir	Ctrl+O	Cmd+O
Enregistrer	Ctrl+S	Cmd+S
Imprimer	Ctrl+P	Cmd+P
Annuler	Ctrl+Z	Cmd+Z
Refaire	Ctrl+Y	Cmd+Maj+Z
Sélectionner Tout	Ctrl+A	Cmd+A
Copier	Ctrl+C	Cmd+C
Coller	Ctrl+V	Cmd+V
Supprimer	Suppr	Suppr
Rotation de la sélection	Espace	Espace
Rotation groupée en bloc	Maj+Espace	Maj+Espace
Zoom Avant	Ctrl++	Cmd++
Zoom Arrière	Ctrl+-	Cmd+-
Ajuster à la Page	Ctrl+9	Cmd+9

---

Plus de Ressources

• Guide de Démarrage Rapide — Commencer
• Conseils et Astuces — Workflows avancés
• Questions Fréquentes — Questions courantes
• Manuel Officiel — Documentation complète
• Forum — Aide communautaire

---

Obtenir de l'Aide

• Questions Fréquentes — Réponses rapides
• Forum — Posez des questions à la communauté (très actif !)
• Problèmes — Signaler les bugs
• Créer des Éléments — Construire des composants personnalisés

---

🌐 Choisir la Langue — English · Français · Deutsch