Limpeza de dados

The Odoo Data Cleaning app maintains data integrity and consistency with the following features:

• Desduplicar: funde ou remove entradas duplicadas para garantir que os dados sejam únicos.

• Reciclar: identifica registros desatualizados para arquivar ou exclui-los.

• Formatar: padroniza os dados de texto, encontrando-os e substituindo-os de acordo com as necessidades especificadas.

Customizable rules ensure text data stays up-to-date, streamlined, consistently formatted, and aligned with company-specific formatting requirements.

Instalar módulos

The Data Cleaning application consists of several modules. Install the following to access all available features:

Nome Technical name	Descrição
Reciclagem de dados data_recycle	Base module to enable the recycle feature, available on Odoo Community edition.
Limpeza de dados data_cleaning	Enables field cleaning feature to format text data across multiple records, available only on Odoo Enterprise edition.
Limpeza de dados (mesclar) data_merge	Enables the deduplication feature to find similar (or duplicate) records, and merge them, available only on Odoo Enterprise edition.

Additionally, several app-specific modules are available

Desduplicação de CRM data_merge_crm	Enables the deduplication feature on the CRM app, and uses the CRM default merging feature.
Ação de mesclagem da Central de Ajuda data_merge_helpdesk	Enables the merge feature for the Helpdesk app.
Ação de mesclagem de projetos data_merge_project	Enables the merge feature for the Projects app.
Desduplicação UTM data_merge_utm	Enables the merge feature for the UTM Tracker app.
Mesclagem de contabilidade WMS data_merge_stock_account	Creates a warning in cases of products merging that may affect inventory valuation, if the Inventory app is installed.

Desduplicação

The Duplicates dashboard groups similar records to be merged by matching conditions within the records set by the deduplication rules.

Navigate to this dashboard by going to Data Cleaning app ‣ Deduplication.

A barra lateral REGRA lista cada uma das regras de desduplicação ativas, apresentando o número total de duplicatas detectadas ao lado de cada regra.

By default, the All rule is selected. Records are grouped by their rule, with a Similarity rating (out of 100%), with the following columns:

• Criado em: a data e a hora em que o registro original foi criado.

• Nome: o nome ou título do registro original.

• Valores dos campos: os valores do registro original nos campos utilizados para detectar duplicatas.

• Usado em: lista outros modelos que referenciam o registro original.

• ID: o ID exclusivo do registro original.

• Is Master: the duplicates are merged into the master record. There can only be one master record in a grouping of similar records.

Selecione uma regra específica na barra lateral REGRA para filtrar os registros duplicados.

Mesclar registros duplicados

Para mesclar registros, comece escolhendo um registro mestre dentro do grupo de registros semelhantes. O registro mestre funciona como uma base, na qual são mescladas informações adicionais de registros semelhantes.

Opcionalmente, não é definido nenhum registro mestre e o Odoo escolhe ao acaso um registro no qual ocorrerá a mesclagem.

Em seguida, clique no botão Mesclar no topo do agrupamento de registros semelhantes. Depois, clique em Ok para confirmar a mesclagem.

Once a record is merged, a message is logged in the chatter of the master record, describing the merge. Certain records, like Project tasks, are logged in the chatter with a link to the old record as a convenient reference of the merge.

Dica

Descarte agrupamentos clicando no botão DESCARTAR. Ao fazer isso, o agrupamento é oculto na lista e arquivado.

View discarded groupings by selecting the Discarded filter from the search bar.

Regras de desduplicação

The Deduplication Rules set the conditions for how records are detected as duplicates.

These rules can be configured for each model in the database, and with varying levels of specificity. To get started, navigate to Data Cleaning app ‣ Configuration ‣ Deduplication.

Dica

The deduplication rules run once every day, by default, as part of a scheduled action cron (Data Merge: Find Duplicate Records). However, each rule can be ran manually anytime.

Modificar uma regra de desduplicação

Select a default rule to edit, or create a new rule by clicking on the New button.

Primeiro, escolha um Modelo para esta regra. A seleção de um modelo atualiza o título da regra do modelo escolhido.

Opcionalmente, configure um Domínio para especificar os registros elegíveis para esta regra. O número de registros elegíveis é mostrado no link Nº registro(s).

Dependendo do Modelo selecionado, aparece o campo Remoção de Duplicados. Escolha se prefere Arquivar ou Apagar os registros mesclados.

Em seguida, selecione um Modo de mesclagem:

• Manual: requer que cada agrupamento duplicado seja mesclado manualmente; também ativa o campo Notificar usuários.

• Automático: mescla automaticamente os agrupamentos duplicados, sem notificar os usuários, com base nos registros com uma percentagem de similaridade acima do limite definido no campo Limite de similaridade.

Habilite o botão de opção Ativo para capturar duplicatas com esta regra, assim que ela for salva.

Por fim, crie pelo menos uma regra de desduplicação no campo Regras de desduplicação, clicando em Adicionar uma linha, na coluna Campo de ID exclusivo.

• Selecione um campo fo modelo no menu suspenso Campo de ID exclusivo. Este campo é referenciado para registros semelhantes.

• Selecione uma condição de correspondência no campo Corresponder se para aplicar a regra de desduplicação, dependendo do texto no Campo de ID exclusivo:

  • Correspondência exata: os caracteres do texto correspondem exatamente.

  • Sem distinção entre maiúsculas/minúsculas e acentos: os caracteres do texto correspondem, independentemente das diferenças de maiúsculas e minúsculas e do acentos específicos do idioma.

Importante

At least one Deduplication Rules must be set for the rule to capture duplicates.

Dica

Estão disponíveis mais alguns campos para uma configuração avançada.

Se estiver numa base de dados multi-empresa, o campo Entre empresas está disponível. Quando ativado, são sugeridas duplicações entre diferentes empresas.

Ative o Modo de desenvolvedor (modo de depuração) para exibilir o campo Limite da sugestão. Duplicatas com similaridade abaixo do limite definido neste campo são não sugeridas.

Com a configuração da regra concluída, feche o formulário da regra ou execute a regra manualmente para capturar instantaneamente registros duplicados.

Executar manualmente uma regra de desduplicação

To manually run a specific deduplication rule at any time, navigate to Data Cleaning app ‣ Configuration ‣ Deduplication, and select the rule to run.

Depois, no formulário da regra, selecione o botão Desduplicar no canto superior esquerdo. Ao fazê-lo, o botão inteligente Duplicatas apresenta o número de duplicatas capturadas.

Click on the Duplicates smart button to manage these records.

Reciclar registros

Use the recycle records feature to rid the database of old and outdated records.

The Field Recycle Records dashboard displays records that can be archived or deleted, by matching conditions within the records set by the recycle record’s rules.

Navigate to this dashboard by going to Data Cleaning app ‣ Recycle Records.

The RECYCLE RULES sidebar lists each of the active recycle record rules.

By default, the All option is selected. Records are displayed with the following columns:

• ID do registro: o ID do registro original.

• Nome do registro: o nome ou título do registro original.

Select a specific rule in the RECYCLE RULES sidebar to filter the records.

Para reciclar registros, clique no botão Validar na linha do registro.

Isso recicla o registro, dependendo de como a regra está configurada, para ser arquivado ou excluído da base de dados.

Dica

Descarte os agrupamentos clicando no botão Descartar. Ao fazer isso, o registro é ocultado da lista e não será detectado pela regra de reciclagem novamente.

Visualize os registros descartados selecionando o filtro Descartado no menu suspenso barra de pesquisa.

Regras de reciclagem de registros

The Recycle Records Rules set the conditions for how records are recycled.

These rules can be configured for each model in the database, and with varying levels of specificity. To get started, navigate to Data Cleaning app ‣ Configuration ‣ Recycle Records.

Dica

Recycle rules run once a day, by default, as part of a scheduled action cron (Data Recycle: Clean Records). However, each rule can be run manually anytime.

Por padrão, não existem regras de registro de reciclagem. Clique no botão Novo para criar uma nova regra.

No formulário de regra de registro de reciclagem, primeiro escolha um Modelo para que essa regra seja direcionada. A seleção de um modelo atualiza o título da regra para o modelo escolhido.

Opcionalmente, configure um Filtro para especificar os registros elegíveis para essa regra. O número de registros qualificados é exibido no link # registros(s).

Em seguida, configure o campo e o intervalo de tempo para que a regra detecte os registros a reciclar:

• Campo de tempo: selecione um campo do modelo para basear o tempo (Delta).

• Delta: digite o período de tempo, que deve ser um número inteiro (ex: 7).

• Unidade Delta: selecione a unidade de tempo (Dias, Semanas, Meses ou Anos).

Em seguida, selecione um Modo de reciclagem:

• Manual: requer que cada registro detectado seja reciclado manualmente e ativa o campo Notificar usuários.

• Automático: mescla automaticamente os agrupamentos reciclados, sem notificar os usuários.

Por fim, selecione uma Ação de reciclagem para Arquivar ou Excluir registros. Se a opção Excluir for selecionada, escolha se deseja ou não Incluir registros arquivados na regra.

Com a configuração da regra concluída, feche o formulário da regra ou execute a regra manualmente para capturar instantaneamente os registros a serem reciclados.

Example

Uma regra de reciclagem pode ser configurada para excluir leads e oportunidades arquivados que foram atualizados pela última vez há um ano e com um motivo de perda específico, usando a configuração a seguir:

• Modelo: Lead/Oportunidade

• Filtro:

  • Ativo está não definido

  • Motivo de perda está em Muito caro

• Campo de tempo: Última atualização em (Lead/Oportunidade)

• Delta: 1

• Unidade Delta: Anos

• Modo de reciclagem: Automático

• Ação de reciclagem: Excluir

• Incluir arquivados:

Executar manualmente uma regra de reciclagem

To manually run a specific recycle rule at any time, navigate to Data Cleaning app ‣ Configuration ‣ Recycle Records, and select the rule to run.

Em seguida, no formulário de regra, clique no botão Executar agora no canto superior esquerdo. Ao fazer isso, o botão inteligente Registros exibe o número de registros capturados.

Click the Records smart button to manage these records.

Limpeza de campos

Use the field cleaning feature to maintain consistent formatting of names, phone numbers, IDs and other fields throughout a database.

The Field Cleaning Records dashboard displays formatting changes to data in fields of a record, to follow a convention set by the field cleaning rules.

Navigate to this dashboard by going to Data Cleaning app ‣ Field Cleaning.

The CLEANING RULES sidebar lists each of the active cleaning rules.

By default, the All rule is selected. Records are listed with the following columns:

• ID do registro: o ID do registro original.

• Nome do registro: o nome ou título do registro original.

• Field: the original record’s field that contains the value to format.

• Current: the current value in the field of the original record.

• Suggested: the suggested formatted value in the field of the original record.

To clean and format records, click the Validate button on the row of the record.

Upon doing so, the record is formatted and/or cleaned.

Dica

Discard records by clicking the Discard button. Upon doing so, the record is hidden from the list and will not be detected by the field cleaning rule again in the future.

View discarded records by selecting the Discarded filter from the search bar.

Field cleaning rules

The Field Cleaning Rules set the conditions for fields to be cleaned and/or formatted.

These rules can be configured for each model in the database, and with varying levels of specificity. To get started, navigate to Data Cleaning app ‣ Configuration ‣ Field Cleaning.

Dica

The field cleaning rules run once every day, by default, as part of a scheduled action cron (Data Cleaning: Clean Records). However, each rule can be ran manually anytime.

By default, a Contact rule exists to format and clean up the Contacts app records. Select the Contact record to make edits, or select the New button to create a new rule.

On the field cleaning rule form, first choose a Model for this rule to target. Selecting a model updates the rule title to the chosen model.

Next, configure at least one rule by clicking Add a line in the Rules section.

Upon doing so, a Create Rules popover window appears with the following fields to configure:

• Select a Field To Clean from the model to assign to an action.

• Choose one of the following Action options:

  • Trim Spaces reveals the Trim field to select the All Spaces or Superfluous Spaces option. Leading, trailing, and successive spaces are considered superfluous.

    Example

    The contact name Dr.  John   Doe can be formatted with the following Trim options:

    • All Spaces: DR.JohnDoe

    • Superfluous Spaces: DR. John Doe

  • Set Type Case reveals the Case field to select either First Letters to Uppercase, All Uppercase, or All Lowercase.

    Example

    The lead/opportunity title lumber inc, Lorraine douglas can be formatted with the following Case options:

    • First Letters to Uppercase: Lumber Inc, Lorraine Douglas

    • All Uppercase: LUMBER INC, LORRAINE DOUGLAS

    • All Lowercase: lumber inc, lorraine douglas

  • Format Phone converts the phone number to an international country format.

    Example

    • Belgium: 061928374 +32 61 92 83 74

    • United States: 800 555-0101 +1 800-555-0101

  • Scrap HTML converts HTML to plain text.

    Example

    HTML text

    <h1>John Doe</h1>
    <p>Lorem ipsum dolor sit <a href="https://example.com">amet</a>.</p>
    

    Texto simples

    **John Doe** Lorem ipsum dolor sit amet [1] .[1] https://example.com
    

  Once a field and action are selected, click Save to close the Create Rules popover window.

Then, select a Cleaning Mode:

• Manual: requires each detected field to be manually cleaned and enables the Notify Users field.

• Automatic: automatically cleans fields without notifying users.

With the rule’s configuration complete, either close the rule form, or run the rule manually to instantly capture fields to clean.

Manually run a field cleaning rule

To manually run a specific field cleaning rule at any time, navigate to Data Cleaning app ‣ Configuration ‣ Field Cleaning, and select the rule to run.

Then, on the rule form, select the Clean button on the top-left. Upon doing so, the Records smart button displays the number of records captured.

Click on the Records smart button to manage these records.

Gerenciador de ações de mesclagem

The Merge Action Manager enables or disables the Merge action available in the Actions menu for models in the database.

Enable Modo de desenvolvedor (modo de depuração) and navigate to Data Cleaning app ‣ Configuration ‣ Merge Action Manager.

Models are listed with the following columns:

• Model: technical name of the model.

• Model Description: display name of the model.

• Type: whether the model is of the Base Object or Custom Object type.

• Transient Model: the model handles temporary data that does not need to be stored long-term in the database.

• Can Be Merged: enables the Merge action for the model.

To view which models are enabled by default, use the search bar to filter models that Can Be Merged.

Veja também

Mesclar contatos