タグとカスタムデータの管理

プレゼンテーション ファイルのデータ ストレージ

PPTX ファイル（.pptx 拡張子のアイテム）は、Office Open XML 仕様の一部である PresentationML フォーマットで保存されます。Office Open XML フォーマットは、プレゼンテーションに含まれるデータの構造を定義します。

スライド はプレゼンテーションの要素の一つで、スライド パート は単一のスライドの内容を含みます。スライド パートは、ISO/IEC 29500 で定義されたユーザー定義タグなど、複数のパートへの明示的なリレーションシップを持つことができます。

カスタム データ（プレゼンテーション固有）やユーザーは、タグ（TagCollection）や CustomXmlParts（CustomXmlPartCollection）として存在できます。

タグは本質的に文字列キーのペア値です。

タグの値を取得する

スライドでは、タグはDocumentProperties.getKeywords() およびDocumentProperties.setKeywords() メソッドに対応しています。このサンプルコードは、Aspose.Slides for Node.js via Java を使用してPresentation のタグの値を取得する方法を示しています：

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

プレゼンテーションへのタグの追加

Aspose.Slides を使用すると、プレゼンテーションにタグを追加できます。タグは通常、次の 2 つの項目で構成されます:

• カスタム プロパティの名前 - MyTag
• カスタム プロパティの値 - My Tag Value

特定のルールやプロパティに基づいてプレゼンテーションを分類する必要がある場合、タグを追加すると便利です。例えば、北米諸国のプレゼンテーションをまとめてカテゴリ分けしたい場合、北米タグを作成し、該当する国（米国、メキシコ、カナダ）を値として割り当てることができます。

このサンプルコードは、Aspose.Slides for Node.js via Java を使用してPresentation にタグを追加する方法を示しています：

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();
    }
}

タグはSlide に対しても設定できます：

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();
    }
}

あるいは個々の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();
    }
}

よくある質問

プレゼンテーション、スライド、またはシェイプからすべてのタグを一括で削除できますか？

はい。tag collection は、すべてのキーと値のペアを一度に削除するclear 操作をサポートしています。

コレクション全体を走査せずに、名前で単一のタグを削除するにはどうすればよいですか？

TagCollection のremove(name) 操作を使用して、キーでタグを削除します。

分析やフィルタリングのために、タグ名の完全なリストを取得するにはどうすればよいですか？

tag collection でgetNamesOfTags を使用します。これにより、すべてのタグ名の配列が返されます。