2007年05月31日

biz-StreamでPDFファイル作成時に、文書全体に設定可能な項目及びアプリケーションからの設定方法を説明いたします。
今回は文書概要に関する情報設定です。

1. 文書概要の設定

PDFファイルでは文書全体の情報として、「タイトル」「サブタイトル」「作成者」「キーワード」の文書概要を設定することができます。
これらの情報は、Adobe Readerで文書情報と表示されるだけではなく、explorer上バルーンヘルプで表示されたり、検索ツールのキーワードとして活用することが可能です。

《 PDFファイルの文書概要設定項目一覧 》

#	文書概要設定項目	説明
(1)	タイトル	PDF文書のタイトル。
(2)	作成者	PDF文書の作成者又は作成者グループ等。
(3)	サブタイトル	他のPDF文書との共通した情報等。
(4)	キーワード	PDF文書の重要な語句等。

※ 上記の「説明」にて記載されている内容は一般的に設定されている内容です。
Acrobat及びbiz-Streamでは自由に設定可能です。

これら情報は通常Adobe Acrobat等によりPDFを作成・編集する際に設定しますが、biz-Streamでレイアウトファイル作成、及びアプリケーションから設定することが可能です。

2. レイアウトデザイナによる文書概要の設定

レイアウトファイルで固定でこの文書概要の情報をする場合、以下の手順で設定を行います。

• レイアウトデザイナでドキュメントレイアウトを作成(又は開く)
• 左にある「ツリービュー」の「文書の概要」を選択
• 文書の概要にある「タイトル」「サブタイトル」「作成者」「キーワード」のフィールドに入力
• 入力が終わったら入力フィールドの下にある[適用]ボタンを押す

3. レイアウトXMLファイルによる文書概要の設定

レイアウトデザイナにより作成するレイアウトXMLファイルは、XML形式のファイルのため、直接XMLタグを編集することによりPDFの文書概要を設定することも可能です。

《 レイアウトXMLファイルのタグ及び属性値一覧 》

#	フィールド	XMLタグ	属性名	指定内容
(1)	タイトル	bs:document-summary	title	タイトル文字列
(2)	作成者		author	作成者文字列
(3)	サブタイトル		subject	サブタイトル文字列
(4)	キーワード		keywords	キーワード文字列

《 レイアウトサンプル 》

<?xml version="1.0" encoding="Shift_JIS" ?>
<!-- XML file created by biz-Stream Designer -->
<!-- Copyright by Brainsellers.com Corporation -->
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format" ...
    <bs:document-properties-set>
        <bs:document-summary title="タイトル"
          subject="サブタイトル" author="作成者" keywords="キーワード"/>
        <bs:document-view initial-page="1" page-size= ...

※ レイアウトタグに関しては、「ドキュメントレイアウトタグ リファレンスガイド」「2.1.4.3 文書の概要 <bs:document-summary>」及びサンプルファイル「<biz-Streamインストールフォルダ>/sample/xml/layout-master-set/layoutSample1.xml」をご参照ください。

4. アプリケーションからの文書概要設定

アプリケーションから動的に設定するには以下のメソッドを利用することが可能です。

《 文書概要を設定するメソッド一覧 》

#	フィールド	メソッド	パラメタ
(1)	タイトル	setTitle(String title)	titlle - タイトル文字列
(2)	作成者	setAuthor(String author)	author - 作成者文字列
(3)	サブタイトル	setSubject(String subject)	subject - サブタイトル文字列
(4)	キーワード	setKeywords(String keyword)	keyword - キーワード文字列

また、これらのメソッドを利用したサンプルプログラムは以下よりダウンロード可能です。

• PDF文書概要設定サンプル PDFDescSample.zip (2.34KBytes)

5. 留意事項

レイアウトXMLファイルの<bs:document-summary> の属性 title/subject/author/keywords が未設定の場合のみ、アプリケーションから setTitle()/setAuthor/setSubject()/setKeyword() メソッドの設定が可能です。