Personnaliser le formulaire

Frappe Books vous permet de personnaliser tous les formulaires, qu’il s’agisse d’une Facture, d’une Partie (Party) ou d’un Article (Item). Vous pouvez utiliser la fonctionnalité Personnaliser le Formulaire pour y ajouter des champs supplémentaires.

Activer la Personnalisation des Formulaires

Pour pouvoir personnaliser un formulaire, vous devez d’abord activer cette option dans les Paramètres Généraux.

Chemin : "Configuration > Paramètres > Général"

Une fois dans l’onglet Paramètres Généraux, cochez la case Activer la Personnalisation des Formulaires.

Vous devrez recharger Frappe Books pour voir l’option, vous pouvez appuyer sur "Ctrl + R" si vous êtes sous Windows ou Linux, ou "Command + R" sur macOS.

::: warning Désactivation de la personnalisation des formulaires

Désactiver la personnalisation des formulaires ne fera que cacher l’option de personnalisation des formulaires dans la barre latérale et la recherche, cela ne désactivera pas les personnalisations existantes. :::

Personnalisation des formulaires

Après avoir activé la personnalisation des formulaires et rechargé Frappe Books, rendez-vous dans la liste de vues Personnaliser le formulaire via la barre latérale.

"Setup > Customize Form"

Ensuite, cliquez sur le bouton bleu"+" pour personnaliser un type de formulaire. Cela ouvrira une nouvelle entrée de formulaire personnalisé.

Sélectionnez un Type de Formulaire à personnaliser.

::: info Type de Formulaire

Le Type de Formulaire fait référence au formulaire auquel vous souhaitez ajouter des champs, tels que Article (Item), Partie (Party), Facture de Vente (Sales Invoice), etc.

Chaque Type de Formulaire ne peut avoir qu’une seule entrée de Formulaire Personnalisé associée. :::

Une fois que vous avez sélectionné le Type de Formulaire, vous pouvez ajouter des Champs Personnalisés.

Champs Personnalisés

Chaque Type de Formulaire peut contenir plusieurs champs personnalisés. Cliquez sur le bouton Ajouter une ligne pour ajouter un nouveau Champ Personnalisé.

Saisissez son Étiquette (Label), par exemple, si vous voulez ajouter un champ couleur à un Article, vous mettrez comme Étiquette « Couleur ».

:::tip Nom du champ (Fieldname)

La saisie de l’Étiquette définira automatiquement la valeur du Nom du champ. Le Nom du champ est le nom utilisé pour faire référence au champ en interne. :::

Après avoir défini l’Étiquette et le Nom du champ, vous pouvez sélectionner le type de champ (fieldtype). Pour plus d’informations sur les types de champ et les autres options que vous pouvez configurer pour chaque ligne de Champ Personnalisé, consultez les sections ci-dessous.

Une fois que vous avez terminé, cliquez sur le bouton bleu Enregistrer.

:::warning Recharger l’application

Après avoir personnalisé un formulaire, vous devez recharger Frappe Books pour voir les champs ajoutés dans les formulaires. :::

Après avoir rechargé l’application, vous verrez les nouveaux champs dans le formulaire.

Types de Champs Personnalisés

Les formulaires personnalisés supportent 16 types de champs différents, chaque type définissant le comportement et l’interface du champ.

Pour certains champs, vous devrez saisir des détails supplémentaires. Voici un tableau décrivant les différents types de champs :

Type de Champ
Description
Exemple
Supplémentaire

Donnée

Champ utilisé pour une saisie texte classique.

Nom complet dans Client

-

Texte

Champ avec une zone plus grande pour un texte long.

Notes dans Facture de Vente

-

Date

Champ utilisé pour saisir uniquement une date.

Date dans Facture de Vente

-

Date et Heure

Champ utilisé pour saisir date et heure.

Date dans Mouvement de Stock

-

Entier

Champ pour saisir un entier (ex : -1, 0, 3).

Code HSN/SAC dans Article

-

Nombre décimal

Champ pour saisir un nombre décimal (ex : 0.12, -9.33).

Quantité dans Article Facture

-

Devise

Champ pour saisir des montants monétaires.

Montant dans Article Facture

-

Case à cocher

Champ affichant une case à cocher.

Suivi Article dans Article

-

Sélection

Champ permettant de sélectionner un choix parmi plusieurs options. Nécessite la valeur Options.

Type d’écriture dans Journal

Options

Saisie automatique

Comme Select mais avec autocomplétion, pour plus d’options.

Pays dans Adresse

Options

Couleur

Champ pour sélectionner une couleur. Peut avoir des options pour sélectionner une couleur.

Couleur dans Paramètres d’impression

Options

Lien

Champ pour référencer un autre document. Nécessite la valeur Target.

Client dans Facture de Vente

Cible

Lien dynamique

Champ pour référencer dynamiquement selon la cible. Nécessite la valeur References.

Nom dans Référence de paiement

Références

Joindre une image

Champ pour sélectionner une image.

Image dans Article

-

Pièce jointe

Champ pour sélectionner un fichier de tout type.

Ajouter pièce jointe dans Facture de Vente

-

Tableau

Champ affichant un tableau (non supporté actuellement).

Articles dans Facture de Vente

Cible

Autres champs personnalisés du formulaire

Champs qui décrivent le comportement :

  • Obligatoire : Si ce champ est requis pour enregistrer un formulaire.

  • Options : Liste d’options séparées par des sauts de ligne, nécessaire pour les champs Sélection et Autocomplétion, et utilisé pour les couleurs.

  • Cible : Type de formulaire dont la valeur du champ Lien est sélectionnée. Si Tableau, alors le nom du type de formulaire Tableau.

  • Références : Nom du champ de référence qui définit le type de lien dynamique. Par exemple Type dans Référence de Paiement.

Champs qui décrivent l’interface utilisateur :

  • Onglet du formulaire : Onglet du formulaire sous lequel le champ est affiché.

  • Section du formulaire : Section sous l’onglet saisi où le champ est affiché.

Suppression des personnalisations

Vous pouvez supprimer les personnalisations d’un formulaire en supprimant son entrée de formulaire personnalisé :

:::danger Perte de données

La suppression des personnalisations entraînera également la perte des données enregistrées dans les champs personnalisés. :::

Last updated