Java'da Sunum Bilgilerini Alın ve Güncelleyin

Bu sayfa ne hakkında

Java kullanarak PowerPoint ve OpenDocument sunumlarında slaytları, yapıyı ve üst verileri keşfedin; daha hızlı içgörüler ve daha akıllı içerik denetimleri için.

Genel Bakış

Aspose.Slides, bir sunumun biçimini tanımlayabilir ve tam bir sunum nesne modeli oluşturmadan belge üst verilerini okuyabilir. Bu, dosyaları sınıflandırmanız, bir envanter oluşturmanız veya sunum içeriğini yükleyip işlemeye karar vermeden önce özellikleri incelemeniz gerektiğinde faydalıdır.

Bu makale, hafif incelemeyi PresentationFactory ve IPresentationInfo aracılığıyla, ayrıca hedefli güncellemeleri IDocumentProperties üzerinden göstermektedir.

Sunum Biçimini Kontrol Et

Yüklenmiş bir sunumunuz zaten varsa, yükleme sonrası tespit ve eski PPT, PPS ve POT akışlarının sınırlamaları için Determine the Original Presentation Format sayfasına bakın.

PresentationFactory.getPresentationInfo kullanarak bir dosyayı Presentation örneği oluşturmayıp inceleyebilirsiniz. IPresentationInfo.getLoadFormat yöntemi, PPTX, PPT veya ODP gibi tespit edilen biçimi raporlar.

import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;

String[] fileNames = { "pres.pptx", "pres.ppt", "pres.odp" };

for (String fileName : fileNames) {
    IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(fileName);
    int loadFormat = presentationInfo.getLoadFormat();
    String formatName = "Other (" + loadFormat + ")";

    if (loadFormat == LoadFormat.Pptx) {
        formatName = "PPTX";
    } else if (loadFormat == LoadFormat.Ppt) {
        formatName = "PPT";
    } else if (loadFormat == LoadFormat.Odp) {
        formatName = "ODP";
    }

    System.out.println(fileName + ": " + formatName);
}

Hafif Bir Sunum Envanteri Oluştur

Birçok sunum dosyasını işlerken, doğrulama, indeksleme veya belge yönetim sistemi için kompakt bir envantere ihtiyaç duyabilirsiniz. Bu senaryoda, bir IPresentationInfo nesnesi elde etmek için PresentationFactory.getPresentationInfo kullanın ve ardından belge üst verilerini okumak için IPresentationInfo.readDocumentProperties çağırın. Bu yaklaşım, bir Presentation örneği oluşturmaz veya tam sunum nesne modelini dolaşmanızı gerektirmez.

IDocumentProperties tarafından sunulan genişletilmiş özellikler aşağıdaki envanter değerlerini sağlar:

Yöntem	Envanter değeri
getSlides	Toplam slayt sayısı.
getHiddenSlides	Gizli slayt sayısı.
getNotes	Not içeren slayt sayısı.
getParagraphs	Mevcut olduğunda toplam paragraf sayısı.
getWords	Toplam kelime sayısı.
getMultimediaClips	Toplam ses ve video klip sayısı.

Aşağıdaki örnek, bu değerleri bir Presentation nesnesi oluşturmadan okur ve kompakt bir envanter yazdırır. Ayrıca, yazı tipleri, temalar ve slayt başlıkları gibi içerik gruplarını göstermek için getHeadingPairs ile getTitlesOfParts birleştirir.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IHeadingPair;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;
import java.nio.file.Paths;

String filePath = "sample.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(filePath);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

int loadFormat = presentationInfo.getLoadFormat();
String formatName = "Other (" + loadFormat + ")";

if (loadFormat == LoadFormat.Pptx) {
    formatName = "PPTX";
} else if (loadFormat == LoadFormat.Ppt) {
    formatName = "PPT";
} else if (loadFormat == LoadFormat.Odp) {
    formatName = "ODP";
}

System.out.println("File: " + Paths.get(filePath).getFileName());
System.out.println("Format: " + formatName);
System.out.println("Title: " + documentProperties.getTitle());
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Statistics:");
System.out.println("  Slides: " + documentProperties.getSlides());
System.out.println("  Hidden slides: " + documentProperties.getHiddenSlides());
System.out.println("  Slides with notes: " + documentProperties.getNotes());
System.out.println("  Paragraphs: " + documentProperties.getParagraphs());
System.out.println("  Words: " + documentProperties.getWords());
System.out.println("  Multimedia clips: " + documentProperties.getMultimediaClips());

IHeadingPair[] headingPairs = documentProperties.getHeadingPairs();
String[] titlesOfParts = documentProperties.getTitlesOfParts();
headingPairs = headingPairs != null ? headingPairs : new IHeadingPair[0];
titlesOfParts = titlesOfParts != null ? titlesOfParts : new String[0];
int partIndex = 0;

if (headingPairs.length == 0 || titlesOfParts.length == 0) {
    System.out.println("Content groups: not available");
} else {
    System.out.println("Content groups:");

    for (IHeadingPair headingPair : headingPairs) {
        System.out.println("  " + headingPair.getName() + " (" + headingPair.getCount() + ")");

        for (int partOffset = 0; partOffset < headingPair.getCount() && partIndex < titlesOfParts.length; partOffset++) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.length) {
        System.out.println("  Other parts:");

        while (partIndex < titlesOfParts.length) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }
}

Her IHeadingPair bir grup adı ve o gruptaki öğe sayısını sağlar. IDocumentProperties.getTitlesOfParts düz, sıralı bir dizi döndürür, bu yüzden her başlık çiftinde belirtilen art arda gelen başlık sayısını tüketin.

Depolanmış Üst Veri ve Biçim Sınırlamaları

IPresentationInfo.readDocumentProperties tarafından döndürülen envanter özellikleri, kaynak belgede bulunan üst verileri yansıtır. Aspose.Slides bu çağrı için bu değerleri yeniden hesaplamak amacıyla sunum nesne modelini yükleyip dolaşmaz. Eksik özellikler varsayılan değerlerle temsil edilir ve saklanan değerler, dosyayı en son kaydeden uygulama belge özelliklerini güncellememişse eski olabilir.

PPTX: Biçim, slayt, not, gizli-slayt, paragraf, kelime ve multimedya sayımları için genişletilmiş belge özelliklerinin yanı sıra başlık çiftleri ve parça başlıkları sağlar. Kullanılabilirlik, belge üreticisi tarafından hangi özelliklerin yazıldığına bağlıdır.
PPT: İkili biçim, karşılık gelen belge özeti özelliklerini saklayabilir. Bir özellik eksikse veya belge üreticisi tarafından yenilenmemişse, Aspose.Slides bu değeri kaydedilen veya varsayılan değer olarak döndürür, slaytlardan hesaplamaz.
ODP: OpenDocument üst verileri, sayfa, paragraf ve kelime sayısı gibi genel belge istatistikleri sağlar, ancak bu değerler her PowerPoint‑spesifik genişletilmiş özelliğe eşlenmez. Gizli‑slayt, not‑slayt, multimedya, başlık‑çifti ve parça‑başlık üst verileri mevcut olmayabilir ve envanter özellikleri varsayılan değer döndürebilir. Sıfır değeri veya boş bir dizi, ilgili içeriğin yok olduğunun kesin kanıtı olarak görülmemelidir.

Envanter ve ön kontrol için hafif üst veri yaklaşımını kullanın. Sonucun bellek içi değişiklikleri yansıtması gerektiğinde veya gerçek sunum içeriğini doğrulamanız gerektiğinde, sunumu yükleyip canlı nesne modelini inceleyin.

Sunum Özelliklerini Güncelle

IPresentationInfo.readDocumentProperties tarafından döndürülen özellikler, bir Presentation örneği oluşturmadan da değiştirilebilir. Değişiklikleri IPresentationInfo.updateDocumentProperties ile uygulayın ve ardından bağlı sunumu IPresentationInfo.writeBindedPresentation ile yazın.

Aşağıdaki görsel, belge özelliklerinin orijinal halini gösterir.

PowerPoint sunumunun orijinal belge özellikleri

Aşağıdaki örnek, başlığı ve en son kaydedilme zamanını değiştirir ve sonucu yeni bir dosyaya yazar:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.PresentationFactory;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;

String sourceFile = "sample.pptx";
String outputFile = "sample_with_updated_properties.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(sourceFile);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

documentProperties.setTitle("Quarterly sales report");
documentProperties.setLastSavedTime(new Date());

presentationInfo.updateDocumentProperties(documentProperties);
try (OutputStream outputStream = new FileOutputStream(outputFile)) {
    presentationInfo.writeBindedPresentation(outputStream);
}

Aşağıdaki görsel, güncellenmiş belge özelliklerini gösterir.

Değiştirilmiş belge özellikleri

Faydalı Bağlantılar

İlgili güvenlik kontrolleri ve koruma ayarları için aşağıdaki makalelere bakın:

SSS

Sunıların gömülü olup olmadığını ve hangileri olduğunu nasıl kontrol edebilirim?

Sunumu yükleyin ve Presentation.getFontsManager kullanın. Gömülü yazı tiplerini elde etmek için IFontsManager.getEmbeddedFonts ve sunum tarafından kullanılan yazı tiplerini elde etmek için IFontsManager.getFonts çağırın. İki sonucu karşılaştırarak render için gerekli ancak gömülmemiş yazı tiplerini bulabilirsiniz.

Dosyanın gizli slaytları olup olmadığını ve kaç tanesi olduğunu nasıl hızlıca öğrenebilirim?

Depolanmış belge üst verileri yeterli olduğunda, PresentationFactory.getPresentationInfo ve IPresentationInfo.readDocumentProperties aracılığıyla IDocumentProperties.getHiddenSlides okuyun. Bu, hafif bir envanter için uygundur. Sunum bellek içinde değiştirildiyse, saklanan üst veri eksik veya eski olabilir; o zaman canlı değerleri doğrulamak için Presentation.getSlides üzerinden döngü yapıp her slaytın ISlide.getHidden yöntemini inceleyin.

Özel slayt boyutu ve yönünün kullanılıp kullanılmadığını ve varsayılanlardan farklı olup olmadığını tespit edebilir miyim?

Evet. Sunumu yükleyin ve Presentation.getSlideSize metodunu çağırın. Mevcut ayarları beklenen ön ayar ve boyutlarla karşılaştırmak için ISlideSize.getType, ISlideSize.getSize ve ISlideSize.getOrientation kullanın.

Grafiklerin dış veri kaynaklarına başvurup başvurmadığını hızlıca görmenin bir yolu var mı?

Evet. Her bir Chart bulun ve IChartData.getDataSourceType metodunu çağır. Dış bir çalışma kitabı için IChartData.getExternalWorkbookPath metodunu kullan. Veri kaynağı türü ve yol dış referansı gösterir, ancak hedefin mevcut olup olmadığını doğrulamak ayrı bir kaynak kontrolü gerektirir.

Render veya PDF dışa aktarmayı yavaşlatabilecek ‘ağır’ slaytları nasıl değerlendirebilirim?

Tek bir karmaşıklık özelliği yoktur. Presentation.getSlides ve her slaytın IBaseSlide.getShapes koleksiyonunu dolaşın. Şekil sayısı, büyük görseller, efektler, animasyonlar veya multimedya varlığı gibi göstergeleri kullanın ve temsili bir render ya da dışa aktarma ölçümü yaparak bir slaytı performans darboğazı olarak onaylamadan önce değerlendirin.

Java'da Sunumları Açma Java’da Orijinal Sunum Biçimini Belirleme