Inserir uma lista¶
Há duas maneiras de inserir uma lista do Odoo em uma planilha do Odoo:
Inserir uma lista a partir de uma visualização de lista do Odoo em uma planilha do Odoo, painel do Odoo ou planilha de cálculo de cotações.
Inserir uma lista que recupera dados do Odoo diretamente de uma planilha do Odoo. Essa opção permite extrair dados de qualquer modelo, inclusive modelos para os quais nenhuma visualização de lista está disponível, por exemplo, o modelo Linha do pedido de venda.
Em ambos os casos, a lista é conectada aos dados subjacentes do banco de dados graças à sua fonte de dados exclusiva, que mantém os dados atualizados e fornece acesso aos dados subjacentes diretamente da planilha. No entanto, o fato de a lista se expandir ou não para acomodar novos registros depende de ela ser uma lista estática ou dinâmica.
Listas estáticas versus dinâmicas¶
Quando uma lista de uma visualização de lista do Odoo é inserida em uma planilha do Odoo, ela é, por padrão, uma lista estática, em que cada célula recupera dados do banco de dados por meio de uma função específica do Odoo. Os dados da lista são mantidos atualizados, mas ela não se expande para acomodar novos registros.
Inserir uma lista do Odoo diretamente de uma planilha do Odoo resulta em uma lista dinâmica, em que uma única função de matriz específica do Odoo recupera dados do banco de dados. Os dados da lista são mantidos atualizados e, se desejado, a função de matriz pode ser modificada para permitir que a lista se expanda para acomodar novos registros.
Nota
Uma lista estática pode ser convertida em uma lista dinâmica e uma lista dinâmica pode ser convertida em uma lista estática, se necessário.
Inserir uma lista do Odoo a partir de uma visualização de lista¶
Dica
Antes de inserir uma lista em uma planilha, considere quais campos devem ficar visíveis e como os registros são filtrados e/ou ordenados. Isso pode afetar tanto o tempo de carregamento quanto a facilidade de uso da planilha.
Campos de propriedade visíveis em uma visualização de lista são incluídos quando a lista é inserida em uma planilha.
Para inserir uma lista de uma visualização de lista do Odoo em uma planilha do Odoo:
Com a visualização de lista relevante aberta, clique no ícone (Ações) ao lado do nome da visualização e, em seguida, em .
Dica
Para inserir apenas registros específicos, selecione os registros relevantes, clique no botão Ações que aparece no topo central da tela e, em seguida, em Inserir na planilha.
Na janela que se abre, edite o Nome da lista, se necessário.
Edite o número de Registros, ou seja, linhas, a serem inseridos, se necessário.
Por padrão, o número exibido é a quantidade de registros visíveis na primeira página da visualização de lista. Por exemplo, se a lista contiver 150 registros, mas apenas 80 estiverem visíveis, este campo exibirá 80.
Dica
Uma lista inserida a partir de uma visualização de lista do Odoo é uma lista estática que não se expandirá automaticamente para acomodar novos registros. Se for provável que novos registros sejam adicionados ao banco de dados, considere adicionar linhas extras ao inserir a lista.
Clique em Planilha em branco para criar uma nova planilha, ou selecione em qual planilha existente a lista deve ser inserida.
Clique em Confirmar.
A lista é inserida em uma nova aba da planilha. A aba na barra inferior mostra o nome da lista seguido pelo ID da lista, por exemplo, Cotações por total (Lista nº 1). Um painel no lado direito da planilha mostra as propriedades da lista.
Por padrão, a lista é uma lista estática, em que cada célula contém uma função específica do Odoo que recupera dados do banco de dados.
Nota
O Nome da lista é usado no nome da planilha e nas propriedades da lista, e pode ser editado a qualquer momento.
Registros/linhas também podem ser adicionados manualmente após a inserção da planilha. Como alternativa, a lista inserida pode ser convertida em uma lista dinâmica para permitir sua expansão e acomodar novos registros.
Ao inserir uma lista em uma nova planilha, a planilha é salva no aplicativo Odoo Documents na pasta pessoal Minha Unidade.
Para desfazer o vínculo entre uma lista inserida e o banco de dados, selecione a lista inteira, clique com o botão direito e selecione Copiar, depois clique com o botão direito novamente e selecione .
Funções de lista estática¶
Uma lista estática usa as seguintes funções específicas do Odoo para recuperar os valores do cabeçalho e dos campos, respectivamente, por meio de sua fonte de dados:
=ODOO.LIST.HEADER(list_id, field_name)
=ODOO.LIST.VALUE(list_id, index, field_name)
Os argumentos da função são os seguintes:
list_id: o ID atribuído quando a lista é inserida. A primeira lista inserida em uma planilha recebe o ID de lista1, a segunda, o ID de lista2, etc.index: identifica a linha na qual o registro apareceu na lista antes da inserção. A primeira linha tem um índice de1, a segunda um índice de2, etc.field_name: o nome técnico do campo.
Dica
Clicar em uma célula individual exibe a fórmula relacionada, se relevante, na barra de fórmulas. Para exibir todas as fórmulas de uma planilha ao mesmo tempo, clique em na barra de menu. O exemplo abaixo mostra as funções usadas para recuperar cabeçalhos e valores da lista.
Converter uma lista estática em uma lista dinâmica¶
Para permitir que uma lista inserida se expanda e acomode novos registros, converta a lista em uma lista dinâmica e, em seguida, atualize a função de matriz.
Existem duas formas principais de converter uma lista estática em uma lista dinâmica:
Duplicar a lista a partir das propriedades da lista. A nova lista dinâmica mantém o mesmo estilo da lista original.
Nota
Com esse método, a nova lista dinâmica recebe o próximo ID de lista disponível. Isso significa que várias listas podem ser associadas ao mesmo modelo, mas apresentar configurações ou cálculos distintos.
Reinserir uma lista dinâmica a partir do menu Dados. Na planilha que contém a lista estática, posicione o cursor em uma célula vazia. Clique em na barra de menus e selecione a lista correspondente.
Uma nova lista dinâmica é exibida, com o mesmo estilo da lista original.
Dica
Também é possível reinserir uma lista dinâmica inserindo a função da lista dinâmica em uma célula vazia, por exemplo,
=ODOO.LIST(1), onde1é o ID da lista. No entanto, com esse método, o estilo da tabela precisa ser reaplicado manualmente.Nota
Quando uma lista dinâmica é reinserida a partir do menu de dados ou inserindo a função de lista dinâmica manualmente, as listas estática e dinâmica compartilham a mesma fonte de dados e, consequentemente, o mesmo ID de lista. Para evitar confusões, exclua a lista estática original.
A célula superior esquerda da nova lista dinâmica contém uma função de matriz específica do Odoo que recupera dados do banco de dados.
Inserir uma lista do Odoo a partir de uma planilha¶
Para inserir uma lista do Odoo diretamente a partir de uma planilha do Odoo:
Abra a planilha Odoo relevante no aplicativo Documentos ou crie uma nova planilha em branco.
Clique em na barra de menus.
No painel Nova lista do Odoo à direita da planilha, selecione o Modelo do qual os dados devem ser recuperados e clique em Salvar.
A lista padrão para o modelo é inserida em uma nova aba da planilha. O nome da aba na barra inferior mostra o nome do modelo seguido pelo ID da lista, por exemplo, Pedido de venda (Lista #1). Um painel no lado direito da planilha mostra as propriedades da lista.
Por padrão, a lista é uma lista dinâmica, onde a célula superior esquerda contém uma função de matriz específica do Odoo que recupera dados do banco de dados.
Dica
Quando uma lista dinâmica é inserida pela primeira vez em uma planilha, são exibidos no máximo 80 registros. Edite a função de matriz para alterar o número máximo de registros a serem exibidos ou para exibir todos os registros e permitir que a lista se expanda para acomodar novos registros.
Função de lista dinâmica¶
Diferente de uma lista estática, onde cada célula contém uma função exclusiva que recupera dados por meio da fonte de dados, uma lista dinâmica possui uma única função de matriz específica do Odoo:
=ODOO.LIST(list_id, [row_count])
Os argumentos da função são os seguintes:
list_id: o ID atribuído quando a lista é inserida. A primeira lista inserida em uma planilha recebe o ID de lista1, a segunda, o ID de lista2, etc.row_count: defina um valor para limitar o número de linhas/registros.
Converter uma lista dinâmica em uma lista estática¶
Em algumas situações, por exemplo, para poder adicionar uma coluna que contenha uma fórmula inserida manualmente, pode ser necessário converter uma lista dinâmica em uma lista estática, na qual cada célula tem uma função individual que recupera dados da fonte de dados. Para fazer isso, siga estas etapas:
Na aba que contém a lista dinâmica, posicione o cursor em uma célula vazia.
Clique em na barra de menus e, em seguida, selecione a lista relevante.
Uma nova lista estática é exibida, com a mesma estilização da lista original. Clique em uma célula para ver a função na barra de fórmulas.
Propriedades da lista¶
As propriedades da lista aparecem no lado direito da tela quando uma lista é inserida. Elas podem ser acessadas a qualquer momento pelo menu Dados selecionando a lista relevante na seção Lista, ou clicando com o botão direito em qualquer lugar da lista e clicando em Ver propriedades da lista.
As seguintes propriedades da lista são exibidas, algumas das quais podem ser editadas:
Lista #: o ID da lista, que é usado para identificar a lista durante a vida útil da planilha. Os IDs de lista são atribuídos sequencialmente à medida que listas adicionais são inseridas na planilha.
Nome da lista: o nome da lista. Edite isso se necessário. Note que editar o nome da lista nas propriedades da lista não modifica o nome da lista exibido no nome da planilha, e vice-versa.
Modelo: o modelo do qual os dados foram extraídos e o número total de registros no modelo. O número de registros é recalculado sempre que a planilha é aberta ou sempre que o navegador ou a planilha são atualizados.
Colunas: as colunas que estavam visíveis na visualização de lista quando a lista foi inserida ou as colunas padrão da lista, caso a lista tenha sido inserida a partir da planilha.
Ordenação: como os dados são ordenados, se aplicável.
Domínio: as regras usadas para determinar quais registros são exibidos. Clique em Editar domínio para adicionar ou editar regras.
Para duplicar ou excluir a fonte de dados de uma lista, clique no ícone (engrenagem), depois clique em Duplicar ou Excluir conforme relevante.
Nota
Para uma lista dinâmica, as colunas só podem ser adicionadas, ocultadas ou excluídas pelas propriedades da lista; essas ações não podem ser executadas na própria lista. Para uma lista estática, ocorre o oposto; as colunas só podem ser adicionadas, ocultadas ou excluídas na própria lista.
Quando filtros globais são usados, o Domínio é combinado com os valores selecionados do filtro global antes que os dados sejam carregados na planilha.
Manipular uma lista inserida¶
Ordenar colunas¶
Nota
Ao contrário dos filtros padrão de planilha, que atuam apenas em dados visíveis, a funcionalidade de Ordenação no painel de propriedades da lista atua nas fontes de dados subjacentes de uma planilha, ordenando os dados essencialmente antes de serem carregados.
Para ordenar uma lista por uma coluna específica:
Abra o painel de propriedades da lista.
Na seção Ordenação, clique em Adicionar.
Selecione o campo apropriado. A tabela será então ordenada com base no campo/coluna selecionado, em ordem crescente.
Altere a Ordem de ordenação para Decrescente, se desejar.
Para excluir uma regra de ordenação, clique no ícone (excluir) no card do campo.
Dica
Adicione várias regras de ordenação para criar uma ordenação hierárquica na qual os dados são primeiro ordenados pelo primeiro campo/coluna de ordenação e, em seguida, pelos campos/colunas subsequentes em ordem. Por exemplo, com a ordenação hierárquica, os clientes podem ser exibidos em ordem alfabética crescente, com seus respectivos pedidos de venda exibidos em ordem decrescente pelo valor total. Para alterar a ordem em que a ordenação hierárquica é aplicada, arraste o card de um campo para a posição desejada.
Manipular uma lista estática¶
Depois que uma lista de uma visualização em lista do Odoo for inserida em uma planilha do Odoo, é possível:
Adicionar linhas/registros¶
Para adicionar linhas/registros a uma lista estática, use um dos seguintes métodos:
Selecione a última linha da tabela e passe o cursor sobre o quadrado azul até que o ícone de adição apareça. Clique e arraste para baixo para adicionar o número desejado de linhas. As células das novas linhas são preenchidas com a fórmula apropriada para recuperar os valores da lista. Se houver dados correspondentes na base de dados, as células serão preenchidas.
Posicione o cursor na célula superior esquerda da planilha, clique em na barra de menus e selecione a lista apropriada. Na janela pop-up, indique o número de linhas/registros a serem inseridos e clique em Confirmar. Uma lista atualizada é inserida, substituindo a lista anterior.
Dica
Os métodos acima também podem ser usados para adicionar linhas em branco adicionais a uma tabela de planilha. Isso pode ser útil para listas em que é provável que registros adicionais sejam gerados na base de dados, por exemplo, novas categorias de produtos ou novos vendedores.
Adicionar, ocultar, excluir ou renomear colunas¶
Para adicionar colunas a uma lista estática:
Selecione a coluna à direita ou à esquerda de onde a nova coluna deve ser inserida.
Clique em e depois ou na barra de menu, ou clique com o botão direito e selecione Inserir coluna à esquerda ou Inserir coluna à direita conforme apropriado.
Copie a célula de cabeçalho de qualquer coluna, cole-a na célula de cabeçalho da nova coluna e pressione
Enter.Dê um clique duplo na nova célula de cabeçalho e, em seguida, selecione e exclua o nome do campo exibido entre o primeiro conjunto de aspas; uma lista com todos os nomes técnicos dos campos do modelo relacionado é exibida.
Selecione o campo apropriado na lista.
Dica
Passe o cursor sobre o nome técnico de um campo para revelar seu rótulo.
Para adicionar um campo relacionado, clique em (seta para a direita) na linha de um campo para acessar a lista de campos relacionados. Selecione o campo apropriado ou digite
.e, em seguida, digite o nome técnico do campo. Por exemplo, para exibir uma coluna com o país do cliente em uma lista do modelo Pedido de venda, use o campo relacionadopartner_id.countryselecionando Cliente e depois País.
Edite o rótulo do campo, se desejar.
Selecione a célula de cabeçalho e dê um clique duplo no quadrado azul no canto inferior direito da célula. As células da coluna são preenchidas com a fórmula apropriada para recuperar os valores da lista. Se houver dados correspondentes no banco de dados, as células serão preenchidas.
Para ocultar uma coluna em uma lista estática, clique com o botão direito do mouse no cabeçalho de letra da coluna e clique em Ocultar coluna. Para reexibir uma coluna, clique em ou (circunflexo para esquerda ou direita) no cabeçalho em qualquer um dos lados da(s) coluna(s) oculta(s).
Para excluir uma coluna em uma lista estática, clique com o botão direito do mouse no cabeçalho de letra da coluna e clique em Excluir coluna.
Para renomear uma coluna em uma lista estática, dê um clique duplo na célula de cabeçalho e edite o rótulo do campo exibido entre o segundo conjunto de aspas. Para reverter para o rótulo padrão do campo no Odoo, remova o rótulo do campo completamente.
Manipular uma lista dinâmica¶
Determinar o número de linhas/registros exibidos¶
Por padrão, quando uma lista do Odoo é inserida diretamente de uma planilha ou quando uma lista é duplicada por meio das propriedades da lista, no máximo 80 registros são inseridos.
Nota
O número total de registros no modelo é exibido abaixo de Modelo nas propriedades da lista.
Para modificar o número de linhas/registros exibidos, dê um clique duplo na célula superior esquerda da tabela e, em seguida:
altere o segundo valor entre colchetes, ou seja, a contagem de linhas, para o número desejado; ou
remova o valor de contagem de linhas para exibir todos os registros e permitir que a lista se expanda para acomodar novos registros.
Adicionar, ocultar ou excluir colunas em uma lista dinâmica¶
Para adicionar colunas a uma lista do Odoo inserida:
Abra o painel de propriedades da lista.
Na seção Colunas, clique em Adicionar.
Selecione o campo apropriado.
Renomeie a coluna se desejar, clicando no cartão da coluna e digitando o novo nome.
Para ocultar ou reexibir uma coluna, clique no ícone (ocultar) ou (reexibir) no cartão da coluna.
Para excluir uma coluna, clique no ícone (excluir) no cartão da coluna.
Duplicar ou excluir uma lista inserida¶
Nota
Ao duplicar ou excluir uma lista inserida, é importante lembrar que cada lista também possui uma fonte de dados.
Duplicar uma lista inserida¶
Duplicar uma lista inserida por meio das propriedades da lista cria uma fonte de dados adicional. Isso permite que diferentes manipulações sejam realizadas nos mesmos dados dentro de uma planilha.
Para duplicar uma lista inserida:
Com o painel de propriedades aberto, clique no ícone (engrenagem) ao lado de Nome da lista e depois em Duplicar. A lista duplicada é inserida automaticamente em uma nova aba da planilha, com as propriedades da lista abertas no painel direito.
Edite o Nome da lista no painel de propriedades e na aba da planilha, se desejar.
A nova fonte de dados recebe o próximo ID de lista disponível. Por exemplo, se nenhuma outra lista tiver sido inserida nesse meio tempo, duplicar a Lista nº 1 resulta na criação da Lista nº 2.
Nota
Duplicar uma lista inserida copiando e colando-a ou duplicando a aba em que ela foi inserida não cria uma nova fonte de dados. Quaisquer alterações feitas nas propriedades dessa lista afetarão, portanto, todas as cópias da lista.
Duplicar uma:
lista estática resulta na inserção da lista dinâmica padrão para esse modelo, ou seja, com colunas padrão e um máximo de 80 registros;
lista dinâmica resulta na inserção de uma lista com as mesmas colunas da lista original e um máximo de 80 registros, mesmo que a lista original tenha sido modificada para ter um limite diferente ou nenhum limite.
Excluir uma lista inserida¶
Para excluir totalmente uma lista inserida e a fonte de dados subjacente de uma planilha, execute as seguintes etapas em qualquer ordem:
Exclua a tabela da planilha que contém a lista usando o método de sua preferência, por exemplo, por meio de comandos de teclado, menus da planilha ou excluindo a aba. Isso exclui a representação visual dos dados.
No painel de propriedades da lista, clique no ícone (engrenagem) e depois em Excluir. Isso exclui a fonte de dados da lista da planilha.
Dica
Como alternativa, após excluir uma lista inserida de uma planilha, use a ferramenta Limpeza de dados para excluir a fonte de dados correspondente.