Formats d'impression

Un format d'impression définit la présentation d'un document imprimé, envoyé par e-mail ou téléchargé en PDF. Chaque format est lié à un type de document (par exemple Facture de vente) ou à un rapport.

Deux niveaux de réglage existent :

• Les paramètres d'impression sont globaux. Ils s'appliquent à tous les formats.
• Chaque format d'impression a ses propres réglages. Ils ne s'appliquent qu'à ce format.

Prérequis

• Avoir le droit de créer ou de modifier des Formats d'impression (rôle Gestionnaire système par défaut).
• Pour définir un format par défaut, avoir le droit de modifier Personnaliser un formulaire.

Types de formats

Vous ne pouvez pas modifier un format standard. Le formulaire affiche « Veuillez créer un duplicata pour faire des changements ». Dupliquez-le (Menu > Dupliquer), donnez un autre nom à la copie, puis modifiez la copie.

Créer un format d'impression

1. Ouvrez la recherche (Ctrl+K), saisissez Format d'impression et ouvrez la liste.
2. Cliquez sur Créer. Une boîte de dialogue s'ouvre.
3. Dans « Print Format For », choisissez DocType (un type de document) ou Report (un rapport).
4. Sélectionnez le type de document ou le rapport.
5. Saisissez le Nom du format.
6. Dans « Commencer avec », choisissez « Éditeur de format d'impression » (éditeur visuel) ou HTML. Un format de rapport est toujours en HTML.
7. Cliquez sur Créer.

Un format créé avec l'éditeur visuel s'ouvre directement dans l'éditeur. Un format HTML s'ouvre dans son formulaire.

Vous pouvez aussi partir de l'aperçu d'impression d'un document : cliquez sur Menu > Personnaliser.

• Si le format affiché est un de vos formats, Dokos l'ouvre dans son éditeur ou son formulaire.
• Sinon, Dokos demande le Nouveau format d'impression, puis ouvre une copie dans l'éditeur visuel.

Modifier avec l'éditeur visuel

L'éditeur affiche le format sur un canevas. Ajoutez des champs du document, des sections, des tableaux, des images ou des codes-barres, puis déplacez-les.

Cliquez sur le canevas en dehors de tout élément pour afficher les réglages du format dans l'inspecteur. Les réglages sont rangés en groupes repliables. Dans la v5, plusieurs libellés de l'éditeur ne sont pas encore traduits : le tableau les reprend tels qu'ils s'affichent.

Le moteur PDF par défaut est Chromium. « PlutoPrint (light) » et « Typst (fast) » sont aussi proposés et marqués Expérimental. Typst n'est disponible que si le format ne contient aucun élément incompatible. Si le format contient un bloc Typst, Chromium et PlutoPrint ne sont plus disponibles. Un format qui utilise encore WeasyPrint affiche « Deprecated, removed in version 17 » : choisissez un autre moteur.

Vos modifications sont enregistrées dans un brouillon. Cliquez sur « Save & Apply » pour les utiliser lors des impressions. L'historique des versions permet de revenir à une version appliquée.

Cet éditeur remplace l'application Print Designer, dépréciée à partir de Dodock v5.50.

Un format de l'ancien constructeur affiche le bouton « Convertir vers le nouvel éditeur » dans son formulaire. Après la conversion, le bouton « Restaurer la mise en page classique » restaure l'ancienne mise en page.

Écrire un format personnalisé (HTML/Jinja)

Dans le formulaire du format :

1. Cochez Format personnalisé.
2. Choisissez le Type de format d'impression : Jinja ou JS.
3. Saisissez le modèle dans le champ HTML.
4. Ajoutez vos règles dans CSS personnalisé si besoin.
5. Enregistrez.

Le modèle accède au document par la variable doc. Vous pouvez utiliser les classes de Bootstrap 3.3, inclus dans les feuilles d'impression.

Exemple : afficher le compte bancaire par défaut du client sur une facture (le champ default_bank_account est un exemple, vérifiez le nom du champ sur votre site) :

{% set bank_account = frappe.db.get_value("Customer", doc.customer, "default_bank_account") %}
<div class="row">
    <div class="col-xs-3 text-right">{{ _("Bank Account") }}</div>
    <div class="col-xs-9">{{ bank_account or "" }}</div>
</div>

Les fonctions disponibles dans les modèles sont listées dans Modèles Jinja.

Si votre imprimante accepte des commandes brutes, cochez Impression brute et saisissez les Commandes brutes. Voir Impression brute.

Champs du formulaire

Définir le format par défaut

1. Ouvrez le format d'impression.
2. Cliquez sur Définir par défaut.

Le bouton n'apparaît pas si le format est déjà le format par défaut du type de document. Dans l'aperçu d'impression, le menu propose aussi « Set as Default Format » (libellé non traduit).

Page d'impression

La page d'impression d'un document affiche l'aperçu et une barre latérale. Pour son usage pas à pas, voir Page d'impression.

Le menu de la page d'impression propose :

La section Page de la barre latérale change la taille du papier (« Paper Size », libellé non traduit) et l'Orientation pour une impression. Les tailles proposées sont « Par défaut », A4, A5, A3, Letter, Legal et Tabloid. Cette section est masquée pour l'impression brute. Elle reste visible pour les formats personnalisés (HTML/Jinja ou JS).

Avec le format Standard, la section Style présente les styles d'impression actifs sous forme de cartes. Le code de la page cite aussi un style « Redesign » parmi les styles standard. Aucun style de ce nom n'est livré avec Dokos : il n'apparaît pas dans les cartes.

Exemple fictif : Paul imprime un bon de livraison en A5 paysage pour une seule fois. Dans la section Page, il choisit A5 et Paysage, puis clique sur Imprimer. Le format d'impression n'est pas modifié.

Ajouter une page de couverture

Une page de couverture est un fichier PDF ajouté au début du PDF généré. Une page de couverture arrière est ajoutée à la fin.

1. Ouvrez la recherche (Ctrl+K) et saisissez Page de couverture.
2. Créez une page : saisissez son nom et joignez le PDF.
3. Ouvrez le format d'impression et sélectionnez-la dans Page de couverture ou Page de couverture arrière.

Exemple fictif : vous joignez vos conditions générales de vente en PDF comme page de couverture arrière du format « Facture Atelier ». Chaque facture téléchargée en PDF avec ce format se termine par ces conditions.

Cas d'usage

Ajouter un titre au-dessus d'une ligne d'article

Le tableau d'articles des formats standard de Dokos imprime une ligne de titre au-dessus d'un article quand la ligne a une valeur dans un champ nommé title ou print_title.

1. Ouvrez Personnaliser un formulaire sur le tableau d'articles, par exemple Article de la facture de vente.
2. Ajoutez un champ de type Données dont le nom technique est print_title.
3. Cochez Autoriser les modifications après validation et Masquer à l'impression.
4. Cliquez sur Mettre à jour.

Le titre saisi sur une ligne s'imprime au-dessus de cette ligne.

Ajouter un texte au-dessus du tableau des articles

1. Ouvrez Personnaliser un formulaire sur le type de document.
2. Ajoutez un champ du type voulu (par exemple Texte) et donnez-lui un libellé.
3. Cliquez sur Mettre à jour.
4. Dans votre format d'impression, placez ce champ juste au-dessus du tableau des articles.