Fórmulas🔗

Definição. Expressão Groovy avaliada pelo Freeplane, escrita no texto de um nó ou no valor de um atributo, prefixada por =.

Onde funcionam🔗

Pôr a fórmula no atributo costuma ser melhor: o texto do nó continua legível e o valor calculado fica na tabela.

Objetos disponíveis🔗

Propriedades de node🔗

Conversões🔗

Atributos são texto. As conversões seguras:

Use num0. É a diferença entre uma soma que funciona e um NullPointerException no dia em que alguém deixar um campo em branco.

Padrões úteis🔗

// Soma dos filhos
=node.children.sum { it['custo'].num0 }

// Soma do ramo inteiro
=node.branch.sum { it['custo'].num0 }

// Contagem de descendentes
=node.branch.size() - 1

// Contagem por ícone
=node.branch.count { it.icons.icons.contains('button_ok') }

// Média
=node.children ? node.children.sum { it['nota'].num0 } / node.children.size() : 0

// Máximo
=node.children.collect { it['custo'].num0 }.max()

// Concatenação dos filhos
=node.children.collect { it.text }.join(', ')

// Percentual concluído
=def t = node.leaves.size()
 def d = node.leaves.count { it.icons.icons.contains('button_ok') }
 t ? "${(d*100/t).round()}%" : "—"

// Dias até um prazo
=((Date.parse('yyyy-MM-dd', node['prazo']) - new Date()) as int) + "d"

// Referência a outro nó pelo ID
=node.map.node('ID_1673829104')['valor'].num0

Recálculo🔗

Fórmulas são reavaliadas quando algo de que dependem muda. Ferramentas → Atualizar fórmulas força o recálculo de tudo.

Duas classes de problema:

• Ciclos — A depende de B que depende de A. Detectado e reportado.
• Dependências implícitas — new Date() não dispara recálculo ao virar o dia. Atualize à mão.

Erros comuns🔗

Segurança🔗

Fórmulas são código, e rodam ao abrir o mapa. Um .mm recebido de terceiros pode conter fórmulas com acesso a arquivos e rede, conforme as permissões que você concedeu.

Trate como trataria uma planilha com macros: as permissões de script devem ser as mínimas necessárias.

Referências🔗

1. Freeplane — Formulas
2. Freeplane — Scripting reference