Formats d'impression personnalisés

Le constructeur de format d'impression permet de créer des formats d'impression personnalisés pour vos documents (factures, devis, bons de commande, etc.) sans écrire de code. Il s'agit d'un éditeur visuel qui affiche en temps réel les modifications que vous apportez.

Accéder au constructeur

1. Ouvrez le document pour lequel vous souhaitez créer un format d'impression (par exemple, une Facture de vente).
2. Ouvrez son aperçu d'impression.
3. Cliquez sur Menu > Personnaliser.
4. Si le format affiché est standard, saisissez le Nouveau format d'impression et cliquez sur Démarrer. Dokos ouvre une copie dans le constructeur. Si c'est un de vos formats, Dokos l'ouvre directement.

Vous pouvez aussi créer le format depuis la liste Format d'impression : voir Créer et modifier un format d'impression.

Interface du constructeur

Le constructeur se compose de trois zones principales :

• La zone de prévisualisation (canevas) : affiche le document tel qu'il apparaîtra à l'impression ou à l'export PDF.
• L'inspecteur de champs : panneau latéral où vous ajustez les propriétés du champ sélectionné (largeur, alignement, style, format).
• La liste des champs : arborescence de tous les champs disponibles que vous pouvez ajouter à votre format.

Personnaliser un champ

Lorsque vous cliquez sur un champ dans le canevas ou dans la liste, l'inspecteur affiche les propriétés modifiables pour ce champ. Les options disponibles dépendent du type de champ sélectionné.

Propriétés générales

Les propriétés d'un champ sont réparties dans les groupes Champ, Style, Disposition, CSS personnalisé et Visibilité. Par exemple :

• Champ : libellé, affichage du libellé, format de date.
• Style : gras, taille de police, couleur de l'étiquette et couleur de la valeur.
• Disposition : alignement (gauche, centre ou droite), taille, espacement.

Champs de type Date et DateHeure

Les champs Date et DateHeure disposent d'une option supplémentaire dans l'inspecteur : le Format de date. Cette option n'apparaît que lorsqu'un champ de ce type est sélectionné.

      
flowchart LR
    A[Sélectionner un champ Date ou DateHeure] --> B[L'inspecteur affiche l'option Format de date]
    B --> C[Choisir un format dans la liste]
    C --> D[Le canevas affiche la date selon le format choisi]
    D --> E[L'impression PDF et l'export Typst appliquent le même format]

    

Choisir un format de date

La liste déroulante Format de date présente plusieurs formats standards. Chaque option est illustrée avec la date du jour, ce qui vous permet de visualiser immédiatement le rendu de chaque format :

• « Valeur système par défaut » (premier choix) : le format de date défini pour votre site.
• Dix autres formats : dd-mm-yyyy, mm-dd-yyyy, yyyy-mm-dd, dd/mm/yyyy, dd.mm.yyyy, d MMM yyyy, d MMMM yyyy, MMM d, yyyy, MMMM d, yyyy et EEE, d MMM yyyy. La liste les affiche avec la date du jour, par exemple 25/09/2026 ou 25 septembre 2026.

Champs DateHeure

Pour les champs DateHeure, le format sélectionné s'applique à la partie date. L'heure, elle, conserve toujours le format d'heure défini dans les paramètres du site. Par exemple, si vous choisissez le format 25 septembre 2026 pour un champ DateHeure dont la valeur est 2026-09-25 14:30:00, l'impression affichera 25 septembre 2026 14:30:00.

Comportement par défaut

Si aucun format de date n'est explicitement choisi pour un champ, la date s'affiche exactement comme avant, c'est-à-dire selon le format par défaut du système. Le réglage d'un format de date par champ n'a aucun impact sur les autres champs du document.

Tableaux et colonnes

Les documents contiennent souvent des tableaux (lignes d'articles, lignes de facturation, etc.). Dans le constructeur, chaque colonne d'un tableau possède son propre éditeur accessible en cliquant sur l'en-tête de la colonne.

Format de date d'une colonne

Si une colonne de tableau contient des valeurs de type Date ou DateHeure, l'éditeur de colonne propose la même option Format de date que pour un champ individuel. Le format choisi s'applique à toutes les valeurs de cette colonne pour chaque ligne du tableau.

Export PDF et Typst

Le format de date défini par champ s'applique de manière cohérente à tous les supports d'impression :

• Impression navigateur (Chrome) : le canevas reflète directement le format choisi.
• Export PDF : le PDF généré par le serveur applique le même format.
• Export Typst : les documents Typst appliquent également le format de date défini pour chaque champ.

      
flowchart TB
    subgraph Sources
        C[Canevas du constructeur]
        P[Impression Chrome]
        E[Export PDF serveur]
        T[Export Typst]
    end
    subgraph Configuration
        F[Format de date par champ]
    end
    F --> C
    F --> P
    F --> E
    F --> T

    

Langue et noms de mois

Les noms de mois et de jours utilisés dans les formats de date (par exemple, « septembre », « mercredi ») suivent la langue de l'utilisateur qui consulte le document. Si votre profil utilisateur est configuré en français, les noms s'afficheront en français, même si le format de date choisi est un format international.

Exemple complet : personnaliser une facture

Exemple fictif : Maison Verte SARL est un client inventé.

1. Ouvrez une Facture de vente adressée à Maison Verte SARL.
2. Ouvrez l'aperçu d'impression, puis cliquez sur Menu > Personnaliser.
3. Dans le constructeur, sélectionnez le champ Date de facturation.
4. Dans l'inspecteur, sous Format de date, choisissez 25 septembre 2026.
5. Sélectionnez le champ Date d'échéance et choisissez le même format.
6. Dans le tableau des articles, cliquez sur l'en-tête de la colonne Date de livraison (si elle existe) et définissez le format 25/09/2026.
7. Le canevas affiche immédiatement les dates dans les formats choisis.
8. Cliquez sur Enregistrer et appliquer, puis imprimez la facture avec ce format.

La facture finale affiche les dates dans un format clair et adapté à vos clients francophones, tout en conservant un format compact pour les dates internes du tableau d'articles.