Python üzerinden Java ile Sunum Bilgilerini Al ve Güncelle
Genel Bakış
Aspose.Slides, bir sunumun formatını belirleyebilir ve tam bir sunum nesne modelini oluşturmadan belge meta verilerini okuyabilir. Bu, dosyaları sınıflandırmanız, bir envanter oluşturmanız veya sunum içeriğini yükleyip işleme almaya karar vermeden önce özellikleri incelemeniz gerektiğinde yararlıdır.
Örnekler, Java üzerinden Python için Aspose.Slides ve uyumlu bir Java çalıştırma ortamı gerektirir. Her örnek, JVM zaten çalışmıyorsa onu başlatır. Örneklerde kullanılan yollarla mevcut sunum dosyalarını sağlayın.
Bu makale, PresentationFactory ve PresentationInfo aracılığıyla hafif denetimi ve DocumentProperties üzerinden hedefli güncellemeleri göstermektedir.
Sunum Formatını Kontrol Et
Yüklenmiş bir sunumunuz 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 bölümüne bakın.
PresentationFactory.getPresentationInfo kullanarak bir dosyayı Presentation örneği oluşturmadan inceleyebilirsiniz. PresentationInfo.getLoadFormat yöntemi, PPTX, PPT veya ODP gibi tespit edilen formatı raporlar.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import LoadFormat, PresentationFactory
file_names = ["pres.pptx", "pres.ppt", "pres.odp"]
for file_name in file_names:
presentation_info = PresentationFactory.getInstance().getPresentationInfo(file_name)
load_format = presentation_info.getLoadFormat()
format_name = f"Other ({load_format})"
if load_format == LoadFormat.Pptx:
format_name = "PPTX"
elif load_format == LoadFormat.Ppt:
format_name = "PPT"
elif load_format == LoadFormat.Odp:
format_name = "ODP"
print(f"{file_name}: {format_name}")
Hafif Bir Sunum Envanteri Oluştur
Birçok sunum dosyasını işlerken, doğrulama, indeksleme veya bir belge yönetim sistemi için kompakt bir envantere ihtiyaç duyabilirsiniz. Bu senaryoda, bir PresentationInfo nesnesi elde etmek için PresentationFactory.getPresentationInfo kullanın ve ardından belge meta verilerini okumak için PresentationInfo.readDocumentProperties metodunu çağırın. Bu yaklaşım bir Presentation örneği oluşturmaz veya tam sunum nesne modelini dolaşmanızı gerektirmez.
DocumentProperties 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 slaytların sayısı. |
| getNotes | Not içeren slaytların sayısı. |
| getParagraphs | Mevcut olduğunda toplam paragraf sayısı. |
| getWords | Toplam kelime sayısı. |
| getMultimediaClips | Ses ve video kliplerin toplam sayısı. |
Aşağıdaki örnek, bir Presentation nesnesi oluşturmadan bu değerleri okur ve kompakt bir envanter yazdırır. Ayrıca, getHeadingPairs ile getTitlesOfParts kombinasyonunu kullanarak yazı tipleri, temalar ve slayt başlıkları gibi içerik gruplarını gösterir.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from pathlib import Path
from asposeslides.api import LoadFormat, PresentationFactory
file_path = "sample.pptx"
presentation_info = PresentationFactory.getInstance().getPresentationInfo(file_path)
document_properties = presentation_info.readDocumentProperties()
load_format = presentation_info.getLoadFormat()
format_name = f"Other ({load_format})"
if load_format == LoadFormat.Pptx:
format_name = "PPTX"
elif load_format == LoadFormat.Ppt:
format_name = "PPT"
elif load_format == LoadFormat.Odp:
format_name = "ODP"
print(f"File: {Path(file_path).name}")
print(f"Format: {format_name}")
print(f"Title: {document_properties.getTitle()}")
print(f"Author: {document_properties.getAuthor()}")
print("Statistics:")
print(f" Slides: {document_properties.getSlides()}")
print(f" Hidden slides: {document_properties.getHiddenSlides()}")
print(f" Slides with notes: {document_properties.getNotes()}")
print(f" Paragraphs: {document_properties.getParagraphs()}")
print(f" Words: {document_properties.getWords()}")
print(f" Multimedia clips: {document_properties.getMultimediaClips()}")
heading_pairs = document_properties.getHeadingPairs()
titles_of_parts = document_properties.getTitlesOfParts()
heading_pairs = heading_pairs if heading_pairs is not None else []
titles_of_parts = titles_of_parts if titles_of_parts is not None else []
part_index = 0
if len(heading_pairs) == 0 or len(titles_of_parts) == 0:
print("Content groups: not available")
else:
print("Content groups:")
for heading_pair in heading_pairs:
print(f" {heading_pair.getName()} ({heading_pair.getCount()})")
for part_offset in range(heading_pair.getCount()):
if part_index >= len(titles_of_parts):
break
print(f" - {titles_of_parts[part_index]}")
part_index += 1
if part_index < len(titles_of_parts):
print(" Other parts:")
while part_index < len(titles_of_parts):
print(f" - {titles_of_parts[part_index]}")
part_index += 1
Her bir HeadingPair bir grup adı ve o gruptaki öğe sayısını sağlar. DocumentProperties.getTitlesOfParts düz, sıralı bir dizi döndürür; bu yüzden her başlık çiftinin belirttiği ardışık başlık sayısını tüketin.
Depolanmış Meta Veriler ve Biçim Sınırlamaları
PresentationInfo.readDocumentProperties tarafından döndürülen envanter özellikleri, kaynak belgede mevcut meta verileri yansıtır. Aspose.Slides, bu çağrı için bu değerleri yeniden hesaplamak amacıyla sunum nesne modelini yüklemez ve dolaşmaz. Eksik özellikler varsayılan değerlerle temsil edilir ve saklanan değerler, dosyayı son kaydeden uygulama belge özelliklerini güncellememişse eski olabilir.
- PPTX: Biçim, slayt, not, gizli slayt, paragraf, kelime ve multimedya sayıları ile başlık çiftleri ve parça başlıkları için genişletilmiş belge özellikleri sağlar. Kullanılabilirlik, belge üreticisinin yazdığı özelliklere bağlıdır.
- PPT: İkili biçim, karşılık gelen belge‑özet özelliklerini depolayabilir. Bir özellik yoksa veya belge üreticisi tarafından güncellenmemişse, Aspose.Slides bu özelliği saklanan veya varsayılan değeriyle döndürür, slaytlardan hesaplamaz.
- ODP: OpenDocument meta verileri, sayfa, paragraf ve kelime sayısı gibi genel belge istatistikleri sağlar, ancak bu değerler her PowerPoint‑özel genişletilmiş özelliğe eşlenmez. Gizli‑slayt, not‑slayt, multimedya, başlık‑çifti ve parça‑başlığı meta verileri mevcut olmayabilir ve envanter özellikleri varsayılan değer döndürebilir. Sıfır değerini veya boş diziyi, ilgili içeriğin bulunmadığının kesin kanıtı olarak değerlendirmeyin.
Envanterler ve ön kontrol için hafif meta veri yaklaşımını kullanın. Sonuç bellekteki değişiklikleri yansıtmalıysa veya gerçek sunum içeriğini doğrulamanız gerekiyorsa, sunumu yükleyin ve canlı nesne modelini inceleyin.
Sunum Özelliklerini Güncelle
PresentationInfo.readDocumentProperties tarafından döndürülen özellikler, bir Presentation örneği oluşturmadan da değiştirilebilir. Değişiklikleri PresentationInfo.updateDocumentProperties ile uygulayın ve ardından bağlı sunumu PresentationInfo.writeBindedPresentation ile yazın.
Aşağıdaki resim, orijinal belge özelliklerini gösterir.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import PresentationFactory
from java.io import FileOutputStream
from java.util import Date
source_file = "sample.pptx"
output_file = "sample_with_updated_properties.pptx"
presentation_info = PresentationFactory.getInstance().getPresentationInfo(source_file)
document_properties = presentation_info.readDocumentProperties()
document_properties.setTitle("Quarterly sales report")
last_saved_time = Date()
document_properties.setLastSavedTime(last_saved_time)
presentation_info.updateDocumentProperties(document_properties)
output_stream = FileOutputStream(output_file)
try:
presentation_info.writeBindedPresentation(output_stream)
finally:
output_stream.close()
Aşağıdaki resim, güncellenmiş belge özelliklerini gösterir.
Faydalı Bağlantılar
İlgili güvenlik kontrolleri ve koruma ayarları için aşağıdaki makalelere bakın:
SSS
Yazı tiplerinin 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 FontsManager.getEmbeddedFonts ve sunumda kullanılan yazı tiplerini elde etmek için FontsManager.getFonts çağırın. İki sonucu karşılaştırarak, görüntüleme için gerekli ancak gömülmemiş yazı tiplerini bulun.
Dosyanın gizli slaytları olup olmadığını ve sayısını nasıl hızlıca öğrenebilirim?
Depolanmış belge meta verileri yeterli olduğunda, DocumentProperties.getHiddenSlides metodunu PresentationFactory.getPresentationInfo ve PresentationInfo.readDocumentProperties aracılığıyla okuyun. Bu, hafif bir envanter için uygundur. Sunum bellekte değiştirilmişse, depolanmış meta veriler eksik veya eski olabilir ya da canlı değerleri doğrulamanız gerekiyorsa, Presentation.getSlides içinde döngü yapın ve her slaytın Slide.getHidden yöntemini inceleyin.
Özel slayt boyutu ve yönlendirmesinin 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 SlideSize.getType, SlideSize.getSize ve SlideSize.getOrientation kullanın.
Grafiklerin harici veri kaynaklarına referans verip vermediğini hızlı bir şekilde görebilir miyim?
Evet. Her bir Chart öğesini bulun ve ChartData.getDataSourceType metodunu çağırın. Harici bir çalışma kitabı için, ChartData.getExternalWorkbookPath metodunu kullanın. Veri kaynağı türü ve yolu, harici bir referansı tanımlar, ancak hedefin erişilebilir olup olmadığını doğrulamak ayrı bir kaynak kontrolü gerektirir.
Render alma veya PDF dışa aktarma sırasında yavaşlamaya neden olabilecek ‘ağır’ slaytları nasıl değerlendirebilirim?
Tek bir karmaşıklık özelliği yoktur. Presentation.getSlides ve her slaytın BaseSlide.getShapes koleksiyonunu dolaşın. Şekil sayısını ve büyük görseller, efektler, animasyonlar veya multimedya varlığını tarama sinyali olarak kullanın ve bir slaytı kesin bir performans darboğazı olarak değerlendirmeden önce temsilci bir render veya dışa aktarma ölçümü yapın.