Adicione comentários e altere as cores das células com a macro ONLYOFFICE

17 agosto 2023By Klaibson

Automatizar tarefas de planilha pode economizar muito tempo e esforço. E as macros do ONLYOFFICE oferecem uma ajuda ao permitir a execução de ações com base nas condições. Este artigo irá guiá-lo através da criação de uma macro que adiciona comentários e altera a cor da célula com base em seus valores.

Adicione comentários e altere as cores das células com a macro ONLYOFFICE

Construindo a macro

Primeiro, direcionamos a planilha atualmente ativa:

var oWorksheet = Api.GetActiveSheet();

Em seguida, direcionamos a seleção no documento:

var oRange = Api.GetSelection()

Depois disso, criamos um loop ForEach que percorre cada célula no intervalo selecionado e recupera os valores das células selecionadas:

oRange.ForEach(function (range) {
    var sValue = range.GetValue();
});

Esses valores são então comparados a um critério específico. Dependendo do resultado da comparação, um comentário é adicionado à célula usando o método AddComment(). Depois de adicionar o comentário, definimos a cor de preenchimento usando SetFillColor():

  if (sValue > 10000000) {
       range.AddComment("The value is bigger than 10000000.");
       range.SetFillColor(Api.CreateColorFromRGB(255, 213, 191))
    } 
else {
           range.AddComment("The value is less than 10000000.");
       range.SetFillColor(Api.CreateColorFromRGB(204, 255, 255))
    }
});

Aqui verificamos se o valor da célula ultrapassa um limite específico. Em caso afirmativo, adicionamos um comentário e ajustamos a cor da célula para um tom laranja claro (RGB: 255, 213, 191). Quando o valor estiver abaixo do limite, um comentário diferente é adicionado junto com a cor azul claro (RGB: 204, 255, 255).

Todo o código da macro é o seguinte:

(function()
{
    var oWorksheet = Api.GetActiveSheet();
var oRange = Api.GetSelection()
oRange.ForEach(function (range) {
    var sValue = range.GetValue();
    if (sValue > 10000000) {
       range.AddComment("The value is bigger than 10000000.");
       range.SetFillColor(Api.CreateColorFromRGB(255, 213, 191))
    } else {
           range.AddComment("The value is less than 10000000.");
       range.SetFillColor(Api.CreateColorFromRGB(204, 255, 255))
    }
});
})();

Agora, vamos rodar nossa macro e ver como funciona!

Esperamos que você ache esta macro uma ferramenta valiosa para simplificar suas tarefas de planilha. Ao usar as macros do ONLYOFFICE, você pode aumentar sua produtividade e mudar seu foco para outros aspectos essenciais do seu fluxo de trabalho.

Convidamos você a explorar o potencial da API do ONLYOFFICE e criar suas próprias macros. Se você tiver dúvidas ou ideias, sinta-se à vontade para comentar ou fale conosco. Estamos ansiosos para ouvir de você e animado para trabalhar juntos. Boa sorte em seus futuros empreendimentos!