2. Odoo saas-19.2
3. ai
4. Finnish

Opens a graph/chart view using search view elements.
Best for: Trends, comparisons, distributions, visual KPIs.

Supported chart types:
- 'bar': Compare values across categories
- 'line': Show trends over time
- 'pie': Display proportions of a whole

Features:
- Apply filters from menu's available options
- Visualize a single measure
- Group by one field for the chart axis
- Search within specific fields
- Stacking and cumulation options
- Order control (ASC/DESC)

💡 Call compute_report_measures() first to find valid measures
⚠️ Each search object must specify 'search_field' and 'value' properties
⚠️ Mode must be exactly 'bar', 'line', or 'pie'
⚠️ Order must be exactly 'ASC' or 'DESC'

Avaa kaavio-/taulukkonäkymän käyttämällä hakunäkymän elementtejä.
Sopii parhaiten: Trendeille, vertailuille, jakaumille, visuaalisille suorituskykymittareille.

Tuetut kaaviotyypit:
- 'pylväs': Vertaa arvoja eri kategorioiden välillä
- 'viiva': Näytä trendit ajan kuluessa
- 'ympyrä': Näytä osuudet kokonaisuudesta

Ominaisuudet:
- Sovella suodattimia valikon käytettävissä olevista vaihtoehdoista
- Visualisoi yksittäisiä mittareita
- Ryhmittele kaavion akseli yhden kentän perusteella
- Hae tiettyjen kenttien joukosta
- Pinonta- ja kertymisvaihtoehdot
- Järjestyksen hallinta (ASC/DESC)

💡 Kutsu ensin compute_report_measures() löytääksesi kelvolliset mitat
⚠️ Jokaisen hakukohteen on tarkennettava 'search_field' ja 'value' ominaisuudet
⚠️ Tilaksi on asetettava tarkalleen 'bar', 'line' tai 'pie'
⚠️ Järjestyksen on oltava tarkalleen 'ASC' tai 'DESC'

Computes exact date/datetime values for relative date expressions. Can traverse years, quarters, months, weeks, and days, and anchor to specific weekdays or times.

**Returns**:
- Date fields: 'YYYY-MM-DD' (in user timezone)
- Datetime fields: 'YYYY-MM-DD HH:MM:SS' (in UTC)

**Core Concepts**:

1. **Operations**: Sequential transformations applied to current time
- navigate: Move through time periods
* Required: type="navigate", period (minute/hour/day/week/month/quarter/year), offset (negative=past, positive=future)
* Optional: boundary ('start' or 'end' of period)
- find_previous: Search backward for specific weekday
* Required: type="find_previous", weekday (0-6)
* Note: boundary not supported - use pin for time adjustment
- find_next: Search forward for specific weekday
* Required: type="find_next", weekday (0-6)
* Note: boundary not supported - use pin for time adjustment

2. **Pin**: Final anchoring to specific position (applied after all operations)
- day: Lock to specific day (integer 1-31) or weekday occurrence (object with weekday 0-6, occurrence 1-5)
- time: Set specific time ('HH:MM' or 'HH:MM:SS')

**Examples**:

# "Yesterday at midnight"
{"operations": [{"type": "navigate", "period": "day", "offset": -1, "boundary": "start"}]}

# "Next Friday at 5 PM"
{"operations": [{"type": "find_next", "weekday": 4}], "pin": {"time": "17:00"}}

# "Start of last week"
{"operations": [{"type": "navigate", "period": "week", "offset": -1, "boundary": "start"}]}

# "First Monday of last month"
{"operations": [{"type": "navigate", "period": "month", "offset": -1, "boundary": "start"}], "pin": {"day": {"weekday": 0, "occurrence": 1}}}

# "3rd week of 2 quarters ago"
{"operations": [{"type": "navigate", "period": "quarter", "offset": -2, "boundary": "start"}, {"type": "navigate", "period": "week", "offset": 2, "boundary": "start"}]}

# "Last Monday at 5 PM"
{"operations": [{"type": "find_previous", "weekday": 0}], "pin": {"time": "17:00"}}

# "5 days into last month"
{"operations": [{"type": "navigate", "period": "month", "offset": -1, "boundary": "start"}, {"type": "navigate", "period": "day", "offset": 5}]}

# "2nd week of 3 years ago"
{"operations": [{"type": "navigate", "period": "year", "offset": -3, "boundary": "start"}, {"type": "navigate", "period": "week", "offset": 1, "boundary": "start"}]}

# "10 days before end of last quarter"
{"operations": [{"type": "navigate", "period": "quarter", "offset": -1, "boundary": "end"}, {"type": "navigate", "period": "day", "offset": -10}]}

Note: Weekday values are 0=Monday through 6=Sunday. Weeks start Monday (ISO 8601).

Laskee päivämäärälausekkeille tarkat päivämäärä- ja aika-arvot. Voi kulkea vuosien, vuosineljännesten, kuukausien, viikkojen ja päivien läpi sekä ankkuroitua tiettyihin viikonpäiviin tai aikoihin.

**Palauttaa**:
- Päivämääräkentät: 'VVVV-KK-PP' (käyttäjän aikavyöhykkeellä)
- Aika-kentät: 'VVVV-KK-PP HH:MM:SS' (UTC-aikavyöhykkeellä)

**Ydinkonseptit**:

1. **Operaatiot**: Peräkkäiset muunnokset, joita sovelletaan nykyiseen aikaan
- navigate: Siirry ajanjaksojen läpi
* Pakollinen: type="navigate", ajanjakso (minuutti/tunti/päivä/viikko/kuukausi/neljännesvuosi/vuosi), poikkeama (negatiivinen = menneisyys, positiivinen = tulevaisuus)
* Valinnainen: raja (jakson 'alku' tai 'loppu')
- find_previous: Etsi tiettyä viikonpäivää takautuvasti
* Pakollinen: type="find_previous", viikonpäivä (0-6)
* Huomautus: rajaa ei tueta – käytä kiinnitystä ajan säätämiseen
- find_next: Etsi tiettyä viikonpäivää eteenpäin
* Vaadittu: type="find_next", viikonpäivä (0–6)
* Huomautus: rajaa ei tueta – käytä kiinnitystä ajan säätämiseen

2. **Kiinnitys**: Lopullinen ankkurointi tiettyyn kohtaan (sovelletaan kaikkien toimintojen jälkeen)
- day: Lukitse tiettyyn päivään (kokonaisluku 1–31) tai viikonpäivän esiintymään (objekti, jossa viikonpäivä 0–6, esiintymä 1–5)
- time: Määritä tietty aika ('HH:MM' tai 'HH:MM:SS')

**Esimerkkejä**:

# "Eilen keskiyöllä"
{"operations": [{"type": "navigate", "period": "day", "offset": -1, "boundary": "start"}]}

# "Ensi perjantaina klo 17"
{"operations": [{"type": "find_next", "weekday": 4}], "pin": {"time": "17:00"}}

# "Viime viikon alussa"
{"operations": [{"type": "navigate", "period": "week", "offset": -1, "boundary": "start"}]}

# "Viime kuun ensimmäisenä maanantaina"
{"operations": [{"type": "navigate", "period": "month", "offset": -1, "boundary": "start"}], "pin": {"day": {"weekday": 0, "occurrence": 1}}}

# "Kolmas viikko kaksi vuosineljännestä sitten"
{"operations": [{"type": "navigate", "period": "quarter", "offset": -2, "boundary": "start"}, {"type": "navigate", "period": "week", "offset": 2, "boundary": "start"}]}

# "Viime maanantaina klo 17.00"
{"operations": [{"type": "find_previous", "weekday": 0}], "pin": {"time": "17:00"}}

# "Viime kuun 5. päivä"
{"operations": [{"type": "navigate", "period": "month", "offset": -1, "boundary": "start"}, {"type": "navigate", "period": "day", "offset": 5}]}

# "Toinen viikko 3 vuotta sitten'"
{"operations": [{"type": "navigate", "period": "year", "offset": -3, "boundary": "start"}, {"type": "navigate", "period": "week", "offset": 1, "boundary": "start"}]}

# "10 päivää ennen viime vuosineljänneksen loppua"
{"operations": [{"type": "navigate", "period": "quarter", "offset": -1, "boundary": "end"}, {"type": "navigate", "period": "day", "offset": -10}]}

Huomautus: Viikonpäivien arvot ovat 0 = maanantai – 6 = sunnuntai. Viikot alkavat maanantaista (ISO 8601).

Retrieves detailed information (context, domain, search_view) for specific menus.
MUST be called before using any open_menu_* tool to get menu-specific details.

Returns JSON object with array of menus:
```
{
"menus": [
{
"menu_id": 389,
"action_id": 1053,
"model": "sale.order",
"context": {"search_default_my_quotation": 1},
"domain": [],
"search_view": "Searchable fields:\n - partner_id, Customer\n\nFilters:\n [Group 1]\n - my_quotation, My Quotations, domain=..."
},
{
"menu_id": 172,
"action_id": 986,
"model": "account.move",
"context": {"search_default_draft": 1},
"domain": [["type", "=", "out_invoice"]],
"search_view": "Searchable fields:\n - partner_id, Customer\n\nFilters:..."
}
]
}
```

Key information for each menu:
- menu_id: The menu identifier (useful for opening menus)
- action_id: The action identifier (useful for compute_report_measures tool)
- model: The Odoo model name (e.g., "sale.order")
- context: Default filters/groupings applied when menu opens (dict)
- domain: Permanent filters that cannot be removed by users (list)
- search_view: Multi-line structured text with sections:
* "Searchable fields:" - Fields that can be used in search parameter
* "Filters:" - Available filter names organized in groups
- Regular filters: name, label, domain="..."
- Date filters: [DATE FILTER] field_name, label, year_range=[...], month_range=[...], options=[...]
* "Groupbys:" - Regular field grouping options (format: field_name, label)
* "Date groupbys:" - Date field grouping options with default intervals (format: field_name, label, default_interval=...)

💡 Performance tip: Request multiple menu details in one call when comparing options
⚠️ Always validate the returned model matches your expectations

Hakee yksityiskohtaisia tietoja (konteksti, domain, search_view) tietyistä valikoista.
TÄYTYY kutsua ennen yhdenkään open_menu_* -työkalun käyttöä valikkokohtaisten tietojen saamiseksi.

Palauttaa JSON-objektin valikkotaulukolla:
```
{
"menus": [
{
"menu_id": 389,
"action_id": 1053,
"model": "sale.order",
"context": {"search_default_my_quotation": 1},
"domain": [],
"search_view": "Searchable fields:\n - partner_id, Customer\n\nFilters:\n [Group 1]\n - my_quotation, My Quotations, domain=..."
},
{
"menu_id": 172,
"action_id": 986,
"model": "account.move",
"context": {"search_default_draft": 1},
"domain": [["type", "=", "out_invoice"]],
"search_view": "Searchable fields:\n - partner_id, Customer\n\nFilters:..."
}
]
}
```

Kunkin valikon avaintiedot:
- menu_id: Valikon tunniste (hyödyllinen valikoita avatessa)
- action_id: Toiminnon tunniste (hyödyllinen compute_report_measures -työkalulle)
- model: Odoo-mallin nimi (esim. "sale.order")
- context: Oletussuodattimet/ryhmittelyt, joita sovelletaan valikon avautuessa (dict)
- domain: Pysyvät suodattimet, joita käyttäjät eivät voi poistaa (list)
- search_view: Monirivinen jäsennelty teksti seuraavilla osioilla:
* "Haettavat kentät:" - Kentät, joita voi käyttää hakuparametreissä
* "Suodattimet:" - Käytettävissä olevien suodattimien nimet ryhmiteltynä
- Tavalliset suodattimet: nimi, nimike, domain="..."
- Päivämääräsuodattimet: [DATE FILTER] field_name, label, year_range=[...], month_range=[...], options=[...]
* "Ryhmittelyt:" - Tavalliset kenttien ryhmittelyvaihtoehdot (muoto: field_name, nimike)
* "Päivämääräryhmittelyt:" - Päivämääräkenttien ryhmittelyvaihtoehdot oletusvälein (muoto: field_name, nimike, default_interval=...)

💡 Suorituskykyvinkki: Pyydä useita valikkotietoja yhdellä komennolla vaihtoehtoja vertaillessasi
⚠️ Varmista aina, että palautettu malli vastaa odotuksiasi

Config Settings

KokoonpanoaAsetukset

Type of server action. The following values are available:
- 'Update a Record': update the values of a record
- 'Create Activity': create an activity (Discuss)
- 'Send Email': post a message, a note or send an email (Discuss)
- 'Send SMS': send SMS, log them on documents (SMS)- 'Add/Remove Followers': add or remove followers to a record (Discuss)
- 'Create Record': create a new record with new values
- 'Execute Code': a block of Python code that will be executed
- 'Send Webhook Notification': send a POST request to an external system, also known as a Webhook
- 'Multi Actions': define an action that triggers several other server actions

Palvelintoiminnon tyyppi. Saatavilla seuraavat arvot:
- 'Päivitä kirjaustietue': päivitä kirjaukstietueen arvot
- 'Luo toimintaenpide': luo toiminnaenpiteen (Viestintä)
- 'Lähetä sähköposti': lähettää viestin, huomautuksens tai sähköpostin (Viestintä)
- 'Lähetä tekstiviesti': lähetä tekstiviestejä, kirjaa ne asiakirjoihin (Tekstiviesti)
- 'Lisää/pPoista seuraajia': lisää tai poista tietueen seuraajia kirjaukseen (Viestintä)
- 'Luo kirjaustietue': luo uusi kirjaustietue uusilla arvoilla
- 'Suorita koodi': Python-koodin pätkä, joka suoritetaan
- 'Lähetä Webhook-ilmoitus': lähetä POST-pyyntö ulkoiseen järjestelmään, joka tunnetaan myös nimellä Webhook
- 'Suorita useita Monitoimintojanot': Määritä toiminto, joka käynnistää useita muita palvelintoimintoja

Type of server action. The following values are available:
- 'Update a Record': update the values of a record
- 'Create Activity': create an activity (Discuss)
- 'Send Email': post a message, a note or send an email (Discuss)
- 'Send SMS': send SMS, log them on documents (SMS)- 'Add/Remove Followers': add or remove followers to a record (Discuss)
- 'Create Record': create a new record with new values
- 'Execute Code': a block of Python code that will be executed
- 'Send Webhook Notification': send a POST request to an external system, also known as a Webhook
- 'Multi Actions': define an action that triggers several other server actions

Palvelintoiminnon tyyppi. Saatavilla seuraavat arvot:
- 'Päivitä tietuekirjaus': päivitä tietuekirjauksen arvot
- 'Luo toimenpideinta': luo toimenpiteeinnan (Viestintä)
- 'Lähetä sähköposti': lähettää viestin, huomautusksen tai sähköpostin (Viestintä)
- 'Lähetä tekstiviesti': lähetä tekstiviestejä, kirjaa ne asiakirjoihin (Tekstiviesti)
- 'Lisää/Ppoista seuraajia': lisää tai poista tietueen seuraajia kirjaukseen (Viestintä)
- 'Luo tietuekirjaus': luo uusi tietuekirjaus uusilla arvoilla
- 'Suorita koodi': Python-koodin pätkä, joka suoritetaan
- 'Lähetä Webhook-ilmoitus': lähetä POST-pyyntö ulkoiseen järjestelmään, joka tunnetaan myös nimellä Webhook
- 'MoniSuorita useita toiminnottoja': Määritä toiminto, joka käynnistää useita muita palvelintoimintoja