Version de développement

Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.

Impression et formats d'impression

Formats d'impression

Exemple — Bureau Moderne Le responsable administratif de Bureau Moderne souhaite créer un format de bon de commande avec le logo en en-tête, les colonnes articles à gauche et le total à droite. Il ouvre la liste des formats d'impression, crée un nouveau format via la nouvelle fenêtre de dialogue, choisit le type « Constructeur » et est redirigé directement vers l'éditeur visuel — sans remplir de formulaire technique.

Un format d'impression définit la mise en page d'un document (facture, devis, bon de commande, etc.) lorsqu'il est imprimé ou exporté en PDF. Dokos propose un constructeur visuel pour créer et modifier ces formats sans connaissances techniques, ainsi qu'une option d'édition HTML pour les utilisateurs avancés.

Créer un format d'impression

Depuis la liste des formats d'impression

La création d'un format d'impression se fait désormais via une fenêtre de dialogue accessible directement depuis la liste des formats d'impression, remplaçant l'ancien formulaire complet qui affichait plus de 40 champs.

Comment créer un format :

Accédez à la liste des Formats d'impression via le menu de recherche (Ctrl+K) ou depuis un document en cliquant sur Imprimer > Réglages d'impression > Format d'impression.
Cliquez sur le bouton Ajouter un format d'impression.
Dans la fenêtre de dialogue qui s'ouvre, renseignez les champs suivants :
- Pour : sélectionnez le type de document (ex. : Facture de vente, Devis, Bon de commande) ou le rapport pour lequel ce format est destiné.
- Nom : donnez un nom à votre format (ex. : « Facture personnalisée — Maison Verte »).
- Type de document : le type de document est automatiquement déduit, mais peut être ajusté manuellement si nécessaire.
Cliquez sur Créer.

      
flowchart TD
    A[Liste des Formats d'impression] --> B[Cliquer sur Ajouter]
    B --> C[Dialogue de création]
    C --> D{Type de format?}
    D -->|Format de document| E[Écran de démarrage du constructeur]
    D -->|Format de rapport| F[Formulaire Format d'impression - HTML]
    E --> G{Choix du point de départ}
    G -->|Constructeur| H[Constructeur de format d'impression]
    G -->|Écrire du HTML| I[Formulaire Format d'impression - HTML]

Les formats de document ouvrent l'écran de démarrage du constructeur de format d'impression.
Les formats de rapport ouvrent directement le formulaire classique, car ils sont uniquement au format HTML.

Écran de démarrage du constructeur

Lorsque vous créez un format de document, Dokos affiche un écran de démarrage dans le constructeur, vous permettant de choisir comment vous souhaitez procéder avant d'afficher les panneaux latéraux (liste des champs et paramètres).

Options disponibles :

Constructeur : ouvre l'éditeur visuel avec un modèle de base. C'est l'option recommandée pour la plupart des utilisateurs.
Écrire du HTML : bascule le format en mode HTML personnalisé et ouvre le formulaire classique avec un modèle de démarrage. Cette option est destinée aux utilisateurs avancés souhaitant un contrôle total sur le code HTML.

Les formats standard (fournis par défaut avec Dokos) ne sont modifiables dans le constructeur qu'en mode développeur.
L'intention (constructeur ou HTML) est demandée dès la création : Dokos ne devine jamais le type de format à votre place.

Édition CSS personnalisée

Le constructeur de format d'impression intègre désormais un éditeur CSS personnalisé directement dans le panneau des paramètres, permettant d'appliquer des styles avancés au format sans quitter l'éditeur.

Comment éditer le CSS :

Ouvrez un format dans le constructeur de format d'impression.
Ouvrez le panneau Paramètres (icône ⚙️ dans la barre latérale).
Activez l'option CSS personnalisé.
Saisissez vos règles CSS dans l'éditeur qui apparaît.
Le CSS est appliqué en temps réel sur le canevas d'aperçu.

Le CSS saisi dans le constructeur est limité au canevas d'aperçu et au rendu final du format. Il ne s'applique pas à l'interface de Dokos.
Pour les formats créés avec le constructeur, la section CSS du formulaire classique est masquée. Utilisez le panneau des paramètres du constructeur.

Modifier un format d'impression existant

Depuis la liste des formats

La liste des formats d'impression adapte désormais le comportement des liens en fonction du type de format :

Formats du constructeur : un clic ouvre directement le constructeur de format d'impression.
Formats standard : un clic ouvre le constructeur uniquement en mode développeur. Hors mode développeur, ils ouvrent le formulaire classique.
Formats personnalisés / JS / HTML / Rapport / Print Designer : un clic ouvre le formulaire classique.

Si vous avez créé un format avec le constructeur et que vous souhaitez revenir au formulaire classique, utilisez l'icône Modifier le format d'impression (✏️) disponible dans la barre d'en-tête du constructeur.

Redirection automatique vers le constructeur

Si un format est créé ou modifié depuis le formulaire classique (via la barre de recherche) et qu'il est de type « constructeur », Dokos le redirige automatiquement vers le constructeur de format d'impression après le premier enregistrement, pour s'assurer que l'édition se fait dans l'outil approprié.

      
flowchart TD
    A[Formulaire classique - Format d'impression] --> B[Enregistrer le format]
    B --> C{Type de format?}
    C -->|Constructeur| D[Redirection automatique vers le constructeur]
    C -->|HTML/JS| E[Rester sur le formulaire classique]