Action Window (ir.actions.act_window)

Was ist ein Action Window (ir.actions.act_window)?

Ein Action Window (ir.actions.act_window) ist in Odoo ein zentrales Action-Objekt, mit dem du definierst, welche Daten (Model), in welcher Ansicht (Liste, Formular, Kanban usw.) und mit welchen Filtern oder Kontextparametern einem Nutzer im Backend oder Portal angezeigt werden. Es steuert damit, welches Fenster sich beim Klick auf ein Menü oder eine Schaltfläche öffnet.

1. Grundlagen: Was bedeutet Action Window (ir.actions.act_window)?

Der Begriff Action Window (ir.actions.act_window) stammt aus dem Business-Framework Odoo und bezeichnet eine spezielle Action-Konfiguration, die ein Datenfenster öffnet. Ein Action Window definiert im Kern:

welches Datenmodell (z. B. Produkt, Bestellung, Kunde) geladen wird,
in welchen Ansichten (Listenansicht, Formularansicht, Kanban, Pivot usw.) die Daten erscheinen,
welche Standardfilter, Domains und Sortierungen aktiv sind,
und über welchen Menüeintrag oder Button der Nutzer dieses Fenster erreicht.

Im Odoo-Datenmodell wird ein Action Window als Datensatz in der technischen Tabelle ir.actions.act_window gespeichert. Diese Action wird über XML, Python oder die Nutzeroberfläche konfiguriert und ist eng mit Menüeinträgen (ir.ui.menu) verknüpft.

2. Technischer Kontext: Wo ist ein Action Window (ir.actions.act_window) im System verankert?

Ein Action Window ist ein technisches Objekt der Odoo-Serverkomponente. Es gehört zur Gruppe der ir.actions, also generischen Aktionen, die im System ausgeführt werden können. Zu den wichtigsten Action-Typen gehören:

ir.actions.act_window – öffnet ein Fenster mit Datensätzen eines Modells,
ir.actions.report – löst einen Report wie PDF oder HTML aus,
ir.actions.server – führt serverseitige Python- oder regelbasierte Aktionen aus,
ir.actions.client – steuert clientseitige Widgets und spezielle UI-Elemente.

Während andere Action-Typen eher spezielle Aufgaben erfüllen, ist das Action Window das Standardwerkzeug, um Geschäftsobjekte in der Benutzeroberfläche anzuzeigen und zu bearbeiten. Es bildet damit die Brücke zwischen Datenbankmodell und Nutzeroberfläche.

3. Aufbau eines Action Window: Wichtige Felder und Parameter

Ein Datensatz in ir.actions.act_window besteht aus einer Reihe von Feldern, mit denen du das Verhalten der geöffneten Ansicht präzise steuerst. Die wichtigsten sind:

Feld	Funktion / Bedeutung
name	Anzeigename der Aktion, oft identisch mit dem Menülabel
res_model	Technischer Name des Modells, dessen Datensätze angezeigt werden (z. B. product.template)
view_mode	Reihenfolge der Ansichtsarten, z. B. tree,form,kanban,pivot,graph
view_ids / view_id	Optionale Verknüpfung zu konkreten Views; steuert z. B. eigene Listen- oder Formularansichten
domain	Filterbedingung (Domain), welche Datensätze initial geladen werden
context	Voreinstellungen und zusätzliche Parameter (z. B. Standardwerte, Suchfilter)
target	Legt fest, ob im aktuellen Fenster, in einem Modal-Popup oder in einem neuen Fenster geöffnet wird

Durch diese Parameter kannst du sehr granular festlegen, wie ein Nutzer mit bestimmten Daten arbeitet. Für E-Commerce-Setups ist das wichtig, um z. B. separate Masken für Produktdaten, Preisregeln oder Feed-Attribute bereitzustellen.

4. Wie funktioniert ein Action Window (ir.actions.act_window) im Zusammenspiel mit Menüs?

In der Praxis erlebst du ein Action Window vor allem, wenn du im Odoo-Backend auf einen Menüeintrag klickst. Hinter fast jedem Menüpunkt steckt technisch eine Verknüpfung zu einem Datensatz in ir.actions.act_window. Der Ablauf ist typischerweise:

Du klickst auf einen Menüeintrag im Backend, zum Beispiel Verkauf → Angebote.
Der Menüeintrag ist mit einem bestimmten Action Window verknüpft.
Odoo lädt das konfigurierte Modell (z. B. sale.order) und wendet Domain, Kontext und View-Konfiguration an.
Du siehst eine Listen- oder Kanbanansicht mit genau den Datensätzen, die zur Aktion passen.

Damit ist ein Action Window immer das Bindeglied zwischen Navigationsstruktur (Menü) und dem konkreten Arbeitsfenster, in dem du deine E-Commerce-Prozesse steuerst.

5. Typische Einsatzszenarien im E-Commerce

Gerade in E-Commerce-Setups mit vielen Produkten, Kanälen und Integrationen spielt das Action Window eine wichtige Rolle für effiziente Workflows. Häufige Szenarien sind:

Produktverwaltung: Eigene Aktionen für Standardprodukte, Varianten, Bundles oder kanal-spezifische Produktlisten.
Preis- und Rabattlogik: Action Windows für Preislisten, Mengenrabatte, individuelle Konditionen oder Kampagnenpreise.
Bestellabwicklung: Gefilterte Views für neue Bestellungen, Aufträge im Versand, Retouren oder Marktplatz-Bestellungen.
Feed-Management: Spezielle Fenster für Export-Feeds, Mapping-Tabellen oder Logeinträge von Schnittstellen.
Content-Workflows: Eigene Aktionen für Produkte mit fehlenden oder veralteten Texten, Bildern oder Attributen.

Solche spezialisierten Action Windows sorgen dafür, dass Teams in E-Commerce-Unternehmen schnell genau die Datensätze sehen, die für ihren Job relevant sind, ohne ständig komplexe Filter konfigurieren zu müssen.

6. Konfiguration: Wie legst du ein Action Window (ir.actions.act_window) an?

Ein neues Action Window kannst du auf drei Wegen anlegen oder anpassen: über die Nutzeroberfläche (Entwicklermodus), über XML in Modulen oder programmgesteuert in Python. Für ein besseres Verständnis ist die UI-Variante ein guter Einstieg.

6.1 Action Window im Odoo-Backend konfigurieren

Im Entwicklermodus kannst du Action Windows direkt im Backend editieren:

Entwicklermodus aktivieren (z. B. über Einstellungen).
Unter Technisch → Aktionen → Fensteraktionen (Bezeichnung kann je Version variieren) findest du alle ir.actions.act_window.
Dort kannst du bestehende Aktionen bearbeiten oder neue anlegen.

Typische Konfigurationsschritte sind:

Auswahl des Modells (res_model), z. B. product.template.
Definition von view_mode, z. B. tree,form,kanban.
Setzen einer Domain, z. B. nur aktive Produkte oder nur Produkte ohne Beschreibung.
Anpassung des Kontexts, z. B. voreingestellte Suchfilter oder Standardwerte.

6.2 Action Window per XML definieren

In Modulen wird ein Action Window häufig via XML angelegt. Ein stark vereinfachtes Beispiel (ohne Codeformatierung, nur konzeptionell):

Ein Act-Window-Datensatz enthält Name, Modell, View-Mode und optional Domain und Kontext. Ein Menüeintrag verweist über das Feld action auf genau dieses Act Window. So ist die Aktion sauber versionssicher und updatefähig in deinem Modul verankert.

6.3 Programmgesteuerte Erstellung in Python

Fortgeschrittene Nutzer legen Action Windows über die ORM-API an, zum Beispiel in Migrationsskripten oder Setup-Routinen. Dabei wird ein Datensatz im Modell ir.actions.act_window erzeugt und mit dem gewünschten Menüeintrag verknüpft.

7. Wichtige Parameter im Detail: Domain, Kontext und View-Modi

Drei Aspekte bestimmen besonders stark, wie sich ein Action Window im Alltag verhält: die Domain, der Kontext und die View-Modi. Sie machen aus einer generischen Datenliste ein genau auf den Use Case zugeschnittenes Arbeitswerkzeug.

7.1 Domain: Welche Datensätze zeigt das Action Window an?

Die Domain ist eine Filterbedingung, die bestimmt, welche Datensätze überhaupt geladen werden. Typische Beispiele im E-Commerce sind:

Nur aktive Produkte: Filter auf ein Feld wie active = True.
Produkte ohne Beschreibung: Filter auf ein leeres Feld wie description = False.
Produkte eines bestimmten Kanals oder einer Marke.

Domains lassen sich hart in der Action hinterlegen oder dynamisch aus dem Kontext ableiten. So kannst du zum Beispiel je Benutzergruppe andere Produktlisten als Startpunkt anbieten.

7.2 Kontext: Voreinstellungen, Standardwerte und UI-Verhalten

Der Kontext enthält zusätzliche Parameter, die das Verhalten der Ansicht beeinflussen. Häufige Einsatzfelder sind:

Voreingestellte Suchfilter oder Gruppierungen.
Standardwerte beim Erstellen neuer Datensätze.
Steuerung von Buttons oder Feldern (z. B. bestimmte Funktionen verstecken oder aktivieren).

Ein praxisnahes Beispiel aus dem E-Commerce ist eine Action, die neue Produkte standardmäßig einer bestimmten Kategorie oder Website zuordnet, weil sie aus einem speziellen Import-Feed stammen.

7.3 View-Modi: List, Form, Kanban, Pivot, Graph

Mit dem Feld view_mode definierst du, in welchen Darstellungsformen das Modell geladen wird und in welcher Reihenfolge Odoo diese anbietet. Typische Kombinationen sind:

tree,form – klassische Listen- und Formularansicht.
kanban,form – für visuelle Workflows (z. B. Produktkanban mit Statusspalten).
tree,form,pivot,graph – für analytische Auswertungen mit Drilldown.

Für E-Commerce-Teams ist es oft sinnvoll, separate Action Windows für operative Arbeit (Listenansicht mit Inline-Bearbeitung) und Reporting (Pivot/Graph) anzulegen.

8. Praxisbeispiele: Action Window für Produktcontent-Workflows

Wenn du im E-Commerce große Sortimente pflegst, kannst du mit Action Windows gezielt Content-Engpässe sichtbar machen und Arbeitslisten bereitstellen. Typische Beispiele:

8.1 Produkte ohne Beschreibungen schnell finden

Ein Action Window für das Modell product.template könnte eine Domain enthalten, die nur Produkte ohne Langtext anzeigt. Zusätzlich lässt sich im Kontext festlegen, dass direkt eine bestimmte Formularansicht mit Content-Tab geöffnet wird. So entsteht eine fokussierte Arbeitsliste für das Content-Team.

8.2 Views für Feed-basierte Content-Automatisierung

Wenn du Tools wie feed2content.ai ® einsetzt, um Produkttexte aus Feeds automatisiert zu erzeugen, ist eine saubere Datenbasis entscheidend. Ein Action Window kann zum Beispiel:

nur Produkte anzeigen, bei denen Pflichtattribute für die Textgenerierung fehlen,
eine Kanbanansicht nach Content-Status (offen, in Arbeit, fertig) bereitstellen,
oder eine spezielle Liste für neu importierte Produkte öffnen, die noch geprüft werden müssen.

Auf diese Weise verknüpfst du technische Datenmodelle, Content-Automatisierung und operative Workflows klar und effizient.

8.3 Separate Aktionen für Marktplatz- und Shop-Inhalte

In Multi-Channel-Setups ist es üblich, je Kanal eigene Content- oder Datenanforderungen zu haben. Mit unterschiedlichen Action Windows kannst du:

eine Aktion für Produkte im eigenen Shop mit vollständigem Content,
und eine andere für Marktplatz-Produkte mit spezifischen Attributen und Richtlinien definieren.

So behalten Teams die Übersicht und sehen immer nur den Teil des Produktkatalogs, der für ihren Aufgabenbereich relevant ist.

9. Abgrenzung: Action Window vs. andere Odoo-Aktionen

Um den Begriff Action Window (ir.actions.act_window) richtig einzuordnen, hilft der Vergleich mit anderen Aktionstypen:

Aktionstyp	Kurzbeschreibung
ir.actions.act_window	Öffnet ein Datenfenster (Views) für ein Modell, inkl. Filter und Kontext; Standard für Backend-Navigation.
ir.actions.report	Erzeugt einen Report (z. B. PDF-Angebot, Rechnung) zu einem oder mehreren Datensätzen.
ir.actions.server	Führt serverseitige Aktionen oder Python-Code aus, oft ausgelöst durch Buttons oder Automatisierungen.
ir.actions.client	Steuert Client-Widgets oder spezielle UI-Komponenten (Dashboards, Wizards).

Das Action Window ist damit eindeutig der Aktionstyp, der sich auf das Öffnen und Anzeigen von Datensätzen fokussiert, nicht auf Berichte oder Codeausführung.

10. Best Practices für Action Windows im E-Commerce

Damit Action Windows nicht nur technisch korrekt, sondern auch effizient im Alltag funktionieren, haben sich einige Best Practices bewährt.

10.1 Klare Trennung nach Use Cases

Separate Aktionen für Produktpflege, Preisverwaltung und Content-Workflows.
Spezielle Actions für Monitoring-Listen, z. B. fehlerhafte Importe oder unvollständige Datensätze.
Eigene Views für Management-KPIs (Pivot/Graph) statt alles über dieselbe Aktion zu lösen.

10.2 Sinnvolle Standardfilter und Domains

Nur relevante Datensätze als Standard anzeigen (z. B. aktive Produkte, offene Bestellungen).
Fehler- oder Sonderfälle in eigenen Aktionen bündeln, damit sie nicht im Tagesgeschäft stören.
Domains so gestalten, dass sie auch bei großem Datenvolumen performant bleiben.

10.3 Konsistente Benennung und Struktur

Aktionen und Menüs so benennen, dass die Zielgruppe (Content, Einkauf, IT) den Zweck sofort erkennt.
Struktur der Action Windows an der Organisationsstruktur orientieren (z. B. je Markenverantwortlichem oder Kanal).
Bei Partnern und Agenturen dieselben Action-Konzepte nutzen, um Schulungsaufwände zu senken.

11. Häufige Fehler und Stolpersteine bei Action Windows

Auch wenn ein Action Window technisch schnell angelegt ist, können kleine Fehler zu schlechter Usability oder Performance-Problemen führen.

Zu breite Domains: Aktionen ohne sinnvolle Filter, die riesige Datenmengen laden, verlangsamen das System.
Unklare View-Konfiguration: Nicht passende oder fehlende Views führen zu verwirrenden oder unvollständigen Masken.
Fehlender Kontext: Ohne sinnvolle Standardwerte oder Suchfilter müssen Nutzer jedes Mal manuell konfigurieren.
Duplikate: Mehrere fast identische Aktionen sorgen für Verwirrung und erschweren Wartung und Schulung.

Gerade in komplexen E-Commerce-Landschaften lohnt es sich, Action Windows als eigenes kleines UX-Projekt zu betrachten und sie gezielt zu planen, statt sie nur technisch „irgendwie“ anzulegen.

12. Rolle von Action Window (ir.actions.act_window) in integrierten Systemlandschaften

Viele mittelgroße und große Onlineshops verbinden Odoo mit Shop-Systemen wie Shopware, Magento oder Shopify Plus sowie mit PIM- und ERP-Lösungen. In solchen Szenarien kann ein gut konfiguriertes Action Window helfen, Datenflüsse transparent zu machen.

Monitoring-Views: Aktionen, die nur fehlerhafte oder unvollständige Synchronisierungen anzeigen.
Staging-Listen: Action Windows für Datensätze im Zwischenstatus, bevor sie in den Live-Shop exportiert werden.
Qualitätskontrolle: Spezielle Aktionen, die Produkte mit fehlenden Pflichtattributen, Bildern oder Texten herausfiltern.

Für Teams, die Content-Automatisierung und Feed-basierte Prozesse nutzen, sind solche Actions ein zentrales Werkzeug, um bei tausenden SKUs den Überblick zu behalten und gezielt nachzusteuern.

13. Häufige Fragen zu Action Window (ir.actions.act_window)

Was ist ein Action Window (ir.actions.act_window) in Odoo?

Ein Action Window, technisch als ir.actions.act_window gespeichert, ist eine Aktion in Odoo, die beim Aufruf ein Fenster mit Datensätzen eines bestimmten Modells öffnet. Es definiert, welche Daten geladen werden, in welchen Ansichten sie erscheinen und mit welchen Filtern, Sortierungen und Kontextparametern gearbeitet wird.

Wofür wird ein Action Window im E-Commerce konkret genutzt?

Im E-Commerce werden Action Windows eingesetzt, um produktbezogene Arbeitslisten, Bestellübersichten, Preislisten oder Content-Workflows bereitzustellen. So kannst du zum Beispiel eigene Fenster für Produkte ohne Texte, für kanalbezogene Sortimente oder für offene Bestellungen konfigurieren und deinen Teams gezielte Sichten geben.

Wie hängt ein Action Window mit Menüs in Odoo zusammen?

Jeder Menüeintrag im Backend ist in der Regel mit einer Aktion verknüpft, meist einem Action Window. Klickst du auf ein Menü, ruft Odoo die verknüpfte ir.actions.act_window Aktion auf, lädt das definierte Modell, wendet Domain und Kontext an und zeigt dir die festgelegten Views wie Liste, Formular oder Kanban.

Welche Felder sind bei einem Action Window besonders wichtig?

Die wichtigsten Felder eines Action Windows sind name für die Bezeichnung, res_model für das Zielmodell, view_mode für die Reihenfolge der Ansichten, domain für die Standardfilterung, context für Voreinstellungen und target für das Öffnungsverhalten. Über diese Felder steuerst du, was der Nutzer sieht und wie er mit den Daten arbeitet.

Wie konfiguriere ich ein neues Action Window in Odoo?

Im Entwicklermodus findest du unter den technischen Einstellungen den Bereich für Fensteraktionen. Dort legst du ein neues Action Window an, wählst das Zielmodell, definierst view_mode, Domain und Kontext und verknüpfst die Aktion bei Bedarf mit einem neuen Menüeintrag. Alternativ kannst du die Aktion auch in einem Modul per XML oder programmgesteuert in Python anlegen.

Was ist der Unterschied zwischen ir.actions.act_window und anderen Odoo Aktionen?

Ein ir.actions.act_window öffnet ein Datenfenster mit bestimmten Views für ein Modell. Andere Aktionen haben andere Zwecke, zum Beispiel erzeugt ir.actions.report Reports wie PDF, ir.actions.server führt serverseitige Logik aus und ir.actions.client steuert spezielle UI Widgets. Das Action Window ist also der Standard für die Anzeige und Bearbeitung von Datensätzen.

Wie helfen Action Windows bei der Skalierung von Produktcontent?

Mit Action Windows kannst du gezielte Arbeitslisten für Content-Teams erstellen, etwa Produkte ohne Beschreibung, Produkte mit veralteten Texten oder artikelgruppenbezogene Listen. In Verbindung mit Feed-basierten Textgenerierungs-Tools lassen sich so fehlende oder zu aktualisierende Inhalte schnell identifizieren, priorisieren und im Bulk bearbeiten, was bei großen Sortimentsgrößen entscheidend für Effizienz und Content-Qualität ist.

14. Nächste Schritte: Du möchtest feed2content.ai ® kennenlernen?

Wenn du deine Produktdaten bereits strukturiert in Feeds, PIM oder ERP führst, kannst du darauf aufbauend Produkttexte automatisiert generieren und über passende Action Windows in deinen E-Commerce-Workflows sichtbar machen. So verbindest du Datenqualität, Content-Produktion und operative Prozesse zu einem skalierbaren Setup.

Sieh dir unsere Funktionen live an und teste feed2content.ai ® kostenfrei.

Kostenlos starten

Du hast noch Fragen?

Kontakt