Správa vlastností prezentace v JavaScriptu
Úvod
Aspose.Slides pro Node.js prostřednictvím Javy podporuje vestavěné a vlastní vlastnosti dokumentu. Použijte tyto vlastnosti ke čtení a aktualizaci metadat prezentace, jako je autor, název a uživatelem definované hodnoty.
Aspose.Slides umožňuje pracovat s vlastnostmi dokumentu prezentace prostřednictvím třídy DocumentProperties. Instance této třídy je vrácena metodou Presentation.getDocumentProperties. Následující příklady ukazují, jak číst, měnit a spravovat tyto vlastnosti.
Note
Aspose.Slides spravuje metadata aplikace a výrobce při ukládání prezentací; tato pole identifikují software, který výstup vytvořil.Správa vlastností prezentace
Vlastnosti dokumentu ukládají popisné informace vedle obsahu prezentace. Rozdělují se do dvou kategorií:
- Vestavěné vlastnosti obsahují standardní metadata, jako jsou název, autor a statistiky dokumentu.
- Vlastní vlastnosti uchovávají páry název/hodnota definované uživatelem.
Aspose.Slides pro Node.js prostřednictvím Javy poskytuje přístup k oběma kategoriím. V PowerPointu vyberte File → Info → Properties → Advanced Properties pro prohlédnutí metadat dokumentu. Dialog rozděluje informace do záložek jako Summary, Statistics, Contents a Custom. Použijte záložku Custom k správě uživatelem definovaných vlastností.
Čtení veřejných vlastností z šifrované prezentace
Otevírací heslo obvykle chrání jak obsah prezentace, tak vlastnosti dokumentu. Když je prezentace šifrována po zavolání ProtectionManager.setEncryptDocumentProperties s hodnotou false, její vlastnosti dokumentu zůstávají veřejné. Aplikace pak může zavolat LoadOptions.setOnlyLoadDocumentProperties s hodnotou true a přečíst veřejná metadata bez zadání otevíracího hesla.
LoadOptions.setOnlyLoadDocumentProperties řídí, co Aspose.Slides načítá; nic neodšifruje. Pokud byly vlastnosti zahrnuty do šifrování, načtení bez hesla selže. Pokud prezentace není šifrována, volba se ignoruje a načte se celá prezentace.
Příklad vyžaduje šifrovanou prezentaci, jejíž vlastnosti dokumentu byly ponechány veřejné. Ověřuje režim načítání pomocí ProtectionManager.isOnlyDocumentPropertiesLoaded a poté čte vestavěné vlastnosti pomocí Presentation.getDocumentProperties:
const slides = require("aspose.slides.via.java");
const loadOptions = new slides.LoadOptions();
loadOptions.setOnlyLoadDocumentProperties(true);
const presentation = new slides.Presentation("public-properties-encrypted.pptx", loadOptions);
try {
if (presentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
const documentProperties = presentation.getDocumentProperties();
console.log("Author: " + documentProperties.getAuthor());
console.log("Title: " + documentProperties.getTitle());
console.log("Keywords: " + documentProperties.getKeywords());
} else {
console.log("The presentation was not loaded in document-properties-only mode.");
}
} finally {
presentation.dispose();
}
V tomto režimu se nenačítá obsah snímků. Snímky, masters, rozvržení, tvary, média a další objekty prezentace nejsou k dispozici. Aplikace by měly vždy zkontrolovat ProtectionManager.isOnlyDocumentPropertiesLoaded před provedením operace vyžadující kompletní objektový model prezentace.
Warning
Veřejná metadata mohou odhalit jména autorů, názvy, předměty, klíčová slova, informace o společnosti, komentáře a vlastní hodnoty. Šifrujte citlivé vlastnosti společně s prezentací. Ponechte je veřejné pouze tehdy, když indexování, klasifikace, vyhledávání nebo systémy pro správu dokumentů mají konkrétní požadavek na přístup k nim bez hesla.Aktualizace vlastností šifrované prezentace
Pro šifrovaný soubor PPTX je prezentace načtená po zavolání LoadOptions.setOnlyLoadDocumentProperties s hodnotou true určena k čtení veřejných metadat. Aspose.Slides nemůže uložit změněné vlastnosti z tohoto objektu jen s metadata, protože veřejné vlastnosti musí zůstat v souladu s odpovídajícími daty uvnitř šifrované prezentace. Aktualizace proto vyžaduje správné otevírací heslo a úplné načtení.
Příklad vyžaduje šifrovanou prezentaci PPTX s veřejnými vlastnostmi dokumentu a známým otevíracím heslem. Otevře kompletní prezentaci pomocí LoadOptions.setPassword, aktualizuje veřejné vestavěné vlastnosti a výsledek uloží. Poté použije PresentationInfo.isEncrypted k ověření, že šifrování zůstalo zachováno, a znovu otevře veřejná metadata bez hesla k ověření nových hodnot:
const slides = require("aspose.slides.via.java");
const inputPath = "public-properties-encrypted.pptx";
const outputPath = "updated-public-properties-encrypted.pptx";
const loadOptions = new slides.LoadOptions();
loadOptions.setPassword("open_password");
const presentation = new slides.Presentation(inputPath, loadOptions);
try {
const documentProperties = presentation.getDocumentProperties();
documentProperties.setTitle("Updated Product Roadmap");
documentProperties.setKeywords("roadmap, planning, indexed");
presentation.save(outputPath, slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
const presentationInfo = slides.PresentationFactory.getInstance().getPresentationInfo(outputPath);
console.log("The presentation is encrypted: " + presentationInfo.isEncrypted());
const metadataLoadOptions = new slides.LoadOptions();
metadataLoadOptions.setOnlyLoadDocumentProperties(true);
const metadataPresentation = new slides.Presentation(outputPath, metadataLoadOptions);
try {
if (metadataPresentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
console.log("Title: " + metadataPresentation.getDocumentProperties().getTitle());
console.log("Keywords: " + metadataPresentation.getDocumentProperties().getKeywords());
} else {
console.log("The presentation was not loaded in document-properties-only mode.");
}
} finally {
metadataPresentation.dispose();
}
Pokud aplikace nemá oprávnění dešifrovat nebo načíst obsah prezentace, musí veřejné vlastnosti šifrovaného souboru PPTX považovat za pouze pro čtení.
Přístup k vestavěným vlastnostem
Třída DocumentProperties zpřístupňuje vestavěná metadata pomocí metod get, včetně getAuthor, getTitle a getCreatedTime. Tento příklad otevře existující prezentaci a vypíše její uložená metadata do konzole. Hodnoty závisejí na vstupní prezentaci; některá pole mohou být prázdná.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("AccessBuiltInProperties.pptx");
try {
const documentProperties = presentation.getDocumentProperties();
console.log("Category: " + documentProperties.getCategory());
console.log("Content status: " + documentProperties.getContentStatus());
console.log("Creation date: " + documentProperties.getCreatedTime());
console.log("Author: " + documentProperties.getAuthor());
console.log("Comments: " + documentProperties.getComments());
console.log("Keywords: " + documentProperties.getKeywords());
console.log("Last modified by: " + documentProperties.getLastSavedBy());
console.log("Manager: " + documentProperties.getManager());
console.log("Modified date: " + documentProperties.getLastSavedTime());
console.log("Presentation format: " + documentProperties.getPresentationFormat());
console.log("Last print date: " + documentProperties.getLastPrinted());
console.log("Is shared between producers: " + documentProperties.getSharedDoc());
console.log("Subject: " + documentProperties.getSubject());
console.log("Title: " + documentProperties.getTitle());
} finally {
presentation.dispose();
}
Úprava vestavěných vlastností
Pro aktualizaci vestavěných metadat použijte metody set na objektu vráceném metodou Presentation.getDocumentProperties. Tento příklad otevře existující prezentaci, zavolá setAuthor, setTitle, setSubject, setComments a setManager, poté uloží aktualizovanou prezentaci pomocí Presentation.save. Uložený soubor PPTX obsahuje nová metadata.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("ModifyBuiltInProperties.pptx");
try {
const documentProperties = presentation.getDocumentProperties();
documentProperties.setAuthor("Aspose.Slides for Node.js 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", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Správa základní adresy hypertextových odkazů
DocumentProperties.getHyperlinkBase vrací základní adresu dokumentu pro relativní hypertextové odkazy. Použijte DocumentProperties.setHyperlinkBase k její změně nebo vymazání. To je užitečné při přesunu prezentace a jejích propojených souborů na jiné místo. Neovlivňuje to jednotlivé odkazy získané metodou Hyperlink.getExternalUrl: změna základu nepřepíše uložené adresy odkazů ani nemění absolutní cíle.
Příklad vyžaduje prezentaci obsahující relativní odkaz, např. target.html, a absolutní odkaz, např. https://example.org/absolute.html. Načte existující základ, přiřadí novou adresu a uloží a znovu otevře prezentaci pro kontrolu hodnoty. Poté základ vymaže prázdným řetězcem a ověří prázdnou hodnotu v samostatném uloženém souboru. Nahraďte ukázkovou adresu základu umístěním vašich propojených souborů.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("hyperlinks.pptx");
try {
console.log("Original base: " + presentation.getDocumentProperties().getHyperlinkBase());
const newBase = "https://example.com/new/";
presentation.getDocumentProperties().setHyperlinkBase(newBase);
presentation.save("hyperlinks-updated.pptx", slides.SaveFormat.Pptx);
const updatedPresentation = new slides.Presentation("hyperlinks-updated.pptx");
try {
console.log("Base preserved: " + (newBase === updatedPresentation.getDocumentProperties().getHyperlinkBase()));
updatedPresentation.getDocumentProperties().setHyperlinkBase("");
updatedPresentation.save("hyperlinks-cleared.pptx", slides.SaveFormat.Pptx);
const clearedPresentation = new slides.Presentation("hyperlinks-cleared.pptx");
try {
console.log("Base cleared: " + ("" === clearedPresentation.getDocumentProperties().getHyperlinkBase()));
} finally {
clearedPresentation.dispose();
}
} finally {
updatedPresentation.dispose();
}
} finally {
presentation.dispose();
}
Obě ověřovací zprávy by měly vypsat true. Vymazání základu ponechá adresy jednotlivých hypertextových odkazů nedotčeny.
Relativní odkaz na target.pptx otevřel old/target.pptx, když základ ukazoval na složku old. Po změně základu na složku new, uložení a opětovném otevření prezentace otevřel stejný odkaz new/target.pptx. Absolutní odkaz nadále otevíral stejný soubor. Otestujte své relativní odkazy v PowerPointu před a po přesunu prezentace či změně jejího základu.
Přidání vlastních vlastností prezentace
Vlastní vlastnosti uchovávají metadata, která nemají odpovídající vestavěné pole. Metoda DocumentProperties.set_Item umožňuje přiřadit hodnotu podle názvu vlastnosti. Tento příklad vytvoří prezentaci, přidá dvě textové hodnoty a celočíselnou verzi a uloží prezentaci pomocí Presentation.save. Přiřazení hodnoty k existujícímu názvu nahradí původní hodnotu vlastnosti.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation();
try {
const 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", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Přístup a úprava vlastních vlastností
Tento příklad otevře prezentaci obsahující vlastní vlastnosti a použije getCountOfCustomProperties k jejich iteraci. getCustomPropertyName přijímá nulový index a vrací název použitý metodou DocumentProperties.set_Item. Příklad vypíše každé původní jméno a hodnotu, nahradí každou hodnotu číslovaným řetězcem bez ohledu na původní typ a uloží změny. Pokud nejsou žádné vlastní vlastnosti, smyčka nic nezmění.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("AccessAndModifyProperties.pptx");
try {
const documentProperties = presentation.getDocumentProperties();
for (let i = 0; i < documentProperties.getCountOfCustomProperties(); i++) {
const propertyName = documentProperties.getCustomPropertyName(i);
const propertyValue = documentProperties.get_Item(propertyName);
console.log("Custom property name: " + propertyName);
console.log("Custom property value: " + propertyValue);
documentProperties.set_Item(propertyName, "New Value " + (i + 1));
}
presentation.save("CustomProperties_output.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Ukázkový příklad
Vyzkoušejte online aplikaci Zobrazit a upravit metadata PowerPoint a zjistěte, jak pracovat s vlastnostmi dokumentu pomocí API Aspose.Slides:
Často kladené otázky
Jak mohu odstranit vestavěnou vlastnost z prezentace?
Vestavěné vlastnosti jsou nedílnou součástí prezentace a nelze je zcela odstranit. Můžete je však buď změnit, nebo nastavit na prázdnou hodnotu, pokud to konkrétní vlastnost umožňuje.
Co se stane, když přidám vlastní vlastnost, která již existuje?
Pokud přidáte vlastní vlastnost, která již existuje, její stávající hodnota bude přepsána novou. Není nutné vlastnost předtím odstraňovat nebo kontrolovat, protože Aspose.Slides automaticky aktualizuje hodnotu vlastnosti.
Mohu přistupovat k vlastnostem prezentace bez úplného načtení prezentace?
Ano. Použijte PresentationFactory.getPresentationInfo a poté PresentationInfo.readDocumentProperties k načtení uložených metadat dokumentu bez vytvoření instance Presentation. Viz Vytvořit lehkou inventuru prezentací pro kompletní příklad reportování a omezení specifických formátů.
Mohu číst veřejné vlastnosti šifrované prezentace bez jejího otevíracího hesla?
Ano. Prezentace musí být šifrována po zavolání ProtectionManager.setEncryptDocumentProperties s hodnotou false a musí být načtena po zavolání LoadOptions.setOnlyLoadDocumentProperties s hodnotou true.
Mohu aktualizovat šifrovaný soubor PPTX v režimu pouze vlastnosti dokumentu?
Ne. Veřejná i šifrovaná data vlastností musejí zůstat konzistentní, takže aktualizace šifrovaného souboru PPTX vyžaduje načtení kompletní prezentace se správným otevíracím heslem.
