JavaScript Kullanarak Sunumlarda Etiketleri ve Özel Verileri Yönetme

Genel Bakış

Bu makale, Aspose.Slides’in PowerPoint sunumlarındaki etiketler ve özel verilerle nasıl çalıştığını açıklar. PPTX dosyalarında verilerin nasıl depolandığını kısaca özetler, sunuma özgü verilerin etiketler ve özel XML bölümleri olarak bulunabileceğini belirtir ve etiketleri anahtar‑değer dize çiftleri olarak tanımlar.

Ayrıca etiket değerlerinin nasıl okunacağını ve bir sunuma, tek bir slayta veya bir şekle nasıl etiket ekleneceğini gösterir. Ek olarak, makale tüm etiketlerin temizlenmesi, bir etiketin adını kullanarak kaldırılması ve etiket adlarının listesinin alınması gibi yaygın etiket yönetimi görevlerini kapsar.

Sunum Dosyalarında Veri Depolama

PPTX dosyaları—.pptx uzantısına sahip öğeler—Office Open XML (OOXML) spesifikasyonunun bir parçası olan PresentationML formatında depolanır. Office Open XML formatı, sunumlarda bulunan verilerin yapısını tanımlar.

Slayt, sunumlardaki öğelerden biri olduğundan, bir slayt bölümü tek bir slaytın içeriğini barındırır. Bir slayt bölümü, ISO/IEC 29500 tarafından tanımlanan Kullanıcı Tanımlı Etiketler gibi birçok bölüme açık ilişkiler kurabilir.

Özel veri (bir sunuma özgü) veya kullanıcı, etiketler (TagCollection) ve CustomXmlParts (CustomXmlPartCollection) olarak bulunabilir.

Etiketler temelde anahtar‑değer dize çiftleridir.

Etiket Değerlerini Almak

Slaytlarda, bir etiket DocumentProperties.getKeywords() ve DocumentProperties.setKeywords() yöntemlerine karşılık gelir. Bu örnek kod, Aspose.Slides for Node.js via Java ile bir Presentation için etiket değerinin nasıl alınacağını gösterir:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var keywords = pres.getDocumentProperties().getKeywords();
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Sunumlara Etiket Ekleme

Aspose.Slides, sunumlara etiket eklemenize izin verir. Bir etiket genellikle iki öğeden oluşur:

• özel bir özelliğin adı - MyTag
• özel bir özelliğin değeri - My Tag Value

Belirli bir kural veya özelliğe göre bazı sunumları sınıflandırmanız gerekiyorsa, bu sunumlara etiket eklemek faydalı olabilir. Örneğin, Kuzey Amerika ülkelerinden gelen tüm sunumları bir araya getirmek isterseniz, bir Kuzey Amerika etiketi oluşturabilir ve ilgili ülkeleri (ABD, Meksika ve Kanada) değer olarak atayabilirsiniz.

Bu örnek kod, Aspose.Slides for Node.js via Java kullanarak bir Presentation içine etiket nasıl ekleyeceğinizi gösterir:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var tags = pres.getCustomData().getTags();
    pres.getCustomData().getTags().set_Item("MyTag", "My Tag Value");
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Etiketler ayrıca Slide için de ayarlanabilir:

var pres = new aspose.slides.Presentation();
try {
    var slide = pres.getSlides().get_Item(0);
    slide.getCustomData().getTags().set_Item("tag", "value");
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Veya herhangi bir bireysel Shape:

var pres = new aspose.slides.Presentation();
try {
    var slide = pres.getSlides().get_Item(0);
    var shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 10, 10, 100, 50);
    shape.getTextFrame().setText("My text");
    shape.getCustomData().getTags().set_Item("tag", "value");
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Sınırlamalar

getCustomData().getTags() kullanılarak özel veri etiket koleksiyonu aracılığıyla eklenen etiketler yalnızca PowerPoint dosyası içinde depolanır. Sunum PDF’ye dışa aktarıldığında bu etiketler PDF etiket yapısına aktarılmaz. Sonuç olarak, etiket olarak atanmış bir özel tanımlayıcı, etiketli PDF’den alınamaz.

Geçici Çözüm: Özel bir tanımlayıcıyı nesnenin Alt Metni içinde (örn., shape.setAlternativeText("MyId")) depolayabilirsiniz. PDF’ye dışa aktardıktan sonra Alt Metin PDF etiket yapısında görünebilir.

SSS

Bir sunum, slayt veya şekilden tüm etiketleri tek bir işlemle kaldırabilir miyim?

Evet. tag collection bir kerede tüm anahtar‑değer çiftlerini silen bir clear işlemini destekler.

Bir etiketi, tüm koleksiyonu dolaşmadan yalnızca adını kullanarak nasıl silebilirim?

TagCollection üzerindeki remove(name) işlemini kullanarak etiketi anahtarına göre silebilirsiniz.

Analiz veya filtreleme için etiket adlarının tam listesini nasıl alabilirim?

tag collection üzerinde getNamesOfTags kullanın; bu, tüm etiket adlarını içeren bir dizi döndürür.