Android'de Sunum Özelliklerini Yönetme
Giriş
Aspose.Slides for Android via Java, yerleşik ve özel belge özelliklerini destekler. Bu özellikleri, yazar, başlık ve kullanıcı tanımlı değerler gibi sunum meta verilerini okumak ve güncellemek için kullanın.
Aspose.Slides, sunum belge özellikleriyle IDocumentProperties arayüzü üzerinden çalışmanıza olanak tanır. Bu arayüzün bir örneği, IPresentation.getDocumentProperties tarafından döndürülür. Aşağıdaki örnekler, bu özellikleri nasıl okuyacağınızı, değiştireceğinizi ve yöneteceğinizi gösterir.
Note
Aspose.Slides, sunumları kaydederken uygulama ve üretici meta verilerini yönetir; bu alanlar çıktıyı oluşturan yazılımı tanımlar.Sunum Özelliklerini Yönetme
Belge özellikleri, sunum içeriğiyle birlikte açıklayıcı bilgiler depolar. İki kategoriye ayrılırlar:
- Yerleşik özellikler standart meta verileri içerir, örneğin başlık, yazar ve belge istatistikleri.
- Özel özellikler kullanıcı tanımlı ad/değer çiftlerini saklar.
Aspose.Slides for Android via Java, her iki kategoriye erişim sağlar. PowerPoint’ta belge meta verilerini incelemek için File → Info → Properties → Advanced Properties seçeneğini seçin. İletişim kutusu bilgileri Summary, Statistics, Contents ve Custom gibi sekmelere gruplar. Kullanıcı tanımlı özellikleri yönetmek için Custom sekmesini kullanın.
Şifrelenmiş Bir Sunumdan Genel Özellikleri Okuma
Açma parolası genellikle hem sunum içeriğini hem de belge özelliklerini korur. Bir sunum, IProtectionManager.setEncryptDocumentProperties false ile çağrıldıktan sonra şifrelenirse, belge özellikleri genel kalır. Bir uygulama daha sonra LoadOptions.setOnlyLoadDocumentProperties true ile çağırarak açma parolasını vermeden genel meta verileri okuyabilir.
LoadOptions.setOnlyLoadDocumentProperties Aspose.Slides’ın neyi yükleyeceğini kontrol eder; hiçbir şeyi deşifre etmez. Özellikler şifreleme içinde dahil edilmişse, parola olmadan yükleme başarısız olur. Sunum şifrelenmemişse, seçenek yok sayılır ve tam sunum yüklenir.
Örnek, belge özellikleri genel bırakılmış bir şifreli sunum gerektirir. Yükleme modunu IProtectionManager.isOnlyDocumentPropertiesLoaded ile doğrular ve ardından IPresentation.getDocumentProperties aracılığıyla yerleşik özellikleri okur:
import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
LoadOptions loadOptions = new LoadOptions();
loadOptions.setOnlyLoadDocumentProperties(true);
Presentation presentation = new Presentation("public-properties-encrypted.pptx", loadOptions);
try {
if (presentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
IDocumentProperties documentProperties = presentation.getDocumentProperties();
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Title: " + documentProperties.getTitle());
System.out.println("Keywords: " + documentProperties.getKeywords());
} else {
System.out.println("The presentation was not loaded in document-properties-only mode.");
}
} finally {
presentation.dispose();
}
Bu modda, slayt içeriği yüklenmez. Slaytlar, ana slaytlar, yerleşimler, şekiller, medya ve diğer sunum nesneleri kullanılamaz. Uygulamalar, tam sunum nesne modelini gerektiren bir işlem gerçekleştirmeden önce her zaman IProtectionManager.isOnlyDocumentPropertiesLoaded kontrol etmelidir.
Warning
Genel meta veriler, yazar adları, başlıklar, konular, anahtar kelimeler, şirket bilgileri, yorumlar ve özel değerleri ortaya çıkarabilir. Hassas özellikleri sunumla birlikte şifreleyin. Bu özellikleri yalnızca indeksleme, sınıflandırma, arama veya belge yönetim sistemlerinin parolasız erişim gerektirdiği durumlarda genel bırakın.Şifrelenmiş Bir Sunumun Özelliklerini Güncelleme
Şifrelenmiş bir PPTX dosyası için, LoadOptions.setOnlyLoadDocumentProperties true ile çağrıldıktan sonra yüklenen sunum, genel meta verileri okumak için tasarlanmıştır. Aspose.Slides, bu yalnızca meta veri nesnesinden değiştirilen özellikleri kaydedemez çünkü genel özellikler şifreli sunumdaki ilgili verilerle tutarlı olmalıdır. Bu nedenle, güncelleme doğru açma parolasını ve tam bir yüklemeyi gerektirir.
Örnek, genel belge özelliklerine sahip şifreli bir PPTX sunumu ve bilinen bir açma parolası gerektirir. Sunumu, LoadOptions.setPassword ile tamamen açar, genel yerleşik özellikleri günceller ve sonucu kaydeder. Ardından IPresentationInfo.isEncrypted kullanarak şifrelemenin korunduğunu doğrular ve yeni değerleri kontrol etmek için genel meta verileri parolasız yeniden açar:
import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.PresentationFactory;
import com.aspose.slides.SaveFormat;
final String inputPath = "public-properties-encrypted.pptx";
final String outputPath = "updated-public-properties-encrypted.pptx";
LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("open_password");
Presentation presentation = new Presentation(inputPath, loadOptions);
try {
IDocumentProperties documentProperties = presentation.getDocumentProperties();
documentProperties.setTitle("Updated Product Roadmap");
documentProperties.setKeywords("roadmap, planning, indexed");
presentation.save(outputPath, SaveFormat.Pptx);
} finally {
presentation.dispose();
}
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(outputPath);
System.out.println("The presentation is encrypted: " + presentationInfo.isEncrypted());
LoadOptions metadataLoadOptions = new LoadOptions();
metadataLoadOptions.setOnlyLoadDocumentProperties(true);
Presentation metadataPresentation = new Presentation(outputPath, metadataLoadOptions);
try {
if (metadataPresentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
System.out.println("Title: " + metadataPresentation.getDocumentProperties().getTitle());
System.out.println("Keywords: " + metadataPresentation.getDocumentProperties().getKeywords());
} else {
System.out.println("The presentation was not loaded in document-properties-only mode.");
}
} finally {
metadataPresentation.dispose();
}
Bir uygulamanın sunum içeriğini deşifre etmesine veya yüklemesine izin verilmiyorsa, şifreli bir PPTX dosyasının genel özelliklerini yalnızca okunabilir olarak ele almalıdır.
Yerleşik Özelliklere Erişim
IDocumentProperties arayüzü, getAuthor , getTitle ve getCreatedTime gibi getter metodları aracılığıyla yerleşik meta verileri ortaya çıkarır. Bu örnek mevcut bir sunumu açar ve kaydedilmiş meta verilerini konsola yazdırır. Değerler giriş sunumuna bağlıdır; bazı alanlar boş olabilir.
import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
Presentation presentation = new Presentation("AccessBuiltInProperties.pptx");
try {
IDocumentProperties documentProperties = presentation.getDocumentProperties();
System.out.println("Category: " + documentProperties.getCategory());
System.out.println("Content status: " + documentProperties.getContentStatus());
System.out.println("Creation date: " + documentProperties.getCreatedTime());
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Comments: " + documentProperties.getComments());
System.out.println("Keywords: " + documentProperties.getKeywords());
System.out.println("Last modified by: " + documentProperties.getLastSavedBy());
System.out.println("Manager: " + documentProperties.getManager());
System.out.println("Modified date: " + documentProperties.getLastSavedTime());
System.out.println("Presentation format: " + documentProperties.getPresentationFormat());
System.out.println("Last print date: " + documentProperties.getLastPrinted());
System.out.println("Is shared between producers: " + documentProperties.getSharedDoc());
System.out.println("Subject: " + documentProperties.getSubject());
System.out.println("Title: " + documentProperties.getTitle());
} finally {
presentation.dispose();
}
Yerleşik Özellikleri Değiştirme
Yerleşik meta verileri güncellemek için, IPresentation.getDocumentProperties tarafından döndürülen nesnenin setter metodlarını kullanın. Bu örnek mevcut bir sunumu açar, setAuthor , setTitle , setSubject , setComments ve setManager metodlarını çağırır, ardından güncellenen sunumu Presentation.save ile kaydeder. Kaydedilen PPTX yeni meta verileri içerir.
import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
Presentation presentation = new Presentation("ModifyBuiltInProperties.pptx");
try {
IDocumentProperties documentProperties = presentation.getDocumentProperties();
documentProperties.setAuthor("Aspose.Slides for Android via Java");
documentProperties.setTitle("Manage PowerPoint Presentation Properties");
documentProperties.setSubject("Modify Built-in Properties");
documentProperties.setComments("Aspose description");
documentProperties.setManager("Aspose manager");
presentation.save("DocumentProperties_output.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Köprü Temelini Yönetme
IDocumentProperties.getHyperlinkBase , göreceli köprüler için belge düzeyinde temel adresi döndürür. IDocumentProperties.setHyperlinkBase ile bunu değiştirebilir veya temizleyebilirsiniz. Bu, bir sunumu ve bağlı dosyalarını başka bir konuma taşırken faydalıdır. Bu, tek bir köprünün IHyperlink.getExternalUrl metodundan ayrı bir özelliktir: temeli değiştirmek, saklanan köprü adreslerini yeniden yazmaz veya mutlak hedefleri değiştirmez.
Örnek, target.html gibi bir göreceli bağlantı ve https://example.org/absolute.html gibi bir mutlak bağlantı içeren bir sunum gerektirir. Mevcut temeli okur, yeni bir temel adresi atar ve değeri kontrol etmek için sunumu kaydedip yeniden açar. Ardından temeli boş bir dizeyle temizler ve ayrı bir kaydedilmiş dosyada boş değeri doğrular. Örnek temel adresini, bağlantılı dosyalarınızın konumuyla değiştirin.
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
Presentation presentation = new Presentation("hyperlinks.pptx");
try {
System.out.println("Original base: " + presentation.getDocumentProperties().getHyperlinkBase());
final String newBase = "https://example.com/new/";
presentation.getDocumentProperties().setHyperlinkBase(newBase);
presentation.save("hyperlinks-updated.pptx", SaveFormat.Pptx);
Presentation updatedPresentation = new Presentation("hyperlinks-updated.pptx");
try {
System.out.println("Base preserved: " + newBase.equals(updatedPresentation.getDocumentProperties().getHyperlinkBase()));
updatedPresentation.getDocumentProperties().setHyperlinkBase("");
updatedPresentation.save("hyperlinks-cleared.pptx", SaveFormat.Pptx);
Presentation clearedPresentation = new Presentation("hyperlinks-cleared.pptx");
try {
System.out.println("Base cleared: " + "".equals(clearedPresentation.getDocumentProperties().getHyperlinkBase()));
} finally {
clearedPresentation.dispose();
}
} finally {
updatedPresentation.dispose();
}
} finally {
presentation.dispose();
}
İki doğrulama mesajı true yazdırmalıdır. Temelin temizlenmesi, tek tek köprü adreslerini değiştirmez.
target.pptx adlı göreceli bir bağlantı, temel old klasörüne işaret ettiğinde old/target.pptx dosyasını açtı. Temel new klasörüne değiştirildikten, kaydedilip sunum yeniden açıldıktan sonra aynı bağlantı new/target.pptx dosyasını açtı. Mutlak bir bağlantı aynı dosyayı açmaya devam etti. Sunumu taşıdıktan veya temelini değiştirdikten önce ve sonra PowerPoint’te göreceli bağlantılarınızı test edin.
Özel Sunum Özellikleri Ekleme
Özel özellikler, karşılık gelen bir yerleşik alanı olmayan meta verileri depolar. IDocumentProperties.set_Item metodu, özellik adına göre bir değer atamanızı sağlar. Bu örnek bir sunum oluşturur, iki metin değeri ve bir tam sayı sürüm değeri ekler ve sunumu Presentation.save ile kaydeder. Mevcut bir ada değer atamak, o özelliğin değerini değiştirir.
import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
Presentation presentation = new Presentation();
try {
IDocumentProperties documentProperties = presentation.getDocumentProperties();
documentProperties.set_Item("Reviewed by", "John Smith");
documentProperties.set_Item("Confidentiality level", "Internal");
documentProperties.set_Item("Document version", 2);
presentation.save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Özel Özelliklere Erişim ve Değiştirme
Bu örnek, özel özellikler içeren bir sunumu açar ve getCountOfCustomProperties kullanarak bunlar üzerinde döner. getCustomPropertyName , sıfırdan başlayan bir indeks alır ve IDocumentProperties.set_Item tarafından kullanılan adı döndürür. Örnek, her özgün adı ve değeri yazdırır, ardından her değeri özgün türüne bakılmaksızın numaralı bir dizeyle değiştirir ve değişiklikleri kaydeder. Özel özellik yoksa, döngü hiçbir değişiklik yapmaz.
import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
Presentation presentation = new Presentation("AccessAndModifyProperties.pptx");
try {
IDocumentProperties documentProperties = presentation.getDocumentProperties();
for (int i = 0; i < documentProperties.getCountOfCustomProperties(); i++) {
String propertyName = documentProperties.getCustomPropertyName(i);
Object propertyValue = documentProperties.get_Item(propertyName);
System.out.println("Custom property name: " + propertyName);
System.out.println("Custom property value: " + propertyValue);
documentProperties.set_Item(propertyName, "New Value " + (i + 1));
}
presentation.save("CustomProperties_output.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Canlı Örnek
Try the PowerPoint Meta Verilerini Görüntüle ve Düzenle online app to see how to work with document properties using the Aspose.Slides API:
SSS
Bir sunumdan yerleşik bir özelliği nasıl kaldırabilirim?
Yerleşik özellikler sunumun ayrılmaz bir parçasıdır ve tamamen kaldırılamaz. Ancak, belirli özellik izin veriyorsa değerlerini değiştirebilir veya boş olarak ayarlayabilirsiniz.
Zaten var olan bir özel özellik eklersem ne olur?
Eğer zaten var olan bir özel özellik eklerseniz, mevcut değeri yeni değerle üzerine yazılır. Özelliği önceden kaldırmanıza veya kontrol etmenize gerek yoktur; Aspose.Slides otomatik olarak özelliğin değerini günceller.
Sunum tamamen yüklenmeden sunum özelliklerine erişebilir miyim?
Evet. PresentationFactory.getPresentationInfo ardından IPresentationInfo.readDocumentProperties kullanarak bir Presentation örneği oluşturmadan depolanmış belge meta verilerini okuyabilirsiniz. Tam raporlama örneği ve format‑spesifik sınırlamalar için Hafif Sunum Envanteri Oluşturma sayfasına bakın.
Şifreli bir sunumun genel özelliklerini açma parolası olmadan okuyabilir miyim?
Evet. Sunum, IProtectionManager.setEncryptDocumentProperties false ile şifrelenmiş olmalı ve LoadOptions.setOnlyLoadDocumentProperties true ile yüklendiğinde bu mümkün olur.
Belge‑özellikleri‑sadece modunda şifreli bir PPTX dosyasını güncelleyebilir miyim?
Hayır. Genel ve şifreli özellik verileri tutarlı olmalıdır, bu yüzden şifreli bir PPTX dosyasını güncellemek doğru açma parolasıyla tam sunumu yüklemeyi gerektirir.
