Tworzenie Własnego Modułu w Odoo ERP System: Przewodnik dla Początkujących

Jak Napisać Własny Moduł w Odoo: Przewodnik dla Początkujących

Modularna architektura Odoo pozwala programistom na rozszerzanie i dostosowywanie systemu poprzez tworzenie własnych modułów. Ten przewodnik przeprowadzi Cię przez proces budowy prostego modułu, od przygotowania struktury po instalację w Twojej instancji Odoo.

Krok 1: Zrozumienie Struktury Modułu

Moduł w Odoo to katalog zawierający określone pliki i podkatalogi. Podstawowa struktura obejmuje:

my_module/
├── __init__.py
├── __manifest__.py
├── models/
│   ├── __init__.py
│   └── my_model.py
├── views/
│   └── my_view.xml
└── security/
    ├── ir.model.access.csv

Każdy element pełni określoną rolę:

• __init__.py: Inicjalizuje pakiet Python.
• __manifest__.py: Zawiera metadane modułu, takie jak nazwa, wersja i zależności.
• models/: Zawiera pliki Python definiujące modele.
• views/: Przechowuje pliki XML definiujące elementy interfejsu użytkownika.
• security/: Zarządza kontrolą dostępu i uprawnieniami.

Krok 2: Utwórz Plik Manifestu

Plik __manifest__.py jest kluczowy dla zdefiniowania modułu. Przykład:

 {
    'name': 'Mój Pierwszy Moduł',
    'version': '1.0',
    'author': 'Twoje Imię',
    'category': 'Custom',
    'depends': ['base'],
    'data': [
        'security/ir.model.access.csv',
        'views/my_view.xml',
    ],
    'installable': True,
    'application': True,
}

Krok 3: Zdefiniuj Model

Utwórz nowy plik Python w katalogu models/, np. my_model.py, i zdefiniuj swój model:

from odoo import models, fields

class MyModel(models.Model):
    _name = 'my.model'
    _description = 'Mój Pierwszy Model'

    name = fields.Char(string='Nazwa', required=True)
    description = fields.Text(string='Opis')

Krok 4: Zaprojektuj Widok

Utwórz plik XML w katalogu views/, np. my_view.xml, i zdefiniuj interfejs użytkownika:

<odoo>
    <record id="view_form_my_model" model="ir.ui.view">
        <field name="name">my.model.form</field>
        <field name="model">my.model</field>
        <field name="arch" type="xml">
            <form string="Mój Model">
                <sheet>
                    <field name="name"/>
                    <field name="description"/>
                </sheet>
            </form>
        </field>
    </record>
</odoo>

Krok 5: Skonfiguruj Uprawnienia

Dodaj plik CSV do katalogu security/, aby zdefiniować prawa dostępu. Na przykład, ir.model.access.csv:

id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_my_model,access_my_model,model_my_model,base.group_user,1,1,1,1

Krok 6: Zainstaluj Moduł

Skopiuj katalog modułu do ścieżki dodatków Odoo, uruchom ponownie usługę Odoo i włącz tryb deweloperski. Przejdź do Aplikacje, wyszukaj swój moduł i kliknij Zainstaluj.

Najlepsze Praktyki

• Stosuj konwencje nazewnictwa plików i klas Odoo.
• Utrzymuj kod modułu w dobrej organizacji dla łatwiejszej konserwacji.
• Testuj moduł dokładnie przed wdrożeniem na produkcję.

Podsumowanie

Tworzenie niestandardowego modułu w Odoo to prosty proces, jeśli postępujesz zgodnie z właściwymi krokami i najlepszymi praktykami. Zrozumienie struktury i celu każdego elementu pozwoli Ci dostosować Odoo do unikalnych wymagań Twojego biznesu.

Napisałeś już swój pierwszy moduł w Odoo? Podziel się swoimi doświadczeniami w komentarzach poniżej!