PHP を使用したプレゼンテーションのタグとカスタムデータの管理

プレゼンテーション ファイルにおけるデータ ストレージ

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

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

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

タグの値を取得する

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

  $pres = new Presentation("pres.pptx");
  try {
    $keywords = $pres->getDocumentProperties()->getKeywords();
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

プレゼンテーションにタグを追加する

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

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

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

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

  $pres = new Presentation("pres.pptx");
  try {
    $tags = $pres->getCustomData()->getTags();
    $pres->getCustomData()->getTags()->set_Item("MyTag", "My Tag Value");
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $slide->getCustomData()->getTags()->set_Item("tag", "value");
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

あるいは個々のShape に対しても設定できます：

  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 100, 50);
    $shape->getTextFrame()->setText("My text");
    $shape->getCustomData()->getTags()->set_Item("tag", "value");
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

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

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

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

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

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

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

PowerPoint テーブル