Come creare un nuovo modello di modulo ONLYOFFICE per Odoo: una guida dettagliata

L’app ONLYOFFICE Templates recentemente rilasciata permette di automatizzare il processo di creazione di moduli utilizzando i dati e i campi disponibili in Odoo. Sebbene ci siano modelli pronti all’uso come fatture e bolle di vendita, crearne di nuovi da zero potrebbe essere una sfida, specialmente per i nuovi utenti. In questa guida passo-passo, imparerai a creare nuovi modelli ONLYOFFICE per vari moduli di Odoo.

Cosa ti serve per iniziare

Per iniziare con la creazione di moduli, devi avere un’istanza Odoo in esecuzione, un’istanza ONLYOFFICE Docs e l’app ONLYOFFICE Templates installata. Questo articolo ti fornisce una panoramica dettagliata di questa integrazione e spiega come funziona.

Se hai integrato ONLYOFFICE Templates con la tua piattaforma Odoo, puoi creare nuovi modelli di moduli, modificare quelli esistenti e stampare moduli già compilati basati sui dati e campi disponibili in Odoo.

Scopriamo come puoi creare un nuovo modello di modulo per una delle sezioni di Odoo, ad esempio un modello di preavviso di due settimane per il dipartimento delle risorse umane per facilitare le dimissioni dei dipendenti.

Step 1. Passa alla modalità sviluppatore

Per creare nuovi modelli di moduli, è consigliato abilitare la modalità sviluppatore in Odoo. Per farlo, clicca sull’icona Impostazioni nel menù Home, trova la sezione Strumenti per sviluppatori nelle Impostazioni generali e clicca sul pulsante Attiva la modalità sviluppatore. Sarai automaticamente reindirizzato al menù Home dopo che la modalità sviluppatore sarà attivata.

Step 2. Crea un nuovo modello ONLYOFFICE

Il passo successivo implica la creazione di un nuovo modello ONLYOFFICE nella sezione Modelli. Avvia l’app ONLYOFFICE Templates dal menù Home e clicca sul pulsante Nuovo nell’angolo in alto a sinistra del modulo.

L’app ti permette di creare nuovi modelli da zero cliccando sul pulsante Nuovo. In alternativa, puoi caricare un file dal tuo disco locale utilizzando il pulsante Carica il tuo file. Il nuovo modello di modulo creato apparirà nella sezione.

Quando crei un nuovo modello, è estremamente importante selezionare il modello Odoo richiesto. La tua scelta dipende da cosa intendi creare. Se scegli il modello sbagliato, il tuo modello non funzionerà come previsto.

Per determinare il nome del modello che devi selezionare, puoi dare un’occhiata all’indirizzo URL del record corrispondente in Odoo. Per fare ciò, vai al modulo Odoo richiesto, apri un qualsiasi record che abbia il pulsante Stampa con ONLYOFFICE e guarda l’indirizzo URL per trovare l’indicazione.

Nel nostro caso, vogliamo creare un modello di preavviso di due settimane. Per questo motivo andiamo al modulo Dipendenti, selezioniamo uno dei record disponibili e guardiamo il suo indirizzo URL. Il valore richiesto è hr.employee.

Ora copia questo valore e torna alla finestra di creazione del modello. Inserisci il valore copiato nel campo Seleziona Modello e clicca su Invio. Il valore hr.employee corrisponde al modello Dipendente, quindi questo modello sarà scelto automaticamente per il nostro nuovo modello. Non dimenticare di inserire il nome del modello e di creare un nuovo modello da zero o caricare un nuovo file dal tuo dispositivo utilizzando una delle opzioni disponibili. Il tuo modello apparirà nella sezione Modelli.

Step 3. Modifica il tuo nuovo modello ONLYOFFICE

Ora che il tuo modello è stato creato, aprilo dalla sezione Modelli e modifica il suo contenuto utilizzando la funzionalità dell’editor ONLYOFFICE. Puoi inserire testo, aggiungere intestazioni e piè di pagina, inserire oggetti e utilizzare vari strumenti di formattazione.

Quando la versione finale del tuo modello PDF è pronta, puoi procedere con il passo successivo e inserire campi compilabili basati sui dati di Odoo.

Step 4. Inserisci campi compilabili con l’app ONLYOFFICE Templates

Ora devi inserire campi compilabili nel tuo modello affinché l’app ONLYOFFICE possa utilizzare i dati di Odoo quando stampi il modello. Questo processo potrebbe sembrare complicato a prima vista, ma non preoccuparti. Quando capirai il principio principale, sarà un gioco da ragazzi.

Con l’app ONLYOFFICE, puoi aggiungere automaticamente i campi richiesti basati su determinati parametri di Odoo. Poiché la modalità sviluppatore è attivata, tutti i campi in ogni modulo di Odoo avranno un punto interrogativo per aiutarti a trovare i parametri richiesti. In particolare, hai bisogno delle informazioni dai parametri Campo e Modello.

Nel nostro modello, ci saranno informazioni su uno dei nostri dipendenti. Per questo motivo devi andare alla sezione Dipendenti e aprire uno dei record. Il primo campo nel tuo modello può essere Manager, che mostrerà il nome del responsabile del dipendente nel tuo preavviso di due settimane. Quindi punta il cursore del mouse sul punto interrogativo accanto a Manager e vedrai alcuni parametri.

Quelli di cui hai bisogno sono:

• Campo: parent_id
• Modello: hr.employee

Devi conoscere questi parametri per inserire il campo corretto nel tuo modello. Torna al tuo modello e clicca dove vuoi aggiungere il primo campo. Nel pannello laterale sinistro, inserisci parent_id e trovalo nella lista. Appartiene alla sezione Dipendente che ha molti campi disponibili.

Ora trova Manager nella sezione Dipendente. Questo è il campo richiesto. Quando ci clicchi sopra, il campo verrà automaticamente aggiunto al tuo modello con una certa chiave di Odoo.

Congratulazioni! Ora hai appena inserito il tuo primo campo. Usando lo stesso algoritmo, aggiungi tutti i campi di cui hai bisogno.

Ora puoi completarlo con i dati di Odoo quando scegli questo modello dopo aver cliccato sul pulsante Stampa con ONLYOFFICE nel menù Azioni.

Consigli su come trovare campi Odoo nell’app ONLYOFFICE

Trovare i campi di Odoo desiderati sarà più facile se prendi in considerazione i seguenti suggerimenti:

Consiglio 1. Quando stai per aggiungere un campo di Odoo nell’editor ONLYOFFICE, devi prima conoscere il suo tipo. Puoi vedere il tipo sotto il parametro Modello in modalità sviluppatore.

Consiglio 2. Se il tipo di un campo è one2many / many2many / many2many / many2one, significa che il valore in questo campo è un’entità separata con i propri campi. Un campo del genere sarà visualizzato come una sezione separata sul pannello laterale sinistro dell’editor ONLYOFFICE. Quando apri questa sezione, tutti i campi correlati di questa entità saranno visualizzati.

Ad esempio, immagina che tu debba aggiungere l’indirizzo di un dipendente nel tuo modello. Utilizzando la modalità sviluppatore, scoprirai che il nome di questo campo è address_id e il suo tipo è many2one. Questa è un’entità separata con le proprie proprietà (campi), che puoi anche visualizzare e trovare nell’editor ONLYOFFICE.

Per accedere a tutti i campi correlati nella sezione Odoo, clicca il pulsante Internal link (freccia).

In questo record Indirizzi, puoi visualizzare i campi dell’entità Indirizzo e poi trovarli nell’editor ONLYOFFICE utilizzando i loro nomi. Ad esempio, troviamo e inseriamo il campo Codice Fiscale. Il suo nome è vat e appartiene alla sezione address_id. Sul pannello laterale sinistro dell’editor ONLYOFFICE, trova la sezione address_id, apri questa sezione e trova il campo chiamato vat.

Utilizzando lo stesso algoritmo, puoi facilmente trovare e aggiungere campi di Odoo con il tipo one2many / many2many / many2many / many2one.

Consiglio 3. Se il valore Modello di un campo specifica un modello non presente nell’indirizzo URL, allora devi cercare una sottosezione. In questo caso, la chiave nella sezione avrà lo stesso nome del modello.

Come creare tabelle in ONLYOFFICE Templates

L’app ONLYOFFICE ha una funzione utile che rende più facile lavorare con le tabelle. Se desideri creare un modello che contenga una tabella (ad esempio, una fattura con un elenco di articoli da vendere), non dovrai inserire campi per tutte le righe. Devi solo creare una tabella nell’editor ONLYOFFICE e inserire i campi che corrispondono ai principali campi di Odoo utilizzando i loro ID, come Descrizione, Quantità, Prezzo Unitario, Tasse, Importo, ecc.

Per scoprire quale campo dovrebbe essere inserito in una determinata colonna della tua tabella, puoi posizionare il cursore del mouse in modalità sviluppatore sull’intestazione della colonna corrispondente nella sezione Odoo e lì vedrai il nome del campo.

Quando stampi il modello, vedrai che ogni articolo ha una riga separata. In questo modo, l’app ONLYOFFICE può aggiungere quanti articoli sono necessari a seconda dei dati disponibili nella sezione Odoo corrispondente.

Ottieni l’app ONLYOFFICE Templates

Ottieni l’app ONLYOFFICE dallo Store di Odoo Apps e migliora i flussi di lavoro elettronici nella tua squadra utilizzando i modelli ONLYOFFICE per diversi moduli di Odoo:

OTTIENI ORA

Nota bene: devi ottenere una licenza speciale di ONLYOFFICE Docs con il supporto dell’app Template di Odoo. Per saperne di più, contatta il nostro team di vendita all’indirizzo sales@onlyoffice.com.