Zum Inhalt springen

Dokumentation / Code und Addons

Module verwalten

Die Odoo-Module eines Dienstes ansehen, installieren, aktualisieren und deinstallieren.

Jeder Odoo-Dienst hat Module, die in seiner Datenbank installiert sind: die von Odoo selbst, etwa CRM oder Buchhaltung, und die der Addons, die du bereitgestellt hast. Ein Addon ist Code, den calmo.cloud aus einem Repository auf den Dienst kopiert; ein Modul ist das, was Odoo aus diesem Code installiert. Der Module-Tab zeigt die Module und lässt dich sie ändern.

Module anzeigen #

  1. Öffne den Dienst aus der Odoos-Liste
  2. Klicke auf den Module-Tab

Die Liste zeigt für jedes Modul den technischen Namen, den Namen, den Status und die Version. Der Filter Apps only ist standardmäßig aktiv und blendet technische Module aus. Die meisten eigenen Module und Module aus dem App Store sind technische Module; schalte den Filter also aus, um sie zu sehen.

calmo.cloud erfährt von den Modulen über das calmo.cloud-Modul in Odoo, das jede Änderung meldet, und über jede Moduloperation, die du hier ausführst. Eine Datenbank, die du von woanders umgezogen hast, hat dieses Modul womöglich nicht installiert. Dann holt die Liste auf, sobald du die App-Liste aktualisierst oder ein Modul installierst.

Modul-Status #

Status Bedeutung
Installed Das Modul ist installiert und in Benutzung
Uninstalled Odoo kennt das Modul, es ist aber nicht installiert
To Install, To Upgrade, To Remove Odoo hat eine Änderung geplant, die nicht zu Ende kam, zum Beispiel weil eine Installation auf einen Fehler lief
Uninstallable Odoo kann das Modul nicht installieren, zum Beispiel weil es für eine andere Odoo-Version geschrieben ist

App-Liste aktualisieren #

Odoo bietet nur die Module an, die in seiner App-Liste stehen. Wenn du ein Addon bereitstellst, kopiert calmo.cloud seinen Code auf den Dienst, aber Odoo führt es erst auf, wenn die App-Liste aktualisiert wurde. Klicke auf Refresh apps list, und Odoo sucht nach Modulen, die seit der letzten Aktualisierung neu sind. Der Dienst läuft dabei weiter.

Für sich allein brauchst du das selten: Wer ein Modul über seinen technischen Namen installiert, aktualisiert die Liste nebenbei.

Module installieren #

Klicke auf Install modules, gib einen oder mehrere technische Namen ein, zum Beispiel sale_management oder den Namen eines gerade bereitgestellten Addons, und bestätige. Odoo installiert sie zusammen mit den Modulen, von denen sie abhängen. Ein bereits installiertes Modul wird übersprungen: Es noch einmal zu installieren, würde seine Daten neu laden und könnte in Odoo vorgenommene Änderungen überschreiben.

Der Dienst steht still, während Odoo die Module installiert, und startet danach wieder. Ein Live-Dienst wird vorher gesichert; das kannst du im Dialog abschalten. Den Fortschritt siehst du im Aktionen-Tab. Ein Modul, dessen Addon noch bereitgestellt wird, lässt sich erst installieren, wenn die Bereitstellung fertig ist. Dasselbe gilt für jedes Modul, solange calmo.cloud eines der Repositories des Dienstes noch auf GitHub liest, etwa direkt nachdem du es hinzugefügt oder ein Modul hineingelegt hast: Wann das fertig ist, zeigt die Spalte Discovery im Repositories-Tab.

Die Schaltflächen Install und Upgrade neben einem Modul in der Liste wirken sofort auf dieses eine Modul, ohne vorherige Sicherung. Bei einem Live-Dienst nutze stattdessen Install modules oder Upgrade all modules.

Alle Module aktualisieren #

Upgrade all modules aktualisiert jedes installierte Modul, damit die Datenbank zum Odoo- und Addon-Code auf dem Dienst passt. Führe es aus, nachdem ein Pull ein neueres Odoo-Image gebaut hat: Die Dienstseite und dieser Tab zeigen Modules need an upgrade, bis du es getan hast (siehe Basis-Image aktualisieren). Führe es auch aus, wenn Seiten nach einem Image-Wechsel oder einer Wiederherstellung mit einem Fehler wie column … does not exist fehlschlagen, selbst ohne diesen Hinweis: Nur das Modul aus der Fehlermeldung zu aktualisieren, lässt die anderen zurück. Bei einer großen Datenbank kann das viele Minuten dauern, und der Dienst steht die ganze Zeit still. Ein Live-Dienst wird vorher gesichert. Solange noch ein Addon auf den Dienst bereitgestellt wird oder calmo.cloud eines seiner Repositories noch auf GitHub liest, lässt es sich nicht starten.

Ein Modul deinstallieren #

Klicke neben einem installierten Modul auf Uninstall und gib zur Bestätigung seinen technischen Namen ein. Odoo löscht alles, was das Modul gespeichert hat, etwa seine Tabellen, Datensätze und Einstellungen, und nur ein wiederhergestelltes Backup bringt es zurück. Ein Live-Dienst wird vorher gesichert.

Solange andere installierte Module von dem Modul abhängen, wird nichts deinstalliert: Die Benachrichtigung nennt sie. calmo.cloud prüft das erst, wenn der Dienst angehalten ist, deshalb startet der Dienst trotzdem kurz neu, und ein Live-Dienst wird trotzdem vorher gesichert. Deinstalliere diese Module zuerst, oder deinstalliere sie gemeinsam über die API oder einen KI-Assistenten. base und das calmo.cloud-Modul havsh lassen sich nicht deinstallieren.

Wer Module ändern darf #

Bei einem Odoo, das ein anderes Team mit deinem teilt, brauchst du zum Installieren und Aktualisieren von Modulen und zum Aktualisieren der App-Liste die Rolle Developer, zum Deinstallieren eines Moduls die Rolle Manager. Siehe Rollen.

Über die API und KI-Assistenten #

Die REST-API (Service Modules) und KI-Assistenten können die Module eines Dienstes auflisten und dieselben Operationen ausführen: installieren, aktualisieren, alle aktualisieren, deinstallieren und die App-Liste aktualisieren, für bis zu 50 Module auf einmal. Jede Operation meldet, was sie mit jedem Modul gemacht hat, zum Beispiel dass eines installiert und ein anderes nicht gefunden wurde. Wird eine Operation unterbrochen, etwa weil calmo.cloud aktualisiert wurde, während Odoo arbeitete, gilt sie nach spätestens etwa einer Stunde als fehlgeschlagen, und was mit den einzelnen Modulen geschah, ist unbekannt: Prüfe dann, ob der Dienst läuft, und sieh dir seine Module an, bevor du sie noch einmal startest. Der API-Token braucht dafür die Berechtigung Install, upgrade and uninstall Odoo modules.

Kern- vs. Addon-Module #

  • Kernmodule sind in Odoo integriert (z.B. CRM, Buchhaltung, Lagerverwaltung)
  • Addon-Module sind Erweiterungen, die du über calmo.cloud aus GitHub-Repositories bereitgestellt hast

Beide Typen erscheinen in der Modulliste und geben dir ein vollständiges Bild davon, was auf jedem Dienst läuft.