Entwicklermodus in Odoo: Wann und wie nutzen

Was Sie vorab brauchen

• Diesen Artikel für die Version 20.0: Laut Release Notes von Odoo S.A. ist Version 20 seit September 2026 die aktuelle Version.
• Ein Benutzerkonto und einen Browser. Im Community-Branch 20.0 gehört der Modus zu Ihrer Sitzung; ein zweites Konto im Betrieb merkt davon nichts (addons/web/models/ir_http.py).
• Für den Weg über die Oberfläche Zugriff auf die App Einstellungen und die Rolle Administrator: Die Dokumentation 20.0 nennt für diese Rolle Zugriff auf technische Funktionen und ordnet das technische Menü Datenbankadministratoren zu.
• Für den Wechsel zum Superuser Einstellungen-Zugriff im Bereich Administration des Benutzerprofils; dieser Schritt hebt Datensatzregeln und Zugriffsrechte auf (Dokumentation 20.0).
• Für Änderungen an Ansichten, Feldern, Standardwerten, Zugriffsrechten und Automatisierungen eine Kopie der Datenbank: Auf Odoo Online ist ein Duplikat für Testzwecke ab Werk neutralisiert und läuft nach 15 Tagen ab (Dokumentation 20.0), siehe Testumgebung für Odoo.
• Ein Backup, das Sie zurücklesen können, bevor Sie technische Einstellungen ändern (Odoo sichern).

Schritt für Schritt: Entwicklermodus nutzen

Schritt 1: Modus über die Oberfläche einschalten

Öffnen Sie die App Einstellungen und suchen Sie den Abschnitt Entwicklertools; klicken Sie auf Entwicklermodus aktivieren.

Ergebnis: An derselben Stelle steht Entwicklermodus deaktivieren, und in der oberen Leiste erscheint das Käfer-Symbol (Entwicklertools öffnen).

Schritt 2: Modus über die Adresse einschalten

Hängen Sie ?debug=1 an die Adresse an, zum Beispiel https://example.odoo.com/odoo?debug=1; ?debug=0 schaltet ab. Für die Fehlersuche im JavaScript gibt es ?debug=assets, für Test-Assets ?debug=tests. Im Community-Branch 20.0 stehen die Modi im Kernmodul web als Zeichenkette in der Sitzung und lassen sich mit Komma verbinden, etwa ?debug=assets,tests (addons/web/models/ir_http.py); die Modi assets und tests nennt auch die Dokumentation 20.0. In der Befehlspalette (Strg+K oder Cmd+K) tippen Sie debug.

Ergebnis: Die Adresse trägt den Parameter, und die Seite lädt im gewählten Modus neu.

Schritt 3: Menü Entwicklertools öffnen

Klicken Sie oben rechts auf das Käfer-Symbol. Die Dokumentation 20.0 beschreibt dieses Menü allgemein: Es enthält Werkzeuge zum Verstehen oder Bearbeiten technischer Daten, etwa Felder, Filter oder Aktionen einer Ansicht, und welche Einträge erscheinen, hängt davon ab, wo Sie es öffnen. Im Community-Branch 20.0 hängt die Auswahl zusätzlich von Ihren Rechten ab: an einem Datensatz Metadaten, Daten, Dateianhänge und Standardwerte festlegen, an einer Ansicht Berechnete Architektur sowie die Einträge Ansicht: Form und Suchansicht, in einer geöffneten Aktion Einträge zu Feldern, Modell, Aktion, Filter und Zugriffsrechten. Für Ansicht: Form und Suchansicht prüft Odoo Ihr Schreibrecht auf ir.ui.view, für Zugriffsrechte Ihr Leserecht auf ir.access; fehlt das Recht, bleibt der Eintrag weg (addons/web/static/src/core/debug/debug_context.js; Einträge am Datensatz und an einer Ansicht: addons/web/static/src/views/debug_items.js; Einträge an einer Aktion: addons/web/static/src/webclient/actions/debug_items.js).

Ergebnis: Im Community-Branch 20.0 zeigt ein Klick auf Metadaten die XML-ID sowie Erstellungs- und Änderungsdatum des Datensatzes (addons/web/static/src/views/debug_items.js).

Schritt 4: Technisches Menü öffnen

In der App Einstellungen liegt das technische Menü mit erweiterten Datenbankeinstellungen zu Datenbankstruktur, Sicherheit und Aktionen (Dokumentation 20.0), zum Beispiel Systemparameter. Den technischen Namen eines benutzerdefinierten Feldes ändern Sie unter Einstellungen ‣ Technisch ‣ Felder. Zuvor entfernen Sie das Feld in Studio aus allen Ansichten, und das erforderliche Präfix bleibt erhalten: x_, bei in Studio angelegten Feldern x_studio_ (Dokumentation 20.0, Studio ‣ Felder, Abschnitt Modify a field’s technical name).

Ergebnis: Unter Einstellungen ‣ Technisch sehen Sie Einträge wie Systemparameter und Felder.

Schritt 5: Änderungen in einer Kopie prüfen

Änderungen an Ansichten, Feldern, Standardwerten, Zugriffsrechten und Automatisierungen gehören in eine Kopie, nicht in die Produktion. Eine neutralisierte Kopie hat geplante Aktionen, ausgehende E-Mails, Bank-Synchronisierung und Zahlungsanbieter abgeschaltet (Dokumentation 20.0); ein Testlauf löst dort keine Kundenmail aus.

Schritt 6: Modus ausschalten

Schalten Sie den Modus mit ?debug=0 oder unter Einstellungen ‣ Entwicklertools aus. Nach dem Abmelden bleibt er in der Sitzung (Community-Branch 20.0, odoo/http/session.py); prüfen Sie das in Ihrem Browser.

Ergebnis: Der Abschnitt Entwicklertools zeigt wieder Entwicklermodus aktivieren.

Welche Werkzeuge der Modus öffnet: Liste mit Risikomarken

Die Tabelle nennt die Werkzeuge der Version 20.0 mit Wirkung und Risikomarke; die Marke ist die Einschätzung dieser Seite nach der Zahl der betroffenen Daten und der Umkehrbarkeit. Die Dokumentation 20.0 beschreibt das Entwicklertools-Menü nur allgemein; wo allein der öffentliche Community-Code eine konkrete Funktion belegt, ist die Zeile auf den Community-Branch 20.0 begrenzt und die Datei genannt.

Werkzeug und Menüweg	Wirkung	Risiko	So begrenzen Sie es
Entwicklermodus aktivieren (Einstellungen ‣ Entwicklertools, ?debug=1)	Blendet technische Menüs ein; im Community-Branch 20.0 legt Odoo den Modus als Zeichenkette in Ihrer Sitzung ab	gering	Nach der Arbeit ausschalten; eine weitergegebene Adresse mit ?debug=1 setzt ihn auch beim Empfänger
Metadaten, Daten (Entwicklertools am Datensatz; Community-Branch 20.0, addons/web/static/src/views/debug_items.js)	Zeigt XML-ID, Erstellungs- und Änderungsdatum und die Rohdaten	gering	Nur lesen
Dateianhänge (Entwicklertools am Datensatz; Community-Branch 20.0, addons/web/static/src/views/debug_items.js)	Öffnet die Anhänge des Datensatzes als Liste	mittel	Anhänge ansehen; Löschen in dieser Liste entfernt sie am Datensatz
Standardwerte festlegen (Entwicklertools am Datensatz)	Schreibt einen Standardwert für ein Feld in die Datenbank, Umfang Nur Sie oder Alle Benutzer (Community-Branch 20.0, ir_default.py)	mittel	Umfang Nur Sie wählen, wenn der Wert nur für Ihr Konto gilt; Alle Benutzer gilt für die ganze Datenbank
Ansicht: Form, Suchansicht (Entwicklertools an einer Ansicht; Community-Branch 20.0, addons/web/static/src/views/debug_items.js)	Öffnet die Ansicht als Datensatz zum Bearbeiten, auch im XML-Editor	hoch	Standard- und geerbte Ansichten nicht direkt ändern, sondern die passende geerbte Studio-Ansicht; sonst stellt das nächste Modul-Upgrade die Ansicht zurück (Dokumentation 20.0, Studio ‣ Ansichten)
Zugriffsrechte (Entwicklertools in einer Aktion; Community-Branch 20.0, addons/web/static/src/webclient/actions/debug_items.js)	Öffnet die Zugriffsrechte des Modells (ir.access) zum Ändern	hoch	Ein Fehler dort kann alle Administratoren aussperren (Dokumentation 20.0, Zugriffsrechte); zuerst Backup, dann in einer Kopie
Einstellungen ‣ Technisch	Erweiterte Einstellungen zu Datenbankstruktur, Sicherheit und Aktionen	hoch	In einer Kopie ändern, nicht im laufenden Betrieb
Superuser werden (Entwicklertools, unten)	Wechselt die Sitzung in den Superuser; Datensatzregeln und Zugriffsrechte gelten nicht mehr	hoch	Nur mit Einstellungen-Zugriff im Bereich Administration; danach abmelden; nach dem Verlassen kann der Zugang gesperrt sein (Dokumentation 20.0)
Profiling aktivieren (Entwicklertools, Werkzeuge)	Zeichnet Anfragen samt SQL-Abfragen auf, mit Ablaufzeit für die ganze Datenbank	mittel	Ablaufzeit setzen und Aufzeichnung beenden; auf Odoo Online nicht möglich (Dokumentation 20.0, Performance)
Assets regenerieren (Entwicklertools, Werkzeuge; Community-Branch 20.0, addons/web/static/src/core/debug/debug_menu_items.js)	Baut die Asset-Bündel neu	gering	Nach Änderungen an Assets ausführen; danach neu laden
Beschaffung: Planer starten (Lager ‣ Vorgänge, im Entwicklermodus)	Führt geplante Aktionen sofort aus	hoch	Odoo weist darauf hin, dass damit auch alle anderen geplanten Aktionen laufen (Dokumentation 20.0); in einer neutralisierten Kopie testen

Für Ansichtsänderungen ohne XML-Editor gibt es Odoo Studio; der Editionsvergleich von Odoo S.A. führt es nur für Enterprise. In Community gehört eine Anpassung in ein eigenes Modul (App und Modul).

So prüfen Sie das Ergebnis

1. Öffnen Sie in der App Einstellungen den Abschnitt Entwicklertools: Steht dort Entwicklermodus deaktivieren, ist der Modus aktiv.
2. Lesen Sie die Adresse: Sie trägt den Parameter ?debug=1, ?debug=assets oder ?debug=tests.
3. Klicken Sie oben rechts auf das Käfer-Symbol und öffnen Sie an einem Datensatz Metadaten: Im Community-Branch 20.0 sehen Sie XML-ID sowie Erstellungs- und Änderungsdatum.
4. Öffnen Sie Einstellungen ‣ Technisch und darin Systemparameter: Ist der Eintrag sichtbar, haben Sie die Rechte eines Datenbankadministrators.
5. Schalten Sie den Modus mit ?debug=0 aus und laden Sie die Seite neu: Der Abschnitt Entwicklertools zeigt wieder Entwicklermodus aktivieren.

Wenn etwas nicht klappt

Symptom	Ursache	Abhilfe
Kein Käfer-Symbol oben	Modus nicht aktiv, oder der Parameter ging beim Navigieren verloren	?debug=1 erneut anhängen oder den Modus in den Entwicklertools einschalten
Kein Eintrag für Ansicht, Suchansicht oder Zugriffsrechte im Menü	Im Community-Branch 20.0 prüft Odoo für Ansicht und Suchansicht Ihr Schreibrecht auf ir.ui.view und für Zugriffsrechte Ihr Leserecht auf ir.access; fehlt das jeweilige Recht, bleibt der Eintrag weg (addons/web/static/src/core/debug/debug_context.js; addons/web/static/src/views/debug_items.js; addons/web/static/src/webclient/actions/debug_items.js). Die Einträge Felder, Modell und Filter setzen außerdem voraus, dass die geöffnete Aktion ein Modell hat	Rechte und Rolle im Benutzerprofil prüfen, siehe Benutzer und Zugriffsgruppen in Odoo
Kein technisches Menü in den Einstellungen	Ihr Konto ist kein Datenbankadministrator	Rolle prüfen; das technische Menü ordnet die Dokumentation Datenbankadministratoren zu
Seiten laden langsam, Assets ungebündelt	?debug=assets liefert Assets nicht minimiert aus (Community-Branch 20.0, odoo/addons/base/models/assetsbundle.py)	Mit ?debug=1 weiterarbeiten oder den Modus beenden
Ansichtsänderung nach dem Upgrade weg	Sie haben eine Standard- oder geerbte Ansicht direkt geändert	Änderung über die passende geerbte Studio-Ansicht oder ein eigenes Modul anlegen
Profiling lässt sich nicht einschalten	Odoo Online lässt kein Profiling zu, oder die Ablaufzeit ist abgelaufen	Auf Odoo Online verzichten; sonst im Feld Profiling aktivieren bis eine Ablaufzeit setzen
Nach Planer starten gingen Mails oder Aufträge heraus	Der manuelle Lauf führt alle geplanten Aktionen aus	Testläufe in einer neutralisierten Kopie ausführen

Wann Sie Hilfe holen sollten

• Vor Änderungen an Zugriffsrechten und Gruppen: Ein Fehler dort kann alle Administratoren aussperren; die Dokumentation nennt das „impotent admin” und verweist auf einen Support-Zugang (Benutzer und Zugriffsgruppen in Odoo).
• Vor dem Wechsel in den Superuser: Er hebt Datensatzregeln und Zugriffsrechte auf; die Dokumentation nennt eine Sperre nach dem Verlassen als mögliche Folge. Halten Sie ein Backup bereit (Odoo sichern).
• Bei eigenem Code: Automatisierungsregeln mit Python-Code (Aktion Execute Code) und eigene Module pflegen Sie selbst. Klären Sie mit Ihrer Odoo-Beratung, wer diese Pflege übernimmt und wie sie abgerechnet wird.