PDC Packaging White Paperdownload.microsoft.com/.../PDC08_Packaging_JPN.docx · Web viewOpen Packaging Conventions は、Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) といった

Open Packaging Conventions ファイル用の Win32 API

Jack DavisMiriam WallaceMicrosoft Corporation2008 年 10 月

対象: Windows® 7

要約: このドキュメントでは、Office Open XML ファイル形式 (ECMA-376 標準) に準拠するカスタムコンテナーファイルの Open Packaging Conventions (OPC) API の Win32 実装の概要について説明します。また、OPC の主要概念の紹介、この概念の Win32 実装へのマッピングに関する説明を行い、2 つの付録では、Win32 と OPC API のマネージ実装の対応とパッケージに関連した URI の文字列表記について説明します。

法的通知

このドキュメントは暫定版であり、このソフトウェアの最終的な製品版の発売時に実質的に変更されることがあります。

このドキュメントに記載されている情報は、このドキュメントの発行時点におけるマイクロソフトの見解を反映したものです。変化する市場状況に対応する必要があるため、このドキュメントは、記載された内容の実現に関するマイクロソフトの確約とはみなされないものとします。また、発行以降に発表される情報の正確性に関して、マイクロソフトはいかなる保証もいたしません。

このホワイトペーパーに記載された内容は情報の提供のみを目的としており、明示、黙示または法律の規定にかかわらず、これらの情報についてマイクロソフトはいかなる責任も負わないものとします。

お客様ご自身の責任において、適用されるすべての著作権関連法規に従ったご使用を願います。このドキュメントのいかなる部分も、米国 Microsoft Corporation の書面による許諾を受けることなく、その目的を問わず、どのような形態であっても、複製または譲渡することは禁じられています。ここでいう形態とは、複写や記録など、電子的な、または物理的なすべての手段を含みます。ただしこれは、著作権法上のお客様の権利を制限するものではありません。

マイクロソフトは、このドキュメントに記載されている内容に関し、特許、特許申請、商標、著作権、またはその他の無体財産権を有する場合があります。別途マイクロソフトのライセンス契約上に明示の規定のない限り、このドキュメントはこれらの特許、商標、著作権、またはその他の無体財産権をお客様に許諾するものではありません。

© 2008 Microsoft Corporation. All rights reserved.Microsoft、MS-DOS、Windows、Windows NT、Windows Server、Windows Vista、Active Directory、ActiveSync、ActiveX、Direct3D、DirectDraw、DirectInput、DirectMusic、DirectPlay、DirectShow、DirectSound、DirectX、Expression、FrontPage、HighMAT、Internet Explorer、JScript、Microsoft Press、MSN、Outlook、PowerPoint、SideShow、Silverlight、Visual Basic、Visual C++、Visual InterDev、Visual J++、Visual Studio、WebTV、Windows Media、Win32、Win32s、および Zune は米国 Microsoft Corporation の米国またはその他の国における登録商標または商標です。

記載されている会社名、製品名には、各社の商標のものもあります。

目次

はじめに.......................................................................................................................................................1OPC パッケージの概念...............................................................................................................................1

パーツ..................................................................................................................................................2リレーションシップ..............................................................................................................................3デジタル署名........................................................................................................................................4

Packaging API オブジェクトモデル..............................................................................................................5Packaging API インターフェイス...................................................................................................................6

IOpcPackage インターフェイス................................................................................................................6IOpcPart インターフェイス.......................................................................................................................7IOpcRelationship インターフェイス..........................................................................................................7IOpcRelationshipSet インターフェイス.....................................................................................................8Packaging API のデジタル署名..................................................................................................................8

詳細情報.......................................................................................................................................................9用語集..........................................................................................................................................................10付録 A: Managed Packaging Implementation のクラスに対する Packaging API インターフェイスのマッピング....................................................................................................................................................................11付録 B: Relationships パーツの名前付け........................................................................................................12


はじめにOpen Packaging Conventions (OPC) は、コンテナーファイルテクノロジの仕様です。これは、Office Open XML の ISO/IEC 標準と ECMA 標準のファイル形式の基盤となっています。OPC 仕様では、ファイル形式の設計担当者に対して、アプリケーションファイルやリソースを格納するための、アクセスが容易で、柔軟性のある、カスタムの圧縮ファイルの形式を作成するためのガイドラインを提供しています。OPC ベースのカスタムの形式を使用しているファイルを "パッケージ" と呼びます。

OPC は、業界標準のコンテナーファイルテクノロジで、これを使用すると、アプリケーションではデータや関連リソースを、移植可能でアクセスしやすい 1 つのファイルに格納することができます。また、主要な物理フォーマットとしては、標準的な ZIP ファイルが使用されます。この新しいファイルパッケージ化テクノロジは、いくつかの主要なマイクロソフトアプリケーションで既に採用されています。

Open Packaging Conventions は、Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) といった Microsoft® Office 2007 ドキュメントの、新しいファイルテクノロジの標準です。

Open Packaging Conventions は、XML Paper Specification (XPS) (.xps) ドキュメントの基盤として使用されています。これは、Windows Vista® および Windows® 7 オペレーティングシステムのネイティブなアーカイブドキュメント形式および印刷スプールドキュメント形式です。

Open Packaging Conventions のマネージ API のサポートは Windows Vista および Windows 7 に組み込まれており、Windows XP および Windows Server 2003 で使用できるように .NET Framework 3.0 に含められています。

Open Packaging Conventions の Win32 API のサポートは Windows 7 に組み込まれています。

複数のデータファイルを 1 つの ZIP ファイルに格納するという馴染みのある使用方法に加えて、Open Packaging Conventions では、新しいファイルの種類を実装するための、オープンで拡張可能なフレームワークを構築するいくつかの革新的な機能が追加されました。OPC のテクノロジは、Office Open XML 標準 (ISO/IEC-29500 および ECMA-376 の Part 2) で定義されています。

このドキュメントでは、Packaging API について説明します。これは、OPC API の Win32 実装で、これを使用すると、プログラムでパッケージの読み込み、書き込み、および変更を行うことができます。

OPC パッケージの概念パッケージとは、アプリケーションデータを含む圧縮ファイルのことです。OPC 仕様では、パッケージを定義するために、"パーツ" と "リレーションシップ" という 2 つの基本的な概念が導入されました。パーツとは、アプリケーションデータを含む物理オブジェクトで、パッケージ内に存在します。リレーションシップとは、パッケージやパーツと、URI アドレスを指定できるリソース (パーツや外部の Web サイトなど) の間の、論理的な関連付けです。図 1 は、パッケージのパーツとリレーションシップの概念的な違いを示しています。

© 2008 Microsoft Corporation. All rights reserved.1


図 1: パッケージのパーツとリレーションシップの役割

パーツ物理パッケージにおいて、パーツはファイルシステムのファイルに似ています。パーツは、ファイルシステムのフォルダー構成と同じように、階層構造になっています。図 2 では、単純なパッケージを使用して、この構成上の共通点を示しています。

パーツとファイルには共通点がありますが、パーツはファイルとは区別されます。パーツは、OPC 仕様で規定されているプロパティを使用する、バイトのストリームとして定義されます。図 2 に示すように、Name プロパティの値 (パーツ名) は、パッケージルートからのパーツの URI です (Name プロパティおよびパーツのその他のプロパティの詳細については、OPC 仕様を参照してください)。

図 2: 単純なパッケージの階層構成 (パーツ名は引用符内に記載)

図 2 に示すように、パーツ名は文字列として表すことができます。この文字列はファイルの完全なパスと似ており、ファイルシステムでファイルの名前とパスを指定する際と同様の規則の多くに従います。パーツ名の詳細については、OPC 仕様を参照してください。パッケージ内の階層構造と URI ベースのパーツの



名前付けによって、OPC 仕様に基づいてカスタムファイル形式を作成するパッケージの設計担当者は、各自の形式およびアプリケーションのニーズに最適なパッケージオブジェクトの論理グループを自由に選択できます。

リレーションシップリレーションシップは、リソースの "ソース" と "ターゲット" 間の、方向の関連付けを定義します。リレーションシップのソースは、パーツまたはパッケージです。リレーションシップのターゲットには、パッケージの内側または外側にある、URI アドレスを指定できる任意のリソースを指定できます。パッケージとパーツはどちらも URI アドレスを指定できるので、両方ともリレーションシップのターゲットに指定できます。たとえば、図 3 は、ソースが "\text\swings" パーツで、ターゲットが "\images\tire_swing.jpg" パーツというリレーションシップを概念的に表したものです。

図 3: 2 つのパーツを関連付けているリレーションシップを概念的に表したす単純なパッケージ

リレーションシップでによって定義される関連付けは、"リレーションシップマークアップ" と呼ばれる XML マークアップを使用して表されます。リレーションシップマークアップは、Relationships パーツと呼ばれる特殊なパーツのパーツコンテンツとして格納されます。リレーションシップのソースとなっている各パッケージまたはパーツは、各自のリレーションシップマークアップをそれぞれの Relationships パーツに格納します。リレーションシップマークアップに関する詳細については、OPC 仕様を参照してください。

たとえば、図 3 のリレーションシップがパッケージに追加された場合、パッケージの階層には、図 4 のように Relationships パーツが追加されます。



図 4: Relationships パーツを含む単純なパッケージの階層

図 4 の Relationships パーツを含む単純なパッケージの階層の Relationships パーツのパーツコンテンツ (リレーションシップマークアップ) を図 5 に示します。

図 5: 単純なパッケージの階層の Relationships パーツの詳細

Relationships パーツの名前は、格納するリレーションシップのソースの URI から派生します。Relationships パーツのパーツ名の詳細については、「付録 B: Relationships パーツの名前付け」を参照してください。

Relationships パーツでは、リレーションシップで定義される関連付けをソースのコンテンツから分離することで、関連付けを簡単に見つけられるようにして、ソースのコンテンツが変更されるのを防いでいます。

リレーションシップと Relationships パーツの詳細については、OPC 仕様を参照してください。

デジタル署名デジタル署名は、パッケージの作成者を特定し、署名済みの "パッケージコンポーネント" (パーツ、リレーションシップなど) が、署名後に変更されていないことを確認するために使用できます。



OPC 仕様では、パッケージのデジタル署名の要件が詳しく規定されていますが、このホワイトペーパーではこのトピックについては説明しません。パッケージへのデジタル署名の Packaging API の実装に関する説明は、Windows SDK に含まれています。この説明は、[Packaging] (パッケージ化)、[Packaging Programming Guide] (パッケージ化プログラミングガイド)、[Packaging Programming Overview] (パッケージ化プログラミングの概要)、[Packaging Advanced Programming Tasks] (パッケージ化プログラミングの高度なタスク) と移動することで参照できます。

Packaging API オブジェクトモデルOPC の主要概念は、"図 6: Packaging API オブジェクトモデル (OPC の主要概念を表しているインターフェイスでは概念がかっこ書きで記載され、その他のインターフェイスは API 固有と記載)" および次の表に示している、Packaging パッケージ化 API の Win32 COM インターフェイスによって表されます。

OPC の概念 Packaging API の表現パッケージ IOpcPackage インターフェイスパーツ IOpcPart インターフェイスリレーションシップ IOpcRelationship インターフェイスRelationships パーツ IOpcRelationshipSet インターフェイス

図 6: Packaging API オブジェクトモデル (OPC の主要概念を表しているインターフェイスでは概念がかっこ書きで記載され、その他のインターフェイスは API 固有と記載)

Packaging API の IOpcFactory インターフェイスでは、この主要概念およびデジタル署名の機能を表すインターフェイスにアクセスできます。IOpcFactory インターフェイスは、CoCreateInstance を呼び出して作成できます。

階層によって表される簡単なパッケージは、図 6 に示す Packaging API オブジェクトモデルを使用して表すこともできます。図 7 に、この 2 つのパッケージの表記を並べて示します。



図 7: 階層および Packaging API オブジェクトモデルによって表される単純なパッケージ

既に説明したように、図 7 の単純なパッケージには、ソースが "\text\swings" パーツで、ターゲットが "\images\tire_swing.jpg" パーツである 1 つのリレーションシップがあります。そのため、オブジェクトモデルにも 1 つのリレーションシップのみが存在しています。

これ以降のトピックでは、OPC の主要概念の Packaging API インターフェイス実装について紹介し、デジタル署名にアクセスする方法について説明します。

Packaging API の *Set インターフェイスは、順序のないコレクションです。そのため、それぞれに含まれているインターフェイスに連続してアクセスすることができる列挙子インターフェイスを、すべてのインターフェイスで使用できます。

Packaging API のさらに詳しい情報については、Windows SDK の「Packaging」(パッケージ化) を参照してください。

OPC API のマネージ実装 (Managed Packaging Implementation、マネージ Packaging API の実装) に対する Packaging API のマッピングについては、「付録 A: Managed Packaging Implementation のクラスに対する Packaging API インターフェイスのマッピング」を参照してください。

Packaging API インターフェイスIOpcPackage インターフェイスIOpcPackage インターフェイスでは、パッケージを表し、図 6 に示すように IOpcPartSet インターフェイスおよび IOpcRelationshipsSet インターフェイスにアクセスすることができます。

IOpcPackage インターフェイスから取得される IOpcPartSet インターフェイスは、パッケージに含まれるすべてのパーツ (ただし、Relationships パーツを除く) を表します。

IOpcPackage インターフェイスから取得される IOpcRelationshipsSet インターフェイスは、パッケージがソースとして含まれているすべてのリレーションシップ (パッケージリレーションシップと呼ばれます) を格納する、Relationships パーツを表します。

IOpcFactory インターフェイスでは、IOpcPackage インターフェイスを作成するメソッドが定義されています。



IOpcPart インターフェイスIOpcPart インターフェイスは、パッケージに含まれる 1 つのパーツを表し、図 6 と図 7 に示したように IOpcRelationshipsSet インターフェイスにアクセスできます。

IOpcPart インターフェイスでは、Content、Content type、Name 、および Compression option プロパティを使用して、パーツの情報にアクセスできます。これらのプロパティの説明を次の表に示し、図 8 に図解します。

プロパティ説明Content OPC 仕様で規定されているパーツを構成するバイトのストリームです。

Content type 形式の設計担当者によって指定された、パーツコンテンツのメディアの種類です。

Name パッケージに含まれるパーツの URI です。Compression option パーツコンテンツで使用する圧縮のオプションです。

図8: Packaging API オブジェクトモデルの IOpcPart インターフェイスの詳細

図 7 と図 8 に示すように、IOpcPart インターフェイスが 1 つまたは複数のリレーションシップのソースであるパーツを表している場合は、IOpcRelationshipsSet インターフェイスを取得できます。これは、ソースとして対応するパーツが含まれているリレーションシップを格納している、Relationships パーツを表します。

IOpcPackage インターフェイスから取得される IOpcPartSet インターフェイスでは、Relationships パーツではなく、パッケージ内のパーツに対応する IOpcPart オブジェクトの列挙子を作成、削除、および取得するメソッドが定義されています。

IOpcRelationship インターフェイスIOpcRelationship インターフェイスは、パッケージの内部または外部いずれかの、ソースおよびターゲットリソース間の方向の関連付けを示すリレーションシップを表します。

IOpcRelationship インターフェイスでは、Relationship identifier、Relationship type、Source URI、Target resource URI 、および Target mode プロパティによって、リレーションシップの情報にアクセスできます。これらのプロパティの説明を次の表に示し、"図 9: Packaging API オブジェクトモデルの IOpcRelationship インターフェイスの詳細" に図解します。



プロパティ説明Relationship identifier リレーションシップの一意の識別子です。

Relationship type OPC パッケージのデザイン担当者によって定義された、リレーションシップの修飾名です。

Source URI リレーションシップのソースの URI です。ソース URI には、パッケージまたはパーツの URI を指定できます。

Target resource URI リレーションシップのターゲットリソースの URI です。

Target mode ターゲットリソースがパッケージの内部と外部のどちらにあるかを示す値です。

図 9: Packaging API オブジェクトモデルの IOpcRelationship インターフェイスの詳細

IOpcRelationshipSet インターフェイスでは、同じソースが含まれているリレーションシップの表記を使用することができ、IOpcRelationship インターフェイスを作成および削除するメソッドが定義されています。

IOpcRelationshipSet インターフェイスIOpcRelationshipSet インターフェイスは、共通のソースが含まれている全リレーションシップを格納する Relationships パーツを表します。IOpcRelationshipSet インターフェイスと Relationships パーツの対応については、図 7 を参照してください。

IOpcPackage インターフェイスから取得された場合、IOpcRelationshipSet インターフェイスはパッケージリレーションシップを格納している Relationships パーツを表します。IOpcPart インターフェイスから取得された場合、IOpcRelationshipSet インターフェイスは、(IOpcPart インターフェイスに対応する) パーツがソースとして含まれているリレーションシップを格納する、Relationships パーツを表します。IOpcRelationshipSet インターフェイスでは、IOpcRelationshipSet インターフェイスが表す Relationships パーツの、パーツコンテンツのストリーム (Relationship XML Mmarkup: リレーションシップ XML マークアップ) にアクセスできます。

IOpcRelationshipSet インターフェイスでは、IOpcRelationshipSet インターフェイスが表す Relationships パーツに格納されるリレーションシップに対応する、IOpcRelationship オブジェクトの列挙子を作成、削除、および取得するためのメソッドが定義されています。

Packaging API のデジタル署名IOpcDigitalSignatureManager インターフェイスでは、署名を作成および変更できるメソッドが定義されており、パッケージのデジタル署名を表す IOpcDigitalSignature インターフェイスの列挙子にアクセスできます。IOpcDigitalSignature インターフェイスでは、署名の情報にアクセスできます。



IOpcFactory インターフェイスでは、IOpcDigitalSignatureManager インターフェイスを作成するメソッドが定義されています。

詳細情報 Open Packaging Conventions (OPC) の詳細については、ECMA International

(http://go.microsoft.com/fwlink/?LinkID=123375&clcid=0x409) の「Standard ECMA-376」(英語) で、ECMA-376 の Part 2 を参照してください。

Managed Packaging Implementation の詳細については、MSDN の「System.IO.Packaging 名前空間」(http://msdn.microsoft.com/ja-jp/library/system.io.packaging.aspx) を参照してください。

Web アドレスは変更される可能性があるため、ここに記載されている Web サイトに接続できない場合があります。


http://msdn.microsoft.com/ja-jp/library/system.io.packaging.aspx



http://go.microsoft.com/fwlink/?LinkID=123375&clcid=0x409


用語集パッケージコンポーネント

パッケージに含まれるパーツ、リレーションシップ、およびコンテンツタイプを表す XML。

パッケージリレーションシップソースがパッケージであるリレーションシップ。パッケージリレーションシップは、"\_rels\.rels" Relationships パーツに格納されます。

パーツOPC 仕様によって定義されているとおりです。IOpcPart インターフェイスによって表されます。

パーツコンテンツパーツのバイトストリーム。

part content type (パーツコンテンツの種類)RFC 2626 の 3.7 の定義と構文に一致する、パーツのコンテンツのメディアの種類。

パーツ名パッケージルートからの、パーツの URI。ファイルの完全なパスと類似しています。

リレーションシップOPC 仕様で定義されている、ソースとターゲットリソース間の方向の関連付け。IOpcRelationship インターフェイスによって表されます。

リレーションシップマークアップリレーションシップを表すために使用される XML マークアップ。

Relationships パーツOPC 仕様で定義されている、リレーションシップマークアップを格納する特殊なパーツ。IOpcRelationshipSet インターフェイスによって表されます。

リソースURI アドレスを指定できる任意の内部オブジェクトまたは外部オブジェクト。

ソースリレーションシップのソースとなるパッケージまたはパーツ。

ターゲットリレーションシップのターゲットとなるリソース。



付録 A: Managed Packaging Implementation のクラスに対する Packaging API インターフェイスのマッピング次の表に示すように、Managed Packaging Implementation のクラスが Win32 インターフェイスに厳密にマップされるという点で、Packaging API は、OPC API のマネージ実装 (Mmanaged Packaging Iimplementation) と非常によく似ています。

マネージ Packaging API Packaging APIPackage クラス IOpcPackage インターフェイスPackagePart クラス IOpcPart インターフェイスPackageRelationship クラス IOpcRelationship インターフェイスPackageDigitalSignature クラス IOpcDigitalSignature インターフェイス

Packaging API は、マネージ Packaging API と多く類似点がありますが、次の表に示すような相違点があります。

マネージ Packaging API Packaging API

パッケージを作成、保存、および読み込むためのメソッドが Package クラスで提供されます。

パッケージを作成、保存、および読み込むためのメソッドが IOpcFactory インターフェイスで提供されます。

URI のユーティリティメソッドは、PackUriHelper クラスで提供されます。

URI のユーティリティメソッドは、必要に応じて IOpcUri、IOpcPartUri、および IOpcFactory インターフェイスに分類されます。

Packaging API と managed Packaging implementation の動作の相違点については、このドキュメントでは取り上げません。これについては、Windows SDK の概要「Packaging API Behavioral Differences from the Managed Implementation」(Packaging API とマネージ Packaging API 実装の動作の相違点) で説明されています。



付録 B: Relationships パーツの名前付けRelationships パーツのパーツ名は、Relationships パーツに格納されているリレーションシップのソース URI から派生します。

リレーションシップソースの URI は文字列として表すことができ、ソースの完全なパス (パッケージルートからの相対パス) と見なすことができます。パーツのパーツ名 (URI) は完全なパスと見なすことができるので、特定のソースの Relationships パーツの URI は、ソース URI から派生させることができます。

リレーションシップのソース URI から Relationships パーツのパーツ名 (URI) を取得するには

1. 元のソース URI の、ソースのパスの末尾に、"\_rels" セグメントを挿入します。この操作によって、パッケージ内にパーツが配置されているサブフォルダーが作成されます。

2. 表示された文字列に、.rels という拡張子を追加します。

たとえば、リレーションシップに、パーツ名 (URI) が "\text\swings" というであるパーツがソースとして含まれている場合は、上記の手順によって、次のような Relationships パーツ名を取得できます。

1. "_rels" セグメントを挿入して、"\text\_rels\swings" とします。

2. "\text\_rels\swings" に .rels という拡張子を追加して、"\text\_rels\swings.rels" とします。

"\text\_rels\swings.rels" という URI は、"図 4: Relationships パーツを含む単純なパッケージの階層" に示されているように適切なリレーションシップパーツ名です。

リレーションシップのソースがパッケージである場合は、対応する Relationships パーツには、"\rels\.rels" というパーツ名 (URI) が含まれます。


Documents

PDC Packaging White Paperdownload.microsoft.com/.../PDC08_Packaging_JPN.docx · Web viewOpen Packaging Conventions は、Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx) といった