Campos e widgets

Fields structure the models of a database. If you think of a model as a table or spreadsheet, fields are the columns and records are the individual rows. Fields also define the type of data that is stored within them. The way in which a field’s data is presented and formatted on the UI is controlled by its widget.

With Studio, it is possible to:

• add new fields to your database. From a technical point of view, there are 15 field types in Odoo. However, you can choose from 21 field types in Studio, as some field types are available more than once with a different default widget;

• add existing fields, i.e., fields that already exists on a model, to any view of that model;

• modify a field’s properties; or

• remove a field from a view.

Studio fields vs. property fields

Fields created using Studio are saved as columns in your Odoo database. Property fields, on the other hand, act as pseudo-fields; they are shared by all records that are linked to the same parent record (e.g., for tasks, the project, or for a product, the product category), but they are not saved as columns in your database.

Example

Adding a Deadline field to the form view of a task using Studio makes that field visible in every task in your database. Adding a Special instructions property field to a task makes the field visible in all tasks within the same project (i.e., its parent) while other projects’ tasks remain unaffected.

Field types

Fields can be broadly divided into two categories:

• Simple fields, which contain basic values, such as text, numbers, files, etc.

• Relational fields, which are used to link and display the data from records on another model.

AI fields

AI fields are essentially standard Odoo fields with added AI capabilities that allow their values to be generated automatically through prompts.

Campos simples

Nota

Non-default widgets, when available, are presented as bullet points or sub-headings.

Texto (char)

O campo Texto é usado para texto curto contendo qualquer caractere. Uma linha de texto é exibida ao preencher o campo.

• Medalha: exibe o valor dentro de uma forma arredondada, semelhante a um marcador. O valor não pode ser editado na interface do usuário, mas um valor padrão pode ser definido.

• Copiar para a prancheta: os usuários podem copiar o valor clicando em um botão.

• E-mail: o valor se torna um link enviar para clicável.

• Imagem: exibe uma imagem usando um URL. O valor não pode ser editado manualmente, mas um valor padrão pode ser definido.

  Nota

  This works differently from selecting the Image field directly, as the image is not stored in Odoo when using a Text field with the Image widget. For example, it can be useful if you want to save disk space.

• Telefone: o valor se torna um link tel clicável.

  Dica

  Marque Habilitar SMS para adicionar ao lado do campo uma opção para enviar um SMS diretamente do Odoo.

• URL: o valor se torna um URL clicável.

Example

Texto multilinha (text)

O campo Texto multilinha é usado para textos mais longos que contenham qualquer tipo de caractere. Duas linhas de texto são exibidas na interface do usuário quando o campo é preenchido.

• Copiar para a prancheta: os usuários podem copiar o valor clicando em um botão.

Example

Número inteiro (integer)

O campo Número inteiro é usado para todos os números inteiros (positivos, negativos ou zero, sem decimal).

• Gráfico de porcentagem: exibe o valor dentro de um círculo de porcentagem, geralmente para um valor calculado. O valor não pode ser editado na interface do usuário, mas um valor padrão pode ser definido.

• Barra de progresso: exibe o valor ao lado de uma barra de porcentagem, geralmente para um valor computado. O campo não pode ser editado manualmente, mas um valor padrão pode ser definido.

• Alça: exibe um ícone de alça de arrastar para ordenar os registros manualmente na List view.

Example

Decimal (float)

O campo Decimal é usado para todos os números decimais (positivo, negativo ou zero, com decimal).

Nota

Os números decimais são exibidos com duas casas decimais após o ponto na interface do usuário, mas são armazenados na base de dados com mais precisão.

• Monetário: é semelhante ao uso do campo Monetário. É recomendável usar o último, pois ele oferece mais funcionalidades.

• Porcentagem: exibe um caractere de porcentagem % após o valor.

• Gráfico de porcentagem: exibe o valor dentro de um círculo de porcentagem, geralmente para um valor calculado. O campo não pode ser editado manualmente, mas um valor padrão pode ser definido.

• Barra de progresso: exibe o valor ao lado de uma barra de porcentagem, geralmente para um valor computado. O campo não pode ser editado manualmente, mas um valor padrão pode ser definido.

• Tempo: o valor deve seguir o formato hh:mm, com um máximo de 59 minutos.

Example

Monetário (monetário)

O campo Monetário é usado para todos os valores monetários.

Nota

Quando você adiciona um campo Monetário pela primeira vez, é solicitado que você adicione um campo Moeda se ainda não existir nenhum no modelo. O Odoo oferece adicionar o campo Moeda. Depois que ele for adicionado, adicione o campo Monetário novamente.

Example

Html (html)

O campo Html é usado para adicionar texto que pode ser editado usando o editor HTML do Odoo.

• Texto multilinha: desativa o editor HTML do Odoo para permitir a edição de HTML bruto.

Example

Data (date)’

O campo Data é usado para selecionar uma data em um calendário.

• Dias restantes: a quantidade restante de dias antes da data selecionada ser exibida (por exemplo, Em 5 dias), com base na data atual deve ser definido como Somente leitura.

Example

Data e Hora (datetime)

O campo Data e Hora é usado para selecionar uma data em um calendário e uma hora em um relógio. A hora atual do usuário é usada automaticamente se nenhuma hora for definida.

Dica

Assim como as propriedades gerais, algumas propriedades específicas estão disponíveis para os campos Data e Hora que têm o widget Data e Hora ou Intervalo de data definido.

Intervalo de datas (daterange)

O widget Intervalo de datar é usado para exibir um período de tempo definido por uma data de início e uma data de término em uma única linha. Um intervalo de datas pode ter uma data de início e de término obrigatória, por exemplo, para um evento de vários dias, ou permitir uma data de início ou de término opcional, por exemplo, para uma intervenção de serviço de campo ou uma tarefa de projeto.

A adição de um intervalo de datas requer dois campos: um campo Data e Hora com o widget Intervalo de datas definido e outro campo selecionado como a data inicial ou a data final. Esse campo subjacente pode ser um campo Data ou Data e Hora existente, ou um campo criado especificamente para essa finalidade.

Para adicionar um intervalo de datas:

1. Identifique um campo Data ou Data e Hora existente que possa ser usado como o campo de data de início/fim subjacente ou adicione um novo campo. Se nesse intervalo de datas:

   • a data de início e adata de término são obrigatórias, esse campo pode ser a data de início ou a data de término; o resultado é o mesmo.

   • a data de início ou de término são opcionais, esse campo é a data de início ou de término, respectivamente.

   Dica

   Para evitar a visualização da mesma informação duas vezes, o campo de data de início/término subjacente pode ser tornado invisível ativando Invisível ou removido da visualização clicando em Remover da visão.

2. Adicione um campo Data e Hora e defina o campo Widget como Intervalo de datas.

3. Digite um Rótulo apropriado.

4. Selecione o campo de data de início/fim subjacente no menu suspenso Campo de data de início ou Campo de data de término, conforme relevante.

5. Se o intervalo de datas tiver uma data inicial e uma data final obrigatórias, ative Sempre o intervalo.

6. Atualize quaisquer outras propriedades gerais ou propriedades específicas para os campos Data e Hora conforme necessário e, em seguida, clique em Fechar no canto superior direito da tela.

Example

Dias restantes (remaining_days)

O widget Dias remanescentes exibe o número restante de dias antes da data selecionada (por exemplo, Em 5 dias), com base na data e na hora atuais. Esse campo deve ser definido como Somente leitura.

Caixa de seleção (boolean)

O campo Caixa de seleção é usado quando um valor deve ser apenas verdadeiro ou falso, indicado pela marcação ou desmarcação de uma caixa de seleção.

• Botão: exibe um botão de rádio. O widget funciona sem alternar para o modo de edição.

• Alternância: exibe um botão de alternância. O widget funciona sem alternar para o modo de edição.

Example

Seleção (selection)

O campo Seleção é usado quando os usuários devem selecionar um único valor em um grupo de valores predefinidos.

• Medalha: exibe o valor dentro de uma forma arredondada, semelhante a um marcador. O valor não pode ser editado na interface do usuário, mas um valor padrão pode ser definido.

• Medalhas: exibe todos os valores selecionáveis simultaneamente dentro de formas retangulares, organizadas na horizontal.

• Prioridade: exibe símbolos de estrelas em vez de valores, que podem ser usados para indicar um nível de importância ou satisfação, por exemplo. Isso tem o mesmo efeito que selecionar o campo Prioridade, embora, para esse último, quatro valores de prioridade já estejam predefinidos.

• Rádio: exibe todos os valores selecionáveis ao mesmo tempo como botões de rádio.

  Dica

  Por padrão, os botões de seleção são organizados verticalmente. Ative a opção Exibir horizontalmente para mudar a forma como são exibidos.

• Barra de status: exibe todos os valores selecionáveis ao mesmo tempo, como uma barra de progresso em forma de seta.

  Dica

  Por padrão, os valores na barra de status são selecionáveis. Desabilite Clicável para evitar que o valor seja editado na interface do usuário.

Example

Prioridade (selection)

O campo Prioridade é usado para exibir um sistema de classificação de três estrelas, que pode ser usado para indicar a importância ou o nível de satisfação. Esse tipo de campo é um Campo de seleção com o widget Prioridade selecionado por padrão e quatro valores de prioridade predefinidos. Consequentemente, os widgets Medalha, Medalhas, Rádio e Seleção têm os mesmos efeitos descritos em Seleção.

Dica

Para alterar o número de estrelas disponíveis adicionando ou removendo valores, clique em Editar valores. Observe que o primeiro valor é igual a 0 estrelas (ou seja, quando nenhuma seleção é feita), portanto, ter quatro valores resulta em um sistema de classificação de três estrelas, por exemplo.

Example

Arquivo (binary)

O campo Arquivo é usado para carregar qualquer tipo de arquivo ou assinar um formulário (widget:guilabel:Assinar).

• Imagem: os usuários podem carregar um arquivo de imagem, que é então exibido na Visualização de formulário. Isso tem o mesmo efeito que usar o campo Imagem.

• Visualizador de PDF: os usuários podem carregar um arquivo PDF, que pode ser navegado a partir da Visualização de formulário.

• Assinar: os usuários podem assinar eletronicamente o formulário. Isso tem o mesmo efeito que selecionar o campo Assinar.

Example

Imagem (binary)

O campo Imagem é utilizado para carregar uma imagem e exibi-la na Visualização de formulário. Esse tipo de campo é um File field com o widget Imagem selecionado por padrão. Consequentemente, os widgets Arquivo, Visualizador de PDF e Assinar têm os mesmos efeitos descritos em Arquivo.

Dica

Para alterar o tamanho de exibição das imagens carregadas, selecione Pequeno, Médio ou Grande na opção Tamanho.

Assinar (binary)

O campo Assinar é usado para assinar o formulário eletronicamente. Esse tipo de campo é um Campo de arquivo com o widget Assinar selecionado por padrão. Consequentemente, os widgets Arquivo, Imagem e Visualizador de PDF têm os mesmos efeitos descritos em Arquivo.

Dica

Para dar aos usuários a opção Auto quando tiverem que desenhar a assinatura, selecione um dos campos Autocompletar com disponíveis (Texto, Many2One, e Campo relacionado somente no modelo). A assinatura é gerada automaticamente usando os dados do campo selecionado.

Campos relacionais

Nota

Non-default widgets, when available, are presented as bullet points or sub-headings.

Many2One (many2one)

Campos Many2One é usado para vincular outro registro (de outro modelo) ao registro que está sendo editado. O nome do registro do outro modelo é então exibido no registro que está sendo editado.

Example

No modelo Pedido de venda, o campo Cliente é um campo Many2One que aponta para o modelo Contato. Isso permite que muitos pedidos de vendas sejam vinculados a um contato (cliente).

Dica

• Para impedir que os usuários criem um novo registro no modelo vinculado, marque a opção Desabilitar criação.

• Para evitar que os usuários abram registros em uma janela pop-up, marque a opção Desabilitar abertura.

• Para ajudar os usuários a selecionar apenas o registro correto, clique em Domínio para criar um filtro.

• To only trigger the search for a linked record after a minimum number of characters has been entered, enter the desired number in the Typeahead search field. In situations where the data set is large, this can enhance both search relevancy and performance.

• Distintivo: exibe o valor dentro de uma forma arredondada, semelhante a um marcador. O valor não pode ser editado na interface do usuário.

• Rádio: exibe todos os valores selecionáveis ao mesmo tempo como botões de rádio.

One2Many (one2many)

O campo One2Many é usado para exibir as relações existentes entre um registro no modelo atual e vários registros de outro modelo.

Example

Você poderia adicionar um campo One2Many no modelo Contato para examinar os muitos pedidos de vendas de um cliente.

Nota

Para usar um campo One2Many, os dois modelos já devem ter sido vinculados usando um campo Many2One. As relações One2Many não existem independentemente: é realizada uma pesquisa reversa das relações Many2One existentes.

Linhas (one2many)

O campo Linhas é usado para criar uma tabela com linhas e colunas (por exemplo, as linhas de produtos em um pedido de vendas).

Dica

Para modificar as colunas, clique no campo Linhas e, em seguida, em Editar visualização de lista. Para editar o formulário que aparece quando o usuário clica em Adicionar uma linha, clique em Editar visualização de formulário.

Example

Many2Many (many2many)

O campo Many2Many é usado para vincular vários registros de outro modelo a vários registros no modelo atual. Os campos Many2Many podem usar Desabilitar criação, Desabilitar abertura, Domínio, assim como os campos Many2One.

Example

No modelo Tarefa, o campo Responsáveis é um campo Many2Many que aponta para o modelo Contato. Isso permite que um único usuário seja atribuído a muitas tarefas e que muitos usuários sejam atribuídos a uma única tarefa.

Dica

To only trigger the search for the linked record after a minimum number of characters has been entered, enter the desired number in the Typeahead search field. In situations where the data set is large, this can enhance both search relevancy and performance.

• Caixas de seleção: os usuários podem selecionar vários valores usando caixas de seleção.

• Marcadores: os usuários podem selecionar vários valores que aparecem em formas arredondadas, também conhecidos como marcadores. Isso tem o mesmo efeito que selecionar o campo Marcadores.

Marcadores (many2many)

O campo Marcadores é usado para exibir vários valores de outro modelo que aparecem em formas arredondadas, também conhecidos como marcadores. Esse tipo de campo é um campo Many2Many com o widget Tags selecionado por padrão. Consequentemente, os widgets Checkboxes e Many2Many têm os mesmos efeitos descritos em Many2Many.

Dica

Para exibir tags com cores de fundo diferentes, marque a opção Usar cores.

Example

Campo relacionado (related)

Um Related Field não é um campo relacional propriamente dito; nenhuma relação é criada entre modelos. Ele usa um relacionamento existente para buscar e exibir informações de outro registro.

Example

Para exibir o endereço de e-mail de um cliente no modelo Pedido de venda, use o Campo relacionado partner_id.email selecionando Cliente e, em seguida, E-mail.

Add a field to a view

With Studio, it is possible to add:

• a new field to a form or list view of a model

• an existing field, i.e., a field that already exists on the model in question, to any view of that model

Dica

Add a new field to a form or list view to save it to the model and make it available as an existing field in other views of the same model.

Add a new field

Dica

Activate developer mode before adding a new field to see, and be able to edit, the field’s technical name during configuration.

To add a new field, follow these steps:

1. Navigate to the relevant form or list view, then click the (Toggle Studio) icon in the upper-right corner. Alternatively, with any app open, click the (Toggle Studio) icon, then navigate to the relevant form or list view.

2. In the Add tab, drag the relevant field type from the New Fields section and drop it in the desired position. If the new field is a relational field, select the relevant reciprocal field, model, or related field in the pop-up.

3. In the Properties tab, configure the field’s properties:

   • Enter the Label to be displayed as the field name on the UI; this is also used to generate the default technical name of the field.

   • Click anywhere outside the Label field to see the Technical Name updated with the default technical name.

     Nota

     • The Technical Name of a new field can be edited in Studio during the configuration process. At any other time, a field’s technical name can only be modified via the technical settings of the database.

     • The technical name of a new field added using Studio is by default prefixed by x_studio_.

   • Optionally, select a different Widget via the dropdown; the default widget for the field type is selected by default.

   • Optionally, configure any other field properties.

4. Click Close in the top-right corner to close Studio.

Ver também

Adding a new AI field

Add an existing field

To add a field that exists on the model but that is not present on the current view, follow these steps:

1. Navigate to the relevant view, then click the (Toggle Studio) icon in the upper-right corner. Alternatively, with any app open, click the (Toggle Studio) icon, then navigate to the relevant view.

2. In the Add tab, in the left panel, click Existing Fields to reveal a list of all the model’s fields that are not currently present in the view.

3. Drag the relevant field and drop it in the desired position.

4. In the Properties tab, configure the relevant properties for the field in the current view.

   Nota

   Various properties can be configured independently for different views, if needed, such as the Label, the Widget, the visibility of the field for certain user groups, as well as whether or not the field is Invisible, Required, or Readonly.

5. Click Close in the top-right corner to close Studio.

Field properties

A series of general properties can be configured for most combinations of field type and widget. Additional properties are available depending on the specific field type and widget selected. For example, Date & Time fields using the Date & Time or Date Range widget have various specific properties that can be configured.

Propriedades gerais

• Class: Use Bootstrap or other custom classes defined in Odoo to customize how the field is styled and displayed on the UI.

• Invisível: Ative essa propriedade quando não for necessário que os usuários visualizem um campo na interface do usuário. Isso ajuda a organizar a interface do usuário, mostrando apenas os campos essenciais, dependendo de uma situação específica.

• Obrigatório: Habilite essa propriedade se um campo sempre deve ser preenchido pelo usuário antes de ser possível continuar.

• Somente leitura: Habilite essa propriedade se os usuários não puderem modificar um campo.

Dica

• The Invisible property also applies inside Studio. To view hidden fields in Studio, click on a view’s View tab and enable Show Invisible Elements.

• The Invisible, Required, and Readonly properties can be enabled for specific records only by clicking on Conditional and creating a filter.

  Example

  On the form view of the Contact model, the Title field only appears when Individual is selected, as that field would not be helpful for a Company contact.

• Label: This is the field name on the UI; the label is used to generate the technical name of the field.

• Dica de ajuda: Para explicar a finalidade de um campo, adicione uma descrição. O texto é exibido ao passar o mouse, em uma caixa de dica de ferramenta acima do ponto de interrogação ao lado do rótulo do campo.

• Technical Name: To view a field’s technical name in Studio (and, during the configuration of a new field, edit it if desired), activate developer mode.

  Dica

  If this field needs to be updated but is no longer editable via Studio, the technical name can be modified via the technical settings of the database.

• Widget: Para alterar a aparência ou a funcionalidade padrão de um campo, selecione um dos widgets disponíveis.

• Placeholder: To provide an example of how a field should be completed, add a fixed placeholder text. The text appears in light gray until a value is entered.

• Dynamic Placeholder: To provide the value of the selected field as an example of how a field should be completed. The text appears in light gray until a value is entered.

• Valor padrão: Para exibir um valor padrão em um campo quando um registro é criado, adicione um valor.

• Permitir visibilidade para grupos: Para limitar os usuários que podem visualizar o campo, selecione um ou mais acessos de grupos <access-rights/groups> de usuários.

• Proibir visibilidade para grupos: Para impedir que determinados usuários vejam o campo, selecione um ou mais acessos de grupos <access-rights/groups> de usuários.

Propriedades dos campos de data e hora

For Date & Time fields using the Date & Time or Date Range widget, some specific properties are available:

• Minimal precision: Determine the smallest date unit that must be selected in the date selector. The possible values are Day, Month, Year or Decade. If no value is selected, the user must select a day in the date selector.

• Maximal precision: Determine the largest date unit that can be used to navigate the date selector. The possible values are Day, Month, Year or Decade. If no value is selected, the user can navigate the date selector by decade.

• Aviso para datas futuras: Ative essa propriedade para exibir um ícone de aviso se uma data futura for selecionada.

• Date format: By default the date will be shown as Apr 2, 2025, 08:05 AM. Enable this property to show the date in the format 4/2/2025 08:05:00. The numeric mode is the format set on the current language. In this mode the seconds are always shown.

• Show date: This property is enabled by default for Date & Time fields. Disable this property to show only the time.

• Mostrar hora: Essa propriedade é ativada por padrão para os campos Data e Hora. Em um campo somente leitura, desative a propriedade para mostrar somente a data. Isso pode manter uma visualização de lista menos desordenada, por exemplo.

• Show seconds: This property is disabled by default for Date & Time fields. Enable the property to show the seconds.

• Intervalo de tempo: Insira um valor para determinar os intervalos de minutos mostrados no seletor de tempo. Por exemplo, digite 15 para permitir intervalos de um quarto de hora. O valor padrão é definido como 5 minutos.

• Primeira data aceita: Insira a primeira data que pode ser selecionada no seletor de datas no formato ISO, ou seja, AAAA-MM-DD. Se a data atual for sempre a primeira data aceita, digite hoje. No seletor de datas, as datas anteriores à primeira data aceita ficam acinzentadas.

• Primeira data aceita: Insira a última data que pode ser selecionada no seletor de datas no formato ISO, ou seja, AAAA-MM-DD. Se a data atual for sempre a última data aceita, digite hoje. No seletor de datas, as datas posteriores à última data aceita ficam acinzentadas.

Modify a field’s properties

To modify the properties of a field, follow these steps:

1. Navigate to the relevant view, then click the (Toggle Studio) icon in the upper-right corner. Alternatively, with any app open, click the (Toggle Studio) icon, then navigate to the relevant view.

2. Click on the relevant field.

3. In the Properties tab, make any desired changes to the field properties.

   Dica

   Various properties can be configured independently for different views, such as the Label, the Widget, the visibility of the field for certain user groups, as well as whether or not the field is Invisible, Required, or Readonly.

4. Click Close in the top-right corner to close Studio.

Nota

The Technical Name of a field (visible in Studio with developer mode activated) cannot be modified in Studio; this can be done via the technical settings of the database.

Modify a field’s technical name

To modify the technical name of a field, activate developer mode, then follow these steps:

1. With the field open in Studio, copy the technical name of the field.

2. Remove the field from all views in Studio, then click Close to close Studio.

3. Navigate to Settings app ‣ Technical ‣ Fields.

4. Paste the copied technical name into the search bar, then open the relevant field.

5. Modify the Field Name as needed.

Once the field’s technical name has been updated, the field can then be added (back) to the relevant view(s) from the list of existing fields.

Importante

When updating the technical name of a field, make sure to keep at least the x_ prefix, which is required for any custom field; for fields created using Studio, keep the x_studio_ prefix to allow such fields to be more easily identified.

Remove a field from a view

To remove a field from a view, follow these steps:

1. Navigate to the relevant view, then click the (Toggle Studio) icon in the upper-right corner. Alternatively, with any app open, click the (Toggle Studio) icon, then navigate to the relevant view.

2. Click on the relevant field.

3. Scroll to the bottom of the Properties tab, then click Remove from view.

4. Click Ok to confirm the action.

Dica

• A removed field can be easily added back to the view at a later stage, if needed.

• If the intention is to declutter the view, it is also possible to modify a field and make it Invisible on the view in question.