付録 A XML 形式での分析結果

サンプルの XML 結果ファイル

次のサンプルに、XML 形式での上級者向け分析ウィザードの結果ファイルを示します。「XML 形式で結果を保存する」を参照してください。ファイルの構造は、analysis.dtd ファイルにより定義されます。「ドキュメント分析結果の DTD」を参照してください。

<?xml version="1.0" encoding="ISO-8859-1" ?> 
<!DOCTYPE results "analysis.dtd"> 
<results generated-by="documentanalysis" version="0.2.407" timestamp="12/02/2004 09:02:56">

<document location="C:\Documents and Settings\john\Desktop\work\test docs\TestAllIssues.doc"
type="Word" application="Word 9.0" issues-count="23" minor-issues-count="8"  pages="3" 
created="02/09/2003 16:21:00" modified="09/09/2003 11:09:00"  
accessed="12/02/2004 09:02:54"
printed="na" last-save-by="WASG" revision="15" based-on-template="Normal.dot">

<references>
		<reference name="VBA 4.0" description="Visual Basic For Applications"  
location="vbe6.dll"
type="TypeLib" GUID="{000204EF-0000-0000-C000-000000000046}"  is-broken="Intact" 
 builtin="BuiltIn" /> 
		<reference name="Word 8.1" description="Microsoft Word 9.0 Object Library" 
		location="msword9.olb" type="TypeLib" GUID="{00020905-0000-0000-C000-000000000046}" 
		is-broken="Intact" builtin="BuiltIn" /> 
			:
	</references>

	<issues>
 		<issue category="ContentAndDocumentProperties" type="PasswordProtection" 
severity="Minor">
			<location type="Document" />
			<details>
				<property name="Password to Open" value="Set" /> 
				<property name="Password to Modify" value="Set" /> 
			</details>
		</issue>	
		<issue category="ContentAndDocumentProperties" type="DocumentPartsProtection"
		severity="Minor">
			<location type="Document" /> 
			<details>
				<property name="Protection" value="Allow Only Revisions" /> 
			</details>
		</issue>
		<issue category="Tables" type="NestedTables" severity="Minor">
			<location type="Page">
				<property name="sublocation" value="1" /> 
			</location>
			<details>
				<property name="OuterTable" value="3x5" /> 
				<property name="InnerTable" value="2x5" /> 
				<property name="StartRow" value="1" /> 
				<property name="StartCol" value="1" /> 
				<property name="Note[0]" value="The inner table will be lost
					 on roundtrip." /> 
			</details>
		</issue>

	:
		<issue category="Fields" type="MailMergeField" severity="Major">
			<location type="Page">
				<property name="sublocation" value="3" /> 
				<property name="line" value="20" /> 
				<property name="column" value="1" /> 
			</location>
			<details>
				<property name="Name" value="Ask" /> 
				<property name="Text" value="ASK Text1 "What do you want"" /> 
			</details>
		</issue>
			:
	</issues>
</document>

<document location="C:\Documents and Settings\john\Desktop\work\test docs\TestNoIssues.doc" 
	type="Word" application="Word 9.0" issues-count="0" minor-issues-count="0" 
	pages="8" created="02/09/2003 16:55:00" modified="31/10/2003 16:06:00"
	accessed="12/02/2004 09:02:56" printed="na" last-save-by="johnr" revision="4" 
	based-on-template="Normal.dot" /> 
</results>

ドキュメント分析結果の DTD

XML 結果ファイルの構造は analysis.dtd ファイルで定義されています。このファイルは、<installation directory>\resources ディレクトリにあります。

<!ELEMENT results ( document+ ) >
<!ATTLIST results generated-by NMTOKEN #REQUIRED >
<!ATTLIST results version CDATA #REQUIRED >
<!ATTLIST results timestamp CDATA #REQUIRED >
<!ATTLIST results type NMTOKEN #REQUIRED >

<!ELEMENT document ( references?, issues? ) >
<!ATTLIST document location CDATA #REQUIRED >
<!ATTLIST document application CDATA #REQUIRED >
<!ATTLIST document issues-count CDATA #IMPLIED >
<!ATTLIST document minor-issues-count CDATA #IMPLIED >
<!ATTLIST document pages CDATA #REQUIRED >
<!ATTLIST document created CDATA #REQUIRED >
<!ATTLIST document modified CDATA #REQUIRED >
<!ATTLIST document accessed CDATA #REQUIRED >
<!ATTLIST document printed CDATA #REQUIRED >
<!ATTLIST document last-save-by CDATA #REQUIRED >
<!ATTLIST document revision CDATA #REQUIRED >
<!ATTLIST document based-on-template CDATA #REQUIRED >

<!ELEMENT references ( reference+ ) >

<!ELEMENT reference EMPTY >
<!ATTLIST reference name CDATA #REQUIRED >
<!ATTLIST reference description CDATA #REQUIRED >
<!ATTLIST reference location CDATA #REQUIRED >
<!ATTLIST reference type CDATA #REQUIRED >
<!ATTLIST reference GUID CDATA #IMPLIED >
<!ATTLIST reference is-broken CDATA #REQUIRED >
<!ATTLIST reference builtin CDATA #REQUIRED >

<!ELEMENT issues ( issue+ ) >

<!ELEMENT issue ( location, details+ ) >
<!ATTLIST issue category CDATA #REQUIRED >
<!ATTLIST issue type CDATA #REQUIRED >
<!ATTLIST issue severity CDATA #REQUIRED >

<!ELEMENT location ( property* ) >
<!ATTLIST location type CDATA #REQUIRED >

<!ELEMENT details ( (property+), (property | note)* ) >

<!ELEMENT property EMPTY >
<!ATTLIST property name CDATA #REQUIRED >
<!ATTLIST property value CDATA #REQUIRED >

<!ELEMENT note EMPTY >
<!ATTLIST note index CDATA #REQUIRED >
<!ATTLIST note value CDATA #REQUIRED >

ドキュメント分析結果の DTD 要素のインデックス

ドキュメント分析結果の DTD では、次の要素が定義されています。

<results>
<document>
<references>
<reference>
<issues>
<issue>
<location>
<details>
<property>
<note>

`<results>`

XML ドキュメントのルートノード

宣言された属性:

#REQUIRED NMTOKEN generated-by

これは、DocumentAnalysisWizard に設定されている必要があります。
#REQUIRED CDATA version

結果の生成に使用される上級者向け分析ウィザードのビルド番号。
#REQUIRED CDATA timestamp

このレポートが書き込まれた時刻。
#REQUIRED NMTOKEN type

分析されたドキュメントタイプ。この属性の値は、Word、 Excel、または PowerPoint を取ることができます。

`<document>`

分析されたドキュメント。

宣言された属性

#REQUIRED CDATA location

分析されたドキュメントへのローカルパス。
#REQUIRED CDATA application

文書を作成したアプリケーション (バージョンを含む)。
#IMPLIED CDATA issues-count

ドキュメントの問題の総数。
#IMPLIED CDATA minor-issues-count

重要でないと分類された問題の数。
#REQUIRED CDATA pages

ドキュメント内の Word のページ、Excel のシート、または PowerPoint のスライドの数。
#REQUIRED CDATA created

ドキュメントが作成された日付。
#REQUIRED CDATA modified

ドキュメントが修正された日付。
#REQUIRED CDATA accessed

ドキュメントが最後にアクセスされた日付。
#REQUIRED CDATA printed

(該当する場合) ドキュメントが最後に印刷された日付。
#REQUIRED CDATA last-save-by

ドキュメントを最後に保存したユーザー。
#REQUIRED CDATA revision

ドキュメントのリビジョン番号。
#REQUIRED CDATA based-on-template

(該当する場合) ドキュメントの基となったテンプレート。

`<reference>`

タイプライブラリへの参照、またはドキュメント内の Visual プロジェクトにあるプロジェクトへの参照を表します。参照が分析および記録されるのは、ドキュメントにマクロが含まれている場合のみです。この情報は、ドキュメント内のマクロの外部オートメーションの依存性が原因と考えられる移植性の問題を判断するのに役立ちます。

宣言された属性

#REQUIRED CDATA name

参照のバージョンを含む、参照の名前。
#REQUIRED CDATA description

参照を説明する名前。
#REQUIRED CDATA location

参照されるプロジェクトのタイプライブラリのファイル名が含まれる文字列。
#REQUIRED CDATA type

タイプライブラリ

オートメーションに使用可能な公開されているオブジェクト、プロパティ、およびメソッドの標準的な記述を含む、ファイルまたは別のファイル内のコンポーネント。

プロジェクト

モジュールのセット
#IMPLIED CDATA GUID

参照のクラス識別子を含む文字列。
#REQUIRED CDATA is-broken

参照が有効な参照を指定していない場合、これは is true に設定されます。
#REQUIRED CDATA builtin

参照が、移動や削除が不可能な標準の参照である場合、これは is true に設定されます。

`<issue>`

ドキュメントの分析で検出された移行問題。

注 –

問題の属性のカテゴリ、種類または重要度はローカライズされず、XML 出力の自動処理を容易にするため、常に英語で出力されます。

宣言された属性:

#REQUIRED CDATA category

異なるドキュメントタイプのさまざまな問題のカテゴリのリストについては、付録 B 「問題のカテゴリと問題の種類」を参照してください。
#REQUIRED CDATA type

異なるドキュメントタイプの現在の問題の種類のリストについては、付録 B 「問題のカテゴリと問題の種類」を参照してください。
#REQUIRED CDATA severity

問題のカテゴリの複雑度。

`<location>`

ドキュメント内の問題の位置。(該当する場合) これには位置に関する詳細な情報を提供する追加のプロパティが含まれます。たとえばページ 1 の問題には、location=Page、および name=sublocation value=1 のプロパティ名/値の組み合わせがある、のようになります。

#REQUIRED CDATA type

これは、ドキュメント、ブック、プレゼンテーション、ページ、シートまたはスライドを指すことができます。注意: この属性はローカライズされず、XML 出力の自動処理を容易にするため常に英語で出力されます。

`<details>`

一連のプロパティとノートで示される、問題の詳細。ドキュメントを移行するユーザーが問題を迅速かつ効率的に解決できるよう、これには十分な情報が含まれます。

`<property>`

プロパティは、問題の詳細と位置に関する情報の保持に使用される名前/値の組み合わせです。これらのプロパティ名/値の組み合わせはローカライズされます。

#REQUIRED CDATA name

プロパティの名前。
#REQUIRED CDATA value

プロパティの文字列値。

`<note>`

ノートは、問題をユーザーに分かりやすくするため、問題の詳細に追加される情報の注記です。ノートは、数値インデックスと値文字列から構成されています。値文字列はローカライズされます。

#REQUIRED CDATA index

ノートの正の数値インデックス。
#REQUIRED CDATA value

ノートの文字列値。