Insérer une liste¶
Il existe deux façons d’insérer une liste Odoo dans une feuille de calcul Odoo :
Insérer une liste à partir d’une vue liste Odoo dans une feuille de calcul Odoo, un tableau de bord Odoo ou une feuille de calcul de calculateur de devis.
Insérer une liste qui extrait des données Odoo directement depuis une feuille de calcul Odoo. Cette option permet d’extraire des données de n’importe quel modèle, y compris des modèles pour lesquels aucune vue liste n’est disponible, par exemple le modèle Sales Order Line.
Dans les deux cas, la liste est connectée aux données sous-jacentes de la base de données grâce à sa source de données unique, qui maintient les données à jour et fournit un accès aux données sous-jacentes directement depuis la feuille de calcul. Cependant, le fait que la liste s’étende ou non pour intégrer de nouveaux enregistrements dépend du fait qu’il s’agisse d’une liste statique ou dynamique.
Listes statiques et dynamiques¶
Lorsqu’une liste provenant d’une vue liste Odoo est insérée dans une feuille de calcul Odoo, il s’agit par défaut d’une liste statique, où chaque cellule extrait des données de la base de données via une fonction spécifique à Odoo. Les données de la liste sont maintenues à jour, mais celle-ci ne s’agrandit pas pour intégrer de nouveaux enregistrements.
L’insertion d’une liste Odoo directement depuis une feuille de calcul Odoo génère une liste dynamique, dans laquelle une unique fonction matricielle propre à Odoo récupère les données de la base de données. Les données de la liste sont maintenues à jour et, si souhaité, la fonction matricielle peut être modifiée pour permettre à la liste de s’étendre afin d’accueillir de nouveaux enregistrements.
Note
Une liste statique peut être convertie en liste dynamique et une liste dynamique peut être convertie en liste statique si nécessaire.
Insérer une liste Odoo depuis une vue liste¶
Astuce
Avant d’insérer une liste dans une feuille de calcul, prendre en compte les champs qui doivent être visibles ainsi que la manière dont les enregistrements sont filtrés et/ou triés. Cela peut avoir un impact à la fois sur le temps de chargement et sur la convivialité de la feuille de calcul.
Les champs de propriétés visibles dans une vue liste sont inclus lorsque la liste est insérée dans une feuille de calcul.
Pour insérer une liste depuis une vue liste Odoo dans une feuille de calcul Odoo :
Depuis la vue liste concernée, cliquer sur l’icône (Actions) à côté du nom de la vue, puis sur .
Astuce
Pour insérer uniquement des enregistrements spécifiques, sélectionner les enregistrements concernés, cliquer sur le bouton Actions qui apparaît en haut au centre de l’écran, puis Insert in spreadsheet.
Dans la fenêtre qui s’ouvre, modifier le Nom de la liste si nécessaire.
Modifier le nombre d”Enregistrements, c’est-à-dire de lignes, à insérer, si nécessaire.
Par défaut, le nombre affiché est le nombre d’enregistrements visibles sur la première page de la vue liste. Par exemple, si la liste contient 150 enregistrements mais que seuls 80 sont visibles, ce champ affiche 80.
Astuce
Une liste insérée depuis une vue liste Odoo est une liste statique qui ne s’étendra pas automatiquement pour accueillir de nouveaux enregistrements. S’il est probable que de nouveaux enregistrements soient ajoutés dans la base de données, envisager d’ajouter des lignes supplémentaires lors de l’insertion de la liste.
Cliquer sur Feuille de calcul vierge pour créer une nouvelle feuille de calcul, ou sélectionner dans quelle feuille de calcul existante la liste doit être insérée.
Cliquer sur Confirmer.
La liste est insérée dans une nouvelle feuille de la feuille de calcul. L’onglet de la feuille dans la barre inférieure affiche le nom de la liste suivi de l’ID de la liste, par ex. Devis par total (Liste #1). Un panneau sur le côté droit de la feuille de calcul affiche les propriétés de la liste.
Par défaut, la liste est une liste statique, dans laquelle chaque cellule contient une fonction propre à Odoo qui récupère les données de la base de données.
Note
Le Nom de la liste est utilisé dans le nom de la feuille et dans les propriétés de la liste, et peut être modifié à tout moment.
Des enregistrements/lignes peuvent également être ajoutés manuellement après l’insertion de la feuille de calcul. La liste insérée peut également être convertie en liste dynamique pour lui permettre de s’étendre afin d’accueillir de nouveaux enregistrements.
Lors de l’insertion d’une liste dans une nouvelle feuille de calcul, celle-ci est enregistrée dans l’application Odoo Documents dans le dossier personnel Mon Drive.
Pour rompre le lien entre une liste insérée et la base de données, sélectionner l’ensemble de la liste, faire un clic droit et sélectionner Copier, puis faire à nouveau un clic droit et sélectionner .
Fonctions de liste statique¶
Une liste statique utilise les fonctions spécifiques à Odoo suivantes pour récupérer respectivement les valeurs d’en-tête et de champ, via sa source de données :
=ODOO.LIST.HEADER(list_id, field_name)
=ODOO.LIST.VALUE(list_id, index, field_name)
Les arguments de la fonction sont les suivants :
list_id: l’ID attribué lors de l’insertion de la liste. La première liste insérée dans une feuille de calcul se voit attribuer l’ID de liste1, la deuxième l’ID de liste2, etc.index: identifie la ligne sur laquelle l’enregistrement apparaissait dans la liste avant l’insertion. La première ligne a un index de1, la deuxième un index de2, etc.field_name: le nom technique du champ.
Astuce
Cliquer sur une cellule individuelle affiche la formule associée, le cas échéant, dans la barre de formule. Pour afficher toutes les formules d’une feuille de calcul en même temps, cliquer sur dans la barre de menus. L’exemple ci-dessous montre les fonctions utilisées pour récupérer les en-têtes et les valeurs de liste.
Convertir une liste statique en liste dynamique¶
Pour permettre à une liste insérée de s’étendre et d’intégrer de nouveaux enregistrements, convertir la liste en liste dynamique, puis mettre à jour la fonction matricielle.
Il existe deux manières principales de convertir une liste statique en liste dynamique :
Dupliquer la liste depuis les propriétés de la liste. La nouvelle liste dynamique conserve le même style que la liste d’origine.
Note
Avec cette méthode, la nouvelle liste dynamique se voit attribuer le prochain identifiant de liste disponible. Cela signifie que plusieurs listes peuvent être associées au même modèle, tout en ayant des configurations ou des calculs distincts.
Réinsérer une liste dynamique depuis le menu Données. Sur la feuille qui contient la liste statique, positionner le curseur dans une cellule vide. Cliquer sur dans la barre de menus, puis sélectionner la liste concernée.
Une nouvelle liste dynamique apparaît, avec le même style que la liste d’origine.
Astuce
Il est également possible de réinsérer une liste dynamique en saisissant la fonction de la liste dynamique dans une cellule vide, par ex.
=ODOO.LIST(1), où1est l” » drafts= »identifiant de la liste. Cependant, avec cette méthode, le style du tableau doit être réappliqué manuellement.Note
Lorsqu’une liste dynamique est réinsérée depuis le menu Données ou en saisissant manuellement la fonction de liste dynamique, les listes statique et dynamique partagent la même source de données et, par conséquent, le même identifiant de liste. Pour éviter toute confusion, supprimer la liste statique d’origine.
La cellule supérieure gauche de la nouvelle liste dynamique contient une fonction matricielle spécifique à Odoo qui récupère les données de la base de données.
Insérer une liste Odoo depuis une feuille de calcul¶
Pour insérer une liste Odoo directement depuis une feuille de calcul Odoo :
Ouvrir la feuille de calcul Odoo pertinente depuis l’application Documents ou créer une nouvelle feuille de calcul vierge.
Cliquer sur dans la barre de menus.
Dans le panneau Nouvelle liste Odoo situé à droite de la feuille, sélectionner le Modèle à partir duquel les données doivent être récupérées, puis cliquer sur Enregistrer.
La liste par défaut du modèle est insérée dans une nouvelle feuille de calcul. Le nom de la feuille dans la barre inférieure affiche le nom du modèle suivi de l” » drafts= »identifiant de la liste, par ex. Sales Order (List #1). Un panneau sur le côté droit de la feuille de calcul affiche les propriétés de la liste.
Par défaut, la liste est une liste dynamique, dont la cellule supérieure gauche contient une fonction matricielle spécifique à Odoo qui récupère les données de la base de données.
Astuce
Lorsqu’une liste dynamique est insérée pour la première fois dans une feuille de calcul, un maximum de 80 enregistrements est affiché. Modifier la fonction matricielle pour changer le nombre maximal d’enregistrements à afficher ou pour afficher tous les enregistrements et permettre à la liste de s’étendre afin d’intégrer de nouveaux enregistrements.
Fonction de liste dynamique¶
Contrairement à une liste statique, où chaque cellule contient une fonction unique qui récupère des données via la source de données, une liste dynamique possède une seule fonction matricielle spécifique à Odoo :
=ODOO.LIST(list_id, [row_count])
Les arguments de la fonction sont les suivants :
list_id: l’identifiant attribué lors de l’insertion de la liste. La première liste insérée dans une feuille de calcul reçoit l’ID de liste1, la deuxième, l’ID de liste2, etc.row_count: définir une valeur pour limiter le nombre de lignes/enregistrements.
Convertir une liste dynamique en liste statique¶
Dans certaines situations, par exemple pour pouvoir ajouter une colonne contenant une formule saisie manuellement, il peut être nécessaire de convertir une liste dynamique en liste statique, où chaque cellule possède une fonction individuelle qui récupère les données de la source de données. Pour ce faire, procéder comme suit :
Sur la feuille qui contient la liste dynamique, positionner le curseur dans une cellule vide.
Cliquer sur dans la barre de menu, puis sélectionner la liste concernée.
Une nouvelle liste statique apparaît, avec le même style que la liste originale. Cliquer sur une cellule pour voir la fonction dans la barre de formule.
Propriétés de la liste¶
Les propriétés de la liste s’affichent sur le côté droit de l’écran lorsqu’une liste est insérée. Elles sont accessibles à tout moment via le menu Données en sélectionnant la liste concernée dans la section Liste, ou en faisant un clic droit n’importe où sur la liste et en cliquant sur Voir les propriétés de la liste.
Les propriétés de liste suivantes sont affichées, dont certaines peuvent être modifiées :
Liste # : l’ID de la liste, qui est utilisé pour identifier la liste pendant toute la durée de vie de la feuille de calcul. Les ID de liste sont attribués séquentiellement au fur et à mesure que des listes supplémentaires sont insérées dans la feuille de calcul.
Nom de la liste : le nom de la liste. Modifiez-le si nécessaire. Notez que la modification du nom de la liste dans les propriétés de la liste ne modifie pas le nom de la liste affiché dans le nom de la feuille, et vice versa.
Modèle : le modèle à partir duquel les données ont été extraites et le nombre total d’enregistrements dans le modèle. Le nombre d’enregistrements est recalculé à chaque ouverture de la feuille de calcul ou à chaque actualisation du navigateur ou de la feuille de calcul.
Colonnes : les colonnes qui étaient visibles dans la vue liste lors de l’insertion de la liste, ou les colonnes par défaut de la liste si la liste a été insérée depuis la feuille de calcul.
Tri : la manière dont les données sont triées, le cas échéant.
Domaine : les règles utilisées pour déterminer les enregistrements affichés. Cliquer sur Modifier le domaine pour ajouter ou modifier des règles.
Pour dupliquer ou supprimer la source de données d’une liste, cliquer sur l’icône (engrenage), puis cliquer sur Dupliquer ou Supprimer selon le cas.
Note
Pour une liste dynamique, les colonnes ne peuvent être ajoutées, masquées ou supprimées que via les propriétés de la liste ; ces actions ne peuvent pas être effectuées dans la liste elle-même. Pour une liste statique, c’est l’inverse ; les colonnes ne peuvent être ajoutées, masquées ou supprimées que dans la liste elle-même.
Lorsque des filtres globaux sont utilisés, le Domaine est combiné avec les valeurs sélectionnées du filtre global avant que les données ne soient chargées dans la feuille de calcul.
Manipuler une liste insérée¶
Trier les colonnes¶
Note
Contrairement aux filtres standards de feuille de calcul, qui n’agissent que sur les données visibles, la fonctionnalité Tri dans le panneau des propriétés de la liste agit sur les sources de données sous-jacentes d’une feuille de calcul, triant ainsi les données avant leur chargement.
Pour trier une liste selon une colonne spécifique :
Ouvrir le panneau des propriétés de la liste.
Dans la section Tri, cliquer sur Ajouter.
Sélectionner le champ approprié. Le tableau est ensuite trié par ordre croissant en fonction du champ/de la colonne sélectionné(e).
Modifier l” » rescue= »true:guilabel:
Ordrede tri en Décroissant si souhaité.
Pour supprimer une règle de tri, cliquer sur l’icône (supprimer) figurant sur la carte du champ.
Astuce
Ajouter plusieurs règles de tri pour créer un tri hiérarchique où les données sont d’abord triées selon le premier champ/la première colonne de tri, puis selon les champs/colonnes suivants dans l’ordre. Par exemple, avec un tri hiérarchique, les clients peuvent être affichés par ordre alphabétique croissant, et leurs bons de commande respectifs par ordre décroissant du montant total. Pour modifier l’ordre dans lequel le tri hiérarchique est appliqué, faire glisser la carte d’un champ vers la position souhaitée.
Manipuler une liste statique¶
Après avoir inséré une liste issue d’une vue liste d’Odoo dans une feuille de calcul Odoo, il est possible de :
Ajouter des lignes/enregistrements¶
Pour ajouter des lignes/enregistrements à une liste statique, utiliser l’une des méthodes suivantes :
Sélectionner la dernière ligne du tableau, puis survoler le carré bleu jusqu’à ce que l’icône plus apparaisse. Cliquer et glisser vers le bas pour ajouter le nombre de lignes souhaité. Les cellules des nouvelles lignes sont renseignées avec la formule appropriée pour récupérer les valeurs de la liste. S’il existe des données correspondantes dans la base de données, les cellules sont renseignées.
Positionner le curseur dans la cellule supérieure gauche de la feuille, cliquer sur dans la barre de menu, puis sélectionner la liste appropriée. Dans la fenêtre contextuelle, indiquer le nombre de lignes/enregistrements à insérer et cliquer sur Confirmer. Une liste mise à jour est insérée, remplaçant la liste précédente.
Astuce
Les méthodes ci-dessus peuvent également être utilisées pour ajouter des lignes vides supplémentaires à un tableau de feuille de calcul. Cela peut s’avérer utile pour les listes où des enregistrements supplémentaires sont susceptibles d’être créés dans la base de données, par ex. de nouvelles catégories d’articles ou de nouveaux vendeurs.
Ajouter, masquer, supprimer ou renommer des colonnes¶
Pour ajouter des colonnes à une liste statique :
Sélectionner la colonne à droite ou à gauche de l’endroit où la nouvelle colonne doit être insérée.
Cliquer sur puis ou depuis la barre de menu, ou faire un clic droit puis Insérer une colonne à gauche ou Insérer une colonne à droite selon le cas.
Copier la cellule d’en-tête de n’importe quelle colonne, la coller dans la cellule d’en-tête de la nouvelle colonne et appuyer sur
Entrée.Double-cliquer sur la nouvelle cellule d’en-tête, puis sélectionner et supprimer le nom du champ qui apparaît entre les premiers guillemets ; la liste de tous les noms techniques des champs du modèle lié apparaît.
Sélectionner le champ approprié dans la liste.
Astuce
Survoler le nom technique d’un champ pour afficher le libellé du champ.
Pour ajouter un champ lié, cliquer sur l’icône (flèche droite) sur la ligne d’un champ pour accéder à la liste des champs liés. Sélectionner le champ approprié ou taper
.puis le nom technique du champ. Par exemple, pour afficher une colonne avec le pays du client dans une liste issue du modèle Sales Order, utiliser le champ liépartner_id.countryen sélectionnant Customer, puis Country.
Modifier le libellé du champ si souhaité.
Sélectionner la cellule d’en-tête, puis double-cliquer sur le carré bleu dans le coin inférieur droit de la cellule. Les cellules de la colonne sont remplies avec la formule appropriée pour récupérer les valeurs de la liste. S’il existe des données correspondantes dans la base de données, les cellules sont renseignées.
Pour masquer une colonne dans une liste statique, faire un clic droit sur la lettre d’en-tête de la colonne, puis cliquer sur Masquer la colonne. Pour réafficher une colonne, cliquer sur ou (flèche gauche ou droite) sur l’en-tête de part et d’autre de la ou des colonnes masquées.
Pour supprimer une colonne dans une liste statique, faire un clic droit sur la lettre d’en-tête de la colonne, puis cliquer sur Supprimer la colonne.
Pour renommer une colonne dans une liste statique, double-cliquer sur la cellule d’en-tête, puis modifier le libellé du champ qui apparaît entre les deuxièmes guillemets. Pour revenir au libellé de champ Odoo par défaut, supprimer entièrement le libellé du champ.
Manipuler une liste dynamique¶
Déterminer le nombre de lignes/enregistrements affichés¶
Par défaut, lorsqu’une liste Odoo est insérée directement depuis une feuille de calcul ou lorsqu’une liste est dupliquée via les propriétés de la liste, un maximum de 80 enregistrements est inséré.
Note
Le nombre total d’enregistrements du modèle est affiché sous Modèle dans les propriétés de la liste.
Pour modifier le nombre de lignes/enregistrements affichés, double-cliquer sur la cellule en haut à gauche du tableau, puis :
remplacer la deuxième valeur entre crochets, c’est-à-dire le nombre de lignes, par le nombre souhaité ; ou
supprimer la valeur du nombre de lignes pour afficher tous les enregistrements et permettre à la liste de s’étendre pour intégrer les nouveaux enregistrements.
Ajouter, masquer ou supprimer des colonnes dans une liste dynamique¶
Pour ajouter des colonnes à une liste Odoo insérée :
Ouvrir le panneau des propriétés de la liste.
Dans la section Colonnes, cliquer sur Ajouter.
Sélectionner le champ approprié.
Renommer la colonne si souhaité en cliquant sur la carte de la colonne, puis en saisissant le nouveau nom.
Pour masquer ou afficher une colonne, cliquer sur l’icône (masquer) ou (afficher) sur la carte de la colonne.
Pour supprimer une colonne, cliquer sur l’icône (supprimer) sur la carte de la colonne.
Dupliquer ou supprimer une liste insérée¶
Note
Lors de la duplication ou de la suppression d’une liste insérée, il est important de se rappeler que chaque liste possède également une source de données.
Dupliquer une liste insérée¶
Dupliquer une liste insérée via les propriétés de la liste crée une source de données supplémentaire. Cela permet d’effectuer différentes manipulations sur les mêmes données au sein d’une même feuille de calcul.
Pour dupliquer une liste insérée :
Une fois les propriétés de la liste ouvertes, cliquer sur l’icône (engrenage) à côté de Nom de la liste, puis sur Dupliquer. La liste dupliquée est automatiquement insérée dans une nouvelle feuille de la feuille de calcul, avec les propriétés de la liste ouvertes dans le panneau de droite.
Modifier le Nom de la liste dans le panneau des propriétés et l’onglet de la feuille si souhaité.
La nouvelle source de données se voit attribuer le prochain ID de liste disponible. Par exemple, si aucune autre liste n’a été insérée entre-temps, dupliquer Liste #1 entraîne la création de Liste #2.
Note
Dupliquer une liste insérée en la copiant-collant ou en dupliquant la feuille dans laquelle elle a été insérée ne crée pas de nouvelle source de données. Toute modification apportée aux propriétés d’une telle liste aurait donc un impact sur toutes les copies de la liste.
Dupliquer une :
liste statique entraîne l’insertion de la liste dynamique par défaut pour ce modèle, c’est-à-dire avec les colonnes par défaut et un maximum de 80 enregistrements ;
liste dynamique entraîne l’insertion d’une liste avec les mêmes colonnes que la liste originale et un maximum de 80 enregistrements, même si la liste originale a été modifiée pour avoir une limite différente ou aucune limite.
Supprimer une liste insérée¶
Pour supprimer complètement une liste insérée et la source de données sous-jacente d’une feuille de calcul, effectuer les étapes suivantes dans n’importe quel ordre :
Supprimer le tableau de la feuille de calcul contenant la liste à l’aide de la méthode de votre choix, par exemple via des commandes au clavier, les menus de la feuille de calcul ou en supprimant la feuille. Cela supprime la représentation visuelle des données.
Depuis le panneau des propriétés de la liste, cliquer sur l’icône (engrenage), puis sur Supprimer. Cela supprime la source de données de la liste de la feuille de calcul.
Astuce
Sinon, après avoir supprimé une liste insérée d’une feuille de calcul, utiliser l’outil de Nettoyage des données pour supprimer la source de données correspondante.