Odoo avancé

La plupart des manipulations décrites dans ce livre se trouvent dans le menu “Configuration”. En fonction des différents droits, les menus disponibles ne seront pas les mêmes. Quelques termes techniques : - Modèle = les objets odoo - Vue = vues et interfaces utilisées par l’utilisateur (Vue Formulaire, kanban view, Calendar, ….) - Contrôleur = code python exécuté pour la gestion des événements

Menu "Configuration"

Tableau de bord

Le tableau de bord reprend les variables de configuration telles que le nombre d’utilisateur, les traductions, les données de la société ou les applications installées. Il permet également d’accéder à la configuration de ces paramètres.

image-1614592749641.png

Your company

Ce formulaire permet de configurer les paramètres de votre société (adresse, logo, réseaux sociaux). 

La partie Easy-My Coop du formulaire permet de configurer le module Easy-My Coop (voir le tutoriel 2 - Pack gestion de coopérative). 

image-1614592860885.png

Paramètres généraux

Ce menu permet d'accéder aux paramètres de configuration des différents modules installés (menu noir sur la gauche). Ces paramètres seront expliqués dans les tutoriels concernant ces modules. 

image-1614592962965.png

Les paramètres généraux permettent également de choisir le Modèle de document, c'est à dire le style d'affichage des PDF générés par Odoo. Cliquer sur "Changez le modèle des documents" pour visualiser les 4 options standards proposées par Odoo.

C'est également là que le bas de page peut être personnalisé (pour indiquer le compte bancaire sur lequel payer, par exemple). Certains éléments sont d'office affichés par défaut (Téléphone, Courriel, Site web, TVA) et d'autres doivent être ajoutés manuellement (IBAN au minimum).

Cliquer sur "Prévisualiser le document" pour générer un PDF et voir le résultat.

image-1639667471679.png

Lorsque L'application Cooperators est utilisée, nous conseillons d'utiliser le layout "emc_external_layout_standard" ou "emc_external_layout_larger_logo".

Gérer les paramètres par défaut de l'utilisateur

Il est possible de définir par défaut pour les utilisateurs.

Pour cela,

Dans la liste sont repris tous les paramètres qui ont été défini par défaut sur cette base de donnée.

0.png

 

screenshot(11).png

Attention que les champs choisi doit être en format JSON.

image.png

Il est possible également de conditionner le paramètre à un utilisateur en particulier.

Éditions en lot

Créer une édition en lot (à partir de la v14-v16)

Le module server_action_mass_edit permet de configurer des éditions en lot grâce aux actions serveur.

En version 14 et 16, la configuration d'une nouvelle édition en lot se fait dans les menus techniques. Activer le mode debug au préalable.

Ensuite, se rendre dans Configuration > Technique > Actions > Action Serveur

screenshot-burocopy.coopiteasy.be-2024.01.08-10_13_20.png

Créer un nouvel enregistrement en choisissant :

screenshot-burocopy.coopiteasy.be-2024.01.08-10_14_46.png

Utiliser une édition en lot

Allez dans le module depuis lequel vous avez accès aux objets à éditer (les articles, les contacts, les opportunités…).

Dans l'exemple ci-dessous, une édition en lot a été créée sur les utilisateurs, afin de pouvoir changer la langue.

screenshot(14).png

Dans le menu utilisateur, mettez vous en vue liste, voir la page Les différentes vues, cocher les lignes pour lesquelles vous voulez faire une édition en masse et cliquer sur le bouton “Action”.

screenshot(15).png

Une fenêtre s’ouvre avec tous les champs que vous pouvez éditer (configurés lors de la mise en place de l'édition en lot.

Vous pouvez ajouter ou enlever massivement des informations (set / remove).

Jusqu'en v14

Le module mass_editing permet de réaliser des éditions massives sur différents objets.

Créer une nouvelle possibilité d'édition en lot (v12)

screenshot12.png

screenshot(13).png

Passer en mode debug

Certains menus ou certaines vues ne sont pas accessibles aux utilisateurs en mode “normal”. Pour accéder à des options supplémentaires, l’utilisateur peut accéder au mode “debug”.  Voici plusieurs manières de procéder:

Option 1 : via le menu Configuration

image-1614588179989.png

La petite icône d'un insecte (bug) au-dessus à droite de votre écran indique que vous êtes maintenant en train d’utiliser Odoo en mode développeur (dit aussi mode débug).

Option 2 : via le "debug mode"

Dans l’url de votre Odoo,

Ajoutez “?debug” après le mot “web” :

image-1614588458838.pngimage-1614588492532.png

Cette option est la plus rapide mais il faudra refaire l’opération à chaque fois que vous vous connecterez.

Option 3 : via le module base_technical_features

Ce module permet d’accéder aux fonctionnalités techniques sans activer le debug mode et cela, de manière permanente, en fonction des préférences utilisateur. 

Si votre Odoo possède ce module, vous verrez dans vos préférences en tant qu’utilisateur que vous pouvez cocher la case “Technical features”.

image-1614589641538.png

image-1614589770423.png

Cela signifie qu’en mode normal (pas développeur), vous pouvez accéder aux vues qui sont normalement accessibles uniquement en mode développeur.

Si votre Odoo ne comprend pas ce module, il vous faut l’installer via le menu Applications.

Option 4 : extension Firefox

 

Firefox permet d’installer une extension pour atteindre le mode debug. 

Pour l’installer : 

image-1614590071532.png

image-1614590621625.png

Empêcher la création d'objets depuis les listes de sélection

Dans le fonctionnement standard Odoo, il est souvent possible de créer des objets directement depuis une liste de sélection ("enregistrer et créer").

Cette possiblité n'est pas toujours utile, et il suffit d'une inattention pour que des doublons soient créés. Cela peut poser problème si l'on a créé des doublons de contact ou de produits depuis un bon de commande, par exemple, car cela pollue la base de donnée et risque d'induire en erreur tous les utilisateur·rices en listant des données non configurées.

 creation_article_otf.png

Pour éviter de créer de nouveaux objets, plusieurs modules existent.

Empêcher les doublons de contacts

Il n'y a rien à configurer.

 
Empêcher les doublons de produits

Il n'y a rien à configurer.

 

Empêcher la création de clients depuis le point de vente

Il n'y a rien à configurer.

 
Empêcher la création de tâches et de projets depuis les feuilles de temps

Il n'y a rien à configurer.

 

Empêcher les doublons d'autres objets

Le module suivant fonctionne seulement pour les champs "many to one", c'est-à-dire lorsqu'on peut uniquement sélectionner une valeur dans une liste (par exemple, le client sur un bon de commande)

Ce module existe en v14

Il faut configurer les modèles qu'on souhaite bloquer. D'abord, se rendre dans le module Configuration et cliquer sur l'onglet "Technique" :

base_optional_quick_create_technique.png

Ensuite, chercher le modèle à bloquer :

base_optional_quick_create_modèle.png

Enfin, cocher l'option "Avoid Quick Create" :

base_optional_quick_create_config.png

 

 

 

Masquer des points de menus

Le module OCA base_menu_visibility_restriction permet de cacher des points de menu à un groupe d'utilisateurs.

Configuration

Nouveau groupe

Créer un nouveau groupe de droits auquel les utilisateurs et utilisatrices concernées devront être associés. Par exemple, "Simplified Menu" : (en mode debug) Paramètres > Utilisateurs & Sociétés > Groupes

image-1693208088980.png

Créer un nouveau groupe :

image-1693208185144.png

Il n'y a rien à configurer à part l'Application (Droits supplémentaires, pour le classement sur la fiche utilisateur) et son nom, ici par exemple : Simplified menus.

On peut y ajouter dès maintenant les utilisateurs et utilisatrices concernés.

Choix des menus à cacher

Dans le menu Paramètres > Techniques > Interface utilisateur > Rubrique, choisir les points de menu à cacher (un par un) et y ajouter le groupe de droit à exclure dans la zone du bas "Excluded Groups" :

image-1693208350957.png

Utilisation

Les utilisateurs et utilisatrices dans le groupe "exclus" ne verront pas le point de menu en question.

Exemple avec un utilisateur non exclu :

image-1693208408862.png

et un utilisateur dans le groupe "exclu" :

image-1693208431231.png

Le menu "Listes de prix" n'est pas visible.

 

 

Utiliser le thème "classique" dans Odoo 16

Le module web_theme_classic applique le thème Odoo "classique" (des versions <16) dans Odoo 16. La

En Odoo V16, le design est très épuré. Cela peut générer certains problèmes pour l'utilisateur :

Ce module restaure le thème plus lisible des versions précédentes.

Sans ce module

https://raw.githubusercontent.com/OCA/web/16.0/web_theme_classic/static/description/product_template_form_without_module.png

 

Avec ce module

https://raw.githubusercontent.com/OCA/web/16.0/web_theme_classic/static/description/product_template_form_with_module.png

 

Retirer les champs de Odoo Entreprise

Le module remove_odoo_entreprise supprime les champs et élements liés à Odoo Entreprise. C'est-à-dire :

image-1678800514805.png

image-1678800696955.png

image-1678800891074.png

Recherche dans le chatter

Le module base_search_mail_content permet de faire des recherches dans les messages du chatter, pour tous les modèles (SO, tâches, factures ...).

C'est notamment très pratique pour rechercher de l'information dans des tâches.

Attention il n'est pas installable par défaut, il faut installer une extension Postgres (demander à une personne technique).

Activer la connexion Superutilisateur [Compléter]

Odoo permet d’avoir des droits supplémentaires si besoin. 

Uniquement si nécessaire - veiller à bien se déconnecter ensuite pour ne pas rester connecté comme superutilisateur.

  1. Ouvrir une fenêtre de navigation privée
  2. Allez sur la page de login et activez le mode développeur. 

Un lien apparait :

image-1614590802690.png

Une fois connecté, vous devriez voir ceci :

image-1614590846058.png

 

Alternativement, se connecter normalement puis activer le mode développeur et cliquer ainsi :

superuser.png

Exporter

Depuis presque toutes les vues d'Odoo, il est possible d'exporter des données.

2.png

Choisir les champs à exporter

La liste des champs disponibles (1) vous donne toutes les informations que vous pouvez exporter depuis cette vue.Pour sélectionner un champ, cliquez dessus puis cliquez sur "ajouter"(2). Le champs apparaîtra dans la liste de droite (3).

Pour les champs précédés de ">" (4), cela signifie que ce champ est un champ dit relationnel, c'est à dire qu'à ce champ sont liées d'autres information. 

Par exemple, depuis la vue article, vous pouvez exporter les informations propres à l'article (nom, prix par exemple). Si vous choisissez un de ces champs, il apparaîtra avec les informations directement dans votre export.

1.png

2.png

Vous pouvez aussi exporter des informations qui sont définies ailleurs et qui sont liées à l'article, par exemple, la catégorie, l'unité ou le fournisseur, qui sont des données indépendantes.

Si vous ne prenez que le premier champ de la liste par contre, ce qui apparaitra dans votre export est l'identifiant de l'objet dans la base de données.

4.png

3.png

Pour avoir le nom de la catégorie, sélectionnez donc prendre la ligne "catégorie d'article/Nom affiché".

Si vous l'ajoutez à la ligne, automatiquement, le champ catégorie d'article viendra avec.

1.png

Enregistrer l'export

Une fois que ma liste est consolidée, vous pouvez enregistrer votre export pour le réutiliser plus tard en cliquant sur "Enregistrer la liste des champs" (5). Si votre export a déjà été enregistré, il suffit de le choisir dans la liste des exports enregistrés.

Exporter

Pour exporter il suffit de choisir le format (6) et de cliquer sur "exporter" (7).

En version 16, il est possible de faire un export global en un seul clic. C'est pratique lorsque il y a une grande quantité d'enregistrement à exporter (comme dans cet exemple avec plus de 10 000 enregistrements)image-1684760339879.png

 

Langues et traductions

Langues et traductions

Charger une nouvelle langue

De base, Odoo est en anglais mais on peut y charger différentes langues (avec même des particularités locales, par exemple le français de Suisse (CH) ou de Belgique (BE)).

Activer une nouvelle langue

Pour activer une nouvelle langue,

4.png

Dans la liste des langues disponibles, cherchez la langue souhaitée et activez la.

3.png

Attention que les séparateurs de milliers et de décimales ainsi que les formats de dates et d'heures varient en fonction des langues.

2.png

 

Charger la langue activée

Une fois la langue activée,

7.png

 

Langues et traductions

Traduire des termes

Une fois une langue chargée et les termes synchronisés, vous pouvez traduire les termes source anglais vers la ou les langues souhaitées.

Depuis une vue

Lorsque vous êtes en mode développeur, depuis certains champs en texte libre, vous pouvez voir apparaitre ce bouton.

8.png

ou celui-ci

9.png

Ces boutons signifient que vous pouvez traduire directement le champs, soit en changeant vos préférences dans la langue que vous souhaitez adapter, soit en cliquant directement sur cette icône.

10.png

 

Via un export-import de fichier .po

Le mode développeur doit être activé.

trad_po_export.png

trad_po_edit.png

Vous pouvez aussi installer le logiciel Poedit pour une interface de traduction plus agréable et sans risque de modifier ce qu'il ne faut pas.

trad_po_import.png

trad_po_apply.png

trad_po_apply-2.png

 

En v12 - Depuis le menu de traduction

Le mode développeur doit être activé.

5.png

Attention qu'il ne faut jamais changer le terme source, mais bien la valeur de la traduction. Pour que la valeur de la traduction s'affiche en français, il faut évidemment changer la ligne correspondant au français.

6.png

Si le terme recherché apparait plusieurs fois il est possible de filtrer par module, afin de mieux cibler.

Si le terme recherché n'apparait pas, il faut peut-être synchroniser les termes.

 

Langues et traductions

Synchroniser les termes

Lorsqu'un développement est réalisé ou un nouveau module installé, il est possible que certains termes ne soient pas traduit.

Pour pouvoir le faire, il est nécessaire de synchroniser les termes.

8.png

Importer des données

Afin de rentrer une liste de données en une fois dans Odoo, il est possible de les importer depuis un fichier excel ou csv.

3.png

v14_imports.png

L'import consiste à créer un fichier excel ou csv qui présente

Construire un fichier d'import

La procédure qui suit est une proposition basée sur l'expérience de Coop IT Easy. D'autres façons de faire peuvent exister

1. Exporter les champs que l'on souhaite modifier

Afin d'obtenir les noms des colonnes reconnues par Odoo, il est intéressant de commencer par exporter les champs souhaités.

Si la base de donnée est vide,

Par exemple pour un article, les colonnes souvent utilisées sont les suivantes :

4.png

Comme expliqué dans la page exporter, les objets (par exemple un article) peuvent présenter des informations qui leur sont propres (nom) ou des informations relationnelles (lien avec d'autres objets, par exemple le fournisseur). Pour identifier une information relationnelle voir la page exporter. 

Pour les données relationnelles, il est nécessaire de fournir l'identifiant de l'objet. Dans les colonnes que vous exportez, prenez donc bien le nom ET identifiant.

2. Exporter les données relationnelles à importer

Afin de faciliter l'encodage, une fois les champs relationnels identifiés,

Par exemple pour les catégories :

5.png

Vous aurez donc un onglet par données relationnelles (1 pour les catégories de produit, 1 pour les unités, 1 pour les taxes etc.)

Attention de bien mettre la colonne nom avant la colonne id, afin de faciliter la suite.

3. Remplir le fichier

Pour éviter les mauvais encodages sur les colonnes relationnelles, vous pouvez utilisez la fonction "validité" dans excel ou libre office pour définir les plages de données acceptées.

4. Faire la correspondance nom-identifiant

5. Sauvegarder en csv

Si possible, choisir cette configuration.

Capture du 2021-03-26 10-48-05.png

Importer

8.png

6.png

Il faut ensuite faire la correspondance entre les colonnes du fichier csv et celles d'Odoo. Normalement, Odoo en propose mais il est important de les vérifier.

Il ne faut pas importer les colonnes "nom" des informations relationnelles, seulement les colonnes d'identifiant. 

Pour importer correctement ces colonnes, il faut qu'elles correspondent dans Odoo à un nom de type "catégorie/id externe".

Capture du 2021-03-26 11-03-49.png

Pour ne pas importer une colonne, cliquez sur la petite croix grise. La colonne se met en "Ne pas importer".

7.png

Si des données ne sont pas correctes, les erreurs sont décrites par Odoo en rouge. 

9.png

Si l'importation est bonne, ce message apparait.

10.png

Modifier des données

L'import peut-être utilisé pour modifier massivement des données.

En effet, en renseignant l'identifiant externe de l'objet, vous indiquez à Odoo que vous voulez modifier les données de cet objet. Seules les colonnes renseignées sont ainsi modifiées, les autres restant à l'identique.

En ne renseignant aucun identifiant externe, vous ajoutez un nouvel objet dans Odoo.

Import de données spécifiques

Import de listes des prix fournisseurs.

Import dans le cadre d'un inventaire.

Gérer les Utilisateurs et les Groupes

Gérer les Utilisateurs et les Groupes

Gérer les droits d'accès

Accéder à la liste des utilisateurs

Divers groupes de droits d’accès existent et permettent de restreindre ou non l'utilisation de certaines fonctionnalités à des profils sur votre Odoo.

Pour y accéder,

image-1614086243421.png

image-1619010313998.pngimage-1619010341053.pngimage-1619010377997.pngimage-1619010426709.png

La section "Autre" reprend les groupes personnalisés que vous auriez créé, cocher la case ajoutera l'utilisateur dans les membres de ce groupe.

Droit d'accès pour l'utilisation des applications

Application Facturation

Application Gestion des Shifts

Application Easy-my Coop

Application Notes de Frais

Application Évènements

Vous trouverez en cliquant ici, les différents statuts d'utilisateurs pour l'utilisation de l'application Évènements.

Gérer les Utilisateurs et les Groupes

Introduction à la configuration des utilisateurs et des groupes

Présentation

Le module Configuration permet de gérer les droits d’accès des utilisateurs. En fonction des différents droits, les menus disponibles ne seront pas les mêmes. 

Il est possible de créer des utilisateurs pour votre application.

Attention, dans Odoo la notion de contact et d'utilisateur sont bien différents. Ainsi, par exemple, une personne s'inscrivant en ligne (via une application comme l'eCommerce ou Cooperators) créer automatiquement un profil utilisateur. Par contre, la création d'une fiche contact dans le back-end ne crée pas nécessairement un utilisateur.

Utilisateurs

Il existe plusieurs types d'utilisateurs ;

Interne

Ces utilisateurs ont accès à l’outil “back-end”, même si leurs droits d'accès peuvent être adaptés et limités.

Portail

Ces utilisateurs ont seulement accès au portail d'Odoo. Ainsi, si par exemple les modules eCommerce  ou Easy-my Coop sont installés, ces utilisateurs peuvent avoir accès à leur factures ou peuvent effectuer des commandes en ligne. On parle d'utilisateur en "front-end".

Public

Les utilisateurs publics sont un statut particulier, ce sont des utilisateurs qui ne se sont pas connectés mais qui naviguent sur le portail web. Ainsi, si un utilisateur public sur le portail web accède à la boutique, rempli son panier mais sans finaliser sa commande (c'est-à-dire s'inscrire et effectuer le paiement), un "brouillon" de devis sera quand même créé dans votre Odoo lié à un utilisateur Public/anonyme.

Groupes

Lorsque vous créez des utilisateurs internes et que vous donnez exactement les mêmes droits d'accès à plusieurs utilisateurs, il peut être intéressant de créer un groupe personnalisé dans lequel les utilisateurs qui y sont ajoutés héritent des droits d'accès définit dans ce groupe (ce groupe peut également "hériter" l'accès à d'autres groupes).

 

Gérer les Utilisateurs et les Groupes

Créer un profil utilisateur

Pour créer un utilisateur,

Ou alors,

image-1618993860832.png

La fiche utilisateur

Plusieurs types de paramètres sont à configurer sur la fiche utilisateur. 

image-1618994308350.png

image-1618994331899.png

Certains modules ont des groupes déjà établis permettant l’accès ou non à certains menus. 

image-1618994504192.png

Également, certains paramètres techniques peuvent ou non être activés en fonction de l’utilisateur. 

image-1618994573717.png

La langue, le pays, la signature et autre peuvent être configurés dans l’onglet préférence. 

image-1618994606278.png

Créer un utilisateur pour une personne qui n'est pas encore un contact

La création d’un utilisateur implique la création d’un contact dans Odoo. Il vaut donc mieux commencer par créer un utilisateur.

 

image-1618994814084.png

Un courriel est envoyé à la personne pour choisir son mot de passe.

 

Créer un utilisateur pour une personne qui est un contact

Si un contact existe déjà dans Odoo et qu’il faut lui donner des accès, pour éviter d’avoir deux contacts à son nom, il faut donner l’accès au portail au contact, ce qui permettra de le voir dans la liste des utilisateurs après avoir enlevé le filtre “utilisateurs internes”.

Pour cela :

image-1618994945438.png

image-1618995227019.png

La personne de contact n’apparaît pas encore dans la liste qui s’affiche. Vous devez désactiver le filtre “Utilisateurs internes” :

image-1618995284457.png

Pour tout nouvel utilisateur, on donne un mot de passe aléatoire (avec un générateur de mot de passe). Le login correspond à l’adresse email. Chaque utilisateur est ensuite responsable de le modifier. 

Si vous souhaitez donner un accès à la base de données (utilisateur interne), une dernière étape est nécessaire :

Ce passage par l’accès au portail (à mettre puis à enlever) permet de faire le lien entre un utilisateur et un contact existant.

Pour cela,

image-1618995430851.png

Action "Dupliquer"

Cette action est pratique et permet de gagner du temps si vous devez créer une série d’utilisateurs.

Sur la fiche de l’utilisateur ouverte,

Attention, ne dupliquez pas un user existant. Créez d’abord votre premier utilisateur et seulement après, dupliquez-le.

image-1618995713088.png

Vous pouvez définir un type d’utilisateur

Les accès de chacun des utilisateurs aux différentes applications est également modifiable. Pour chaque application un groupe défini les accès.

 

Gérer les Utilisateurs et les Groupes

Configurer des paramètres par défaut pour les utilisateurs

Si vous voulez que les utilisateurs créés par défaut aient certaines caractéristiques, il y a plusieurs moyens de le faire.

Option 1 : via le sous-menu Technique

Pour cela : 

image-1618996769626.png

image-1618996873372.png

Par exemple, si vous voulez mettre des paramètres par défauts lors de la création de contact, il existe 151 paramètres où vous pouvez le faire.

image-1619004032887.png

Pour changer la langue : 

Vous êtes ramené à l’écran précédent. 

Si vous laissez le champ “user” libre, ce sera le paramètre par défaut pour tous les utilisateurs.

image-1619004104856.png

Cette façon de procéder demande de connaître la valeur système des paramètres par défaut. C’est pourquoi une deuxième option, ne demandant pas de connaître la nomenclature est possible.

Option 2 : via un utilisateur défini

Il est possible de définir des paramètres par défaut, par exemple la langue utilisée lors de la création d’un contact. 

Pour cela : 

image-1619004507498.png

Une nouvelle fenêtre s’ouvre. 

image-1619004605973.png

Vous pouvez retrouver les paramètres par défaut ainsi configurés dans Configuration < Technique < "Action" < Paramètres par défaut de l’utilisateur.

Gérer les Utilisateurs et les Groupes

Réinitialiser un mot de passe

Via la fiche utilisateur

Il est possible pour le/la gestionnaire des utilisateurs de renvoyer un lien de réinitialisation de mot de passe, voir de le changer. 

image-1619004842909.png

Depuis la page de login

Il est possible d’activer l’option pour que les utilisateurs puissent eux-mêmes réinitialiser leur mot de passe sur la page de Login.

Dans la version 16, l'option n'existe pas et la possibilité de réinitialiser son mot de passe est toujours présente depuis la page de login.

image-1619005326529.png

Ce qui ajoutera l'option "Reset Password" sur leur page d'identification.

image-1619005416958.png

Gérer les Utilisateurs et les Groupes

Créer un groupe personnalisé

Si vous donnez souvent exactement les mêmes droits d’accès à plusieurs personnes au fil des mois, il peut être judicieux de créer un groupe personnalisé qui hérite des groupes habituellement attribués. Les groupes sont créés pour définir les règles des modèles dans une application.

Pour créer un groupe,

image-1619008300086.png

Les différents onglets dans la création de votre groupe sont à compléter en cliquant sur "ajouter une ligne". Ci-dessous est illustré un exemple du groupe "Gestionnaire de vente".

image-1619008624908.png

image-1619008791607.png

Important, n'oubliez pas de toujours tester les paramètres que vous modifiez afin de vous assurer qu'ils sont appliqués aux bons utilisateurs.

image-1619009002358.png

image-1619009281081.png

image-1619009395545.png

 

Une fois que ce groupe est créé, il apparaitra sur la fiche de utilisateur, tout en bas dans la section "Autre".  Vous devez être en mode développeur pour les voir affichés.

En voici un exemple fait pour la BEES coop.

image-1619007827085.png

Ainsi, lorsque vous choisissez les groupes auxquels l'utilisateur peut avoir accès sous Droits d'accès, les détails des règles et des héritages de ce groupe ne sont pas affichés. La case cochée dans cet exemple, équivaut alors à l’attribution des droits suivants:

  1. Point de vente : Responsable
  2. Vente : voir ses propres pistes
  3. Inventaire : User
  4. RH : employé
  5. + création de contacts

Accéder aux métadonnées

Depuis n'importe quelle vue en mode développeur, cliquez sur le petit insecte puis "View Metadata"

6.png

Cela vous permet d'avoir accès aux métadonnées de la vue en cours. Cela peut-être intéressant par exemple pour voir si une page est remise à son défaut lors d'une mise à jour (si le no update est set sur true).

6.png

 

Rapport

Rapport

Modifier un rapport

Les rapports modifiés ne résistent pas l'update de la base de données, tout comme les vues.

Du coup, il est nécessaire, si vous voulez conserver une modification sur un rapport, de dupliquer le rapport existant que vous souhaitez modifier avant de le modifier.

Cela se fait depuis l'application Configuration, menu Technique < Rapports

4.png

Cliquez ensuite sur le bouton "créer"

3.png

Il vous sera demandé différentes informations de format ainsi que les vue qweb.

2.png

Rapport

Changer le nom des rapports

Il est possible de changer le nom des différents pdf créés depuis des objets Odoo.

Par exemple, dans le cadre d'une facture, 3 PDF différents peuvent être générés.

Les pdfs générés depuis le bouton "imprimer" (1)

10.png

Pour changer le nom du pdf, allez dans la configuration générale<Technique<"Rapport".

13.png

Sélectionnez l'objet désiré (facture par exemple). Le nom du rapport se configure depuis le champ "Nom du rapport imprimé".

14.png

Les pdfs générés en pièce jointe de l'objet (2)11.png

Pour changer le nom du pdf, allez également dans la configuration générale<Technique<"Rapport" et sélectionnez l'objet désiré.

La configuration se fait depuis l'onglet propriété avancée, depuis le champs "enregistrer comme préfixe de pièce jointe".

Les pdfs attachés aux mails (3)

12.png

Pour changer le nom du pdf il faut aller cette fois dans l'onglet paramètre avancé du modèle de mail, dans le champs "Nom du fichier du rapport".

15.png

 

Vues

Vues

Modifier une vue

Ce guide explique comment modifier un rapport ou une vue backend via l’interface de Odoo.

Pour comprendre le mécanisme plus en profondeur, je vous invite à lire la section “Extending Views” du chapître 4 du livre de dev Odoo.

Petite clarification du vocabulaire:

Cas utilisé

Nous allons prendre un exemple lié à une tâche récente pour foodhub. 

La demande était de rajouter une ligne dans les notes de crédits avec la phrase ci-dessous. 



Trouver le rapport à modifier

La première chose à faire dans ce cas-là est d’aller voir le code du rapport en question. Pour faire cela : 



On voit que le template ci-dessus est trop court, ce n’est pas celui là qu’on veut. Dans ce cas-ci, il n’y a pas de vue infante ni parente. On voit par contre un appel ‘t-call’ (voir flèche rouge). 

On cherche donc quel template est appelé via ‘t-call’. Pour cela on va dans les vues (Settings>Technical>Views) et on cherche le nom du template appelé (on prend le nom du template, donc ce qui est après le point : report_invoice_document_with_payments). 

On trouve un résultat. On l’ouvre:



On observe ici que le template est toujours très court, ce ne doit pas être le bon. On constate qu’il y a une vue parente. On clique dessus et tada ! Un bon template bien long ! En parcourant le code on voit des champs qui semblent correspondre à ce qu’on voit dans le pdf de la facture. Parfait, on a trouvé le bon rapport, c’est report_invoice_document !



Modifier le rapport

Pour modifier le rapport, on ne modifie pas le code du template lui-même, mais on crée un template qui hérite de lui et le modifie.  Cela permet que le changement ne disparaisse pas lors d’une mise à jour du module.


On crée donc une nouvelle vue en appuyant sur Create.


On remplit le formulaire. Seuls les champs suivants sont importants:


Ensuite, il faut écrire le code xml qui va modifier la vue parente. Voici le code qui a été écrit dans notre exemple:


<?xml version="1.0"?>

<data inherit_id="account.report_invoice_document">

<xpath expr="//div[@id='total']/.." position="after">

<p t-if="o.type == 'out_refund'">Please deduct this credit note from a future invoice or ask a refund.</p>        

</xpath>

</data>


Explication du code :


On a un élément ‘Total’, qui est imbriqué dans plusieurs balises “td”, “tr”, “table” (qui sont des balises liées au tableau), et </div> (le slash “/” veut dire que c’est des balises de fermeture). 


On décide d’intervenir au-dessus du “<p>” qui a un “name=comment”, mais après la dernière balise “div”, voir la flèche bleue. 


On veut donc placer l’élément après toute la grosse balise “div” qui a “class=clearfix”. On remplit donc l’attribut “expr” de xpath avec : "//div[@id='total']/..". Ce qui se traduit en : la balise parente (“/..") de la balise div qui a pour id ‘total’ (//div[@id='total']"). 

Dans l’attribut “position”, on précise qu’on veut ajouter quelque chose après l’élément qu’on a sélectionné (position="after").

Note : il peut y avoir plusieurs manières de sélectionner un élément avec xpath. Les principaux critères de choix sont:

Par exemple on aurait aussi pu avoir <xpath expr="//p[@name=’comment']"   

position="before"></xpath>. Ça aurait été plus simple, même si on préfère “id” plutôt que “name” car il y a un contrôle sur l’unicité des id, pas sur le name. 



Documenter le changement

On va ensuite documenter le changement dans le module custom existant (s’il existe, sinon que faire ?). Par exemple, on va dans le repo cie_custom, puis dans le module foodhub_custom. On ouvre le fichier readme/DESCRIPTION.rst, on l’édite (en cliquant sur le crayon en haut à droite). On édite le fichier et on écrit un message de commit (par exemple : “[ADD] report modification doc”). On choisit l’option “Create a new branch” pour ouvrir une pull request. On renseigne ensuite la pull request en taggant des développeurs pour qu’ils valident le changement. 




Vues

Empêcher qu'une vue soit écrasée lors d'une mise à jour

Certains objets dans Odoo sont modifiables mais pas pérennes, c'est-à-dire qu'une mise à jour peut supprimer les modifications faites.

Pour empêhcer les mises à jour au niveau des vues (ce qui concerne principalement les rapports PDF), il faut être en mode débug puis

2.png

Image collée à 2022-3-30 15-575.png

Image collée à 2022-3-30 15-57.png

Vues

Ajouter un champs - Odoo v16

Odoo permet d’ajouter des nouveaux champs par l’interface.


Attention que
- les changements peuvent être invisibles pour les programmeurs, car les éléments personnalisés ne figurent nulle part dans le code. Le débogage devient plus difficile en conséquence
- les migrations deviennent beaucoup plus difficiles car il faut retrouver toutes les modifications personnalisées et les prendre en compte
- former les gens à l'utiliser correctement est plutôt difficile.
- les modifications personnalisées peuvent être remplacées par des mises à jour de modules, ce qui annule le travail.

Activer le mode développeur et aller dans le menu de configuration<technique<Structure de la base de données>champs

1.png

Créer ensuite un nouveau champs et entrer les paramètres adéquats. Un champ ajouté doit avoir un nom précédé d'un x_

2.png

Aller ensuite dans le menu configuration<technique<Interface utilisateur<vues

3.png

Créer une nouvelle vue qui héritera d'une vue existante. Cela permet de s'assurer que les modifications soient pérennes.

4.png

Dans l'exemple ci-dessus, le champs "x_profil", champs texte libre a été rajouté à la vue contact, après le champs "email".

<field name="email" position = "after">
<field name = "x_profil"/>
</field>

Faire des recherches avancées

Le module web_advanced_search permet de faire des recherches plus poussées, notamment pour les données relationnelles.

Capture du 2022-01-18 10-35-05.png

Il est également possible de faire des recherches avancées.

1.png

2.png

 

WIP - Désinstaller des modules en masse

S'il est possible nativement d'installer des modules "en masse", ce n'est pas le cas pour les désinstallations. Voici une astuce pour pouvoir le faire :

Attention cela va désinstaller les modules sans vous montrer les modules qui en dépendent et qui seront aussi désinstallé. A utiliser avec précaution !

1. Installer le module mass_editing et créer une opération en lot comme ci-dessous.

image-1690553845634.png

2. Aller dans les applications en vue liste, et sélectionnez les applications à désinstaller.

image-1690554064837.png

3. Définir le statut "to be removed", puis sur Apply.

image-1690554104471.png

4. Cliquez sur le menu Apply Schedule Upgrade. (note peut-être que cette étape n'est pas nécessaire que l'étape 5 suffit).

image-1690554159658.png

5. Attention : cela va désinstaller les modules, mais cela ne vas pas désinstaller les modules qui en dépendent !

bi_view_editor : rapport customisé

À quoi sert ce module ?

Le module bi_view_editor permet de créer des vues listes, pivots et graphiques customs. On peut ajouter les champs que l'on souhaite dans la vue, y compris des champs qui n'existent pas dans le modèle à représenter mais qui sont dans des modèles liés. 

Par exemple, on souhaite créer une vue pivot des écritures analytiques qui contiennent comme champ le "compte analytique parent". Or ce champ est défini sur le compte analytique, mais pas directement sur l'écriture analytique.

Untitled Diagram.png

Ainsi, si l'on va voir la vue pivot des écritures analytiques, on ne peut pas regrouper les écritures via le compte analytique parent.

image-1699954853544.png

Le module bi_view_editor va donc permettre de créer des vues pivots contenant des champs liés, mais qui ne sont pas directement accessibles sur la vue pivot native de Odoo.

Cas d'usage simple

Attention, pour utiliser ce module, c'est mieux d'avoir une idée de l'organisation du modèle de donnée, c'est-à-dire, quel champs existent dans quels modèles, et quels sont les liens entre les modèles. Ces infos sont parfois transparentes sur l'interface de Odoo mais parfois pas. Dans mon exemple avec les écritures analytique, j'ai besoin de comprendre que le champs "parent analytic account" est défini sur le modèle "compte analytique", qui est lié aux écritures analytiques.

En cas de besoin plus complexe qui ne peut pas être réalisé par bi_view_editor, on peut utiliser bi_sql_editor. Il demande de coder une requête directement en SQL, ce qui est plus flexible.

Une fois le module installé (voir les détails techniques dans le readme), on peut y accéder via le menu Dashboard>Custom Reports (ou en français : Tableau de bord>Custom reports).

On arrive sur l'écran suivant. On peut encoder le nom du rapport, puis commencer à chercher les données que l'on souhaite inclure.

image-1699955384185.png

Je commence à ajouter les champs présents dans le modèle "analytic line" (écritures analytiques) que je souhaite intégrer à ma vue.

image-1699955472051.png

Ensuite, on ajoute le champ "parent analytic account", qui est dans le modèle Compte analytique (analytic account).

image-1699955970568.png

Maintenant on a tous les champs que l'on souhaite. Par défaut ils sont ajoutés seulement à la vue liste. On doit les configurer pour qu'ils s'affichent comme ligne, colonne ou mesure dans la vue pivot.

On fait un clic-droit sur l'icône "liste"

image-1699956138581.png

Et on choisit  "Measure" pour le champ "Montant", car il sera utilisé comme valeur à calculer.

image-1699956183224.png

Pour les autres champs, on les ajoute comme lignes (row) et colonne parce qu'ils seront utilisés pour regrouper les données.

image-1699956240176.png

On a terminé, on clique sur "Generate the BI view", puis sur "open BI view", et enfin sur l'icône de la vue pivot.

Quand on ouvre la vue pivot, par défaut tous les champs lignes et colonnes seront utilisé et "ouvert". Donc si il y en a beaucoup cela peut prendre du temps pour calculer le tableau.C'est un comportement bizarre. C'est donc mieux de limiter le nombre de champs à ceux purement nécéssaires.

Et voilà, on a notre vue pivot et on peut la regrouper par "parent analytic account".

image-1699956460942.png

image-1699956542122.png

Enfin, on peut créer un menu via le bouton "Create a menu" dans la configuration de la vue.

Si on veut changer la configuration, il faut cliquer sur "reset to draft".

Le module peut aussi être utilisé pour créer des vues listes customisées, mais dans ce cas, les lignes ne sont pas cliquables ! C'est juste un outil de rapport, ce n'est pas un outil pour modifier les données.

Le module peut être utilisé de manière plus complexe, par exemple en ajoutant des groupes de sécurité, ou en allant chercher des champs plus éloignés du modèle principal. Cette documentation ne couvre pas ces cas d'usage.

Configuration d'une nouvelle société (mode multisociété)

Odoo permet d'administrer différentes sociétés sur une même instance, c'est le mode multisociété.

Par défaut, seulement une société existe sous le nom de "My Company", que l'on renomme lors d'une implémentation. Ajouter des sociétés supplémentaire active automatiquement le mode multisociété.

Avant d'ajouter des sociétés, il faut définir une architecture pour la base de données partagée : les contacts, les articles seront-ils partagés ou segmentés ?

Avec Odoo standard, la comptabilité est forcément séparée entre sociétés. En revanche les articles et les contacts peuvent être partagés ou réservés, selon les besoins :

Le module OCA account_multicompany_easy_creation permet de réaliser les étapes suivantes, et bien plus, de manière simplifiée

Ajouter une société

Créer une nouvelle société

Dans l'application Paramètres, ouvrir le menu "Utilisateurs et sociétés" et cliquer sur "Sociétés" :

screenshot-odoo16.sixteen.prod.srv.coopiteasy.be-2024.02.19-18_00_02.png

Définir quels comptes utilisateur ont accès à la nouvelle créée

Ajouter les utilisateurs et utilisatrices limitées à la société en sélectionnant uniquement la nouvelle société sur leur fiche.

Ajouter la nouvelle société sur la fiche des utilisateurs existants qui doivent pouvoir gérer toutes les sociétés.

Définir un plan comptable pour la nouvelle société

Dans la configuration de la facturation, sélectionner le paquet de localisation, ce qui installera le plan comptable adéquat. Dans Odoo standard, la comptabilité est séparée entre chaque société, même si la société créée est enfant d'une société mère : il n'y a pas d'héritage du plan comptable (des fonctionnalités spécifiques existent, contacter le support de Coop IT Easy pour plus de détails).

Gérer le partage des contacts et des articles dans la nouvelle société

Les articles et les contacts partagés (sur lesquels on n'a configuré aucune société) seront automatiquement partagés avec la nouvelle société. Par défaut, un nouvel article ou un nouveau contact sera partagé.

Pour ajouter des contacts et des articles réservés, sélectionner la société sur ces objets, par exemple pour les contacts, dans l'onglet "Vente et Achat" :

screenshot-step-coop.test.coopiteasy.be-2024.02.27-14_28_57.png

Créer par défaut des objets réservés

On peut définir, pour chaque utilisateur, si les nouveaux contacts et les nouveaux articles créés seront partagés ou réservés (par défaut, ils sont partagés).

Pour le faire sur un contact, sélectionner un contact réservé (sur lequel la société est spécifiée) et passer un mode debug.

Ouvrir le menu debug et cliquer sur "Valeurs par défaut" :

screenshot-step-coop.test.coopiteasy.be-2024.02.27-14_35_35.png

Là, en face de la mention "Par défaut :", sélectionner "Société = nomdelasociété"  et cocher la condition "Seulement vous".

Ensuite, se rendre dans la vue des paramètres par défaut de l'utilisateur. Cliquer sur la valeur par défaut "Société (res.partner)" que l'on vient de créer. Dupliquer l'enregistrement autant de fois que nécessaire pour tous les profils utilisateurs qui doivent avoir cette valeur par défaut :

screenshot-step-coop.test.coopiteasy.be-2024.02.27-14_40_56.png

Les prochains contacts créés par l'un ou l'une de ces users seront réservés net n'apparaîtront pas aux users des autres sociétés.

Ajouter un site web dédié pour la nouvelle société

Si l'on utilise le module site web, il est possible de créer un nouveau site web pour la nouvelle