Gestion des balises et des données personnalisées

Stockage des données dans les fichiers de présentation

Les fichiers PPTX – éléments avec l’extension .pptx – sont stockés au format PresentationML, qui fait partie de la spécification Office Open XML. Le format Office Open XML définit la structure des données contenues dans les présentations.

Avec une diapositive étant l’un des éléments dans les présentations, une partie de diapositive contient le contenu d’une seule diapositive. Une partie de diapositive est autorisée à avoir des relations explicites avec de nombreuses parties – telles que les balises définies par l’utilisateur – définies par l’ISO/IEC 29500.

Les données personnalisées (spécifiques à une présentation) ou à l’utilisateur peuvent exister sous forme de balises (ITagCollection) et de CustomXmlParts (ICustomXmlPartCollection).

Les balises sont essentiellement des paires clé-valeur de chaîne.

Obtenir les valeurs des balises

Dans les diapositives, une balise correspond aux méthodes IDocumentProperties.getKeywords() et IDocumentProperties.setKeywords(). Ce code d’exemple vous montre comment obtenir la valeur d’une balise avec Aspose.Slides pour PHP via Java pour Presentation:

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

Ajouter des balises aux présentations

Aspose.Slides vous permet d’ajouter des balises aux présentations. Une balise se compose généralement de deux éléments :

• le nom d’une propriété personnalisée - MyTag
• la valeur de la propriété personnalisée - My Tag Value

Si vous devez classer certaines présentations en fonction d’une règle ou d’une propriété spécifique, vous pouvez bénéficier de l’ajout de balises à ces présentations. Par exemple, si vous souhaitez regrouper ou rassembler toutes les présentations des pays d’Amérique du Nord, vous pouvez créer une balise nord-américaine et attribuer les pays pertinents (les États-Unis, le Mexique et le Canada) comme valeurs.

Ce code d’exemple vous montre comment ajouter une balise à une Presentation en utilisant Aspose.Slides pour PHP via Java :

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

Les balises peuvent également être définies pour une 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();
    }
  }

Ou pour toute forme Shape individuelle :

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