PHPでプレゼンテーション情報を取得および更新

このページの概要

Aspose.Slides for PHP を使用して、PowerPoint および OpenDocument プレゼンテーションのスライド、構造、メタデータを調査し、迅速なインサイトと賢いコンテンツ監査を実現します。

概要

Aspose.Slides はプレゼンテーションの形式を識別し、完全なプレゼンテーションオブジェクトモデルを作成せずにドキュメントメタデータを読み取ることができます。これは、ファイルを分類したり、インベントリを作成したり、プレゼンテーションコンテンツをロードして処理するかどうかを判断する前にプロパティを検査したりする場合に便利です。

この記事では、PresentationFactory と PresentationInfo を使用した軽量検査、および DocumentProperties を使用した対象的な更新を示します。

プレゼンテーション形式の確認

すでにプレゼンテーションをロードしている場合は、ロード後の検出方法とレガシー PPT、PPS、POT ストリームの制限については、Determine the Original Presentation Format を参照してください。

PresentationFactory::getPresentationInfo を使用して、Presentation インスタンスを作成せずにファイルを検査します。PresentationInfo::getLoadFormat メソッドは、PPTX、PPT、ODP など検出された形式を報告します。

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$fileNames = ["pres.pptx", "pres.ppt", "pres.odp"];

foreach ($fileNames as $fileName) {
    $presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($fileName);
    $loadFormat = java_values($presentationInfo->getLoadFormat());
    $formatName = "Other (" . $loadFormat . ")";

    if ($loadFormat === LoadFormat::Pptx) {
        $formatName = "PPTX";
    } elseif ($loadFormat === LoadFormat::Ppt) {
        $formatName = "PPT";
    } elseif ($loadFormat === LoadFormat::Odp) {
        $formatName = "ODP";
    }

    echo $fileName . ": " . $formatName . PHP_EOL;
}

軽量プレゼンテーションインベントリの構築

多数のプレゼンテーションファイルを処理する場合、検証、インデックス作成、またはドキュメント管理システム向けのコンパクトなインベントリが必要になることがあります。このシナリオでは、PresentationFactory::getPresentationInfo を使用して PresentationInfo オブジェクトを取得し、次に PresentationInfo::readDocumentProperties を呼び出してドキュメントメタデータを読み取ります。このアプローチでは、Presentation インスタンスを作成したり、完全なプレゼンテーションオブジェクトモデルを走査したりする必要はありません。

DocumentProperties が提供する拡張プロパティは、次のインベントリ値を示します。

メソッド	インベントリ値
getSlides	スライド総数。
getHiddenSlides	非表示スライド数。
getNotes	ノートが含まれるスライド数。
getParagraphs	利用可能な場合の段落総数。
getWords	単語総数。
getMultimediaClips	オーディオおよびビデオクリップ総数。

以下の例は、これらの値を Presentation オブジェクトを作成せずに取得し、コンパクトなインベントリを出力します。また、DocumentProperties::getHeadingPairs と DocumentProperties::getTitlesOfParts を組み合わせて、フォント、テーマ、スライドタイトルなどのコンテンツグループを表示します。

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$filePath = "sample.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($filePath);
$documentProperties = $presentationInfo->readDocumentProperties();

$loadFormat = java_values($presentationInfo->getLoadFormat());
$formatName = "Other (" . $loadFormat . ")";

if ($loadFormat === LoadFormat::Pptx) {
    $formatName = "PPTX";
} elseif ($loadFormat === LoadFormat::Ppt) {
    $formatName = "PPT";
} elseif ($loadFormat === LoadFormat::Odp) {
    $formatName = "ODP";
}

echo "File: " . basename($filePath) . PHP_EOL;
echo "Format: " . $formatName . PHP_EOL;
echo "Title: " . java_values($documentProperties->getTitle()) . PHP_EOL;
echo "Author: " . java_values($documentProperties->getAuthor()) . PHP_EOL;
echo "Statistics:" . PHP_EOL;
echo "  Slides: " . java_values($documentProperties->getSlides()) . PHP_EOL;
echo "  Hidden slides: " . java_values($documentProperties->getHiddenSlides()) . PHP_EOL;
echo "  Slides with notes: " . java_values($documentProperties->getNotes()) . PHP_EOL;
echo "  Paragraphs: " . java_values($documentProperties->getParagraphs()) . PHP_EOL;
echo "  Words: " . java_values($documentProperties->getWords()) . PHP_EOL;
echo "  Multimedia clips: " . java_values($documentProperties->getMultimediaClips()) . PHP_EOL;

$headingPairs = $documentProperties->getHeadingPairs();
$titlesOfParts = $documentProperties->getTitlesOfParts();

if (java_is_null($headingPairs) || java_is_null($titlesOfParts)) {
    echo "Content groups: not available" . PHP_EOL;
} else {
    $headingPairs = java_values($headingPairs);
    $titlesOfParts = java_values($titlesOfParts);
    $partIndex = 0;

    if (count($headingPairs) === 0 || count($titlesOfParts) === 0) {
        echo "Content groups: not available" . PHP_EOL;
    } else {
        echo "Content groups:" . PHP_EOL;

        foreach ($headingPairs as $headingPair) {
            $partCount = java_values($headingPair->getCount());
            echo "  " . java_values($headingPair->getName()) . " (" . $partCount . ")" . PHP_EOL;

            for ($partOffset = 0; $partOffset < $partCount && $partIndex < count($titlesOfParts); $partOffset++) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }

        if ($partIndex < count($titlesOfParts)) {
            echo "  Other parts:" . PHP_EOL;

            while ($partIndex < count($titlesOfParts)) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }
    }
}

各 HeadingPair はグループ名とそのグループ内の項目数を提供します。DocumentProperties::getTitlesOfParts はフラットで順序付けられた配列を返すため、各ヘディングペアで指定された連続したタイトル数を消費します。

保存されたメタデータと形式の制限

PresentationInfo::readDocumentProperties が返すインベントリプロパティは、ソースドキュメントで利用可能なメタデータを反映しています。Aspose.Slides はこの呼び出しのためにプレゼンテーションオブジェクトモデルをロードおよび走査してこれらの値を再計算しません。欠落しているプロパティは既定値で表され、最後にファイルを保存したアプリケーションがドキュメントプロパティを更新しなかった場合、保存された値は古い可能性があります。

PPTX: スライド、ノート、非表示スライド、段落、単語、マルチメディアのカウント、およびヘディングペアとパートタイトル用の拡張ドキュメントプロパティを提供します。利用可能性はドキュメント作成者が書き込んだプロパティに依存します。
PPT: バイナリ形式は対応するドキュメント要約プロパティを保存できます。プロパティが存在しない、またはドキュメント作成者によって更新されていない場合、Aspose.Slides はスライドから計算するのではなく、保存された値または既定値を返します。
ODP: OpenDocument メタデータはページ、段落、単語の総数など一般的なドキュメント統計を提供しますが、これらの値はすべての PowerPoint 固有拡張プロパティに対応しているわけではありません。非表示スライド、ノートスライド、マルチメディア、ヘディングペア、パートタイトルのメタデータは利用できない場合があり、インベントリプロパティは既定値を返すことがあります。ゼロ値や空配列を、該当コンテンツが存在しないという決定的な証拠として扱わないでください。

インベントリや事前チェックには軽量メタデータアプローチを使用してください。結果がメモリ内の変更を反映する必要がある場合や、実際のプレゼンテーションコンテンツを検証する必要がある場合は、プレゼンテーションをロードしてライブオブジェクトモデルを検査してください。

プレゼンテーションプロパティの更新

PresentationInfo::readDocumentProperties が返すプロパティは、Presentation インスタンスを作成せずに変更することもできます。PresentationInfo::updateDocumentProperties で変更を適用し、続いて PresentationInfo::writeBindedPresentation でバインドされたプレゼンテーションを書き出します。

以下の画像は元のドキュメントプロパティを示しています。

PowerPoint プレゼンテーションの元のドキュメントプロパティ

以下の例はタイトルと最終保存時刻を変更し、結果を新しいファイルに書き出します。

use aspose\slides\PresentationFactory;

$sourceFile = "sample.pptx";
$outputFile = "sample_with_updated_properties.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($sourceFile);
$documentProperties = $presentationInfo->readDocumentProperties();

$documentProperties->setTitle("Quarterly sales report");
$documentProperties->setLastSavedTime(new Java("java.util.Date"));

$presentationInfo->updateDocumentProperties($documentProperties);
$outputStream = new Java("java.io.FileOutputStream", $outputFile);
try {
    $presentationInfo->writeBindedPresentation($outputStream);
} finally {
    $outputStream->close();
}

以下の画像は更新後のドキュメントプロパティを示しています。

PowerPoint プレゼンテーションの変更後ドキュメントプロパティ

便利なリンク

関連するセキュリティチェックおよび保護設定については、以下の記事を参照してください。

よくある質問

フォントが埋め込まれているか、どのフォントが埋め込まれているかを確認するにはどうすればよいですか？

プレゼンテーションをロードし、Presentation::getFontsManager を使用します。FontsManager::getEmbeddedFonts を呼び出して埋め込みフォントを取得し、FontsManager::getFonts を呼び出してプレゼンテーションで使用されているフォントを取得します。両方の結果を比較し、レンダリングに必要だが埋め込まれていないフォントを特定します。

ファイルに非表示スライドが含まれているか、そしてその数をすばやく判断する方法はありますか？

保存されたドキュメントメタデータが十分であれば、PresentationFactory::getPresentationInfo と PresentationInfo::readDocumentProperties を通じて DocumentProperties::getHiddenSlides を読み取ります。これは軽量インベントリに適しています。メモリ上でプレゼンテーションが変更されている場合や、保存されたメタデータが欠落または古い可能性がある場合、またはライブ値を検証する必要がある場合は、Presentation::getSlides を反復し、各スライドの Slide::getHidden メソッドを確認してください。

カスタムスライドサイズと方向が使用されているか、既定と異なるかを検出できますか？

はい。プレゼンテーションをロードし、Presentation::getSlideSize を呼び出します。SlideSize::getType、SlideSize::getSize、SlideSize::getOrientation を使用して現在の設定と期待されるプリセットや寸法を比較します。

チャートが外部データソースを参照しているかどうかをすばやく確認する方法はありますか？

はい。各 Chart を見つけ、ChartData::getDataSourceType を呼び出します。外部ブックの場合は、ChartData::getExternalWorkbookPath を呼び出します。データソースの種類とパスが外部参照を示しますが、対象が利用可能かどうかの検証は別途リソースチェックが必要です。

レンダリングや PDF エクスポートを遅くする可能性のある「重い」スライドを評価する簡単な方法はありますか？

単一の複雑度プロパティは存在しません。Presentation::getSlides と各スライドの BaseSlide::getShapes コレクションを走査します。シェイプ数や大きな画像、エフェクト、アニメーション、マルチメディアの有無をスクリーニングシグナルとして使用し、代表的なレンダリングまたはエクスポートを測定して、スライドを確実なパフォーマンスボトルネックとして扱う前に評価してください。

PHPでプレゼンテーションを開く PHP で元のプレゼンテーション形式を判定する