Capítulo 20 · 20.1
Mover automaticamente uma linha para uma folha de arquivo quando o estado é Klaar
Uma lista de encomendas, de tarefas ou de faturas cresce todas as semanas. O que está terminado não quer deitar fora, mas também já não o quer ver no meio do trabalho em curso. No Excel, muitas pessoas faziam isto com uma macro VBA ou com um script no Google Sheets: tudo o que tem o estado Klaar passa para uma folha Archief. No Euro-Office faz o mesmo com uma macro em JavaScript. Um clique e a lista volta a estar organizada.
Como exemplo, utilizamos a lista de encomendas da Bloemisterij Het Zonnetje, um cliente da WebOké. Na folha Orders encontram-se, nas colunas A a E, o número da encomenda, o cliente, a encomenda, o valor e o estado. Existe uma segunda folha Archief com os mesmos cabeçalhos de coluna.

Primeiro: a janela Macros
As macros estão ativas na sua WebOké Nextcloud; não precisa de ativar nada. Encontra-as na folha de cálculo e no documento de texto, no separador Ver, com o botão Macros. A janela tem, à esquerda, duas listas, Macros e Custom functions (consulte Fórmulas do Excel com LET ou LAMBDA: o que fazer em alternativa no Euro-Office), e à direita o código. Por cima do código encontram-se os botões Executar (o pequeno triângulo), Depurar, Copiar, Mudar nome, Eliminar e a caixa de verificação Início automático.
Uma macro pertence ao ficheiro em que é criada. É guardada no ficheiro xlsx e acompanha-o quando copia ou partilha o ficheiro.
Passo 1: a folha Archief
- Clique no sinal de mais, em baixo, para criar uma nova folha e dê-lhe exatamente o nome Archief (botão direito do rato sobre o separador, Mudar nome).
- Copie a linha de cabeçalho de Orders para a linha 1 de Archief. A macro começa a preencher a partir da linha 2.
Passo 2: criar a macro
- Volte à folha Orders. Isto é importante: a macro trabalha na folha que está aberta.
- No separador Ver, clique em Macros.
- Ao lado de Macros, clique no sinal de mais (1). Aparece uma macro vazia com algumas linhas de código.
- Clique em Mudar nome e dê à macro o nome Naar archief (2).
- Apague o código à direita e cole este código no seu lugar:
(function () {
// Mover as linhas com o estado Klaar para a folha Archief.
const bron = Api.GetActiveSheet();
const doel = Api.GetSheet("Archief");
if (!doel) { return; }
// Procurar a primeira linha vazia em Archief (coluna A).
let doelRij = 2;
while (doel.GetRange("A" + doelRij).GetValue() !== "") { doelRij++; }
// 1. De cima para baixo: copiar as linhas concluidas, pela ordem correta.
const laatste = bron.GetUsedRange().GetRowsCount();
const weg = [];
for (let r = 2; r <= laatste; r++) {
const status = String(bron.GetRange("E" + r).GetValue()).trim().toLowerCase();
if (status === "klaar") {
bron.GetRange("A" + r + ":E" + r).Copy(doel.GetRange("A" + doelRij));
doelRij++;
weg.push(r);
}
}
// 2. Eliminar de baixo para cima, para que os numeros das linhas se mantenham corretos.
for (let i = weg.length - 1; i >= 0; i--) {
bron.GetRows(weg[i]).Delete("up");
}
})();

Passo 3: executar e guardar
- Clique em Executar, o pequeno triângulo (3). A macro faz o seu trabalho de imediato; a janela permanece aberta.
- Clique em Guardar. Desta forma, guarda a macro no ficheiro. Se clicar em Cancelar, a macro desaparece, mas o que já fez mantém-se.


Como funciona o código
- Api.GetActiveSheet() é a folha que está aberta e Api.GetSheet("Archief") é o arquivo. Se essa folha não existir, a macro termina sem fazer nada.
- A linha while procura a primeira linha vazia em Archief. Assim, pode executar a macro novamente todas as semanas: as novas encomendas concluídas ficam por baixo das antigas.
- GetUsedRange().GetRowsCount() conta quantas linhas estão preenchidas.
- O estado é lido linha a linha. trim() remove os espaços e toLowerCase() converte o texto em minúsculas. Por isso, também "klaar" e "Klaar " com um espaço são contabilizados, como acontece no nosso exemplo com B-106 e B-108.
- Copy copia a linha incluindo a formatação, como o formato em euros do valor.
- Só no fim são eliminadas as linhas, de baixo para cima. Se eliminar primeiro a linha 2, tudo sobe uma posição e salta uma linha.
Adaptar à sua própria lista
- Outra coluna de estado: substitua o "E" em GetRange("E" + r) pela letra da sua coluna.
- Mais colunas: se a sua lista for até à coluna H, substitua ":E" por ":H".
- Outra palavra: substitua "klaar" por, por exemplo, "pago" ou "concluído", sempre em minúsculas.
- Outro arquivo: substitua "Archief" pelo nome da sua folha, exatamente como aparece no separador.
Dica: coloque na folha um botão que inicie esta macro; assim, os seus colegas nunca precisam de abrir a janela Macros. Consulte Um botão na sua folha de cálculo que inicia uma macro.
Armadilhas
- Teste primeiro numa cópia. Uma macro faz muita coisa de uma só vez. No nosso teste, Desfazer não reverteu a macro, nem mesmo depois de clicar duas vezes. Faça previamente uma cópia do ficheiro ou utilize o histórico de versões para voltar atrás (consulte Histórico da versão: restaurar uma versão anterior).
- A folha errada está aberta? Se executar a macro enquanto Archief está aberta, ela procura Klaar no arquivo. Nesse caso, não acontece nada ou acontece algo estranho. Vá sempre primeiro a Orders.
- A sua tabela não começa na linha 1? GetRowsCount conta a partir da primeira linha preenchida. Se houver um título e uma linha vazia por cima da sua tabela, some essas linhas a laatste.
- Fórmulas na linha? Copy copia também as fórmulas. Se uma fórmula fizer referência a outra linha de Orders, é possível que deixe de estar correta no arquivo.
- Várias pessoas no ficheiro? Deixe apenas uma pessoa executar a macro. Consulte também Utilizar macros com segurança: definições de macros, início automático para colegas e reutilização.
O que não é possível
- Mover automaticamente assim que alguém escolhe Klaar: em princípio, isso é possível com uma macro que reage a alterações (consulte Preencher automaticamente a data e a hora quando alguém altera uma célula), mas remover uma linha enquanto alguém ainda está a escrever é instável e propenso a erros. Um botão é mais fiável.
- Mover para outro ficheiro: uma macro só pode trabalhar no seu próprio ficheiro. Se pretender um arquivo por ano num ficheiro separado, copie manualmente a folha Archief no final do ano.
- Gravar em vez de programar: Record macro não regista as ações de copiar e colar. Por isso, esta macro tem mesmo de ser colada como código. Mais informações sobre a gravação em Converter manualmente uma macro VBA em JavaScript: a tabela de conversão.
