Champs et widgets¶
Les champs permettent de structurer les modèles d’une base de données. Si vous imaginez un modèle sous la forme d’un tableau ou d’une feuille de calcul, les champs sont les colonnes dans lesquelles les données sont stockées dans les enregistrements (c’est-à-dire les lignes). Les champs définissent également le type de données qui y sont stockées. La manière dont les données sont présentées et formatées dans l”UI est déterminée par leur widget.
D’un point de vue technique, il y a 15 types de champ dans Odoo. Toutefois, vous pouvez choisir parmi 20 champs dans Studio, car certains types de champs sont disponibles plus d’une fois en appliquant un différent widget par défaut.
Astuce
Il est uniquement possible d’ajouter de Nouveaux champs aux vues Formulaire et Liste. Dans les autres vues, vous ne pouvez ajouter que des Champs existants (champs déjà présents dans le modèle).
Champs simples¶
Les champs simples contiennent des valeurs de base, telles qu’un texte, des chiffres, des fichiers, etc.
Note
Les widgets autres que ceux par défaut, lorsqu’ils sont disponibles, sont énumérés sous forme de points ci-dessous.
Texte (char)¶
Le champ Texte est utilisé pour un texte court contenant n’importe quel caractère. Une ligne de texte est affichée lorsque le champ est complété.
Badge : permet d’afficher la valeur à l’intérieur d’une forme arrondie, semblable à une étiquette. Il n’est pas possible de modifier la valeur dans l’UI, mais il est possible de définir une valeur par défaut.
Copier dans le presse-papiers : les utilisateurs peuvent copier la valeur en cliquant sur un bouton.
Email : la valeur devient un lien mailto cliquable.
Image : permet d’afficher une image à l’aide d’une URL. Il n’est pas possible de modifier la valeur manuellement, mais il est possible de définir une valeur par défaut.
Note
Ceci fonctionne différemment de la sélection directe du champ Image, puisque l’image n’est pas stockée dans Odoo lors de l’utilisation d’un champ Texte avec le widget Image. Par exemple, cela peut être utile si vous voulez économiser de l’espace disque.
Téléphone : la valeur devient un lien tel cliquable.
Astuce
Cochez Activer les SMS pour ajouter une option permettant d’envoyer un SMS directement depuis Odoo à côté du champ.
URL : la valeur devient une URL cliquable.
Example
Texte multiligne (text)¶
Le champ Texte multiligne est utilisé pour un texte plus long contenant n’importe quel type de caractère. Deux lignes de texte sont affichées sur l’UI lorsque le champ est complété.
Copier dans le presse-papiers : les utilisateurs peuvent copier la valeur en cliquant sur un bouton.
Example
Entier (integer)¶
Le champ Entier est utilisé pour tous les nombres entiers (positifs, négatifs, ou zéro, sans décimale).
Graphique circulaire : affiche la valeur à l’intérieur d’un cercle de pourcentage, généralement pour une valeur calculée. Il n’est pas possible de modifier la valeur sur l’UI, mais il est possible de définir une valeur par défaut.
Barre de progression : affiche la valeur à côté d’une barre de progression, généralement pour une valeur calculée. Il n’est pas possible de modifier le champ manuellement, mais il est possible de définir une valeur par défaut.
Poignée : affiche une icône de poignée pour ordonner manuellement les enregistrements dans la vue Liste.
Example
Décimale (float)¶
Le champ Décimale est utilisé pour tous les nombres décimaux (positifs, négatifs, ou zéro, avec décimale).
Note
Les nombres décimaux sont affichés avec deux décimales après la virgule sur l’UI, mais ils sont stockés dans la base de données avec plus de précision.
Monétaire : cette option est similaire à l’utilisation du champ Monétaire. Il est recommandé d’utiliser ce dernier, car il offre plus de fonctionnalités.
Pourcentage : affiche un caractère de pourcentage
%après la valeur.Graphique circulaire : affiche la valeur à l’intérieur d’un cercle de pourcentage, généralement pour une valeur calculée. Il n’est pas possible de modifier ce champ manuellement, mais il est possible de définir une valeur par défaut.
Barre de progression : affiche la valeur à côté d’une barre de progression, généralement pour une valeur calculée. Il n’est pas possible de modifier le champ manuellement, mais il est possible de définir une valeur par défaut.
Heure : la valeur doit respecter le format hh:mm, avec un maximum de 59 minutes.
Example
Monétaire (monetary)¶
Le champ Monétaire est utilisé pour toutes les valeurs monétaires.
Note
Lorsque vous ajoutez d’abord un champ Monétaire, vous avez tendance à vouloir ajouter un champ Devise s’il n’y en a pas déjà un sur le modèle. Odoo propose d’ajouter le champ Devise pour vous. Une fois qu’il est ajouté, ajoutez de nouveau le champ Monétaire.
Example
Html (html)¶
Le champ Html est utilisé pour ajouter du texte qui peut être édité en utilisant l’éditeur HTML d’Odoo.
Texte multiligne : désactive l’éditeur HTML d’Odoo pour permettre l’édition de HTML brut.
Example
Date (date)¶
Le champ Date est utilisé pour sélectionner une date sur un calendrier.
Jours restants : le nombre de jours restants avant l’affichage de la date sélectionnée (par ex. Dans 5 jours), en fonction de la date actuelle.
Example
Date & Heure (datetime)¶
Le champ Date & Heure est utilisé pour sélectionner une date sur un calendrier et une heure sur une horloge. L’heure actuelle de l’utilisateur est automatiquement utilisée si aucune heure n’est définie.
Date : utilisé pour enregistrer l’heure sans l’afficher sur l’UI.
Jours restants : affiche le nombre de jours restants avant la date sélectionnée (par ex. Dans 5 jours), en fonction de la date et de l’heure actuelles.
Example
Case à cocher (boolean)¶
Le champ Case à cocher est utilisé lorsqu’une valeur ne peut être que vraie ou fausse, en cochant ou en décochant une case à cocher.
Bouton : affiche un bouton radio. Le widget fonctionne sans passer en mode édition.
Bascule : affiche un bouton à bascule. Le widget fonctionne sans passer en mode édition.
Example
Sélection (selection)¶
Le champ Sélection est utilisé lorsque les utilisateurs doivent sélectionner une seule valeur parmi un nombre de valeurs prédéfinies.
Badge : permet d’afficher la valeur à l’intérieur d’une forme arrondie, semblable à une étiquette. Il n’est pas possible de modifier la valeur dans l’UI, mais il est possible de définir une valeur par défaut.
Badges : affiche simultanément toutes les valeurs sélectionnables à l’intérieur de formes rectangulaires, organisées horizontalement.
Priorité : affiche des symbôles en forme d’étoile à la place des valeurs, qui peuvent être utilisés pour indiquer un niveau d’importance ou de satisfaction par exemple. Cela a le même effet que de sélectionner le champ Priorité, bien que, pour ce dernier, quatre valeurs de priorité soient déjà prédéfinies.
Radio : affiche toutes les valeurs sélectionnables en même temps sous forme de boutons radio.
Astuce
Par défaut, les boutons radio sont organisés verticalement. Cochez Affichez horizontalement pour modifier la façon dont ils sont affichés.
Example
Priorité (selection)¶
Le champ Priorité permet d’afficher un système d’évaluation à trois étoiles, qui peut être utilisé pour indiquer un niveau d’importance ou de satisfaction. Ce type de champ est un champ Sélection avec le widget Priorité sélectionné par défaut et quatre valeurs de priorité prédéfinies. Par conséquent, les widgets Badge, Badges, Radio, et Sélection ont les mêmes effets que ceux décrits dans la section Sélection.
Astuce
Pour modifier le nombre d’étoiles disponibles en ajoutant ou supprimant des valeurs, cliquez sur Modifier les valeurs. Notez que la première valeur est égale à 0 étoiles (c’est-à-dire, lorsqu’aucune sélection n’est faite), donc quatre valeurs donnent un système d’évaluation à trois étoiles par exemple.
Example
Fichier (binary)¶
Le champ Fichier permet de charger tout type de fichier ou de signer un formulaire (widget Signature).
Image : les utilisateurs peuvent charger une image, qui est alors affichée dans la vue Formulaire. L’effet est le même que celui du champ Image.
Visualiseur PDF : les utilisateurs peuvent charger un fichier PDF, qui peut ensuite être consulté à partir de la vue Formulaire.
Signature : les utilisateurs peuvent signer le formulaire électroniquement. L’effet est le même que celui du champ Signature.
Example
Image (binary)¶
Le champ Image permet de charger une image et de l’afficher dans la vue Formulaire. Ce type de champ est un champ Fichier avec le widget Image sélectionné par défaut. Par conséquent, les widgets Fichier, Visualiseur PDF, et Signature ont les mêmes effets que ceux décrits sous la section Fichier.
Astuce
Pour modifier l’affichage des images chargées, sélectionnez Petite, Moyenne ou Grande dans l’option Taille.
Signature (binary)¶
Le champ Signature permet de signer le formulaire électroniquement. Ce type de champ est un champ Fichier avec le widget Signature sélectionné par défaut. Par conséquent, les widgets Fichier, Image et Visualiseur PDF ont les mêmes effets que ceux décrits sous la section Fichier.
Astuce
Pour donner aux utilisateurs l’option Automatique lorsqu’ils doivent dessiner leur signature, sélectionnez un des champs Autocompléter avec disponibles (Texte, Many2One et Champ associé sur le modèle uniquement). La signature est générée automatiquement à l’aide des données du champ sélectionné.
Champs relationnels¶
Les champs relationnels sont utilisés pour lier et afficher les données des enregistrements d’un autre modèle.
Note
Les widgets autres que ceux par défaut, lorsqu’ils sont disponibles, sont énumérés sous forme de points ci-dessous.
Many2One (many2one)¶
Le champ Many2One est utilisé pour lier un autre enregistrement (d’un autre modèle) au modèle en cours d’édition. Le nom de l’enregistrement de l’autre modèle est alors affiché sur l’enregistrement en cours d’édition.
Example
Sur le modèle Commande, le champ Client est un champ Many2One qui pointe vers le modèle Contact. Cela permet de lier plusieurs commandes à un seul contact (client).
Astuce
Pour empêcher les utilisateurs de créer un nouvel enregistrement dans le modèle lié, cochez Désactiver la création.
Pour empêcher les utilisateurs d’ouvrir des enregistrements dans une fenêtre contextuelle, cochez Désactiver l’ouverture.
Pour aider les utilisateurs à ne sélectionner que le bon enregistrement, cliquez sur Domaine pour créer un filtre.
Badge : affiche la valeur à l’intérieur d’une forme arrondie, semblable à une étiquette. Il n’est pas possible de modifier la valeur sur l’UI.
Radio : affiche toutes les valeurs sélectionnables en même temps sous forme de boutons radio.
One2Many (one2many)¶
Le champ One2Many est utilisé pour afficher les relations existantes entre un enregistrement du modèle actuel et plusieurs enregistrements d’un autre modèle.
Example
Vous pouvez ajouter un champ One2Many au modèle Contact pour consulter les nombreuses commandes d”un seul client.
Note
Pour utiliser un champ One2Many, les deux modèles doivent déjà avoir été liés à l’aide d’un champ Many2One. Les relations One2Many n’existent pas indépendamment : une recherche inverse des relations Many2One existantes est effectuée.
Lignes (one2many)¶
Le champ Lignes permet de créer un tableau avec des lignes et des colonnes (par ex. les lignes de produits d’une commande).
Astuce
Pour modifier les colonnes, cliquez sur le champ Lignes et ensuite Modifier la vue liste. Pour modifier le formulaire qui apparaît lorsqu’un utilisateur clique sur Ajouter une ligne, cliquez plutôt sur Modifier la vue formulaire.
Example
Many2Many (many2many)¶
Le champ Many2Many permet de lier plusieurs enregistrements d’un autre modèle à plusieurs enregistrements du modèle actuel. Les champs Many2Many peuvent utiliser Désactiver la création, Désactiver l’ouverture, Domaine, tout comme les champs Many2One.
Example
Sur le modèle Tâche, le champ Assignés est un champ Many2Many qui pointe vers le modèle Contact. Cela permet à un seul utilisateur d’être assigné à plusieurs tâches et à plusieurs utilisateurs d’être assignés à une seule tâche.
Cases à cocher : les utilisateurs peuvent sélectionner plusieurs valeurs à l’aide de cases à cocher.
Étiquettes : les utilisateurs peuvent sélectionner plusieurs valeurs apparaissant dans des formes arrondies, également connues comme des étiquettes. L’effet est le même que celui de la sélection du champ Étiquettes.
Étiquettes (many2many)¶
Le champ Étiquettes permet d’afficher plusieurs valeurs d’un autre modèle dans des formes arrondies, également connues comme des étiquettes. Ce type de champ est un champ Many2Many avec le widget Étiquettes sélectionné par défaut. Par conséquent, les widgets Cases à cocher et Many2Many ont les mêmes effets que ceux décrits dans la section Many2Many.
Astuce
Pour afficher des étiquettes avec différentes couleurs de fond, cochez Utiliser des couleurs.
Example
Propriétés¶
Invisible : Lorsqu’il n’est pas nécessaire que les utilisateurs voient un champ dans l’UI, cochez Invisible. Cela permet d’alléger l’UI en n’affichant que les champs essentiels en fonction d’une situation spécifique.
Example
Dans la vue Formulaire du modèle Contact, le champ Titre n’apparaît que lorsque Individuel est sélectionné, car ce champ n’est pas utile pour une Société.
Note
L’attribut Invisible s’applique également à Studio. Pour afficher les champs masqués dans Studio, cliquez sur l’onglet Vue d’une vue et cochez Afficher les éléments invisibles.
Requis : Si un champ doit toujours être complété par l’utilisateur avant de pouvoir continuer, cochez Requis.
Lecture seule : Si les utilisateurs ne doivent pas être en mesure de modifier un champ, cochez Lecture seule.
Note
Vous pouvez choisir d’appliquer ces trois propriétés uniquement à des enregistrements spécifiques en cliquant sur Conditionnel et en créant un filtre.
Libellé : Le champ Libellé est le nom du champ dans l’UI.
Note
Ce nom n’est pas le même que celui utilisé dans la base de données PostgreSQL. Pour afficher et modifier ce dernier, activez le mode développeur, et modifiez le nom technique.
Infobulle d’aide : Pour expliquer l’utilité d’un champ, écrivez une description sous Infobulle d’aide. Elle s’affiche à l’intérieur d’une infobulle lorsque vous passez la souris sur le libellé du champ.
Placeholder : Pour donner un exemple de la manière dont un champ doit être complété, écrivez-le sous Placeholder. Il s’affiche en gris clair à la place de la valeur du champ.
Widget : Pour changer l’apparence ou la fonctionnalité par défaut d’un champ, sélectionnez un des widgets disponibles.
Valeur par défaut : Pour ajouter une valeur par défaut à un champ lorsqu’un enregistrement est créé, utilisez Valeur par défaut.
Limiter la visibilité aux groupes : Pour limiter les utilisateurs qui peuvent voir le champ, sélectionnez un groupe d’accès d’utilisateurs.