Excel-gegevens integreren in PowerPoint-presentaties

Inleiding

PowerPoint‑presentaties zijn een krachtige manier om informatie weer te geven en te communiceren. Ze worden vaak gebruikt in combinatie met Excel‑werkboeken, waarbij Excel een uitstekende bron van gestructureerde gegevens biedt en PowerPoint uitblinkt in het visualiseren van die gegevens voor een publiek.

Er zijn veel praktische scenario’s waarbij het combineren van Excel en PowerPoint essentieel is: mail merges, het vullen van datatabellen, het genereren van één dia per gegevensrecord (batch‑dia‑generatie), het maken van trainingsmateriaal en het consolideren van meerdere Excel‑rapporten in één presentatie, om er maar een paar te noemen.

Tot nu toe vergde het implementeren van dergelijke functies met de Aspose.Slides‑API het vertrouwen op oplossingen van derden zoals Aspose.Cells. Hoewel deze tools robuust zijn, kunnen ze te complex en kostbaar zijn voor gebruikers die alleen basisgegevensintegratiefunctionaliteit nodig hebben.

Hoe het werkt

Om het werken met Excel‑gegevens gemakkelijker en gestroomlijnder te maken, heeft Aspose.Slides nieuwe klassen geïntroduceerd voor het lezen van gegevens uit Excel‑werkboeken en het importeren van inhoud in een presentatie. Deze functie biedt krachtige nieuwe mogelijkheden voor API‑gebruikers die Excel willen gebruiken als gegevensbron binnen hun presentatieworkflows.

De nieuwe functionaliteit is ontworpen voor algemeen data‑toegang en is niet geïntegreerd in het Presentation Document Object Model (DOM). Dat betekent dat het geen bewerken of opslaan van Excel‑bestanden toestaat — het enige doel is werkboeken te openen en door hun inhoud te navigeren om celgegevens op te halen.

In de kern van deze functie bevindt zich de nieuwe klasse ExcelDataWorkbook. Deze klasse stelt je in staat een Excel‑werkboek te laden vanaf een lokaal bestand of een stroom. Eenmaal geladen biedt het verschillende overloads van de methode getCell waarmee je specifieke cellen kunt ophalen op basis van hun positie (bijv. rij‑ en kolomindexen of benoemde bereiken).

Elke oproep aan getCell retourneert een instantie van de klasse ExcelDataCell. Dit object vertegenwoordigt een enkele cel in het Excel‑werkboek en geeft je toegang tot de waarde ervan op een eenvoudige en intuïtieve manier.

Een Excel‑grafiek importeren

De volgende stap om de functionaliteit uit te breiden is de klasse ExcelWorkbookImporter. Deze hulpprogrammaklasse biedt functionaliteit om inhoud uit een Excel‑werkboek in een presentatie te importeren. Het bevat verschillende overloads van de methode addChartFromWorkbook die je helpen de geselecteerde grafiek uit het opgegeven Excel‑werkboek op te halen en toe te voegen aan het einde van de opgegeven shape‑collectie op de gespecificeerde coördinaten.

Kortom, het is een lichte en eenvoudige API voor het lezen van Excel‑gegevens — precies wat veel ontwikkelaars nodig hebben zonder de overhead van een volledige spreadsheet‑verwerkingsbibliotheek.

Laten we coderen

Voorbeeld van Mail‑Merge‑scenario

In het volgende voorbeeld implementeren we een eenvoudig Mail‑Merge‑scenario door meerdere presentaties te genereren op basis van gegevens die opgeslagen zijn in een Excel‑werkboek.

Om te beginnen hebben we twee dingen nodig:

1. Een Excel‑werkboek dat de gegevens bevat

2. PowerPoint‑presentatiesjabloon

// Laad het Excel-werkboek met personeelsgegevens.
ExcelDataWorkbook workbook = new ExcelDataWorkbook("TemplateData.xlsx");
int worksheetIndex = 0;

// Laad de presentatiesjabloon.
Presentation templatePresentation = new Presentation("PresentationTemplate.pptx");

try {
    // Doorloop de Excel-rijen (exclusief de header op rij 0).
    for (int rowIndex = 1; rowIndex <= 4; rowIndex++) {

        // Maak een nieuwe presentatie voor elk personeelsrecord.
        Presentation employeePresentation = new Presentation();

        try {
            // Verwijder de standaard lege dia.
            employeePresentation.getSlides().removeAt(0);

            // Kloon de sjabloondia naar de nieuwe presentatie.
            ISlide slide = employeePresentation.getSlides().addClone(templatePresentation.getSlides().get_Item(0));

            // Haal alinea's op van de doelvorm (gaat er vanuit dat vormindex 1 wordt gebruikt).
            IParagraphCollection paragraphs = ((IAutoShape)slide.getShapes().get_Item(1)).getTextFrame().getParagraphs();

            // Vervang de tijdelijke aanduidingen door gegevens uit Excel.
            String employeeName = workbook.getCell(worksheetIndex, rowIndex, 0).getValue().toString();
            IPortion namePortion = paragraphs.get_Item(0).getPortions().get_Item(0);
            namePortion.setText(namePortion.getText().replace("{{EmployeeName}}", employeeName));

            String department = workbook.getCell(worksheetIndex, rowIndex, 1).getValue().toString();
            IPortion departmentPortion = paragraphs.get_Item(1).getPortions().get_Item(0);
            departmentPortion.setText(departmentPortion.getText().replace("{{Department}}", department));

            String yearsOfService = workbook.getCell(worksheetIndex, rowIndex, 2).getValue().toString();
            IPortion yearsPortion = paragraphs.get_Item(2).getPortions().get_Item(0);
            yearsPortion.setText(yearsPortion.getText().replace("{{YearsOfService}}", yearsOfService));

            // Sla de gepersonaliseerde presentatie op naar een apart bestand.
            employeePresentation.save(String.format("%s Report.pptx", employeeName), SaveFormat.Pptx);
        } finally {
            employeePresentation.dispose();
        }
    }
} finally {
    templatePresentation.dispose();
}

Voorbeeld van Excel‑tabel

In het tweede voorbeeld kopiëren we eenvoudig gegevens uit een Excel‑tabel en tonen we deze op een PowerPoint‑dia in een visueel aantrekkelijker formaat.

In dit voorbeeld hergebruiken we hetzelfde Excel‑werkboek als in het eerste voorbeeld, dat een eenvoudige personeels‑tabel bevat.

// Laad het Excel-werkboek met de personeelsgegevens.
ExcelDataWorkbook workbook = new ExcelDataWorkbook("TemplateData.xlsx");
int worksheetIndex = 0;

// Maak een nieuwe PowerPoint-presentatie.
Presentation presentation = new Presentation();

try {
    // Voeg een tabelvorm toe aan de eerste dia.
    ITable table = presentation.getSlides().get_Item(0).getShapes().addTable(
            50, 200,
            new double[]{200, 200, 200},
            new double[]{30, 30, 30, 30, 30}
    );

    // Vul de PowerPoint-tabel met gegevens uit het Excel-werkboek.
    for (int rowIndex = 0; rowIndex < 5; rowIndex++) {
        for (int columnIndex = 0; columnIndex < 3; columnIndex++) {
            String cellValue = workbook.getCell(worksheetIndex, rowIndex, columnIndex).getValue().toString();
            table.getColumns().get_Item(columnIndex).get_Item(rowIndex).getTextFrame().setText(cellValue);
        }
    }

    // Sla de gemaakte presentatie op in een bestand.
    presentation.save("Table.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Voorbeeld van een Excel‑grafiek importeren

In dit voorbeeld importeren we een grafiek van het eerste werkblad van het Excel‑werkboek dat in het vorige voorbeeld werd gebruikt. De grafiek zal in de resulterende presentatie naar het externe werkboek linken.

Eerst voegen we een cirkelgrafiek toe aan het Excel‑werkboek op basis van de personeels‑tabel.

// Maak een nieuwe PowerPoint-presentatie.
Presentation presentation = new Presentation();
try {
    // Haal de vormverzameling op van de eerste dia.
    IShapeCollection shapes = presentation.getSlides().get_Item(0).getShapes();

    // Importeer de grafiek met de naam "Chart 1" van het eerste blad van het werkboek en voeg deze toe aan de vormverzameling.
    ExcelWorkbookImporter.addChartFromWorkbook(shapes, 10, 10, "TemplateData.xlsx", "Sheet1", "Chart 1", false);

    // Sla de resulterende presentatie op in een bestand.
    presentation.save("Chart.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Voorbeeld van alle Excel‑grafieken importeren

Stel je voor dat je een Excel‑werkboek vol grafieken hebt en je moet ze allemaal importeren in een presentatie. Elke grafiek moet op een nieuwe dia worden geplaatst.

De volgende code doorloopt alle werkbladen in het bron‑Excel‑bestand, haalt de grafieken uit elk werkblad op en voegt elke grafiek toe aan een aparte dia met behulp van een lege dia‑lay-out. In de resulterende presentatie wordt alleen de grafiek‑data ingebed, niet het volledige werkboek.

// Laad het Excel-werkboek met de personeelsgegevens.
ExcelDataWorkbook workbook = new ExcelDataWorkbook("ExcelWithCharts.xlsx");

// Maak een nieuwe PowerPoint-presentatie.
Presentation presentation = new Presentation();
try {
    // Haal de lege dia-indeling op.
    ILayoutSlide blankLayout = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);

    // Haal de namen op van alle werkbladen die in het Excel-werkboek staan.
    List<String> worksheetNames = workbook.getWorksheetNames();

    for (String name : worksheetNames) {
        // Haal een map op die grafiekindices naar grafieknamen koppelt voor het werkblad.
        Dictionary<Integer, String> worksheetCharts = workbook.getChartsFromWorksheet(name);

        for (KeyValuePair<Integer, String> chart : worksheetCharts) {
            // Voeg een nieuwe dia toe met de lege indeling.
            ISlide slide = presentation.getSlides().addEmptySlide(blankLayout);

            // Importeer de opgegeven grafiek uit het Excel-werkboek in de vormverzameling van de dia.
            ExcelWorkbookImporter.addChartFromWorkbook(
                    slide.getShapes(), 10, 10, workbook, name, chart.getKey(), false);
        }
    }

    // Sla de resulterende presentatie op in een bestand.
    presentation.save("Charts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Samenvatting

Dit mechanisme, direct beschikbaar in Aspose.Slides, combineert het werken met Excel‑gegevens en presentaties op één plek. Het stelt je in staat dia’s te maken met visuele grafieken en gegevens gepresenteerd als Excel‑tabellen — zonder extra bibliotheken of complexe integraties.