Personalizar puntos de datos en gráficos Treemap y Sunburst usando PHP

Entre los demás tipos de gráficos de PowerPoint, existen dos tipos “jerárquicos”: el gráfico Treemap y el gráfico Sunburst (también conocido como Gráfico Sunburst, Diagrama Sunburst, Gráfico radial, Gráfico radial o Gráfico de pastel multilevel). Estos gráficos muestran datos jerárquicos organizados como un árbol, desde las hojas hasta la parte superior de la rama. Las hojas se definen por los puntos de datos de la serie, y cada nivel de agrupación anidado posterior se define por la categoría correspondiente. Aspose.Slides for PHP a través de Java permite dar formato a los puntos de datos del gráfico Sunburst y Treemap.

A continuación se muestra un gráfico Sunburst, donde los datos en la columna Series1 definen los nodos hoja, mientras que las demás columnas definen los puntos de datos jerárquicos:

Empecemos añadiendo un nuevo gráfico Sunburst a la presentación:

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Sunburst, 100, 100, 450, 400);
    # ...
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Ver también

• Creando gráfico Sunburst

Si es necesario dar formato a los puntos de datos del gráfico, debemos usar lo siguiente:

IChartDataPointLevelsManager, IChartDataPointLevel clases y el método IChartDataPoint.getDataPointLevels proporcionan acceso para dar formato a los puntos de datos de los gráficos Treemap y Sunburst. IChartDataPointLevelsManager se utiliza para acceder a categorías de varios niveles; representa el contenedor de objetos IChartDataPointLevel . Básicamente es un contenedor para IChartCategoryLevelsManager con propiedades añadidas específicas para los puntos de datos. La clase IChartDataPointLevel tiene dos métodos: getFormat y getDataLabel que proporcionan acceso a la configuración correspondiente.

Mostrar el valor de un punto de datos

Mostrar el valor del punto de datos “Leaf 4”:

  $dataPoints = $chart->getChartData()->getSeries()->get_Item(0)->getDataPoints();
  $dataPoints->get_Item(3)->getDataPointLevels()->get_Item(0)->getLabel()->getDataLabelFormat()->setShowValue(true);

Establecer etiqueta y color del punto de datos

Establecer la etiqueta de datos de “Branch 1” para que muestre el nombre de la serie (“Series1”) en lugar del nombre de la categoría. Luego establecer el color del texto a amarillo:

  $branch1Label = $dataPoints->get_Item(0)->getDataPointLevels()->get_Item(0)->getLabel();
  $branch1Label->getDataLabelFormat()->setShowCategoryName(false);
  $branch1Label->getDataLabelFormat()->setShowSeriesName(true);
  $branch1Label->getDataLabelFormat()->getTextFormat()->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
  $branch1Label->getDataLabelFormat()->getTextFormat()->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->YELLOW);

Establecer color de rama del punto de datos

Cambiar el color de la rama “Steam 4”:

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Sunburst, 100, 100, 450, 400);
    $dataPoints = $chart->getChartData()->getSeries()->get_Item(0)->getDataPoints();
    $stem4branch = $dataPoints->get_Item(9)->getDataPointLevels()->get_Item(1);
    $stem4branch->getFormat()->getFill()->setFillType(FillType::Solid);
    $stem4branch->getFormat()->getFill()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    $pres->save("pres.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Preguntas frecuentes

¿Puedo cambiar el orden (clasificación) de los segmentos en Sunburst/Treemap?

No. PowerPoint ordena los segmentos automáticamente (normalmente por valores descendentes, en sentido horario). Aspose.Slides refleja este comportamiento: no puedes cambiar el orden directamente; lo consigues preprocesando los datos.

¿Cómo afecta el tema de la presentación a los colores de los segmentos y etiquetas?

Los colores del gráfico heredan el theme/palette de la presentación a menos que establezcas explícitamente rellenos/fuentes. Para obtener resultados consistentes, fija rellenos sólidos y el formato de texto en los niveles necesarios.

¿Se conservarán los colores de rama personalizados y la configuración de etiquetas al exportar a PDF/PNG?

Sí. Al exportar la presentación, la configuración del gráfico (rellenos, etiquetas) se conserva en los formatos de salida porque Aspose.Slides renderiza aplicando el formato del gráfico.

¿Puedo calcular las coordenadas reales de una etiqueta/elemento para colocar una superposición personalizada sobre el gráfico?

Sí. Después de que se valida la disposición del gráfico, están disponibles los valores reales de x e y para los elementos (por ejemplo, una DataLabel), lo que ayuda a posicionar con precisión las superposiciones.