Aplicar fórmulas de hoja de cálculo de gráficos en presentaciones en Android

Acerca de las fórmulas de hoja de cálculo de gráficos en presentaciones

Hoja de cálculo del gráfico (o hoja de trabajo del gráfico) en una presentación es la fuente de datos del gráfico. La hoja de cálculo del gráfico contiene datos que se representan en el gráfico de forma visual. Cuando crea un gráfico en PowerPoint, la hoja de trabajo asociada a este gráfico se crea automáticamente también. La hoja de trabajo del gráfico se crea para todos los tipos de gráficos: gráfico de líneas, gráfico de barras, gráfico de explosión, gráfico circular, etc. Para ver la hoja de cálculo del gráfico en PowerPoint debe hacer doble clic en el gráfico:

todo:image_alt_text

La hoja de cálculo del gráfico contiene los nombres de los elementos del gráfico (Nombre de categoría: Category1, Nombre de serie) y una tabla con datos numéricos apropiados para esas categorías y series. Por defecto, cuando crea un nuevo gráfico, los datos de la hoja de cálculo del gráfico se establecen con datos predeterminados. Luego puede cambiar los datos de la hoja de cálculo en la hoja de trabajo manualmente.

Normalmente, el gráfico representa datos complejos (p. ej., analistas financieros, analistas científicos), con celdas que se calculan a partir de los valores de otras celdas o de otros datos dinámicos. Calcular el valor de una celda manualmente y codificarlo directamente en la celda dificulta su cambio futuro. Si cambia el valor de una celda determinada, todas las celdas que dependen de ella deberán actualizarse también. Además, los datos de la tabla pueden depender de datos de otras tablas, creando un esquema de datos de presentación complejo que necesita actualizarse de manera fácil y flexible.

Fórmula de hoja de cálculo del gráfico en una presentación es una expresión para calcular y actualizar automáticamente los datos de la hoja de cálculo del gráfico. La fórmula de hoja de cálculo define la lógica de cálculo de datos para una celda concreta o un conjunto de celdas. La fórmula de hoja de cálculo es una fórmula matemática o lógica, que utiliza: referencias a celdas, funciones matemáticas, operadores lógicos, operadores aritméticos, funciones de conversión, constantes de cadena, etc. La definición de la fórmula se escribe en una celda, y esa celda no contiene un valor simple. La fórmula de hoja de cálculo calcula el valor y lo devuelve, luego ese valor se asigna a la celda. Las fórmulas de hoja de cálculo del gráfico en presentaciones son en realidad las mismas que las fórmulas de Excel, y se admiten las mismas funciones, operadores y constantes predeterminados para su implementación.

En Aspose.Slides la hoja de cálculo del gráfico se representa con el método Chart.getChartData.getChartDataWorkbook del tipo IChartDataWorkbook. La fórmula de hoja de cálculo puede asignarse y modificarse con el método IChartDataCell.setFormula. La siguiente funcionalidad es compatible con las fórmulas en Aspose.Slides:

  • Constantes lógicas
  • Constantes numéricas
  • Constantes de cadena
  • Constantes de error
  • Operadores aritméticos
  • Operadores de comparación
  • Referencias a celdas estilo A1
  • Referencias a celdas estilo R1C1
  • Funciones predefinidas

Normalmente, las hojas de cálculo almacenan los últimos valores calculados de las fórmulas. Si después de cargar la presentación, los datos del gráfico no se cambiaron, el método IChartDataCell.getValue devuelve esos valores al leer. Pero, si los datos de la hoja se modificaron, al leer la propiedad ChartDataCell.Value se lanza la excepción CellUnsupportedDataException para las fórmulas no compatibles. Esto se debe a que cuando las fórmulas se analizan correctamente, se determinan las dependencias de las celdas y la validez de los últimos valores. Pero, si la fórmula no puede analizarse, no se puede garantizar la validez del valor de la celda.

Agregar una fórmula de hoja de cálculo de gráfico a una presentación

Primero, agregue un gráfico a la primera diapositiva de una nueva presentación con IShapeCollection.getShapes.addChart. La hoja de trabajo del gráfico se crea automáticamente y puede accederse con el método Chart.getChartData.getChartDataWorkbook:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 150, 150, 500, 300);

    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();

    // ...
} finally {
    if (pres != null) pres.dispose();
}

Escribamos algunos valores en celdas con la propiedad IChartDataCell.setValue del tipo Object, lo que significa que puede asignar cualquier valor a la propiedad:

workbook.getCell(0, "F2").setValue(-2.5);

workbook.getCell(0, "G3").setValue(6.3);

workbook.getCell(0, "H4").setValue(3);

Ahora, para escribir una fórmula en la celda, puede usar el método IChartDataCell.setFormula:

Nota: El método IChartDataCell.setFormula se usa para establecer referencias a celdas estilo A1.

Para establecer la referencia de celda R1C1Formula, puede usar el método IChartDataCell.setR1C1Formula:

Luego, si intenta leer los valores de las celdas B2 y C2, se calcularán:

Object value1 = cell1.getValue(); // 7.8

Object value2 = cell2.getValue(); // 2.1

Constantes lógicas

Puede usar constantes lógicas como FALSE y TRUE en las fórmulas de celda:

workbook.getCell(0, "A2").setValue(false);
IChartDataCell cell = workbook.getCell(0, "B2");
cell.setFormula("A2 = TRUE");
Object value = cell.getValue(); // el valor contiene el booleano "false"

Constantes numéricas

Los números pueden usarse en notación común o científica para crear una fórmula de hoja de cálculo de gráfico:

workbook.getCell(0, "A2").setFormula("1 + 0.5");
workbook.getCell(0, "B2").setFormula(".3 * 1E-2");

Constantes de cadena

Una constante de cadena (o literal) es un valor específico que se usa tal cual y no cambia. Las constantes de cadena pueden ser: fechas, textos, números, etc.:

workbook.getCell(0, "A2").setFormula("\"abc\"");
workbook.getCell(0, "B2").setFormula("\"2/3/2020 12:00\"");

Constantes de error

A veces no es posible calcular el resultado mediante la fórmula. En ese caso, se muestra el código de error en la celda en lugar de su valor. Cada tipo de error tiene un código específico:

  • #DIV/0! - la fórmula intenta dividir por cero.
  • #GETTING_DATA - puede mostrarse en una celda mientras su valor aún se está calculando.
  • #N/A - falta información o no está disponible. Algunas causas pueden ser: las celdas usadas en la fórmula están vacías, hay un carácter de espacio extra, error ortográfico, etc.
  • #NAME? - no se puede encontrar una cierta celda u otro objeto de fórmula por su nombre.
  • #NULL! - puede aparecer cuando hay un error en la fórmula, como: (,) o un carácter de espacio usado en lugar de dos puntos (:).
  • #NUM! - el número en la fórmula puede ser inválido, demasiado largo o demasiado pequeño, etc.
  • #REF! - referencia de celda no válida.
  • #VALUE! - tipo de valor inesperado. Por ejemplo, valor de cadena asignado a una celda numérica.
IChartDataCell cell = workbook.getCell(0, "A2");
cell.setFormula("2 / 0");
Object value = cell.getValue(); // el valor contiene la cadena "#DIV/0!"

Operadores aritméticos

Operador Significado Ejemplo
+ (plus sign) Suma o signo positivo unario 2 + 3
- (minus sign) Resta o negación 2 - 3
-3
* (asterisk) Multiplicación 2 * 3
/ (forward slash) División 2 / 3
% (percent sign) Porcentaje 30%
^ (caret) Exponenciación 2 ^ 3

Nota: Para cambiar el orden de evaluación, encierre entre paréntesis la parte de la fórmula que debe calcularse primero.

Operadores de comparación

Operador Significado Ejemplo
= (equal sign) Igual a A2 = 3
<> (not equal sign) Distinto de A2 <> 3
> (greater than sign) Mayor que A2 > 3
>= (greater than or equal to sign) Mayor o igual que A2 >= 3
< (less than sign) Menor que A2 < 3
<= (less than or equal to sign) Menor o igual que A2 <= 3

Referencias a celdas estilo A1

Las referencias a celdas estilo A1 se usan en las hojas de cálculo, donde la columna tiene un identificador de letra (p. ej., “A") y la fila tiene un identificador numérico (p. ej., “1"). Las referencias a celdas estilo A1 pueden usarse de la siguiente manera:

Referencia de celda Ejemplo
Absoluta Relativa Mixta
Celda $A$2 A2

A$2

$A2
Fila $2:$2 2:2 -
Columna $A:$A A:A -
Rango $A$2:$C$4 A2:C4

$A$2:C4

A$2:$C4

A continuación se muestra un ejemplo de cómo usar una referencia a celda estilo A1 en una fórmula:

workbook.getCell(0, "A2").setFormula("C3 + SUM(F2:H5)");

Referencias a celdas estilo R1C1

Las referencias a celdas estilo R1C1 se usan en las hojas de cálculo, donde tanto la fila como la columna tienen un identificador numérico. Las referencias a celdas estilo R1C1 pueden usarse de la siguiente manera:

Referencia de celda Ejemplo
Absoluta Relativa Mixta
Celda R2C3 R[2]C[3] R2C[3]
R[2]C3
Fila R2 R[2] -
Columna C3 C[3] -
Rango R2C3:R5C7 R[2]C[3]:R[5]C[7] R2C3:R[5]C[7]
R[2]C3:R5C[7]

A continuación se muestra un ejemplo de cómo usar una referencia a celda estilo R1C1 en una fórmula:

workbook.getCell(0, "A2").setR1C1Formula("R2C4 + SUM(R5C6:R7C9)");

Funciones predefinidas

Existen funciones predefinidas que pueden usarse en las fórmulas para simplificar su implementación. Estas funciones encapsulan las operaciones más usadas, como:

  • ABS
  • AVERAGE
  • CEILING
  • CHOOSE
  • CONCAT
  • CONCATENATE
  • DATE (1900 date system)
  • DAYS
  • FIND
  • FINDB
  • IF
  • INDEX (reference form)
  • LOOKUP (vector form)
  • MATCH (vector form)
  • MAX
  • SUM
  • VLOOKUP

Preguntas frecuentes

¿Se admiten archivos Excel externos como fuente de datos para un gráfico con fórmulas?

Sí. Aspose.Slides admite libros de trabajo externos como fuente de datos del gráfico, lo que le permite usar fórmulas de un XLSX fuera de la presentación.

¿Pueden las fórmulas del gráfico referenciar hojas dentro del mismo libro de trabajo por nombre de hoja?

Sí. Las fórmulas siguen el modelo de referencia estándar de Excel, por lo que puede referenciar otras hojas dentro del mismo libro de trabajo o un libro externo. Para referencias externas, incluya la ruta y el nombre del libro utilizando la sintaxis de Excel.

Formato de gráficos de presentación en Android Animar gráficos de PowerPoint en Android