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.
Généralités

Impression et PDF - Généralités

Imprimer depuis un mobile, ajouter des pages de couverture à un PDF, styler les impressions avec l'en-tête et choisir le générateur PDF.

Impression et PDF

Cette page décrit les réglages communs à toutes les impressions : l'impression depuis un mobile, les pages de couverture, le CSS de l'en-tête et le générateur PDF. Pour créer ou mettre en page un format, consultez Créer et modifier un format d'impression.

Imprimer depuis un appareil mobile

Sur un écran de moins de 992 pixels de large (tablette, téléphone), l'action Imprimer est aussi dans le menu ... du formulaire. Sur un grand écran, utilisez l'icône d'imprimante du formulaire.

  1. Ouvrez le document à imprimer.
  2. Appuyez sur le menu ... en haut à droite du formulaire.
  3. Choisissez Imprimer.
  4. Choisissez le format d'impression, puis téléchargez le PDF.

L'action Imprimer apparaît seulement dans ces conditions :

  • votre rôle a l'autorisation Imprimer sur ce type de document ;
  • le type de document n'est pas un document unique (« Single »), comme une page de paramètres ;
  • pour un document soumettable, le document est validé. Un brouillon s'imprime si « Autoriser les impressions des documents en brouillon » est coché dans les « Paramètres d'impression ». Un document annulé s'imprime si « Autoriser les impressions des documents annulés » est coché.

Ajouter des pages de couverture à un PDF

Un format d'impression peut ajouter un PDF avant le document (page de couverture) et un PDF après le document (page de couverture arrière). Dokos les ajoute à chaque PDF généré avec ce format : téléchargement, pièce jointe d'un e-mail ou envoi automatique.

  1. Créez une Page de couverture. Saisissez son « Nom de la page de couverture » et joignez le fichier PDF dans le champ « Page de couverture ».
  2. Ouvrez le Format d'impression concerné.
  3. Choisissez la page de début dans le champ « Page de couverture », et la page de fin dans le champ « Page de couverture arrière ».
  4. Enregistrez le format.

Le PDF d'une page de couverture peut contenir plusieurs pages. Une page de couverture arrière peut donc contenir des annexes, comme vos conditions générales de vente.

Exemple fictif : un cabinet de conseil crée la page de couverture « Présentation cabinet » (1 page) et la page arrière « CGV » (3 pages). Il les règle sur son format de devis. Un devis de 2 pages donne un PDF de 6 pages.

Les pages de couverture sont ajoutées seulement au PDF. L'aperçu de la page d'impression ne les montre pas.

En-têtes de lettre standards

Dokos fournit deux en-têtes de lettre standards. Ils affichent le logo, l'adresse et les coordonnées de la société.

NomUtilisé pour (« En-tête de lettre pour »)
Company LetterheadDocuments (DocType)
Company Letterhead ReportRapports (Report)

Dokos choisit un en-tête par défaut pour les documents et un autre pour les rapports :

  • Le premier en-tête créé pour les documents, ou pour les rapports, devient l'en-tête par défaut de ce groupe.
  • À la mise à jour d'un site, si un groupe n'a pas d'en-tête par défaut, un en-tête standard actif de ce groupe le devient.

Pour changer l'en-tête par défaut, ouvrez l'en-tête voulu, cochez « En-tête par défaut », puis enregistrez.

Un en-tête standard ne se modifie qu'en mode développeur. Pour l'adapter, dupliquez-le, puis modifiez la copie.

Contenu de l'en-tête « Company Letterhead »

L'en-tête « Company Letterhead » n'affiche ni le type ni le numéro du document : le format d'impression les montre déjà. Il se présente en trois zones.

  • À gauche : le logo de la société, puis le nom de la société et son adresse (rue, puis « Ville - Code postal, Région, Pays »).
  • À droite : l'identifiant fiscal, le téléphone, puis l'e-mail et le site web sur une même ligne, séparés par « · ».

Règles d'affichage :

  • Société : celle du document. Si le document n'a pas de société, Dokos utilise la société par défaut.
  • Adresse : l'adresse de la société du document, sinon l'adresse de facturation du document, sinon une adresse active liée à la société (l'adresse principale d'abord).
  • Pays : il s'affiche seulement s'il diffère du pays de la société.
  • Identifiant fiscal : le « Numéro de TVA » de la société, s'il est renseigné.
  • Téléphone et e-mail : ceux de l'adresse, sinon ceux de la société.
  • Site web : affiché sans http://, https:// ni / final.
  • Lignes vides : une information non renseignée est omise, sans ligne vide.

Exemple fictif : la société Atelier des Lilas SARL a une adresse « 12 rue des Lilas, 69003 Lyon » (même pays que la société), le numéro de TVA « FR12345678901 », le téléphone « 04 78 00 00 00 », l'e-mail « contact@atelier-lilas.example » et le site « https://www.atelier-lilas.example/ ». L'en-tête imprime à gauche le logo, « Atelier des Lilas SARL », « 12 rue des Lilas » puis « Lyon - 69003 ». À droite, il imprime l'identifiant fiscal « FR12345678901 », « 04 78 00 00 00 », puis « contact@atelier-lilas.example · www.atelier-lilas.example ». Le pays n'est pas imprimé.

Les champs GSTIN et PAN ne font pas partie de Dokos. Ils ne s'affichent dans cet en-tête que si une application tierce les ajoute à l'adresse ou à la société.
L'en-tête « Company Letterhead - Grey » n'existe plus. À la mise à jour du site, ses documents, sociétés et formats d'impression utilisent « Company Letterhead ». Si « Company Letterhead - Grey » était l'en-tête par défaut, « Company Letterhead » le devient.

Styler les impressions avec le CSS de l'en-tête

L'en-tête a un champ CSS personnalisé. Dokos ajoute ces règles CSS à chaque impression qui utilise cet en-tête. Vous pouvez ainsi avoir une charte graphique par en-tête, par exemple une par société.

  1. Ouvrez la liste En-Tête.
  2. Ouvrez l'en-tête à styler, ou créez-en un.
  3. Saisissez vos règles dans le champ CSS personnalisé.
  4. Enregistrez, puis ouvrez l'aperçu d'un document pour vérifier le rendu.
/* Exemple : en-tête de tableau vert et police globale */
.print-format {
  font-family: 'Arial', sans-serif;
}
.print-format th {
  background-color: #2e7d32;
  color: #ffffff;
}

Le format d'impression a aussi un champ « CSS personnalisé ». Utilisez-le pour un style propre à un format.

À l'installation d'un nouveau site, Dokos choisit aussi un format d'impression par défaut pour 8 types de documents. Consultez Formats d'impression par défaut pour les nouveaux sites.

Choisir le générateur PDF

Le générateur PDF transforme le document en fichier PDF. Il se règle à deux niveaux :

  • Pour tout le site : champ Générateur PDF des « Paramètres d'impression ». Choix : chrome ou PlutoPrint. La valeur par défaut est PlutoPrint.
  • Pour un format d'impression : champ Générateur PDF du format. Il remplace le réglage du site. Choix : chrome, PlutoPrint ou Typst. Un nouveau format est créé avec PlutoPrint. Le format standard d'un type de document n'impose pas de générateur : il suit le réglage du site (PlutoPrint si le réglage est vide).
GénérateurUsage
PlutoPrintMoteur HTML léger, par défaut. Il s'exécute dans le processus de Dokos, sans lancer de navigateur. Voir Quand PlutoPrint laisse la main à Chromium.
chromeRendu d'un navigateur récent : CSS Grid, Flexbox, variables CSS, JavaScript. Dokos télécharge Chromium au premier usage s'il ne le trouve pas.
TypstPour les formats créés avec l'éditeur de format d'impression. Consultez Utiliser Typst pour un format d'impression.

Le générateur wkhtmltopdf n'existe plus dans cette version. Un format qui l'utilisait passe à chrome à son prochain enregistrement.

Quand PlutoPrint laisse la main à Chromium

PlutoPrint ne sait pas rendre tous les contenus. Dans ces cas, Dokos imprime le PDF avec chrome, sans erreur :

  • le format ou la page contient du JavaScript (balise script ou attribut d'événement) ;
  • le format ou le CSS de l'en-tête de lettre utilise une grille CSS (display: grid) ;
  • un format HTML personnalisé contient un code-barres dessiné dans le navigateur (balise portant l'attribut data-barcode-value). Les codes-barres du constructeur de format d'impression ne sont pas concernés : Dokos les dessine sur le serveur et PlutoPrint les imprime ;
  • l'impression demande une plage de pages précise ;
  • PlutoPrint n'est pas installé sur le serveur. Il est fourni pour Linux x86_64, macOS arm64 et Windows ; sur une autre machine, tous les PDF sont imprimés avec Chromium.

À l'enregistrement d'un format, les contrôles sont plus stricts :

  • Pour un nouveau format réglé sur PlutoPrint, si le format contient du JavaScript ou une grille CSS, Dokos le règle sur chrome et affiche « Générateur PDF défini sur Chromium : » suivi du motif (par exemple « Grille CSS »).
  • Pour un format existant réglé sur PlutoPrint, l'enregistrement est refusé avec le message « Ce format ne peut pas utiliser le moteur de rendu PlutoPrint : » suivi du motif (titre « Moteur de rendu PlutoPrint indisponible »). Les motifs possibles sont « JavaScript », « Grille CSS » et « PlutoPrint n'est pas installé sur ce serveur ». Choisissez chrome ou retirez l'élément signalé.

Exemple fictif : l'atelier Maison Verte SARL crée un format de bon de livraison avec du HTML contenant une grille CSS, et laisse le générateur sur PlutoPrint. À l'enregistrement, Dokos règle le format sur chrome et indique « Grille CSS ». Le PDF est généré avec Chromium.

Différences de rendu avec Chromium

PlutoPrint est un moteur léger : certains effets CSS peuvent y être rendus autrement qu'avec Chromium, et le nombre de pages peut différer. Contrôlez le PDF d'un format important avec les deux moteurs avant de le mettre en service.

Contrôler les sauts de page

Ajoutez des règles CSS dans le champ « CSS personnalisé » du format d'impression ou de l'en-tête.

/* Garder une section entière sur la même page */
.section-break {
  page-break-inside: avoid;
}

/* Forcer un saut de page avant un bloc qui a la classe break-before */
.break-before {
  page-break-before: always;
}

/* Éviter une ligne seule en haut ou en bas de page */
p {
  orphans: 3;
  widows: 3;
}

Créer un format avec l'éditeur visuel

L'éditeur de format d'impression permet d'organiser les sections, les colonnes et les tableaux d'un format sans écrire de code. Consultez Créer et modifier un format d'impression et Mettre en page un format d'impression.

L'application Print Designer propose un éditeur visuel par glisser-déposer pour créer des formats d'impression sans écrire de HTML. Elle est dépréciée : à partir de Dodock v5.50, l'éditeur de format d'impression intégré à Dodock la remplace, sans application supplémentaire (voir Modifier avec l'éditeur visuel). Pour un nouveau format, utilisez cet éditeur intégré. Les formats existants de Print Designer restent utilisables tant que l'application est installée.

Print Designer