Créer, relire, modifier puis supprimer une note

1. Créez une catégorie pour l'exercice

1. Ouvrez Notes de formation → Catégories.
2. Cliquez sur Nouveau.
3. Saisissez Personnel, puis enregistrez.

Vous venez d'administrer une catégorie avec le modèle training.note.category. Odoo ajoute la ligne dans training_note_category ; vous n'avez exécuté aucune instruction SQL d'écriture.

2. Reliez la note de départ à cette catégorie

1. Ouvrez Notes de formation → Notes, puis la note Bienvenue.
2. Dans le field Catégorie, choisissez Personnel.
3. Dès que la valeur change, repérez l'indicateur d'état dans la barre supérieure de la fiche. Cliquez sur son icône en forme de nuage, dont l'infobulle indique Enregistrer manuellement.
4. Revenez à la liste, puis rouvrez Bienvenue.

Résultat attendu : la fiche affiche toujours Personnel. Odoo a écrit la référence de la catégorie dans category_id avec l'ORM. La note Bienvenue reste une donnée de départ décrite dans le XML du module ; gardez-la pour cette démonstration de relation.

3. Comprenez pourquoi la fiche est modifiable

Dans notre XML, la racine est simplement <form>. En Odoo 19, ses attributs create, edit et delete valent true par défaut : il n'est donc pas nécessaire d'ajouter edit="true". Les trois fields de la fiche ne portent pas non plus l'attribut readonly.

La fiche standard s'ouvre alors directement avec ses fields modifiables ; ne cherchez pas un bouton séparé pour passer en mode édition. Lorsque vous changez une valeur, l'indicateur d'état de la barre supérieure permet de forcer la sauvegarde avec l'icône en forme de nuage. Odoo peut aussi sauvegarder en quittant une fiche, mais utilisez ici l'enregistrement manuel afin de rendre chaque étape visible.

4. Choisissez d'abord les écrans standard pour le CRUD

Pour le travail ERP interne courant — créer, consulter, modifier et supprimer des records — les views list et form reliées à une action sont le choix par défaut. Elles apportent immédiatement la navigation, les gestes CRUD et l'intégration aux droits Odoo. Ne reconstruisez pas ces écrans en code personnalisé sans besoin précis.

Les trois approches de cette journée sont complémentaires. Elles affichent le même model training.note, passent par le même ORM et respectent les mêmes droits ; leur présentation et leur niveau d'interaction changent.

QWeb et Owl ne remplacent donc pas le back-office standard. Utilisez-les lorsque leur forme de page ou leur interactivité répond à un besoin que les views ordinaires ne couvrent pas simplement.

5. Parcourez les quatre opérations CRUD

Create : créez une note temporaire

1. Dans la liste Notes, cliquez sur Nouveau.
2. Saisissez Note de test CRUD dans Titre.
3. Saisissez Version 1 : note créée depuis le formulaire. dans Contenu.
4. Choisissez Personnel dans Catégorie, puis cliquez sur l'icône de sauvegarde manuelle.
5. Revenez à la liste.

Résultat attendu : une ligne Note de test CRUD apparaît avec la catégorie Personnel. Cette note vient du formulaire : elle n'existe pas dans data/training_note_data.xml.

Read : retrouvez exactement le même record

1. Cliquez sur la ligne Note de test CRUD.
2. Vérifiez le titre, le contenu et la catégorie, puis revenez à la liste.
3. Dans pgAdmin, ouvrez Query Tool. Avec psql, utilisez la même requête dans votre base d'exercice.

SELECT note.id, note.title, note.body, category.name AS category
FROM training_note AS note
LEFT JOIN training_note_category AS category
  ON category.id = note.category_id
WHERE note.title = 'Note de test CRUD';

Résultat attendu : une seule ligne contient le titre, le contenu de version 1 et la catégorie Personnel. Notez son id : l'opération suivante modifiera cette ligne au lieu d'en créer une autre.

Update : modifiez puis vérifiez la persistance

1. Rouvrez Note de test CRUD.
2. Remplacez le titre par Note de test CRUD — vérifiée.
3. Remplacez le contenu par Version 2 : modification enregistrée avec l'ORM. et gardez la catégorie Personnel.
4. Cliquez sur l'icône de sauvegarde manuelle, revenez à la liste, puis rouvrez la note sous son nouveau titre.

Résultat attendu dans Odoo : la liste et la fiche montrent le nouveau titre et le contenu de version 2. La catégorie Personnel est toujours sélectionnée.

SELECT note.id, note.title, note.body, category.name AS category
FROM training_note AS note
LEFT JOIN training_note_category AS category
  ON category.id = note.category_id
WHERE note.title = 'Note de test CRUD — vérifiée';

Résultat attendu dans PostgreSQL : l'id est le même que celui noté après la création. Le titre et le contenu ont changé ; la catégorie reste Personnel. Il s'agit bien d'une mise à jour du record existant.

Delete : supprimez uniquement la note de l'exercice

1. Ouvrez la fiche Note de test CRUD — vérifiée.
2. Dans la barre supérieure, ouvrez le menu Actions, représenté par une icône en forme d'engrenage.
3. Choisissez Supprimer, relisez la confirmation, puis confirmez.

Résultat attendu dans Odoo : vous revenez à la liste et la ligne Note de test CRUD — vérifiée n'y apparaît plus.

SELECT id, title
FROM training_note
WHERE title = 'Note de test CRUD — vérifiée';

Résultat attendu dans PostgreSQL : la requête ne renvoie aucune ligne. L'interface n'a pas simplement masqué la note : le client web a demandé la suppression du record training.note. L'ORM a appelé unlink(), vérifié le droit perm_unlink et les éventuelles record rules, puis appliqué le cycle de suppression du modèle.

6. Vérification finale

• Create : la note temporaire est apparue dans la liste et dans PostgreSQL.
• Read : la liste, la fiche et le SELECT ont montré le même record.
• Update : le titre et le contenu ont changé sans changer l'id ; la catégorie Personnel a persisté.
• Delete : la note d'exercice a disparu de la liste et la requête ne renvoie plus son id.