Python via Java でプレゼンテーションを XAML にエクスポート

このページの概要

Aspose.Slides for Python via Java を使用して、PowerPoint および OpenDocument のプレゼンテーションを XAML にエクスポートします。デフォルトオプションを使用するか、非表示スライドを含めることができます。

概要

この記事では、Aspose.Slides for Python via Java を使用して PowerPoint プレゼンテーションを XAML にエクスポートする方法を説明します。XAML の簡単な概要を含み、デフォルト設定でプレゼンテーションを XAML に保存する方法を示し、XamlOptions を使用してエクスポートをカスタマイズする方法（非表示スライドのエクスポートを含む）を実演します。また、フォールバックフォント、XAML スタックの互換性、非表示スライドのエクスポート動作に関する一般的な質問にも答えます。

例を実行するには、Aspose.Slides for Python via Java と互換性のある Java ランタイムが必要です。pres.pptx を現在の作業ディレクトリに配置してください。各例は、JVM がまだ起動していない場合にのみ起動します。

XAML について

XAML は XML ベースのマークアップ言語で、WPF（Windows Presentation Foundation）や UWP（Universal Windows Platform）、Xamarin.Forms などのフレームワークでユーザーインターフェイスを記述するために使用されます。

XAML ファイルはビジュアルデザイナーで操作することも、マークアップを直接記述・編集することもできます。

デフォルトオプションでプレゼンテーションを XAML にエクスポート

以下の Python の例は、デフォルト設定でプレゼンテーションを XAML にエクスポートする方法を示します。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, XamlOptions

presentation = Presentation("pres.pptx")
try:
    xaml_options = XamlOptions()
    presentation.save(xaml_options)
finally:
    presentation.dispose()

デフォルトでは、エクスポートされたスライドはプロセスの現在の作業ディレクトリ内の pres サブフォルダーに保存されます。フォルダーは自動的に作成され、必要な画像も同様に保存されます。

出力フォルダー名は、拡張子なしのソースファイル名から取得されます。pres.pptx の場合、出力ファイルは pres/Slide_1.xaml、pres/Slide_2.xaml などと名付けられます。入力プレゼンテーションに絶対パスを指定した場合でも、出力フォルダーは入力ファイルと同じ場所ではなく、現在の作業ディレクトリを基準に作成されます。

カスタムオプションでプレゼンテーションを XAML にエクスポート

Aspose.Slides がプレゼンテーションを XAML にエクスポートする方法は、XamlOptions クラスで制御できます。

出力をカスタム場所に保存するには、IXamlOutputSaver を実装し、その実装インスタンスを XamlOptions の setOutputSaver メソッドに渡します。

XAML 出力に非表示スライドを含めるには、以下の Python の例のように True を指定して setExportHiddenSlides を呼び出します。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, XamlOptions

presentation = Presentation("pres.pptx")
try:
    xaml_options = XamlOptions()
    xaml_options.setExportHiddenSlides(True)
    presentation.save(xaml_options)
finally:
    presentation.dispose()

生成されたすべての XAML アーティファクトを取得

XAML エクスポートでは、エクスポートされた各スライドに対して XAML ドキュメントと、個別の画像やサポートリソースが生成されることがあります。デフォルトのファイルシステム保存機能の代わりにこれらのアーティファクトを受け取るには、カスタム IXamlOutputSaver を XamlOptions.setOutputSaver に割り当てます。XAML オプションを受け取る Presentation.save のオーバーロードを使用してエクスポートを開始します。

Python では、jpype.JProxy を使用して Java の IXamlOutputSaver インターフェイスを実装します。コールバックパスを str に変換し、Java のバイト配列を Python の bytes にコピーしてから返す方法を以下に示します。

コールバックライフサイクルを理解

path はアーティファクトを識別し、相対ディレクトリを含む場合があります。XAML が相対パスでリソースを参照する可能性があるため、この情報を保持してください。
data にはアーティファクトのバイトが含まれます。画像やその他のバイナリリソースはテキストとしてデコードしてはいけません。
セーバーは返却前にデータを保持または永続化する責任があります。例では各バイト配列をアプリケーション所有のメモリにコピーしています。
エクスポートは、プレゼンテーションの保存操作が完了し、すべてのコールバックが正常に終了した場合にのみ成功とみなします。ストレージエラーを無視したり、観測されないバックグラウンド書き込みを開始したりしないでください。永続化が後で行われる場合は、そのステップが成功した後に全体の成功を報告してください。

XamlOptions.setExportHiddenSlides はカスタムセーバーにも適用されます。デフォルト設定 False は非表示スライドの XAML ドキュメントを除外します。True を渡すとそれらとエクスポートに必要なリソースが含まれます。リソース数はプレゼンテーションによって異なるため、スライドごとに 1 つのコールバックがあるとか、固定されたコールバック順序があると想定しないでください。

メモリへエクスポートしアーティファクトを検査

この完全な例は pres.pptx を読み込み、すべてのアーティファクトを名前と不変の bytes 値の Python 辞書に収集し、名前、タイプ、バイト数を出力します。提供された名前はそのまま保持されます。重複する名前がある場合は、アーティファクトを静かに上書きするのではなくコレクションを無効とします。例では結果を使用する前にこのチェックを行います。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpial.startJVM()

from asposeslides.api import Presentation, XamlOptions

class MemoryXamlSaver:
    def __init__(self):
        self.artifacts = {}
        self.valid = True

    def save(self, path, data):
        name = str(path)
        if name in self.artifacts:
            self.valid = False
            print(f"Export rejected: duplicate artifact name: {name}")
            return
        self.artifacts[name] = bytes(data)

def main():

    saver = MemoryXamlSaver()
    output_saver = jpype.JProxy("com.aspose.slides.IXamlOutputSaver", inst=saver)
    presentation = Presentation("pres.pptx")
    try:
        options = XamlOptions()
        options.setOutputSaver(output_saver)
        options.setExportHiddenSlides(True)
        presentation.save(options)
    finally:
        presentation.dispose()

    if not saver.valid:
        print("Export rejected: the artifact collection is invalid.")
        return

    inspect_xaml_text = False
    image_extensions = (".png", ".jpg", ".jpeg", ".gif", ".bmp", ".tif", ".tiff", ".svg")
    for name, data in saver.artifacts.items():
        lower_name = name.lower()
        is_xaml = lower_name.endswith(".xaml")
        is_image = lower_name.endswith(image_extensions)
        kind = "slide XAML" if is_xaml else "image" if is_image else "supporting resource"
        print(f"{name}: {len(data)} bytes ({kind})")

        # XAML のみデコードし、テキスト検査が必要なときだけデコードします。
        if is_xaml and inspect_xaml_text:
            markup = data.decode("utf-8")
            print(markup)


main()

拡張子のチェックは検査に有用です。未知のリソース型を含め、すべてのアーティファクトを保持してください。保存や転送時にはバイトを変更せずにそのまま保持します。テキスト処理が必要な XAML のみ、UTF-8 で bytes.decode を使用してください。

収集したアーティファクトを ZIP アーカイブにパッケージ

この独立した例はエクスポートを収集し、名前を検証したうえで元のバイトを ZIP アーカイブに書き込みます。ユニークなアーカイブ名は同時実行エクスポートジョブを分離します。ZIP エントリはスラッシュ (/) を使用し、相対ディレクトリを保持します。正規化後に衝突する危険な名前や安全でない名前は、書き込む前にパッケージ全体を破棄します。

from uuid import uuid4
from zipfile import ZipFile

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, XamlOptions

class MemoryXamlSaver:
    def __init__(self):
        self.artifacts = {}
        self.valid = True

    def save(self, path, data):
        name = str(path)
        if name in self.artifacts:
            self.valid = False
            print(f"Export rejected: duplicate artifact name: {name}")
            return
        self.artifacts[name] = bytes(data)

def main():

    saver = MemoryXamlSaver()
    output_saver = jpype.JProxy("com.aspose.slides.IXamlOutputSaver", inst=saver)
    presentation = Presentation("pres.pptx")
    try:
        options = XamlOptions()
        options.setOutputSaver(output_saver)
        options.setExportHiddenSlides(False)
        presentation.save(options)
    finally:
        presentation.dispose()

    if not saver.valid:
        print("Export rejected: the artifact collection is invalid.")
        return

    entries = {}
    entry_names = set()
    for name, data in saver.artifacts.items():
        entry_name = name.replace("\\", "/")
        segments = entry_name.split("/")
        unsafe_name = entry_name.startswith("/") or ":" in entry_name or "\x00" in entry_name
        unsafe_name |= any(not segment.strip() or segment in (".", "..") for segment in segments)
        normalized_name = entry_name.casefold()
        if unsafe_name or normalized_name in entry_names:
            print(f"Export rejected: unsafe or duplicate artifact name: {name}")
            return
        entry_names.add(normalized_name)
        entries[entry_name] = data

    job_id = uuid4()
    archive_path = f"xaml-{job_id}.zip"
    try:
        with ZipFile(archive_path, mode="x") as archive:
            for name, data in entries.items():
                archive.writestr(name, data)

        # クローズにより ZIP ディレクトリが確定し、成功が報告されます。
        print(f"Saved {len(entries)} artifacts to {archive_path}")
    except OSError as exception:
        print(f"Archive persistence failed: {exception}")


main()

例では Python の zipfile.ZipFile を使用してローカルアーカイブを作成しています。エクスポーター自体は個別の XAML や画像ファイルを書き込みません。リモートストレージの場合は、アーカイブ書き込み段階を収集したバイト配列のアップロードに置き換えてください。エクスポートジョブの識別子とフル相対アーティファクト名をブロブキーとして使用するか、ジョブ識別子、相対名、バイナリデータをデータベース行に保存します。すべてのアップロードが完了するかデータベーストランザクションがコミットされた後にジョブを公開し、永続化に失敗した場合は部分的な出力をクリーンアップしてください。

大規模なプレゼンテーションの場合、カスタムセーバーで各アーティファクトを直接アプリケーションストレージに永続化すれば、エクスポート全体の追加コピーをメモリに保持する必要がなくなります。エクスポーターの観点からは、各コールバックを同期的に保ち、宛先がバイトを受け取った後にのみ返却し、エラーは呼び出し元に伝搬させてください。

リソース名を保持し参照を検証

宛先が要求する場合はパス区切り文字を正規化しますが、相対ディレクトリは保持してください。すべての生成名が一意でリソース参照が有効であることが確実でない限り、pathlib.Path.name のみを使用しないでください。
宛先固有の名前検証を適用します。個別ファイルを書き込む場合、ルートパスやディレクトリトラバーサルセグメントを拒否し、pathlib.Path.resolve で宛先を解決し、ディレクトリ区切り文字を含めたチェックで意図したエクスポートディレクトリ以下に留まっていることを確認します。書き込み先をリダイレクトできるシンボリックリンクのない、アプリケーション管理のディレクトリを使用してください。
エクスポートジョブごとに別々のセーバーとストレージ名前空間を使用します。区切り文字の正規化後および宛先の大小文字感度ルールに従って衝突を検出してください。
公開前に、各 XAML ドキュメントを XML として解析し、画像の Source や ImageSource 属性などのファイルベースのリソース参照を検査します。各相対 URI をそれを含む XAML アーティファクトのディレクトリに対して解決し、結果のストレージ名を正規化して、対応するマップキー、ZIP エントリ、または保存オブジェクトが存在することを確認します。外部 URI と XAML マークアップ式は相対ファイル名とは別に扱ってください。

例として、pres/Slide_1.xaml が images/image1.png を参照している場合、保存されたリソースは pres/images/image1.png として利用可能である必要があります。image1.png だけを保持すると関係が壊れます。オブジェクトストレージの場合、ジョブプレフィックス以下に同じレイアウトを保持し、これらのリソース URL を XAML コンシューマがアクセスできるようにしてください。完了した ZIP を再度開き、エントリ名とリソースバイトを検証し、対象 XAML 環境で代表的なスライドを読み込んで画像が正しく解決されることを確認します。

FAQ

元のフォントがマシンに存在しない場合、予測可能なフォントを確保するにはどうすればよいですか？

XamlOptions で setDefaultRegularFont を呼び出します。元のフォントが欠如している場合、エクスポート時のフォールバックフォントとして使用されます。ただし、生成された XAML がフォールバックフォントを参照することや、対象マシンにそのフォントが存在することが保証されるわけではありません。XAML が参照するフォントが表示環境に存在することを確認してください。

エクスポートされた XAML は WPF のみを対象としていますか、それとも他の XAML スタックでも使用できますか？

Aspose.Slides はパブリック API を通じて WPF 用 XAML をエクスポートします。UWP や Xamarin.Forms など他の XAML スタックとの互換性は保証されていません。生成されたマークアップは対象環境でテストしてください。

非表示スライドはサポートされていますか？デフォルトでエクスポートされないようにする方法はありますか？

デフォルトでは、非表示スライドは含まれません。これらの動作は XamlOptions の setExportHiddenSlides で制御できます。エクスポートが不要な場合は無効のままにしてください。

PythonでPowerPointプレゼンテーションを変換 | HTML、PNG、PDF、Word、TIFF Python via Java でプレゼンテーションを HTML5 に変換