Como criar um novo modelo de formulário ONLYOFFICE para Odoo: um guia detalhado

O recém-lançado ONLYOFFICE Templates aplicativo permite que você automatize o processo de criação de formulários usando dados e campos disponíveis no Odoo. Embora existam modelos prontos para uso, como faturas e notas fiscais, criar novos do zero pode ser desafiador, especialmente para novos usuários. Neste guia passo a passo, você aprenderá a criar novos modelos do ONLYOFFICE para vários módulos do Odoo.

O que você precisa para começar

Para começar a criar o formulário, você precisa ter uma instância Odoo em execução, um ONLYOFFICE Docs instância e o aplicativo ONLYOFFICE Templates instalado. Este artigo fornece uma visão geral detalhada dessa integração e explica como ela funciona.

Se você tiver o ONLYOFFICE Templates integrado à sua plataforma Odoo, você pode criar novos modelos de formulário, editar os existentes e imprimir modelos de formulário já preenchidos com base nos dados e campos disponíveis no Odoo.

Vamos descobrir como você pode criar um novo modelo de formulário para um dos módulos Odoo. Por exemplo, um modelo de aviso de duas semanas para o departamento de RH para facilitar a demissão dos funcionários.

Etapa 1. Mude para o modo de desenvolvedor

Para criar novos modelos de formulário, é recomendável que o modo de desenvolvedor no Odoo esteja habilitado. Para fazer isso, clique no ícone Configurações no menu Início, encontre a seção Ferramentas do desenvolvedor em Configurações gerais e clique no botão Ativar o modo de desenvolvedor. Você será redirecionado automaticamente para o menu Início depois que o modo de desenvolvedor estiver ativado.

Etapa 2. Crie um novo ONLYOFFICE template

O próximo passo implica na criação de um novo modelo ONLYOFFICE no módulo Templates. Inicie o aplicativo ONLYOFFICE Templates no menu Início e clique no botão Novo no canto superior esquerdo do módulo.

O aplicativo permite que você crie novos modelos do zero se você clicar no botão Novo. Como alternativa, você pode carregar um arquivo do seu drive local usando o botão Carregue seu arquivo. O modelo de formulário recém-criado aparecerá no módulo.

Ao criar um novo modelo, é de vital importância selecionar o modelo Odoo necessário. Sua escolha depende do que você vai criar. Se você escolher o modelo errado, seu modelo não funcionará como esperado.

Para determinar o nome do modelo que você precisa selecionar, você pode dar uma olhada no endereço URL do registro correspondente no Odoo. Para fazer isso, vá para o módulo Odoo necessário, abra qualquer registro que tenha o botão Imprimir com ONLYOFFICE e olhe para o endereço URL para encontrar a dica.

No nosso caso, queremos criar um modelo de aviso de duas semanas. É por isso que vamos para o módulo Funcionários, selecionamos um dos registros disponíveis e olhamos para seu endereço URL. O valor necessário é hr.employee.

Agora copie esse valor e volte para a janela de criação de modelo. Insira o valor copiado no campo Selecione o modelo e clique em Enter. O valor hr.employee corresponde ao modelo Empregado, então esse modelo será escolhido automaticamente para nosso novo modelo. Não se esqueça de inserir o nome do modelo e criar um novo modelo do zero ou carregar um novo arquivo do seu dispositivo usando uma das opções disponíveis. Seu modelo aparecerá no módulo Templates.

Etapa 3. Edite seu novo modelo ONLYOFFICE

Agora que seu modelo foi criado, abra-o no módulo Templates e edite seu conteúdo usando a funcionalidade do editor ONLYOFFICE. Você pode inserir texto, adicionar cabeçalhos e rodapés, inserir objetos e usar várias ferramentas de formatação.

Quando a versão final do seu modelo PDF estiver pronta, você pode prosseguir para a próxima etapa e inserir campos preenchíveis com base nos dados do Odoo.

Etapa 4. Insira campos preenchíveis com o aplicativo ONLYOFFICE Templates

Agora você precisa inserir campos preenchíveis no seu modelo para que o aplicativo ONLYOFFICE possa usar os dados do Odoo quando você imprimir o modelo. Este processo pode parecer complicado à primeira vista, mas não se preocupe. Quando você entender o princípio principal, será moleza.

Com o aplicativo ONLYOFFICE, você pode adicionar automaticamente os campos obrigatórios com base em certos parâmetros do Odoo. Como o modo de desenvolvedor está ativado, todos os campos em cada módulo do Odoo terão um ponto de interrogação para ajudar você a encontrar os parâmetros obrigatórios. Especificamente, você precisa de informações dos parâmetros Campo e Modelo.

Em nosso modelo, haverá informações sobre um de nossos funcionários. É por isso que você precisa ir ao módulo Funcionários e abrir um dos registros. O primeiro campo em seu modelo pode ser Gerente, que mostrará o nome do gerente do funcionário em seu aviso de duas semanas. Então, aponte o cursor do mouse para o ponto de interrogação ao lado de Gerente, e você verá alguns parâmetros.

Os que você precisa são:

• Campo: parent_id
• Modelo: hr.employee

Você precisa saber esses parâmetros para inserir o campo correto no seu modelo. Volte para o seu modelo e clique onde você quer adicionar o primeiro campo. No painel do lado esquerdo, insira parent_id e encontre-o na lista. Pertence à seção Funcionário que possui vários campos disponíveis.

Agora encontre Gerente na seção Funcionário. Este é o campo obrigatório. Quando você clicar nele, o campo será automaticamente adicionado ao seu modelo com uma determinada chave Odoo.

Parabéns! Agora você acabou de inserir seu primeiro campo. Usando o mesmo algoritmo, adicione quantos campos precisar.

Agora você pode concluí-lo com os dados do Odoo ao escolher este modelo após clicar no botão Imprimir com ONLYOFFICE no menu Ação.

Dicas sobre como encontrar campos Odoo no aplicativo ONLYOFFICE

Encontrar os campos desejados do Odoo será mais fácil se você levar em consideração as seguintes dicas:

Dica 1. Quando você for adicionar um campo Odoo no editor ONLYOFFICE, você precisa saber seu tipo primeiro. Você pode ver o tipo no parâmetro Modelo no modo de desenvolvedor.

Dica 2. Se o tipo de um campo one2many / many2many / many2many / many2one, significa que o valor neste campo é uma entidade separada com seus próprios campos. Tal campo será exibido como uma seção separada no painel esquerdo do ONLYOFFICE Editor. Quando você abrir esta seção, todos os campos relacionados desta entidade também serão exibidos.

Por exemplo, imagine que você precisa adicionar o endereço de um funcionário ao seu modelo. Usando o modo de desenvolvedor, você descobrirá que o nome deste campo é address_id e seu tipo é many2one. Esta é uma entidade separada com suas próprias propriedades (campos), que você também pode visualizar e encontrar no editor ONLYOFFICE.

Clique no botão Link interno (seta) para acessar todos os campos relacionados na seção Odoo.

Neste registro de Endereço, você pode visualizar os campos da entidade Endereço e, em seguida, encontrá-los no editor ONLYOFFICE usando seus nomes. Por exemplo, vamos localizar e inserir o campo ID Fiscal. Seu nome é vat e ele pertence à seção address_id. No painel esquerdo do Editor ONLYOFFICE, encontre a seção address_id, abra esta seção e encontre o campo chamado vat.

Usando o mesmo algoritmo, você pode facilmente encontrar e adicionar campos Odoo com o tipo one2many / many2many / many2many /many2one.

Dica 3. Se o valor Model de um campo especificar um modelo que não seja do endereço URL, então você precisa procurar por uma subseção. Neste caso, a chave na seção terá o mesmo nome que o modelo.

Como criar tabelas no ONLYOFFICE Templates

O aplicativo ONLYOFFICE tem um recurso útil que facilita o trabalho com tabelas. Se você quiser criar um modelo que contenha uma tabela (por exemplo, uma fatura com uma lista de itens a serem vendidos), não precisará inserir campos para todas as linhas. Você só precisa criar uma tabela no editor ONLYOFFICE e inserir os campos que correspondem aos principais campos do Odoo usando seus IDs, como Descrição, Quantidade, Preço unitário, Impostos, Valor, etc.

Para descobrir qual campo deve ser inserido em uma determinada coluna da sua tabela, você pode colocar o cursor do mouse no modo de desenvolvedor no cabeçalho da coluna correspondente na seção Odoo e lá você verá o nome do campo.

Ao imprimir o modelo, você verá que cada item tem uma linha separada. Dessa forma, o aplicativo ONLYOFFICE pode adicionar quantos itens forem necessários, dependendo dos dados disponíveis no módulo Odoo correspondente.

Obtenha o app ONLYOFFICE Templates

Obtenha o aplicativo ONLYOFFICE na Odoo Apps Store e melhore os fluxos de trabalho de documentos eletrônicos em sua equipe usando modelos ONLYOFFICE para diferentes módulos Odoo:

OBTENHA AGORA

Nota importante: você precisa obter uma licença especial do ONLYOFFICE Docs com o suporte do aplicativo Odoo Templates. Para saber mais, entre em contato com nossa equipe de vendas em sales@onlyoffice.com.