Como trabalhar com fórmulas

Este tópico discute a classe Open XML SDK CellFormula e como ela se relaciona com o esquema SpreadsheetML do formato de arquivo Open XML. Para obter mais informações sobre a estrutura geral das partes e elementos que compõem um documento SpreadsheetML, consulte Estrutura de um documento SpreadsheetML (SDK do Open XML).

Fórmulas em SpreadsheetML

Você pode usar fórmulas para criar modelos computacionais. As fórmulas permitem o cálculo automático de valores com base nos dados dentro e fora da planilha ou na saída de outras células computadas na planilha.

As fórmulas são armazenadas dentro de cada célula que usa uma fórmula, no arquivo XML da planilha. Use o CellFormula elemento (<f/>>) para definir o texto da fórmula. As fórmulas podem conter expressões matemáticas que incluem uma ampla variedade de funções predefinidas.

O CellValue elemento (<v/>>) armazena o valor da fórmula em cache com base na última vez em que a fórmula foi calculada. Isso permite que o usuário adie o cálculo dos valores da fórmula quando a planilha for aberta, o que economiza tempo ao abrir uma planilha. Você não precisa especificar o valor e, se omiti-lo, é responsabilidade do leitor Open XML calcular o valor com base na definição da fórmula quando a planilha for aberta. Para obter mais informações sobre a CellValue classe, consulte CellValue.

As seguintes informações da especificação ISO/IEC 29500 introduzem o cellFormula elemento (<f/>>).

Uma fórmula SpreadsheetML é a representação sintática de uma série de cálculos que é analisada ou interpretada pelo aplicativo de planilha em uma função que calcula um valor ou uma matriz de valores com base em entradas de zero para muitos.

Uma fórmula é uma expressão que pode conter o seguinte: constantes, operadores, referências de célula, chamadas para funções e nomes.

Example: Considere a fórmula PI()*(A2^2). Nesse caso,

• PI() resulta em uma chamada para a função PI, que retorna o valor de π. - A referência de célula A2 retorna o valor dessa célula. - 2 é uma constante numérica. - O operador de acento circunflexo (^) eleva seu operando esquerdo à potência de seu operando direito. - Os parênteses, ( e ), são usados para agrupamento. - O operador asterisco (*) realiza a multiplicação de seus dois operandos.

Um operador é um símbolo que especifica o tipo de operação a ser executada em um ou mais operandos. Existem operadores aritméticos, de comparação, de texto e de referência.

Cada conjunto de células horizontais em uma planilha é uma linha e cada conjunto de células verticais é uma coluna. A combinação de linha e coluna de uma célula designa o local dessa célula.

Uma referência de célula designa uma ou mais células na mesma planilha. Usando referências, pode-se: - Usar dados contidos em diferentes partes da mesma planilha em uma única fórmula. - Use o valor de uma única célula em várias fórmulas. - Consulte células em outras planilhas na mesma pasta de trabalho e até mesmo em outras pastas de trabalho. (As referências a células em outras pastas de trabalho são chamadas de links.)

Uma função é uma fórmula nomeada que recebe zero ou mais argumentos, executa uma operação e, opcionalmente, retorna um resultado. Alguns exemplos de chamadas de função são: PI(), POWER(A1,B3) e SUM(C6:C10).

Há mais de 300 funções predefinidas definidas por esta especificação do Office Open XML. Funções definidas pelo usuário também são permitidas.

Um nome é um alias para uma constante, uma referência de célula ou uma fórmula. Um nome em uma fórmula pode facilitar a compreensão do propósito dessa fórmula. Por exemplo, a fórmula SOMA(VendasPrimeiro Trimestre) é mais fácil de identificar do que SOMA(C20:C30).

Cada expressão tem um tipo. As fórmulas SpreadsheetML são compatíveis com os seguintes tipos: matriz, erro, lógica, número e texto.

Um valor ou constante de matriz representa uma coleção de um ou mais elementos, cujos valores podem ter qualquer tipo (ou seja, os elementos de uma matriz não precisam ter todos o mesmo tipo).

© ISO/IEC 29500: 2016

Para obter mais informações sobre a sintaxe da fórmula, consulte a especificação ISO/IEC 29500.

Exemplo de SpreadsheetML

Este exemplo mostra o XML de um arquivo que contém uma fórmula, a função SOMA, na célula A6 da Planilha1. O XML a seguir define a planilha e está contido no arquivo "sheet1.xml".

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:mc="https://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="x14ac" xmlns:x14ac="https://schemas.microsoft.com/office/spreadsheetml/2009/9/ac">
        <dimension ref="A1:A6"/>
        <sheetViews>
            <sheetView tabSelected="1" workbookViewId="0">
                <selection activeCell="A7" sqref="A7"/>
            </sheetView>
        </sheetViews>
        <sheetFormatPr defaultRowHeight="15" x14ac:dyDescent="0.25"/>
        <sheetData>
            <row r="1" spans="1:1" x14ac:dyDescent="0.25">
                <c r="A1">
                    <v>1</v>
                </c>
            </row>
            <row r="2" spans="1:1" x14ac:dyDescent="0.25">
                <c r="A2">
                    <v>2</v>
                </c>
            </row>
            <row r="3" spans="1:1" x14ac:dyDescent="0.25">
                <c r="A3">
                    <v>3</v>
                </c>
            </row>
            <row r="4" spans="1:1" x14ac:dyDescent="0.25">
                <c r="A4">
                    <v>4</v>
                </c>
            </row>
            <row r="5" spans="1:1" x14ac:dyDescent="0.25">
                <c r="A5">
                    <v>5</v>
                </c>
            </row>
            <row r="6" spans="1:1" x14ac:dyDescent="0.25">
                <c r="A6">
                    <f>SUM(A1:A5)</f>
                    <v>15</v>
                </c>
            </row>
        </sheetData>
        <pageMargins left="0.7" right="0.7" top="0.75" bottom="0.75" header="0.3" footer="0.3"/>
    </worksheet>